通过 EMM 部署

什么是 EMM？

企业移动设备管理（EMM）是一个集中管理 Android 平板机群的 IT 平台 — Intune（Microsoft）、Jamf Pro、Esper、Scalefusion 和 Samsung Knox 是常见选择。您的 Jonot 应用通过 Managed Google Play 注册到您的 EMM 后，EMM 就可以向每台设备推送托管配置：应用在启动时以及 IT 管理员更新时读取的键值设置，无需新的 APK 构建。

注册 Managed Google Play

在推送配置之前，您的 Jonot 应用必须在您 EMM 的应用目录中可用：

1. 按照 Google 的从 Google Play 导入应用指南，将 Jonot Kiosk 和 Jonot Desk 添加到您的 Managed Google Play 账户。
2. 在您的 EMM 中，将两个应用都添加到您用于自助终端/服务台平板的设备配置文件。
3. EMM 会自动发现每个应用的托管配置模式（定义在 APK 内的 app_restrictions.xml 中）。无需手动导入模式。

配置键

两个应用共享相同的键，除了 URL 覆盖（自助终端使用 kioskUrlOverride；服务台使用 deskUrlOverride）。除非另有说明，所有键都是可选的，默认为空。

• pairingCode（字符串） — 首次启动时自动配对设备。应用将代码注入 SPA，员工无需在设备上输入 7 位配对码。按设备设置 — 每台平板设置不同的值。
• managerPin（字符串） — 集中设置逃生舱 PIN。设置后，跳过设备上的首次运行 PIN 设置对话框。留空则让现场员工手动设置 PIN。推送新值也是找回遗忘的 PIN的推荐方式，无需接触设备。
• allowEscapeHatch（布尔值，默认 true） — 设为 false 可完全禁用右上角五次点按手势。适用于希望没有任何逃生路径的高流量公共自助终端。
• kioskUrlOverride / deskUrlOverride（字符串） — 高级，仅限预发布/局域网。 覆盖内置的 SPA URL（https://kiosk.jonot.io 或 https://desk.jonot.io）。生产环境请留空。
• apiOriginOverride（字符串） — 高级，仅限预发布/局域网。 覆盖内置的 API 源（https://api.jonot.io）。生产环境请留空。

在您的 EMM 中部署设置

具体界面因 EMM 而异，但一般步骤是：

1. 在您的 EMM 控制台中，打开 Jonot Kiosk 或 Jonot Desk 的托管应用配置。
2. EMM 将模式渲染为表单。填入您想设置的键；其余留空即使用默认值。
3. 将配置分配给您的设备组或单台设备。
4. 推送配置。设备在线时应用立即收到，否则在下次签到时收到。
5. 应用重新读取配置并应用。URL 和源变更会重新加载 WebView（相当于重建应用） — 进行中的顾客流程会被重置。

推荐的按部署设置

• pairingCode： 您 Jonot 管理后台中该设备的配对码。
• managerPin： 您的企业 IT PIN 策略（或留空以便现场设置）。
• allowEscapeHatch： 大多数部署用 true；仅在永远不需要现场管理访问时用 false。

URL 覆盖

标准生产部署不需要 URL 覆盖键。仅在以下情况设置：

• 您正在针对预发布环境测试。
• 您在本地局域网上有自托管离线主机部署（apps/host）。

如果设置了 URL 覆盖，请同时确保设备的 ALLOW_CLEARTEXT 构建配置允许 HTTP（用于局域网 URL）。这需要自定义构建 — Play Store 构建始终默认将明文流量（cleartext）设为 false。

行为细节

• 自动配对（pairingCode）：每次页面加载后，代码作为 window.__JONOT_MANAGED_PAIRING_CODE 注入 SPA。SPA 启动时读取该值并自动完成配对。向已配对设备推送相同代码是无操作。向之前自动配对过的设备推送不同代码会再次触发配对。
• 管理员 PIN（managerPin）：存储在设备的加密 SharedPreferences 中，使用与设备 PIN 设置相同的键。在下一次逃生舱点按时生效。设置后，EMM 推送的 PIN 优先，并在每次应用启动或配置变更时覆盖设备上的 PIN。
• 逃生舱（allowEscapeHatch）：配置变更时立即应用 — 无需重启。
• URL/源覆盖：配置变更时应用。应用重新加载到新 URL — 进行中的顾客流程会被重置。