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 叠层在个别时机可能被页面遮挡；若遇此情况可先切账号栏或刷新后再开「关于 / 信息」。