- android-offline/:DCloud 离线集成工程(simpleDemo/libs 含 5+ Runtime aar)+ pack.ps1 + prepare.cjs - 包名 com.gztbyc.pda_wms、appId __UNI__0B3DAD3、BootReceiver 迁到新包名目录 - AndroidManifest 补齐权限(与 src/manifest.json 对齐)、新增蓝牙权限与 usesCleartextTraffic(生产接口为 http) - prepare.cjs 默认资源目录改为 dist/build/app-plus,注入到 assets/apps/__UNI__0B3DAD3/www 并对齐 compilerVersion - config/:android.example.json 模板 + README(appKey 与 appId/包名/证书指纹绑定说明);android.json 与 keystore 均不提交 - scripts/build-apk.cjs + npm run build:apk / android:pack:raw:生产编译(含地址校验)→ gradle 出包到 release/android - .gitignore 忽略 keystore、config/android.json、SDK、生成的 www 与 release
3.6 KiB
3.6 KiB
Android 离线打包(WMS_PDA)
本目录是 DCloud 官方 Android 离线打包集成工程,用于在本地用命令行出 APK(不需要 Android Studio,也不依赖 DCloud 云打包)。
目录
| 路径 | 说明 | git |
|---|---|---|
HBuilder-Integrate-AS/ |
Android Studio 集成工程,已提交(保证发布基座一致)。包名/版本/签名/应用名/appid/appKey 全部由 simpleDemo/build.gradle 在构建时从 config/android.json 与根 package.json 动态读取,工程内不含任何密码 |
✅ |
HBuilder-Integrate-AS/simpleDemo/libs/ |
5+ Runtime 等 aar(lib.5plus.base-release.aar、uniapp-v8-release.aar、breakpad、install-apk 等) |
✅ |
keystore/ |
签名密钥文件 | ❌ (忽略) |
icon/ splash/ |
图标与启动图源文件,prepare.cjs 用它们覆盖 res/ 下同名资源 |
✅ |
SDK/ |
DCloud 离线 SDK 解压目录(体积大,约 165MB),仅在需要额外原生模块时才下载 | ❌ (忽略) |
pack.ps1 |
命令行打包主脚本(JDK/SDK 探测 → 注入 → gradlew assembleRelease) |
✅ |
prepare.cjs |
注入 App 资源、覆盖图标/启动图、对齐 compilerVersion |
✅ |
一键打包
npm run build:apk # = 生产编译 + 产物地址校验 + 离线打包
npm run build:apk -- -Clean # gradle 全量重编
npm run build:apk -- -NoInject # 跳过资源注入(已注入过时用)
npm run android:pack:raw # 跳过前端编译,仅用现有 dist/build/app-plus 打包
产物:release/android/wms-pda_v{版本}_release.apk。版本唯一来源是根 package.json 的 version(X.Y.Z),versionCode 自动推导为 X*1000000 + Y*1000 + Z。
环境要求:JDK 17+(脚本会自动探测 JAVA_HOME、Android Studio JBR 等常见位置)、Android SDK(ANDROID_HOME/ANDROID_SDK_ROOT/local.properties 任一即可)。
与云打包的差异(重要)
- 签名不同:云打包用的是 DCloud 的证书,本地离线打包用
config/android.json配置的 keystore。若此前对外发布过云打包版本,切换后签名不一致、无法覆盖安装(需先卸载重装);若包名+签名已被第三方 SDK/推送/应用商店绑定,需要重新登记。 - 权限来自 AndroidManifest:离线打包不会读取
src/manifest.json的权限声明,权限必须写在HBuilder-Integrate-AS/simpleDemo/src/main/AndroidManifest.xml。增删权限时请两处同步,否则会出现「云打包能用、离线包缺权限」的差异。 - 明文 HTTP:生产接口是
http://qimen.wms.gztbyc.com,所以<application>上显式声明了android:usesCleartextTraffic="true"(Android 9+ 默认禁止明文 HTTP)。日后切 HTTPS 可移除。 - appKey 校验:
appKey与appId+ 包名 + 证书 SHA-256 严格绑定,不匹配时 APK 能装能开但启动白屏提示「未配置appkey或配置错误」。详见config/README.md。 - Runtime 版本提示:
prepare.cjs会把 www 内manifest.json/app-config-service.js的compilerVersion对齐到config/android.json的runtimeVersion,用于消除启动时「本应用使用 HBuilderX %s 编译,而手机端 SDK 版本是 %s」的提示。
首次使用清单
- 在
config/android.json填appKey、keyAlias、storePassword、keyPassword(该文件不提交 git); - 把对应证书放入
android-offline/keystore/; npm run build:apk。
发布上传(scp +
latest.json)在pack.ps1内,但只有存在config/deploy.json时才会执行;本仓库不提供该文件,因此默认不会上传。