EMM経由でデプロイする
EMMとは？
Section titled “EMMとは？”Enterprise Mobility Manager（EMM）は、多数のAndroidタブレットを一元管理するITプラットフォームです — Intune（Microsoft）、Jamf Pro、Esper、Scalefusion、Samsung Knoxなどがよく使われます。JonotのアプリをManaged Google Play経由でEMMに登録すると、EMMは各デバイスにManaged Configurationsをプッシュできるようになります。これは、アプリが起動時、およびIT管理者が更新するたびに読み込むキー／バリュー形式の設定で、新しいAPKビルドを必要としません。
Managed Google Playへの登録
Section titled “Managed Google Playへの登録”設定をプッシュする前に、EMMのアプリカタログでJonotのアプリが利用可能になっている必要があります。
- GoogleのGoogle Playからアプリをインポートするガイドに従って、Jonot KioskとJonot DeskをManaged Google Playアカウントに追加します。
- EMMで、キオスク／デスク用タブレットに使用するデバイスプロファイルに両方のアプリを追加します。
- EMMは各アプリのManaged Configurationスキーマ（APK内の
app_restrictions.xmlで定義）を自動的に検出します。手動でのスキーマインポートは不要です。
URLの上書き（キオスクはkioskUrlOverride、デスクはdeskUrlOverride）を除き、両アプリは同じキーを共有します。特に記載がない限り、すべてのキーは任意で既定値は空です。
pairingCode（文字列） — 初回起動時にデバイスを自動的にペアリングします。アプリがこのコードをSPAに埋め込むため、スタッフが7文字のペアリングコードをデバイス上で入力する必要はありません。デバイスごとの設定であり、タブレットごとに異なる値を設定します。managerPin（文字列） — エスケープハッチのPINを一元的に設定します。設定すると、デバイス上での初回起動時のPIN設定ダイアログはスキップされます。空欄のままにすると、現地のスタッフが手動でPINを設定できます。新しい値をプッシュすることは、デバイスに触れずに忘れたPINを復旧する推奨の方法でもあります。allowEscapeHatch（真偽値、既定値true） —falseに設定すると、右上5回タップのジェスチャーを完全に無効化します。逃げ道を一切用意したくない、来場者の多い公共のキオスクに便利です。kioskUrlOverride/deskUrlOverride（文字列） — 上級者向け、ステージング／LAN環境のみ。 ビルトインのSPA URL（https://kiosk.jonot.ioまたはhttps://desk.jonot.io）を上書きします。本番環境では空欄のままにしてください。apiOriginOverride（文字列） — 上級者向け、ステージング／LAN環境のみ。 ビルトインのAPIオリジン（https://api.jonot.io）を上書きします。本番環境では空欄のままにしてください。
EMMで設定をデプロイする
Section titled “EMMで設定をデプロイする”正確なUIはEMMによって異なりますが、一般的な手順は次のとおりです。
- EMMコンソールで、Jonot KioskまたはJonot DeskのManaged App Configurationを開きます。
- EMMはスキーマをフォームとして表示します。設定したいキーに入力し、残りは既定値のまま空欄にしておきます。
- デバイスグループまたは個々のデバイスに設定を割り当てます。
- 設定をプッシュします。デバイスがオンラインであればアプリはすぐにそれを受け取り、オフラインの場合は次回のチェックイン時に受け取ります。
- アプリは設定を再読み込みして適用します。URLやオリジンの変更はWebViewを再読み込みします（実質的にアプリの再作成となります） — 進行中のお客様のフローはリセットされます。
デプロイごとの推奨設定
Section titled “デプロイごとの推奨設定”pairingCode: そのデバイス用にJonotのAdminダッシュボードで発行されたペアリングコード。managerPin: 会社のIT部門のPINポリシー（現地での設定に任せる場合は空欄のままにします）。allowEscapeHatch: ほとんどのデプロイではtrue。現地での管理アクセスが一切不要な場合にのみfalseにします。
URLの上書き
Section titled “URLの上書き”標準的な本番デプロイでは、URL上書き用のキーは不要です。設定が必要なのは次の場合のみです。
- ステージング環境に対してテストを行っている場合。
- ローカルLAN上にオンプレミスのオフラインホスト（
apps/host）をデプロイしている場合。
URLの上書きを設定する場合は、デバイスのALLOW_CLEARTEXTビルド設定がHTTP（LAN上のURL向け）を許可していることも確認してください。これにはカスタムビルドが必要です — Playストア版のビルドは常にcleartextの既定値がfalseになっています。
- 自動ペアリング（
pairingCode）: このコードは、ページの読み込みごとにwindow.__JONOT_MANAGED_PAIRING_CODEとしてSPAに埋め込まれます。SPAは起動時にこの値を読み取り、自動的にペアリングを完了します。すでにペアリング済みのデバイスに同じコードをプッシュしても何も起こりません。以前に自動ペアリングされたデバイスに別のコードをプッシュすると、再度ペアリングが実行されます。 - マネージャーPIN（
managerPin）: デバイス上のPIN設定で使われるのと同じキーの下で、デバイスの暗号化されたSharedPreferencesに保存されます。次にエスケープハッチをタップしたときに反映されます。設定されている場合、EMMからプッシュされたPINが優先され、アプリの起動時や設定変更のたびにデバイス上のPINを上書きします。 - エスケープハッチ（
allowEscapeHatch）: 設定変更時に即座に反映され、再起動は不要です。 - URL／オリジンの上書き: 設定変更時に反映されます。アプリは新しいURLに再読み込みされ、進行中のお客様のフローはリセットされます。