打包优化: - 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 颜色、保存按钮宽度、表单卡片 边框圆角阴影、字段标签宽度等样式
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或配置错误」。此时按顺序核对:
appId是否为__UNI__0B3DAD3;packageName是否与申请 Key 时填写的包名一致;- 证书 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: 即上表右栏要用的指纹
签名不同会导致无法覆盖安装已发布的云打包版本(需先卸载重装),这是切离线打包的必然代价。
首次使用
- 确认
config/android.json已存在(本仓库已预填非敏感项),填写appKey、keyAlias、storePassword、keyPassword; - 确认
android-offline/keystore/下有对应 keystore; - 执行
npm run build:apk(= 生产编译 + 产物地址校验 + 离线打包)。