商品图片编辑/维护(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,调试用)
74 lines
4.6 KiB
Markdown
74 lines
4.6 KiB
Markdown
# 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`(= 生产编译 + 产物地址校验 + 离线打包)。
|