WMS_PDA/config/README.md
zm2000 7c6aedfa6d feat(product): 商品维护页表单与图片管理重构,打包优先使用最新编译产物
打包优化:
- prepare.cjs 优先使用 CLI 最新编译产物 dist/build/app-plus,
  unpackage/resources 仅作兜底,避免旧代码打入 APK

商品图片管理重构(itemMaint/edit/detail/query/uploadImgCos):
- 统一图片 URL 与 fileId 提取逻辑,支持嵌套 file 对象及
  file_url/file_id 等字段,消除多处重复解析
- getImages 请求参数简化为 type + id,移除冗余的
  business_id/stock_id/business_type
- 商品编辑/维护页进入时拉取最新图片并记录初始快照与文件 ID,
  返回时通过 ReferenceFile 回滚图片引用,避免未保存即改动图片
- 保存成功后通过事件 + storage 通知商品查询页刷新缓存

商品维护页(itemMaint):
- 表单移除"有效期"快捷选择,保质期改用商品原始数据;
  新增"净重 NET_WEIGHT"字段
- 新增扫描与提示语音播报,页面隐藏/卸载时自动停止播报
- 调整输入框 placeholder 颜色、保存按钮宽度、表单卡片
  边框圆角阴影、字段标签宽度等样式
2026-10-05 18:26:29 +08:00

58 lines
3.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` | ✅ |
## 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: 即上表右栏要用的指纹
```
> 签名不同会导致**无法覆盖安装**已发布的云打包版本(需先卸载重装),这是切离线打包的必然代价。
## 首次使用
1. 确认 `config/android.json` 已存在(本仓库已预填非敏感项),填写 `appKey`、`keyAlias`、`storePassword`、`keyPassword`;
2. 确认 `android-offline/keystore/` 下有对应 keystore;
3. 执行 `npm run build:apk`(= 生产编译 + 产物地址校验 + 离线打包)。