- 退件拆包: 参照散单 Web returnUnpackwork 移植(returnUnpack.*/stock.warehouse.search/order.detail 反查对照), 扫码指令条码(jsbarcode renderjs)、快扫串行队列+乐观累加、明细扫描行置顶、左右分栏原单对照汇总(未退回/一致/差异)、备注下拉选项本地持久化 - 摄像头: camera.ts(camera.list/setOsd、camera_server.*、getLiveStreamUrl 本地 MJPEG 代理), 设置弹窗+浮动预览窗(拖拽/全屏/最小化胶囊)、OSD 单号条码推送、fetch 探测 502 内网->公网回退 - exe 内置海康取流服务 electron/hikvision-live.js: 监听 127.0.0.1:17320(与 printServer 17311 隔离), ISAPI digest 登录+快照轮询 multipart MJPEG(~5fps, 零 npm 依赖); 端口候选回退 httpPort->port->80(NVR port 常为 RTSP 554); 通道号映射 0/1->主码流 101/2->子 102(100 无效通道 NVR 返回 503); writeHead 后 flushHeaders(否则首帧前响应头不 flush); 登录限时 3.5s; 登录失败 502 兜底图与 printServer 行为一致 - 全局 401 处理: 非 skipAuth 请求 code/status=401 清 token 回登录(3s 去抖), 工作台 token 请求由 packaging 页自处理 - 菜单路径别名: menuRouteMap 兼容后端短路径(/order)与完整路径(/pages/xxx/index); index 页 rawPath 未定义引用修复; 布局样式微调 - 已验证: 17320 起服务/config 200/真实 NVR(192.168.8.241 ch2, port=554)回退 80 出流 7 帧/端口占用 blocked; 通道1 Device Busy 为车间占流非代码问题
WMS 工作台(wms_worker_station)
真机调试热更新(dev:adb)
npm run dev:adb 一条命令完成真机调试闭环:
- 自动列出所有 ADB 设备(多台时交互选择,单台自动选中)
- 进程常驻,监听
src/与原生工程源码(simpleDemo/src/main/java、AndroidManifest.xml) - 保存文件后自动:
build:app→ 离线打包(gradle 增量) →adb install -r→ 启动应用(约 20 秒/轮) - 真机 console 实时打印到终端(含视图层 renderjs)
可选参数:
npm run dev:adb -- --no-launch:重装后不自动启动应用npm run dev:adb -- --adb=D:\path\to\adb.exe:自定义 adb 路径(默认自动探测 SDK)
console 转发原理(release 包 console 默认不进 logcat):
- 逻辑层:
src/main.js接管console.*与 uni-app 内部日志uni.__log__(编译后的 console.log 走它),转发到 logcat tagUniConsole - 视图层:
src/render-common/viewport-fix.js的installConsoleForward(),各页 renderjs 调用,tagUniViewConsole
注意:不要 watch simpleDemo/src/main/assets 与 res(构建注入产物),否则构建自触发死循环(已在脚本中排除)。
⚠️ 真机坑:登录页 reLaunch 到打包模式白屏(切后台回前台才恢复)
现象
- 真机(RK3288 工控机 / Android 7.1.2,系统 WebView = Chromium 52)上,从登录页
uni.reLaunch到打包模式页(/pages/packaging/index)后整个页面白屏; - 按 Home 退后台再切回前台,页面恢复正常显示;
- 服务层逻辑正常执行(页面 onLoad/onShow/mounted 都跑了,toast/语音也正常),只有渲染层白屏。
根因
- reLaunch 创建的新页面 WebView 初始视口为 0×0(
window.innerWidth/innerHeight都是 0,document.body尺寸 0×0); - 全局 CSS 的
html { font-size: min(3.515625vw, 5.2734375vh) }依赖视口,视口为 0 时 fontSize 计算为 0px; - 本项目全站用 rem 布局,fontSize=0 → 所有 rem 尺寸归零 → 白屏;
- 切后台回前台时 Activity resume 触发原生重排,视口恢复(961×640 CSS 像素,dpr=2 对应物理 1920×1280),页面随即正常。
诊断方法(重要,后续排查类似问题照此做)
- renderjs 的
console.log在 release 包里拿不到(不会输出到 logcat); - 必须用原生日志:
plus.android.importClass('android.util.Log').i('TAG', msg),然后adb logcat | grep TAG; - 轮询观察视口:
setInterval里打印window.innerWidth + 'x' + window.innerHeight与document.documentElement.style.fontSize / getComputedStyle(...).fontSize。
修复(已落地,公共逻辑抽离到 src/render-common/viewport-fix.js)
- 在页面 renderjs 的
mounted里import { installZeroViewportFix } from '../../render-common/viewport-fix.js'并调用一次,检测视口 0×0 时强制原生 Activity 重排自愈; - 新页面接入示例:
// 页面 .vue 内的 renderjs 模块
<script module="remInject" lang="renderjs">
import { installZeroViewportFix } from '../../render-common/viewport-fix.js'
export default {
mounted() {
// #ifdef APP-PLUS
installZeroViewportFix() // 视口自愈(0×0 → requestLayout+invalidate)
return // 注意:APP 端 renderjs 不覆盖 fontSize,rem 由 App.vue 全局 CSS 承担
// #endif
// H5 端 rem 逻辑...
},
}
</script>
后续开发注意
- 不要在页面 renderjs 的 APP 端覆盖
htmlfontSize(真机 rem 统一由App.vue全局纯 CSS 承担,renderjs 覆盖会导致字号/布局异常); - 不要在新页面 WebView 创建早期(onLoad)调用
plus.screen.lockOrientation/plus.webview.currentWebview().setStyle等 native 操作——实测无效且会触发AdaUniWebView的ViewOptions.updateViewDataNPE。横屏由manifest.json的全局screenOrientation配置承担,打包页的 lockLandscape 已因此移除; - 若新增页面在真机出现同样白屏,按上面的示例接入
installZeroViewportFix即可; - 排查白屏类问题先看视口尺寸(renderjs 里打 Log),而不是猜字体/样式——0×0 视口下 CSS 的 vw/vh 全部失效是这类白屏的典型特征。
Description
Languages
Vue
70.4%
JavaScript
19.9%
TypeScript
4.3%
PowerShell
3.1%
CSS
1%
Other
1.3%