chore(apk): 版本对齐到 1.0.122 并补充打包文档

- package.json 与 src/manifest.json 版本同步为 1.0.122 / versionCode 1000122
- prepare.cjs 增加版本一致性校验(两处不一致时告警)
- 文档补充:版本号单一来源与云打包 versionCode 差异、图标/启动图来源、appKey 与证书指纹匹配
This commit is contained in:
liufumingren 2026-10-02 21:20:14 +08:00
parent bf44b33abd
commit f9327397d6
5 changed files with 63 additions and 3 deletions

View File

@ -25,6 +25,26 @@ npm run android:pack:raw # 跳过前端编译,仅用现有 dist/build/ap
产物:`release/android/wms-pda_v{版本}_release.apk`。版本唯一来源是根 `package.json` 的 `version`(X.Y.Z),`versionCode` 自动推导为 `X*1000000 + Y*1000 + Z`。
> ⚠ **版本号要两处同步**:`package.json.version` 与 `src/manifest.json` 的 `versionName`/`versionCode`(后者供 HBuilderX 云打包使用)。`prepare.cjs` 会在打包前校验两者并告警,避免云包/离线包版本号不一致。
>
> 历名包在线上的 `versionCode` 是云打包时手工填的小数字(如 1.0.121 → 125),而离线方案会得到 `1000122` 这类值。**今后统一用 `package.json` 推导,不要再手工填小数字**,否则切回云打包时会变成「降级安装」被系统拦下。
## 图标与启动图
| 文件 | 来源 | 尺寸 |
|---|---|---|
| `icon/app-icon.png` | 从线上 APK(v1.0.121)`res/9T.png` 提取 | 512×512 |
| `splash/splash.png` | 从线上 APK `res/-u.png` 提取 | 1242×2208(竖屏) |
`prepare.cjs` 会把它们覆盖到 `simpleDemo/src/main/res/drawable/{icon,splash}.png`。有更高清的原始图标(如 1024×1024)时直接覆盖 `icon/app-icon.png` 即可。
从任意 APK 里重新取素材的办法:
```powershell
# 解包 APK 后用 aapt2 查出图标文件名,再按尺寸挑最大的一张
& "$env:ANDROID_HOME\build-tools\35.0.0\aapt2.exe" dump badging <apk路径> | Select-String 'application-icon'
```
环境要求:JDK 17+(脚本会自动探测 `JAVA_HOME`、Android Studio JBR 等常见位置)、Android SDK(`ANDROID_HOME`/`ANDROID_SDK_ROOT`/`local.properties` 任一即可)。
## 与云打包的差异(重要)
@ -41,4 +61,6 @@ npm run android:pack:raw # 跳过前端编译,仅用现有 dist/build/ap
2. 把对应证书放入 `android-offline/keystore/`;
3. `npm run build:apk`。
> ⚠️ **`appKey` 必须与签名证书指纹匹配**。线上已发布 APK(云打包,签名证书 SHA-256 `d9689a9b…25d6ff`)内的 appKey 为 `f523d8541674ad75105fa604f5a51a54`——它**只对该 SHA-256 对应的证书有效**。若本地离线打包用的是自有 keystore(`android-offline/keystore/` 里那把),需先比对指纹,不一致则到 dev.dcloud.net.cn 重新申请,否则 APK 启动会白屏提示「未配置appkey或配置错误」。比对办法见 `config/README.md`。
> 发布上传(scp + `latest.json`)在 `pack.ps1` 内,但只有存在 `config/deploy.json` 时才会执行;本仓库不提供该文件,因此默认不会上传。

View File

@ -40,6 +40,30 @@ for (const key of required) {
}
}
// ---------- 1.5 版本一致性校验 ----------
// 离线包的 versionName/versionCode 由 simpleDemo/build.gradle 从 package.json 推导
// (versionCode = X*1000000 + Y*1000 + Z);而 src/manifest.json 的 versionName/versionCode
// 是 HBuilderX 云打包使用的值。两者必须一致,否则同一版本会出现两个 APK 版本号,
// 应用内更新提示、版本排查都会对不上号。
// 注:编译产物 www 内不含版本字段(实测),APK 版本完全由原生工程决定,故此处只做一致性校验。
try {
const pkgVersion = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf-8')).version
const [x, y, z] = String(pkgVersion).split('.').map((n) => parseInt(n, 10))
const expectedCode = x * 1000000 + y * 1000 + z
const manifestText = fs.readFileSync(path.join(ROOT, 'src', 'manifest.json'), 'utf-8')
const mVersion = (manifestText.match(/"versionName"\s*:\s*"([^"]*)"/) || [])[1]
const mCode = Number((manifestText.match(/"versionCode"\s*:\s*(\d+)/) || [])[1])
log(`版本: package.json=${pkgVersion} (versionCode ${expectedCode}) | src/manifest.json=${mVersion} (versionCode ${mCode})`)
if (mVersion !== pkgVersion || mCode !== expectedCode) {
warn('package.json 与 src/manifest.json 版本号不一致,请两处同步(否则云打包/离线包会出现不同版本号)')
}
} catch (error) {
warn(`版本一致性校验已跳过: ${error.message}`)
}
// ---------- 2. 定位 SDK 工程 ----------
const AS_DIR = path.join(OFFLINE_DIR, 'HBuilder-Integrate-AS')
const DEMO_DIR = path.join(AS_DIR, 'simpleDemo')

View File

@ -36,6 +36,20 @@
需要更换包名或证书时,要先去 https://dev.dcloud.net.cn → 应用详情 → Android → 离线打包 Key 管理 重新申请(需填包名与证书 SHA-256)。
### 当前已知指纹(用于快速判断是否需要重新申请 Key)
| 用途 | 证书 SHA-256 | appKey |
|---|---|---|
| 线上已发布 APK(DCloud 云打包签名) | `d9689a9ba66e55e3002508b6ea9bb3bc086a2ba541df9cb86cdde43d6c25d6ff` | `f523d8541674ad75105fa604f5a51a54` |
| 本地离线打包(自有 keystore) | 用下面命令查,**与左栏不一致就必须重新申请** | 重新申请后填入本文件 |
```powershell
& "$env:JAVA_HOME\bin\keytool.exe" -list -v -keystore "d:\WMS_PDA\android-offline\keystore\<证书文件>"
# 输出里的 SHA256: 即上表右栏要用的指纹
```
> 签名不同会导致**无法覆盖安装**已发布的云打包版本(需先卸载重装),这是切离线打包的必然代价。
## 首次使用
1. 确认 `config/android.json` 已存在(本仓库已预填非敏感项),填写 `appKey`、`keyAlias`、`storePassword`、`keyPassword`;

View File

@ -1,6 +1,6 @@
{
"name": "wms-pda",
"version": "1.0.8",
"version": "1.0.122",
"private": true,
"description": "天豹云仓 WMS_PDA(uni-app Vue2 + @vue/cli 4.5)",
"scripts": {

View File

@ -2,8 +2,8 @@
"name" : "WMS_PDA",
"appid" : "__UNI__0B3DAD3",
"description" : "多平台快速开发的UI框架",
"versionName" : "1.0.8",
"versionCode" : 8,
"versionName" : "1.0.122",
"versionCode" : 1000122,
"transformPx" : false,
"app-plus" : {
"optimization" : {