Odoo 客户端

产品定位

面向门店 / 办公桌面的 Odoo 多端客户端（Windows）：用本机 Edge WebView2 内嵌打开 Odoo，并提供打印、客显、称重等本地能力桥接，无需再单独开浏览器。

本版能力

• 内嵌 Odoo：基于 Microsoft Edge WebView2 渲染后台与 PoS 等页面；支持会话 Cookie 注入，登录态可在壳内延续。
• 本地服务桥：页面可通过客户端桥调用本机能力（如 printFile 打印、客显、电子秤读数等），便于收银与前台场景。
• PDF 打印后端：安装包内附带 SumatraPDF（便携）与 Ghostscript 运行文件，优先走安装目录组件完成打印相关流程。
• 账号与本地配置：支持多账号管理；账号库与运行日志写在用户数据目录，不随安装包下发，卸载默认不删用户数据。
• 系统托盘：关闭窗口可进入托盘（依本机环境），便于常驻使用。
• 设备 / 本地服务：可在客户端中配置与管理本地设备及服务（如串口电子秤等，视现场硬件而定）。
• 应用内信息：地址栏「更多」中可查看 WebView 引擎与内核版本；支持打开 WebView 开发者工具（桌面）。
• 升级检测：可对接公司发布通道检测新版本（依现场 Odoo / 发布服务配置）。

运行环境

安装与注意

1. 运行 Setup.exe，按向导完成安装（界面默认简体中文，可选 English / Español）。
2. 若提示缺少 WebView2，请按向导打开官方 Evergreen 安装页完成后再启动客户端。
3. 本包为 桌面专用；手持读码器扫码广播、Gecko WebView 等能力见同日 Android 发行说明，不包含在本 Windows 安装包中。
4. 首次使用请在客户端内配置 Odoo 服务器地址并登录。

已知说明

• 安装包体积会大于「纯浏览器书签」方案，因内含桌面壳、WebView2 插件以及 SumatraPDF / Ghostscript 等打印组件。
• 客显、部分外设依赖本机硬件与驱动；未配置时不影响普通网页访问 Odoo。

产品定位

面向门店 / 办公桌面的 Odoo 多端客户端（Linux）：用本机 WebKitGTK 内嵌打开 Odoo，并提供打印、客显、称重等本地能力桥接，无需再单独开浏览器。能力对齐同日 Windows 桌面包，内核与安装形态按 Linux 桌面环境适配。

本版能力

• 内嵌 Odoo：基于 WebKitGTK 4.1（本仓库 flet-webview-linux）渲染后台与 PoS 等页面；支持会话 Cookie 注入，登录态可在壳内延续。
• 本地服务桥：页面可通过客户端桥调用本机能力（如 printFile 打印、客显、电子秤读数等），便于收银与前台场景。HTTPS 站点下桥脚本走分块注入，避免 WebKit 拦截页面内明文 HTTP 请求。
• PDF / 小票打印：走系统 CUPS（cups-client 为依赖；建议安装 cups 服务）。设备发现可枚举本机打印队列，不附带 Windows 包中的 SumatraPDF / Ghostscript。
• 账号与本地配置：支持多账号管理；账号库与运行日志写在用户数据目录，不随 .deb 下发，卸载默认不删用户数据。
• 系统托盘：关闭窗口可进入托盘（依赖 AppIndicator / StatusNotifier）；缺 GIR 或无 StatusNotifierWatcher 时关窗退化为最小化。
• 设备 / 本地服务：可在客户端中配置与管理本地设备及服务（如串口电子秤等，视现场硬件而定）。
• 应用内信息：地址栏「更多」中可查看 WebView 引擎与内核版本；支持打开 WebView 开发者工具（桌面）。
• 升级检测：可对接公司发布通道检测新版本（依现场 Odoo / 发布服务配置）。

运行环境

安装与注意

1. 安装 .deb（家目录权限过严时请先拷到 /tmp 再用 apt / dpkg）：

   sudo dpkg -i Odoo-Client-*.deb
   sudo apt-get install -f
   # 或：
   cp Odoo-Client-*.deb /tmp/
   sudo apt install /tmp/Odoo-Client-*.deb
   
   

2. 首次使用请在客户端内配置 Odoo 服务器地址并登录。

3. Wayland 会话下客户端会走 XWayland（GDK_BACKEND=x11），以保证窗口尺寸与设备工具栏可用；COSMIC / GNOME 坞按 APPLICATION_ID（cn.com.eist.odoo-client）显示图标。

4. 本包为 桌面专用；手持读码广播、Gecko WebView 等见同日 Android 发行说明。办公打印与客显亦见同日 Windows 说明（Windows 侧打印后端为 SumatraPDF / Ghostscript）。

已知说明

• 安装包体积会大于「纯浏览器书签」方案，因内含桌面壳与 WebKitGTK 运行依赖；打印依赖系统 CUPS，不内嵌 Windows 那套便携 PDF 组件。
• 客显、部分外设依赖本机硬件与驱动；未配置时不影响普通网页访问 Odoo。
• 部分虚拟显卡环境启动脚本会关闭 WebKit DMA-BUF（避免白块）；实机保持硬件合成。
• 信息类弹窗与 WebView 叠层在个别时机可能被页面遮挡；若遇此情况可先切账号栏或刷新后再开「关于 / 信息」。

产品定位

面向门店手持 / 平板的 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 真推送本版未接。