Aller au contenu principal

Terminaux Android et shell WebView

L'agent Android parle le même protocole que l'agent de bureau, utilise le même moteur de tickets et reçoit les travaux du cloud de la même façon. Voir Installer l'agent pour l'installer et l'activer.

Imprimantes​

ConnexionComment les imprimantes sont trouvées
Intégrée (Sunmi, PAX, iMin, Telpo)Détectée à partir du modèle de l'appareil
Réseau 9100printers.manual dans la configuration, scan de sous-réseau et mDNS en option
Bluetooth (SPP)Imprimantes associées dans les paramètres Bluetooth d'Android. Android 12 et versions ultérieures demandent l'autorisation « Appareils à proximité » (Réglages → Autoriser les imprimantes Bluetooth).
Hôte USBAppareils USB de classe imprimante. Android demande une fois par imprimante.

Applications web : le shell WebView​

Les navigateurs Android ne font pas confiance aux certificats installés par l'utilisateur : une page web dans Chrome ne peut donc pas joindre wss://localhost. Ouvrez plutôt votre application web dans le shell WebView de l'agent (l'entrée « Application web JodaPrint » du lanceur). La page reçoit window.JodaPrintBridge, et le SDK navigateur l'utilise automatiquement : votre code ne change pas.

Configurez le shell dans la configuration de l'appareil (Tableau de bord → Configuration) :

{
  "android": {
    "shell": {
      "url": "https://pos.example.com/register",
      "fullScreen": true,
      "disableBack": true,
      "autoStart": true
    }
  }
}
  • L'origine de la page doit figurer dans les origines autorisées, et les requêtes sont signées comme sur ordinateur (ou utilisez le mode non signé). Le pont n'est fourni qu'aux cadres des origines autorisées.
  • fullScreen masque les barres système ; avec disableBack, le bouton Retour reste dans l'application web.
  • autoStart ouvre le shell après le démarrage de l'appareil. Pour une borne dédiée, définissez aussi JodaPrint comme application kiosque dans votre MDM ; si le MDM autorise le mode verrouillage de tâches, le shell verrouille l'appareil sur l'application.
  • Le shell nécessite Android System WebView 83 ou version ultérieure.

Pour utiliser le WebSocket même dans le shell, passez bridge: false au SDK.

Applications natives sur le même appareil​

Les autres applications de l'appareil peuvent utiliser ws://127.0.0.1:8182/v1 en clair, avec le même protocole. C'est désactivé par défaut : activez-le dans les Réglages de l'application JodaPrint. Les origines autorisées et les signatures s'appliquent comme sur ordinateur.

Garder l'agent actif​

  • Acceptez l'exemption de l'optimisation de la batterie quand l'application la demande. Certaines marques (Xiaomi, Huawei, Oppo) demandent aussi d'autoriser le « démarrage automatique » de JodaPrint dans leurs propres paramètres.
  • L'agent démarre au lancement de l'appareil et après une mise à jour.

Appareils gérés​

Pour configurer de nombreux appareils avec un MDM Android Enterprise, voir Android avec un MDM.

Mises à jour​

  • Installé depuis une boutique : la boutique met JodaPrint à jour.
  • APK installé manuellement : quand une nouvelle version est disponible, une notification ouvre Réglages → Télécharger et installer. L'agent vérifie la signature de la version, puis Android demande à l'utilisateur de confirmer. La mise à jour n'est silencieuse que lorsque JodaPrint est propriétaire de l'appareil (bornes provisionnées par MDM).