中国 帮助

打包发布

App 打包分两步:先构建 Web 资源,再打原生安装包。前者用 npm 脚本,后者用 HBuilderX 或原生工程。 1. 构建资源 bash npm run build:app 产物在 dist/build/app/。这个目

打包发布
封面

> 本文整理自平台文档 docs/wujies/5.x/frontends/app/build.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-84e24c70c1a2-cover.svg)

App 打包分两步:先构建 Web 资源,再打原生安装包。前者用 npm 脚本,后者用 HBuilderX 或原生工程。

1. 构建资源

npm run build:app

产物在 dist/build/app/。这个目录是 uni-app 的 Web 资源,本身不是 apk / ipa,需要交给 HBuilderX 做原生打包。

2. 打原生包

### 方式 A:HBuilderX 云打包(推荐)

1. HBuilderX 打开 wujies-uniapp/; 2. 「发行 → 原生 App-云打包」; 3. 选择 Android / iOS,填证书、包名、版本; 4. 等待云端返回安装包。

需要准备:

平台材料
Android签名证书(.keystore)、别名、密码、包名
iOS开发 / 发布证书、Provisioning Profile、Bundle ID

> 云打包之前先确认 src/manifest.json 的 app-plus.modules 和 app-plus.distribute.sdkConfigs: > 仓库里这两项目前是空的,也就是推送、微信支付、支付宝、定位等原生能力一个都没启用。 > 需要哪个就在 modules 里声明、在 sdkConfigs 里填对应的开放平台参数,然后重新 npm run build:app。

### 方式 B:本地打包

使用 HBuilderX 生成的离线 SDK,把 dist/build/app/ 资源放进原生工程,再用 Android Studio / Xcode 编译。适合需要接入原生 SDK、或不能上云的场景。

3. 版本与权限

  • versionName:展示给用户,例如 1.0.0;
  • versionCode:整数,每次发版 +1;
  • Android 权限:只声明实际用到的,过度申请会被商店拒审;
  • iOS 隐私描述:相机、相册、定位等必须在 Info.plist 写清用途。

4. 发版检查清单

  • [ ] src/config.js 的 baseUrl 指向生产环境
  • [ ] appEncrypt 与后端一致
  • [ ] versionCode 已递增
  • [ ] 应用图标、启动图、应用名称已替换
  • [ ] Android 签名证书与上次发版一致(不一致无法覆盖安装)
  • [ ] iOS 证书与 Bundle ID 正确
  • [ ] 隐私政策、用户协议链接可访问
  • [ ] 真机回归:登录(账号密码 / 邮箱验证码 / 手机验证码三种 grantType)、下单支付、上传、消息
  • [ ] 用到原生 SDK 的功能(微信支付、推送等)已确认 modules / sdkConfigs 配好——仓库现状是未接
  • [ ] 应用商店截图与描述已更新

src="/images/docs/app-build.png" caption="HBuilderX 云打包界面(截图占位)" hint="建议 1440 × 900,截打包配置与证书选择。" />

常见问题

现象原因
安装包无法覆盖安装签名证书变了,或 versionCode 没递增
打开白屏资源没打进包、baseUrl 不可达、路由模式不匹配
支付调不起各端支付参数 / 回调地址 / 应用签名不一致
推送收不到厂商通道未配置、证书 / AppID 不匹配
iOS 审核被拒权限描述缺失、隐私政策缺失、使用了被禁 API

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-84e24c70c1a2-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容