From f9327397d6d1c286a74e94cbe8e76cba057825cd Mon Sep 17 00:00:00 2001 From: liufumingren Date: Fri, 2 Oct 2026 21:20:14 +0800 Subject: [PATCH] =?UTF-8?q?chore(apk):=20=E7=89=88=E6=9C=AC=E5=AF=B9?= =?UTF-8?q?=E9=BD=90=E5=88=B0=201.0.122=20=E5=B9=B6=E8=A1=A5=E5=85=85?= =?UTF-8?q?=E6=89=93=E5=8C=85=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - package.json 与 src/manifest.json 版本同步为 1.0.122 / versionCode 1000122 - prepare.cjs 增加版本一致性校验(两处不一致时告警) - 文档补充:版本号单一来源与云打包 versionCode 差异、图标/启动图来源、appKey 与证书指纹匹配 --- android-offline/README.md | 22 ++++++++++++++++++++++ android-offline/prepare.cjs | 24 ++++++++++++++++++++++++ config/README.md | 14 ++++++++++++++ package.json | 2 +- src/manifest.json | 4 ++-- 5 files changed, 63 insertions(+), 3 deletions(-) diff --git a/android-offline/README.md b/android-offline/README.md index 7c863d8..1f02001 100644 --- a/android-offline/README.md +++ b/android-offline/README.md @@ -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 | 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` 时才会执行;本仓库不提供该文件,因此默认不会上传。 diff --git a/android-offline/prepare.cjs b/android-offline/prepare.cjs index a8d0a27..9226b07 100644 --- a/android-offline/prepare.cjs +++ b/android-offline/prepare.cjs @@ -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') diff --git a/config/README.md b/config/README.md index a812eb1..5fc9ce5 100644 --- a/config/README.md +++ b/config/README.md @@ -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`; diff --git a/package.json b/package.json index 0e5174c..eee03c2 100644 --- a/package.json +++ b/package.json @@ -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": { diff --git a/src/manifest.json b/src/manifest.json index 1c2cf26..8313c63 100644 --- a/src/manifest.json +++ b/src/manifest.json @@ -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" : {