Odoo 客户端

产品定位

面向门店手持 / 平板的 Odoo 多端客户端（Android）：在壳内 WebView 打开 Odoo 后台与 PoS，并通过客户端 JavaScript 桥把本机能力交给页面调用（与官方 Mobile JavaScript / web_mobile 同一套路，详见仓库内桥接文档）。业务侧继续写 Odoo JS，不必为壳单独写原生。

本版要点

• 海康威视手持读码器 MV-IDP5204（Android 11）：已验证扫码可用。设备以 扫码广播 交出条码，壳入队后由 PoS 经桥（enableReader / getReaderData）取码，并按条码添加对应商品。HID 键盘口扫码仍可走网页 barcode；本版重点验证的是广播 + 桥。官方相机扫码 API（scanBarcode）本版未做，手持场景不依赖相机预览。
• 红米 K80（Android 16）：已验证可正常访问与操作 Odoo。
• 关于安装包体积：MV-IDP5204 系统内置 WebView 内核过旧，无法可靠渲染 Odoo。本版启动时探测 System WebView 主版本：≥ 110 用系统 WebView，低于 110（或探测失败）改用内嵌 GeckoView。海康等旧 ROM 走 Gecko，因此 APK 体积明显增大，属预期行为。地址栏「更多」可查看当前引擎信息。

本版能力

• 内嵌 Odoo：系统 WebView 或 GeckoView 渲染后台 / PoS；Gecko 路径支持注入桥脚本，便于读头桥在线。
• 客户端桥：与桌面共用同一套调度。本版 Android 侧与收银相关、已验证或可用的包括：壳内切号（switchAccount / updateAccount）、PoS 读头轮询、Toast / SnackBar 轻反馈；推送相关方法已登记，无真机 FCM token 时失败不影响登录。
• 账号与本地配置：支持多账号；账号库与日志在应用数据目录，不随 APK 下发。
• 升级检测：可对接公司发布通道检测新版本（依现场 Odoo / 发布服务配置）。
• 架构：发布包仅 arm64-v8a。

运行环境

安装与注意

1. 安装 Odoo-Client-*-arm64.apk（未知来源 / 企业分发按现场策略）。
2. 首次打开配置 Odoo 服务器地址并登录。
3. 手持读码：确认广播约定与海康适配一致；进 PoS 后确认桥为「在线」再测加购。
4. 本包为 Android 专用；Windows 安装、办公打印、客显等见同日 Windows 发行说明。

已知说明

• APK 因含 GeckoView 等组件，体积大于「仅系统 WebView」方案。
• 手机端 办公打印 / PoS 热敏小票 / 钱箱、系统通讯录、完整通知栏、相机扫码、Firebase 真推送 本版未接或仅有降级；桌面打印与客显请用 Windows 包。
• 较新机走系统 WebView 时，以现场 PoS「桥（在线/离线）」为准；旧机 Gecko 路径为本版扫码联调重点。

变更摘要

Android arm64：System WebView≥110 用系统内核，否则 GeckoView（兼容海康等旧 ROM）。MV-IDP5204 扫码广播经 JS 桥送入 PoS 加购已验证；红米 K80（Android 16）可正常访问 Odoo。APK 因 Gecko 较大属预期。手机端打印 / 相机扫码 / FCM 真推送本版未接。