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

74 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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) | 用下面命令查,**与左栏不一致就必须重新申请** | 重新申请后填入本文件 |
```powershell
& "$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`(= 生产编译 + 产物地址校验 + 离线打包)。