WMS_PDA/config/README.md
zm2000 db90efa0cb chore: 版本升至 1.0.123,商品图片维护回滚逻辑优化,新增发布上传配置
商品图片编辑/维护(edit.vue、itemMaint.vue):
- 图片未变化时直接放行返回,不再每次返回都发 ReferenceFile 请求(修复需点两次返回)
- 返回键/返回按钮先拦截,回滚完成后再 navigateBack,避免页面提前销毁导致回滚中断、图片停留在删除后状态
- navigateBack 增加 success/fail 均未触发的静默失效重试兜底
- 保存成功后同步初始快照,避免保存后返回被误回滚到保存前图片
- itemMaint 图片查询支持多候选 id 兜底(查询页传入 id/stock_id 优先),修复按条码重查不到商品时图片不显示

商品查询页(query.vue):
- 跳转维护页时附带 id/stock_id 参数,供图片查询兜底
- 图片缩略图增加 :key 强制刷新

发布上传(config/deploy.json、deploy.example.json):
- 新增部署配置,打包结束后自动生成 latest.json 并用 scp 上传 APK + 版本清单
- config/README.md 补充 deploy.json 字段说明

测试包构建脚本(dev-adb.cjs):
- 不注入地址时(--prod-api / 未配置开发地址)显式删除继承的环境变量,避免终端残留 VUE_APP_API_BASE_OVERRIDE/URL 把开发地址带进包

文档(README.md):
- 更新测试包命令用法,说明 npm 10 下 -- 参数会被吞、需直接用 node 调用脚本

其他:
- package.json、manifest.json 版本号 1.0.122 → 1.0.123
- 新增 scripts/_argtest.cjs(打印 argv,调试用)
2026-10-06 19:30:29 +08:00

4.6 KiB
Raw Permalink Blame History

config 目录说明

本目录存放打包/发布相关配置。含密码等敏感信息的一律不提交 git,配套的 *.example.json 模板提交。

文件 说明 是否提交
android.json Android 离线打包本地配置(appKey、签名密码等) ❌
android.example.json 上述配置的模板,首次使用复制为 android.json ✅
deploy.json 发布上传配置(scp 目标、下载地址前缀等),存在时打包结束自动上传 APK + latest.json ❌
deploy.example.json 上述配置的模板,首次使用复制为 deploy.json ✅

android.json 字段

字段 说明
appId uni-app appid。本项目为 __UNI__0B3DAD3,不要与工作台/散单的 __UNI__900BDC1 混用
appKey DCloud 离线打包 Key,按 appId + packageName + 签名证书 SHA-256 三者绑定
appName 桌面显示的应用名(构建时写入 resValue app_name)
packageName Android 包名(applicationId 与 gradle namespace 都由它决定,发布后不可更改)
abis CPU 架构。此处与 src/manifest.json 的 abiFilters 保持一致(armeabi-v7a、arm64-v8a)
icon / splash 图标/启动图路径(相对项目根),prepare.cjs 会用它们覆盖 res/ 下的同名资源
wwwSource App 资源目录。留空则依次尝试 dist/build/app-plus(CLI 最新编译产物)、unpackage/resources/<appId>/www(HBuilderX 本地打包产物,仅作兜底)
runtimeVersion 离线 SDK 的 5+ Runtime 版本。prepare.cjs 会把 www 内 manifest.json/app-config-service.js 的 compilerVersion 对齐到该值,避免启动时弹「HBuilderX %s 编译 / 手机端 SDK %s」提示
signing.keystore 签名文件路径(相对项目根),放在 android-offline/keystore/(该目录 git 不跟踪)
signing.storePassword / keyAlias / keyPassword 签名密码与别名,自己填写,不要提交。DCloud 下发的 keystore(PKCS12)别名固定为 __uni__ + appid 小写,本项目即 __uni__0b3dad3;PKCS12 的 storePassword 与 keyPassword 必须相同

appKey 务必与三者一致

appKey 失效的典型表现:APK 能装能开,但启动即白屏并提示「未配置appkey或配置错误」。此时按顺序核对:

  1. appId 是否为 __UNI__0B3DAD3;
  2. packageName 是否与申请 Key 时填写的包名一致;
  3. 证书 SHA-256 是否与申请 Key 时使用的一致:
    keytool -list -v -keystore android-offline\keystore\<你的证书> -alias <别名>
    
    输出里的 SHA256: 即为指纹。

需要更换包名或证书时,要先去 https://dev.dcloud.net.cn → 应用详情 → Android → 离线打包 Key 管理 重新申请(需填包名与证书 SHA-256)。

当前已知指纹(用于快速判断是否需要重新申请 Key)

用途 证书 SHA-256 appKey
线上已发布 APK(DCloud 云打包签名) d9689a9ba66e55e3002508b6ea9bb3bc086a2ba541df9cb86cdde43d6c25d6ff f523d8541674ad75105fa604f5a51a54
本地离线打包(自有 keystore) 用下面命令查,与左栏不一致就必须重新申请 重新申请后填入本文件
& "$env:JAVA_HOME\bin\keytool.exe" -list -v -keystore "d:\WMS_PDA\android-offline\keystore\<证书文件>"
# 输出里的 SHA256: 即上表右栏要用的指纹

签名不同会导致无法覆盖安装已发布的云打包版本(需先卸载重装),这是切离线打包的必然代价。

deploy.json 字段(发布上传)

打包结束后,pack.ps1 会检查 config/deploy.json:存在则生成 latest.json(版本、文件名、下载地址、SHA-256、发布时间)并用 scp 上传 APK 与 latest.json;不存在则跳过上传(仅打本地包)。加 -NoUpload 或 -Dev 也会跳过上传。

字段 必填 说明
host ✅ scp 目标主机 IP/域名
user ✅ SSH 用户名
remoteDir ✅ 远程上传目录
downloadUrlPrefix ✅ 下载 URL 前缀,与 APK 文件名拼接成完整下载地址写入 latest.json
keyPath ⬜ SSH 私钥路径,填写后会校验文件存在
port ⬜ SSH 端口,默认 22
latestJsonName ⬜ 版本清单文件名,默认 latest.json

首次使用

  1. 确认 config/android.json 已存在(本仓库已预填非敏感项),填写 appKey、keyAlias、storePassword、keyPassword;
  2. 确认 android-offline/keystore/ 下有对应 keystore;
  3. 执行 npm run build:apk(= 生产编译 + 产物地址校验 + 离线打包)。