- 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
45 lines
3.6 KiB
Markdown
45 lines
3.6 KiB
Markdown
# 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` | ✅ |
|
||
|
||
## 一键打包
|
||
|
||
```powershell
|
||
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」的提示。
|
||
|
||
## 首次使用清单
|
||
|
||
1. 在 `config/android.json` 填 `appKey`、`keyAlias`、`storePassword`、`keyPassword`(该文件不提交 git);
|
||
2. 把对应证书放入 `android-offline/keystore/`;
|
||
3. `npm run build:apk`。
|
||
|
||
> 发布上传(scp + `latest.json`)在 `pack.ps1` 内,但只有存在 `config/deploy.json` 时才会执行;本仓库不提供该文件,因此默认不会上传。
|