Connecter le téléphone à une app
Ajouter une app à KeplinGo par QR ou à la main, le raccourci sur l'écran d'accueil, plusieurs apps sur le même téléphone, et ce que le téléphone ajoute aux écrans.
Juste après l'installation, KeplinGo ne sait pas à quelle installation se connecter ni quelles apps ouvrir. Chaque app s'ajoute une fois, avec l'adresse de l'installation et l'identifiant de l'app, et dispose ensuite de son raccourci sur l'écran d'accueil.
Il y a deux façons d'ajouter une app. Le QR est celle à utiliser quand on prépare des téléphones pour d'autres personnes ; la saisie à la main sert quand il n'y a pas de QR.
Ajouter une app par QR
Le code QR se génère sur la plateforme et contient l'adresse de l'installation et l'app choisie.
- Ouvrez Paramètres dans la barre latérale.
- Descendez jusqu'au panneau Application mobile et trouvez Connexion par QR.
- Ouvrez le sélecteur Choisissez l'app… et choisissez l'app, par exemple Gestion des Clients.

- Le code apparaît en dessous, avec le lien écrit à côté et le bouton Copier le lien.

- Sur le téléphone, avec KeplinGo installé, pointez l'appareil photo vers le code et ouvrez le lien qu'il affiche.
KeplinGo s'ouvre sur l'écran Se connecter à une app, déjà rempli. Le QR évite la saisie, mais n'ajoute pas l'app tout seul : la personne touche encore Valider l'adresse et lit le nom de l'app avant d'entrer.
Note
Le QR contient la première adresse publiée de l'app, et le téléphone ouvre la version publiée. Dans le champ Adresse, l'option Adresse de la plateforme (version de travail) sert à tester ce qui n'est pas encore publié.
Astuce
Le QR est la façon pratique de préparer toute une équipe : projetez-le en réunion, ou imprimez-le à côté des téléphones. Chaque personne pointe l'appareil photo et n'a plus qu'à entrer avec ses identifiants.
Ajouter une app à la main
- Ouvrez KeplinGo. Sans aucune app configurée, l'écran Se connecter à une app apparaît. Avec des apps configurées, la liste Vos apps apparaît : touchez Ajouter une app.
- Saisissez l'Adresse du serveur : l'adresse à laquelle la plateforme
répond, comme
https://votre-app.exemple.fr. Sanshttps://, KeplinGo l'ajoute. - Saisissez l'App : l'identifiant court de l'application, comme
gestao-clientes. C'est le même que celui de ses adresses. - Touchez Valider l'adresse.
KeplinGo demande au serveur si l'app existe, et répond de l'une de ces façons :
| Réponse | Que faire |
|---|---|
| Vous allez vous connecter à « Gestion des Clients », avec l'icône de l'app | C'est correct : touchez Ajouter et ouvrir. |
| « Ce serveur n'a pas cette app. » | L'adresse est correcte, l'identifiant de l'app ne l'est pas. |
| « Impossible de se connecter à cette adresse. » | L'adresse est fausse, ou le téléphone n'atteint pas le serveur. |
| « Cette adresse n'est pas une app de cette plateforme. » | L'adresse répond, mais ce n'est pas une installation Keplin. |
| « Saisissez une adresse https://. » | L'adresse ne convient pas : KeplinGo n'accepte que les connexions sécurisées. |
Note
La validation existe pour qu'on lise le nom de l'app avant de donner des identifiants à qui que ce soit. C'est pourquoi elle reste un geste explicite, même quand le QR a déjà tout rempli.
Entrer dans l'app
Ajouter et ouvrir enregistre l'app et l'ouvre sur son écran de connexion : le même écran de connexion que l'app affiche dans le navigateur, avec le design que vous lui avez donné. Les identifiants sont ceux de l'application, pas ceux de la plateforme : les comptes gérés dans les paramètres de l'app.

La session reste enregistrée sur le téléphone et se renouvelle pendant que l'on travaille ; seule une longue inactivité y met fin.
Si l'app a des fournisseurs d'authentification (voir Se connecter avec des fournisseurs d'authentification), le bouton de chacun ouvre la page du service dans un onglet Chrome. Quand la personne a fini de se connecter, KeplinGo revient au premier plan avec l'app déjà ouverte. Active Directory se connecte par les champs de l'écran de connexion, comme dans le navigateur.
Le raccourci sur l'écran d'accueil
La première fois qu'il ouvre une app, KeplinGo demande à Android de placer un raccourci vers elle sur l'écran d'accueil. Android affiche sa propre boîte de dialogue de confirmation, avec le nom et l'icône de l'app.
- Pour ajouter le raccourci, touchez Ajouter à l'écran d'accueil dans la boîte de dialogue.
Le raccourci ouvre l'app directement, sans passer par la liste. Il porte le nom de l'app et l'icône choisie dans Paramètres de l'app ▸ Général ▸ Icône sur le téléphone (voir Créer et gérer des apps) ; sans image, il porte l'icône de l'app dessinée sur la couleur principale du thème. Quand le nom ou l'icône changent sur la plateforme, le raccourci se met à jour tout seul à la prochaine ouverture de l'app.
Note
Android ne permet pas à une app de changer le nom sous lequel elle a été installée. Dans la liste des apps du téléphone, KeplinGo apparaît toujours sous le nom KeplinGo ; le nom et l'icône de chaque app se trouvent sur les raccourcis. Le launcher peut ajouter au raccourci un petit badge avec l'icône de KeplinGo.
Si vous refusez la boîte de dialogue, vous pouvez demander le raccourci plus tard : dans la liste Vos apps, touchez Plus d'options (les trois points) à côté de l'app et choisissez Ajouter à l'écran d'accueil.
Sur Android 7, le raccourci garde le nom et l'icône qu'il avait à sa création : Android ne permet de mettre à jour les raccourcis qu'à partir d'Android 8.
Plusieurs apps sur le même téléphone
KeplinGo garde autant d'apps que nécessaire, de la même installation ou d'installations différentes.
- Chaque app s'ouvre dans sa propre tâche Android. Dans les apps récentes, chacune a sa carte, avec son icône, et passer de l'une à l'autre ne fait rien perdre de ce qui était ouvert.
- Chaque app a sa propre session. Entrer dans l'une ou en sortir ne touche pas aux autres.
- L'icône de KeplinGo dans la liste des apps ouvre la liste Vos apps. Avec une seule app configurée, elle ouvre directement cette app.
- En appuyant longuement sur l'icône de KeplinGo, les apps configurées et Ajouter une app apparaissent.
Dans une app, le menu de l'utilisateur contient l'entrée Apps KeplinGo, qui ouvre la liste. C'est ainsi qu'on ajoute une autre app sans quitter celle qui est ouverte.
Ce que l'on voit sur le téléphone
KeplinGo affiche les écrans que vous avez dessinés pour le téléphone, avec la navigation du téléphone (menu latéral ou barre inférieure, selon votre configuration) et l'écran que vous avez marqué comme écran d'accueil.

C'est le même runtime que le navigateur : tout ce qui fonctionne dans le navigateur fonctionne ici, y compris les widgets custom, les modales, les rapports et le SDK complet. Il n'y a pas de deuxième version de l'application à maintenir.
Ce que le téléphone ajoute :
| Élément | Dans KeplinGo |
|---|---|
| Localisation | keplin.device.location() lit le GPS du téléphone. Android demande l'autorisation la première fois. keplin.device.platform vaut "android". |
| Appareil photo | Le widget Fichier avec l'appareil photo activé ouvre l'appareil photo du téléphone. Les widgets custom qui utilisent la caméra en direct (un lecteur de codes, par exemple) la reçoivent aussi, avec l'autorisation d'Android. |
| Fichiers | Les rapports, les exports et les pièces jointes s'ouvrent dans l'app du téléphone qui lit ce type de fichier, comme le lecteur PDF ; s'il n'y en a aucune, le partage s'ouvre. |
| Liens externes | Une adresse extérieure à l'app s'ouvre dans le navigateur du téléphone ; un numéro de téléphone ou un email s'ouvrent dans l'app correspondante. |
| Bouton Retour | Revient à l'écran précédent de l'app. Sur le premier écran, il mène à l'écran d'accueil et l'app reste dans les apps récentes. |
Quand le réseau tombe
Sans réseau, KeplinGo affiche l'avis Pas de connexion, avec le bouton Réessayer. Les écrans viennent du serveur, il n'y a donc pas de copie locale à afficher.
Retirer une app
- Ouvrez la liste Vos apps : touchez l'icône de KeplinGo, ou choisissez Apps KeplinGo dans le menu de l'utilisateur d'une app.
- Touchez Plus d'options (les trois points) à côté de l'app et choisissez Retirer.
- Confirmez avec Retirer.
L'app quitte KeplinGo et sa session se termine. Android ne permet pas à KeplinGo de supprimer le raccourci de l'écran d'accueil : le raccourci devient gris, avec l'avis que l'app a été retirée, jusqu'à ce que vous le retiriez à la main.
Pourquoi ça ne fonctionne pas…?
- …le QR ? Vérifiez que KeplinGo est installé sur le téléphone. Sans l'app installée, le lien du code n'ouvre rien.
- …la connexion, avec la bonne adresse ? Le téléphone doit atteindre
le serveur. Une adresse interne de l'entreprise ne répond pas en dehors de
son réseau. L'adresse doit commencer par
https://. - …mon mot de passe de la plateforme ? Les identifiants sont ceux de l'app, pas ceux de qui construit. Ceux qui construisent entrent dans la plateforme par le navigateur.
- …un écran qui existe dans le navigateur ? Les permissions sont les mêmes : un écran sans accès pour ce compte n'apparaît pas. Vérifiez son rôle dans les permissions de l'app.
- …le nom de l'app dans la liste des apps du téléphone ? Android affiche le nom sous lequel l'app a été installée, KeplinGo. Le nom de chaque app se trouve sur son raccourci.
- …le raccourci sur l'écran d'accueil ? La boîte de dialogue a été refusée, ou le launcher n'accepte pas les raccourcis. Demandez-le à nouveau dans la liste, sous Plus d'options ▸ Ajouter à l'écran d'accueil.