Dernière version disponible de l’application : 7.4.4

Introduction

Cet article explique les étapes pour configurer une application mobile personnalisée dans la page Branded mobile app publisher de la plateforme. Les paramètres de cette page vous permettent de personnaliser l'apparence, les fonctionnalités et les capacités de vos applications mobiles Android et iOS personnalisées.

• Vous pouvez enregistrer les paramètres au fur et à mesure et revenir les compléter plus tard.
• Lorsque vous êtes prêt, sur cette même page, vous pouvez ensuite générer les builds de vos applications mobiles personnalisées.

Vous pouvez créer plus d'une application personnalisée. Pour ceux qui utilisent Extended Enterprise, Docebo recommande de créer une application personnalisée spécifique pour chaque sous-domaine.

Prérequis : ID de l'application, liens des stores et Firebase

Avant de commencer à configurer une application dans la page Branded mobile app publisher, vous devez avoir complété les étapes suivantes :

• Sélectionnez un ID pour votre application mobile personnalisée. Il est recommandé d'utiliser la notation de domaine inversé (par exemple, com.docebo.mobile). Cela correspondra au packageId pour Android, et au bundleID pour iOS. Votre ID doit être unique et ne pas être déjà présent dans ces stores. De préférence, il doit être le même pour les deux stores (bien que cela ne soit pas obligatoire)
  Le nom du package ne peut pas contenir les mots-clés de la liste des mots-clés Java (s’ouvre dans un nouvel onglet).
• Sélectionnez le nom public de votre application mobile. Ce sera le même pour les versions Android et iOS de l'application. Assurez-vous que le nom choisi n'existe pas déjà sur le Google Play Store ou l'Apple App Store.

• Pour chaque store, dans Google Play Console / App Store Connect, suivez la procédure de création de l'application (vous n'avez pas besoin de télécharger une version pour l'instant). Au cours de ce processus, il vous sera demandé de fournir l’ID choisi, et la création de l’application générera un lien Store tel que les suivants : https://play.google.com/store/apps/details?id=com.docebo.mobile
https://apps.apple.com/us/app/go-learn/id1362542319
   

  Passez cette étape si vous ne prévoyez pas de distribuer votre application personnalisée via ces stores.

En créant d'abord les applications de cette manière, vous pouvez être sûr que l’ID de l’application choisi est unique.

Conseil : Notez votre ID d’application et les liens Store, vous devrez les insérer dans les configurations ultérieures.

Veuillez noter : Si vous prévoyez de distribuer votre application personnalisée via la gestion des appareils mobiles (MDM) ou par une autre méthode en dehors du Google Play Store ou de l'Apple App Store, vous pouvez toujours créer le packageID dans Google Play Console et le bundleID dans Apple Store Connect. Dans ce cas, vous n'avez pas besoin de créer la fiche de l’application et vous n’avez pas besoin d’un lien Store.

De plus, si vous souhaitez que votre application mobile dispose de notifications push, de la connexion Google ou de Google Analytics, vous devez d’abord compléter les étapes décrites dans l'article Configurer Firebase pour une application mobile personnalisée.

Tokens

La création d'une nouvelle application mobile personnalisée nécessite un token, que vous pouvez acheter auprès de votre Account Manager. Les tokens que vous achetez restent associés à votre compte, et vous pouvez ensuite les utiliser pour créer vos applications personnalisées.

• Vous avez besoin d'un token pour chaque application personnalisée : un seul token couvre à la fois les versions iOS et Android de l’application.
• Le token est requis uniquement lors de la création d’une nouvelle application personnalisée. Vous n’avez pas besoin de token pour mettre à jour votre application.
• Lorsque vous appuyez sur le bouton + pour créer une nouvelle application mobile, la boîte de dialogue Nouvelle application mobile personnalisée vous informera du nombre de tokens dont vous disposez.

Si vous publiez plusieurs applications, par exemple pour vos sous-domaines d’entreprise étendue, vous aurez besoin d’un token par application.

Créer une nouvelle application personnalisée

1. Sélectionnez Menu Admin > Paramètres du thème > Éditeur d'application mobile personnalisée.
   Vous verrez la liste des applications mobiles préexistantes. Ici, vous pouvez cliquer sur une des applications existantes pour modifier ou continuer sa configuration (voir Modifier ou supprimer une application personnalisée), ou cliquer sur le bouton + pour commencer à en créer une nouvelle.
2. Appuyez sur le bouton +. Dans la boîte de dialogue, vérifiez que vous disposez du jeton nécessaire, puis cliquez sur Continuer.
   
3. Dans le panneau Nouvelle application mobile personnalisée qui s'ouvre, remplissez les champs suivants : 
   • Nom de l'application : Le nom public que vous avez choisi pour votre application. C'est le nom que vos apprenants verront, et qui sera le même pour les versions Android et iOS de l'application. Assurez-vous qu'il s'agit d'un nom unique qui n'existe pas déjà sur Google Play Store ou Apple App Store.
   • Email : Insérez une adresse email pour les notifications liées à la gestion des builds. Vous ne pouvez insérer qu'une seule adresse email dans ce champ. Docebo recommande d'insérer une adresse de liste de diffusion, afin que toutes les personnes responsables de la gestion de l'application puissent être notifiées et recevoir directement les mises à jour.
4. Lorsque vous êtes prêt, cliquez sur Créer et modifier.

Une page s'ouvrira où vous pourrez configurer tous les paramètres de votre application personnalisée nouvellement créée. Cette page se compose de trois onglets : Propriétés, iOS et Android.

Vous pouvez maintenant commencer la configuration de votre application (reportez-vous aux chapitres Onglet Propriétés et Onglets iOS et Android dans cet article) et sauvegarder votre progression à tout moment en cliquant sur Enregistrer les modifications. Ensuite, lorsque vous serez prêt à reprendre, vous pourrez sélectionner l'application depuis la page Éditeur d'application mobile pour continuer ou modifier sa configuration.

Générez les builds et téléchargez-les sur les boutiques d’applications

Lorsque vous avez configuré tous les paramètres de votre application mobile personnalisée dans l’onglet Propriétés et dans les onglets iOS et Android, cliquez sur Enregistrer les modifications pour sauvegarder la configuration de votre application. Vous êtes alors prêt à générer les builds.

Veuillez noter : Si vous avez configuré les Mises à jour directes, lorsque vous générez les builds, ils seront également automatiquement re-signés et téléchargés sur les boutiques d’applications correspondantes. Donc, si le processus réussit, vous n’avez pas besoin de faire d’autres démarches. Pour plus d’informations, consultez l’article Configurer les mises à jour directes pour l’application mobile personnalisée > chapitre Générer un build avec mises à jour directes

Si vous n’avez PAS les Mises à jour directes, après avoir généré les builds, vous devrez les télécharger, les re-signer manuellement, puis les télécharger sur les boutiques d’applications. 

Cliquez sur le bouton Générer les builds. Ensuite, dans la boîte de dialogue, cliquez sur Générer (ou Générer et télécharger, si vous avez les Mises à jour directes) pour confirmer.

Cela lancera la génération du ou des paquets d’application – selon que vous avez sélectionné Activer l’application mobile uniquement pour Android, uniquement pour iOS, ou pour les deux. Le processus de génération du paquet peut prendre plusieurs heures (jusqu’à 24 heures).

Veuillez noter : La génération du build peut échouer si elle est lancée pendant le processus de mise à jour hebdomadaire ou mensuelle de Docebo. Si cela arrive, essayez de régénérer une fois le processus terminé.

Vous pouvez suivre la progression dans la section Statut du build des onglets iOS et Android :

• Lorsque vous cliquez sur le bouton Générer les builds, il change en Build demandé.
• Lorsque le processus est terminé, il change en Build disponible (ou Build généré et envoyé à la boutique, pour les mises à jour directes), avec la date de création et d’expiration du build. Cela signifie que le paquet est prêt à être téléchargé. Vous recevrez également une notification par email.

Re-signer manuellement et téléchargez votre paquet sur la boutique d’applications

Répétez les étapes suivantes pour chaque version de votre application (iOS et Android) qui n’est pas soumise automatiquement. 

• Une fois le build disponible, cliquez sur Télécharger le build pour télécharger le paquet. 

Vous devez maintenant le re-signer pour remplacer la signature numérique temporairement appliquée par Docebo lors du processus de création de l’application par la vôtre, puis téléchargez le paquet re-signé sur les boutiques d’applications. Suivez les instructions dans Re-signer et publier l’application mobile personnalisée

Veuillez noter : Si vous ne téléchargez pas le paquet avant la date d’expiration, vous ne pourrez plus le télécharger et devrez générer un nouveau build.

Modifier ou supprimer une application personnalisée

La page Éditeur d’application mobile personnalisée liste toutes les applications personnalisées créées jusqu’à présent. Si vous souhaitez modifier ou supprimer une application, ou générer ou télécharger des builds, sélectionnez l’icône des points de suspension à la fin de la ligne de l’application, puis choisissez l’option correspondante dans le menu déroulant.

Chaque fois que vous modifiez l’application, vous devez demander un nouveau build. Une fois le processus de build terminé, vous recevrez une notification par email.

Modifier une application personnalisée

1. Cliquez sur l’icône des points de suspension sur la ligne de l’application et sélectionnez Modifier.

2. Effectuez les modifications nécessaires dans les Propriétés et les onglets iOS et Android, puis, lorsque vous êtes prêt, cliquez sur Enregistrer les modifications.

   Vous verrez un avertissement indiquant qu’une fois vos modifications enregistrées, les builds précédents seront supprimés et ne seront plus disponibles au téléchargement. Ceci afin d’éviter de télécharger un build avec des paramètres différents de ceux que vous venez de configurer.

3. Lorsque vous confirmez, le statut dans les colonnes build iOS/build Android passera à Jamais généré, indiquant que le build n’a pas encore été généré avec les paramètres actuels.

   Une fois que vous cliquez sur le bouton Générer le build pour générer un build avec les nouveaux paramètres, le statut passera à Build demandé puis, lorsque le processus sera terminé, à Disponible.

Supprimer une application personnalisée

1. Cliquez sur l’icône des points de suspension sur la ligne de l’application et sélectionnez Supprimer.
2. Dans la boîte de dialogue, cliquez à nouveau sur Supprimer pour confirmer.
   → L’application est retirée de la page Éditeur d’application mobile personnalisée. Notez que cette suppression ne retire pas l’application des boutiques où elle a été publiée. Vous devrez également la retirer séparément des boutiques d’applications.

Veuillez noter : Si vous supprimez une application et que vous en avez de nouveau besoin, vous devrez reconfigurer tous ses paramètres dans les onglets Propriétés, iOS et Android.

Mettre à jour l’application personnalisée

Même si vous ne modifiez pas les paramètres de votre application mobile personnalisée, vous devrez périodiquement générer et distribuer un nouveau build pour intégrer les dernières mises à jour, basées sur la nouvelle version du code source. Les builds dans l’éditeur d’application mobile personnalisée sont toujours générés en utilisant la version la plus récente du code source disponible.

Consultez la page des mises à jour produit pour savoir quand une nouvelle version de Go.Learn et de l’application mobile personnalisée a été publiée.
→ Lorsque vous voyez qu’une mise à jour de l’application est disponible, vous pouvez créer une nouvelle version de votre application mobile personnalisée et la télécharger dans votre boutique d’applications, pour livrer cette mise à jour à tous vos utilisateurs. Pour ce faire :

• Effectuez les étapes décrites dans le chapitre Générez les builds et téléchargez-les sur les boutiques d’applications

Veuillez noter :

• Vous n’êtes pas obligé de mettre à jour votre application personnalisée, cependant la mise à jour est fortement recommandée pour garantir que vous disposez de la version la plus fiable et la plus complète de l’application — avec toutes les fonctionnalités incluses dans la version de Go.Learn.
• Notez également que Docebo offre un support produit uniquement pour la dernière version de l’application mobile.

Dans le cas où vous seriez obligé de mettre à jour votre application personnalisée pour des raisons spécifiques, nous veillons à vous en informer à l’avance via la page Mises à jour produit et les articles de la base de connaissances dans Aide Docebo. En général, nous vous suggérons de mettre à jour votre application (en générant un nouveau build puis en distribuant l’application) au moins une fois par trimestre.

Onglet Propriétés

L’onglet Propriétés contient certains paramètres communs aux versions iOS et Android de l’application mobile :

• Détails de l’application
• Option de domaine
• Verrouillage de certificat
• Notifications push
• Partenaire de mesure mobile (MMP)
• Utilisation de l’application en Chine
• Lecture audio en arrière-plan

Détails de l’application

Dans la section Détails de l’application, vous trouverez les informations que vous avez définies lors de la création de l’application mobile personnalisée : Nom de l’application et Email. Vous pouvez les modifier ici si nécessaire.

Option de domaine

Dans le champ URL du domaine, saisissez l’adresse que vous tapez dans la barre d’adresse de votre navigateur pour accéder à votre plateforme. Il peut s’agir de l’URL docebosaas de votre plateforme ou de son domaine personnalisé si un est configuré.
→ Assurez-vous que l’URL ne comporte pas de barre oblique finale (/), car cela pourrait provoquer des problèmes de connexion. Voici quelques exemples d’URL de plateforme :

https://maplateforme.docebosaas.com

ou

https://learning.mamarque.it

Pour les plateformes d’entreprise étendue, vous pouvez saisir l’URL du client souhaité, ou son domaine secondaire s’il est configuré.

Veuillez noter que, uniquement si votre plateforme a activé la version open-domain de l’application mobile, le champ Option de domaine sera absent de l’onglet Propriétés, car dans ce cas vous n’avez pas besoin de définir un domaine fixe à utiliser pour votre application.

Ajout d'un certificat

L'ajout d'un certificat est une technique développée pour protéger les applications web et mobile contre les autorités de certification malveillantes (rogue certificate authorities). Elle garantit qu'aucune donnée du réseau n'est compromise, même si un utilisateur installe un certificat racine malveillant sur son appareil mobile. 

En activant le certificat pour votre application mobile personnalisée, vous pouvez, en tant que Superadmin, protéger votre application des attaques de phishing et attaque de l'homme du milieu (man-in-the-middle attack). Cette technique vous assure un haut niveau de sécurité et de confidentialité. Avec l'activation d'un certificat, vous intégrez à votre application l'empreinte digitale (digest) que vous savez être utilisée par vos services backend. Cela renforce le niveau de sécurité de votre application mobile personnalisée, car cela vous permet de découvrir immédiatement si vous êtes victime d'une cyberattaque. 

Afin de renforcer la sécurité de votre application, lorsque vous validez votre certificat digital HTTPS, cochez l'option qui vous permet d'activer le certificat dans la section Ajout d'un certificat. Puis entrez le résumé de votre certificat HTTPS au format SHA-256 Pin dans le champ Résumé. 

Pour récupérer le résumé, demandez de l'aide au responsable sécurité de votre entreprise ou rendez vous sur https://www.ssllabs.com/ssltest/, un service en ligne gratuit qui réalise une analyse gratuite de la configuration de tout serveur web SSL. 

Suivez ces étapes sur le site SSL Labs. Veuillez noter que Docebo n'est pas responsable de l'exhaustivité des informations suivantes, en cas de modifications apportées par SSL Labs au processus décrit :

• Entrez l'URL de la plateforme Docebo dans le champ Hostname et cliquez sur Submit. Veillez à entrer la même URL ici et dans le champ URL domaine de la section Option du domaine (onglet Propriétés de la page Éditeur d’application mobile personnalisée)
• Attendez que l'analyse soit complète, puis cliquez sur l'adresse IP récupérée dans la colonne Server. Si plus d'un résultat s'affiche dans le tableau, veuillez sélectionner le premier.
• Une page affichant le rapport SSL s'ouvre. Vous y trouverez le digest de votre certificat dans la section Subject de la boite Certificate.  
• Copiez la séquence qui suit Pin SHA256, et collez-là dans le champ Résumé de la section Ajout d'un certificat, sur votre plateforme Docebo. Assurez-vous de ne pas copier-coller des espaces vides au début ou à la fin de la séquence. 
• N'oubliez pas d'enregistrer vos changements et de générer une nouvelle version pour votre application. L'application que vous venez de concevoir prend en charge l'ajout de certificat ! 

Veuillez noter que si vous devez apporter des changements à votre certificat et que vous publiez un nouveau certificat digital, vous devrez alors recommencer le processus pour le nouveau certificat (aller sur https://www.ssllabs.com/ssltest/, entrer l'URL dans le champ Hostname, etc. jusqu'à la génération d'une nouvelle version et sa distribution.)  

Notifications push

Les notifications push sont des messages courts, envoyés via votre application mobile personnalisée, même quand l’application n’est pas ouverte. Vos utilisateurs peuvent consulter ces messages dans la zone de notification ou sur l’écran verrouillé de leur appareil. Le Virtual Coach, dédié à la formation, sur votre plateforme, utilise ces notifications pour signaler aux apprenants du contenu susceptible de les intéresser ou des tâches en attente de réalisation. Plus d’informations sur le Virtual Coach et sur la manière de l’activer et d’activer ses notifications. Découvrez comment les utilisateurs peuvent interagir avec le Virtual Coach.  

Afin d’activer les notifications push, cochez la case correspondante dans la section Notifications Push de l'onglet Propriétés. Deux champs s’afficheront sous la case : ID de projet et Fichier de configuration du compte Firebase. 

Dans le premier champ, entrez l’ID de projet qui correspond au Project ID dans Google Firebase (s'ouvre dans un nouvel onglet). Dans le deuxième champ, téléversez le fichier de configuration json Firebase Admin SDK. Veuillez noter que ces deux champs sont obligatoires.  

Si vous souhaitez avoir des notifications push, votre application mobile personnalisée doit comporter au moins un projet dans Google Firebase (cela est également nécessaire pour les applications iOS). Veuillez noter qu’il est de votre responsabilité de générer un projet dans Firebase. Il est recommandé de contacter votre consultant IT pour procéder à l’enregistrement du compte de votre entreprise dans Google Firebase et pour créer votre projet. Une fois votre projet créé, cliquez que l’icône engrenage près de l’option Project Overview, dans la barre latérale et sélectionnez Project Settings. Dans la section Your Project et l’onglet General (premier onglet à gauche), vous trouverez le Project ID. Copiez ce texte depuis Firebase et collez-le dans le champ ID Projet de votre plateforme Docebo.  

Pour une explication, étape par étape, sur la manière de créer un projet Firebase, veuillez vous référer à la Knowledge Base de Google Firebase (s'ouvre dans un nouvel onglet) et à cet article de la Knowledge Base Docebo sur les notifications push. 

Pour télécharger le fichier json Admin SDK Configuration, depuis Firebase, ouvrez l’onglet Service Accounts dans votre compte Firebase et cliquez sur Generate New Private Key, en bas de l’onglet. Une fenêtre pop-up s’affiche. Vous devez confirmer votre action en cliquant sur Generate Key. Téléversez alors le fichier json depuis Firebase et chargez le champ Fichier de configuration du compte Firebase de votre plateforme Docebo. 

Une fois que vous avez rempli ces deux champs obligatoires dans votre plateforme, cliquez sur Enregistrer les modifications en bas de la page. 

Pour une explication détaillée sur la manière de récupérer toutes les données nécessaires à la complétion des champs requis, permettant de configurer les notifications push dans la plateforme, veuillez vous référer à l'article de la Knowledge Base Docebo sur les notifications push. 

Note : Lorsque vous activez les notifications push dans l’onglet Propriétés, la section Google Services dans les onglets iOS et Android (en fonction de l’onglet ou des onglets que vous avez activés en cochant Activer l’Application mobile) est automatiquement activée. Cela veut dire que vous n’avez pas besoin de cocher Activer Google Services pour activer cette section. Veuillez noter que vous devez renseigner tous les champs de la section Google Services.  

Si vous n’activez pas les notifications push, dans l’onglet Propriétés, la section Google Services des onglets iOS et Android n’est pas automatiquement activée. Pour l'activer, vous devez cocher la case Activer Google Services et afficher les champs figurant en dessous. Lorsque vous n’activez pas les notifications push, seul Google Sign-In est activé dans la section Google Services (les autres services tels que les notifications push ou Firebase Analytics ne sont pas activés). Vous trouverez plus d’informations sur Google Services dans la section Paramètres de cet article. 

Mobile Measurement Partner (MMP)

Si vous avez créé différentes campagnes promotionnelles pour votre application mobile personnalisée, sur différents réseaux publicitaires et médias sociaux, vous devrez mesurer et analyser le retour sur investissement (ROI) de chaque campagne. Les partenaires de mesure mobiles (Mobile Measurement Partner - MMP) sont particulièrement utiles pour mesurer les performances et le taux de conversion de différents réseaux publicitaires. Ils sont aussi utilisés pour comparer les performances de chaque réseau et comprendre quel média est le plus performant.

Un MMP collecte, organise et harmonise les données des applications mobiles, afin de fournir une évaluation uniforme des mesures de performance des campagnes.

Le MMP Adjust (s'ouvre dans un nouvel onglet) peut être intégré à l’Éditeur d’application mobile personnalisée. Afin d'activer le support d'Adjust, en tant que MMP, pour votre application mobile personnalisée, vérifiez le paramètre correspondant, dans la section Mobile Measurement Partner (MMP), puis collez le token d'application que vous avez généré, sur le tableau de bord Adjust, visible sous Token d'application, dans Adjust, comme vous pouvez le voir dans la capture d'écran ci-dessous.

Veuillez noter que lorsque vous publiez votre application de marque sur l'App Store d'Apple, des questions de confidentialité vous sont posées sur les types de données collectées dans votre application. Vous pouvez trouver ces détails dans la Base de connaissances Adjust (s'ouvre dans un nouvel onglet). Afin d'indiquer les bonnes réponses, dans le formulaire, reportez vous au PDF joint au chapitre Remarques importantes sur le processus de publication, dans l'article de la Knowledge Base expliquant comment publier une application mobile personnalisée.

Utilisation de l'app en Chine

Si vous souhaitez activer l'option d'optimisation, concernant l'utilisation des applications en Chine, cochez l'option correspondante. Cette fonctionnalité offre des performances optimisées à ceux qui utilisent l'application en Chine, y compris aux utilisateurs qui entrent et sortent du pays et y séjournent pendant de courtes périodes.

Background audio playback

Cette fonctionnalité vous permet de continuer à lire vos fichiers audio ou vidéo même lorsque l'application travaille en arrière-plan, ou lorsque vous verrouillez ou éteignez l'écran. Cette fonctionnalité vous sert aussi lorsque vous passez à une autre application ou que vous créer un podcast, par exemple, sur votre application mobile personnalisée. Les commandes de lecture sont intégrées dans la zone de notification de votre appareil.

Pour activer la fonctionnalité, cochez le paramètre Activer la lecture audio en arrière-plan, dans la section Lecture audio en arrière-plan.

Onglets IOS et Android

Le deuxième onglet, iOS vous permet de publier votre application mobile personnalisée dans l’App Store iOS. Le troisième onglet Android vous permet de publier votre application mobile personnalisée dans le Google Play Store. 

Statut de la version

Pour activer l'application mobile, vous devez activer l'option correspondante dans la section Statut de la version. Si vous générez la version pour iOS, activez cette option dans l'onglet iOS, et si vous générez la version pour Android, activez-la dans l'onglet Android. Si vous souhaitez publier votre application dans les deux stores, vous devez activer l'option Activer application mobile dans les deux onglets iOS et Android.

Reader app (iOS uniquement)

Cette section est uniquement disponible que pour ceux qui créent une application personnalisée pour les appareils iOS dans l'onglet iOS. Utilisez cette section si votre application permet aux utilisateurs d'accéder à des contenus payants qu'ils ont achetés en dehors de l'écosystème Apple et non dans l'application.

En activant le mode Reader app par le biais de l'option correspondante, votre application ne sera pas rejetée par l'App Store d'Apple et vos utilisateurs pourront accéder au contenu qu'ils ont acheté précédemment.

La seule différence entre les Reader apps et les apps où ce mode n'est pas activé est que l'enregistrement des utilisateurs n'est pas disponible par le Reader app, les utilisateurs doivent donc s'enregistrer à partir de la plateforme desktop.

Une fois que vous avez coché l'option Activer reader app, n'oubliez pas d'enregistrer vos modifications et de générer la version de votre application. Vous pouvez maintenant la télécharger sur l'App Store pour vous conformer aux directives d'Apple sur le commerce électronique (contenu payant) (s'ouvre dans un nouvel onglet).

Vue d'ensemble des paramètres et des images de l'application

Faites défiler la page. Vous pouvez commencer la configuration des détails techniques dans la section Paramètres et la sélection des images à afficher dans votre application mobile personnalisée dans la section Images app. Vous trouverez ces deux sections dans l’onglet iOS ainsi que dans l’onglet Android. Si vous souhaitez publier votre application dans ces deux stores, vous devez configurer les sections Paramètres et Images App dans les deux onglets iOS et Android.  

Veuillez vous référer aux paragraphes suivants de cet article pour savoir comment configurer les sections susmentionnées. 

À noter! Il vous faudra un token pour publier votre application dans l’Apple Store et l’Android Google Store. En utilisant un seul token, vous pourrez publier votre application mobile personnalisée dans les deux app stores. 

Veuillez noter que tous les autres paramètres et toutes les autres options de cette fonctionnalité, décrits dans la suite de cet article, sont plus techniques que ceux expliqués jusqu’à présent. Pour vous assurer que vous configurez correctement toutes les options, Docebo recommande de travailler avec un spécialiste app store de votre entreprise. 

Paramètres

Certaines des options visibles dans la section Paramètres existent aussi bien dans les onglets iOS que Android, tandis que les autres sont spécifiques à l'app store iOS ou à l'app store Android. 

Parcourons chacune des options disponibles dans la section Paramètres :

Link Store (pour Android et iOS) et identification de l'application (Android)

Insérez le Link Store dans le champ URL. Vous le trouverez dans la page de publication de l’application, dans l’app store. Si votre application est destinée à Android, vous devez également entrer le Nom du paquet (Package name) dans la section Identification de l’application. Il s'agit du nom du paquet Android, utilisé par Docebo, pour concevoir votre application. Veuillez vérifier que le nom du paquet n’est utilisé par aucune autre application dans le Play Store. Docebo conseille d’utiliser la notation DNS inverse (ex. appname.company.com = com.company.appname). Utilisez toujours des minuscules. Note : le nom du paquet ne doit pas contenir les mot de la liste des mot clés réservés Java (s'ouvre dans un nouvel onglet).

Format package (Android)

Si votre application est destinée à Android, référez vous à la section Format package, où vous pouvez choisir le type du paquet qui sera créé quand vous générez la version. 

Vous pouvez sélectionner l’option Android App Bundle (AAB), le nouveau format standard utilisé par Android qui crée des paquets plus petits, d'où des téléchargements plus légers pour les utilisateurs finaux. En créant un paquet AAB, vous gagnerez en flexibilité. Vous bénéficiez de plus d’espace sur votre appareil, de mises à jour plus rapides ainsi que de performances optimisées pour votre appareil mobile. Cependant, étant donné que l’utilisation du format AAB nécessite obligatoirement l’utilisation de “app signing by Google Play”, votre application sera peut-être moins compatible avec les systèmes MDM. 

Vous pouvez également sélectionner l’option APK (Android Package). Elle crée des paquets plus grands, mais elle assure une meilleure compatibilité entre les appareils et les systèmes Mobile Device Management (MDM). APK n’est plus pris en charge par le Play Store mais vous pouvez toujours publier votre application en utilisant votre système MDM. 

Note Importante : depuis août 2021, Google Play (s'ouvre dans un nouvel onglet) exige que les nouvelles applications et que les mises à jour aux applications existantes publiées sur l’Android Google Store utilisent le format de package Android App Bundle (AAB).

Vous devez donc vous assurer de sélectionner l’option AAB (Android App Bundle), dans la section Format Package. Si vous avez précédemment défini le format APK (Android Package), qui n’est plus pris en charge par le Play Store à partir d'août 2021, passez à l'option AAB (Android App Bundle). Une fois la configuration terminée, lancez le processus de génération du paquet en cliquant sur le bouton Générer version.

Veuillez noter que le format APK est toujours disponible mais il ne peut être utilisé que si vous publiez votre application en utilisant un système Mobile Device Management (MDM) (si le système MDM prend en charge ce format).

Google services (sur Android et iOS)

Passez maintenant à la section Google services. Cette section vous permet d'intégrer votre application mobile personnalisée aux différents services Google tels que Google Sign-In (connexion avec Gmail/Google Apps), notifications push et Firebase Analytics. Veuillez noter que si vous n’activez pas les notifications push (dans l’onglet Propriétés), seul le service Google Sign-In est activé parmi les différents services Google (les notifications push et Firebase Analytics ne sont pas activés). Vous pouvez activer Google services en sélectionnant les cases correspondantes. Lorsque vous activez Google services, deux ou trois champs s’affichent en dessous de cette option (deux pour une application iOS, trois pour une application Android). 

Les champs texte inclus dans cette section (Google iOS Client ID, Google Web Client ID et Fichier de configuration) peuvent être renseignés en copiant et collant les paramètres correspondant dans Google Api Console (s'ouvre dans un nouvel onglet). Le champ Google iOS Client ID est requis uniquement pour les applications iOS. Il n’est pas requis pour une application Android.

Vous devez également utiliser le Google Api Console pour obtenir le Fichier de Configuration, puis le téléverser dans ce champ. Pour téléverser le fichier, cliquez sur l’icône de téléversement ou sur le champ de texte et sélectionnez le fichier que vous avez précédemment récupéré, sur votre appareil, pour confirmer votre action. 

A noter : Google Sign-In a deux noms différents : Connexion avec Gmail (Login with Gmail) et Connexion avec les Google Apps (Login with Google Apps). La connexion via Gmail concerne les utilisateurs finaux tandis que la connexion avec les Google Apps concerne les entreprises et ne peut être activée que par un administrateur du système (veuillez noter que l’administrateur du système ne désigne pas l’administrateur de la plateforme). Si votre administrateur n’a pas activé la Connexion avec Google Apps, dans le compte mail de votre entreprise, vous ne pouvez pas utiliser cette option, même si vous avez un compte Gmail personnel. Sur la page de connexion de l’application, vous trouverez un bouton de connexion avec Google uniquement si, en tant que Superadmin, vous avez configuré et activé l’application qui permet la connexion par les comptes Google. 

A noter : Si vous utilisez Auth0 dans votre application mobile personnalisée, assurez-vous de définir les callbacks URL, comme expliqué dans la section Configurer Auth0 pour l’application Go.Learn, dans l'article Docebo pour Auth0. 

Universal link (pour iOS) et App links (pour Android)

Un Universal link est une URL unique que vous pouvez utiliser pour que, lorsque vos utilisateurs cliquent/pressent sur lien, ils ouvrent une fenêtre ou une page dans leur navigateur web, navigateur mobile ou application mobile en fonction de l'appareil utilisé. Pour le mobile, lorqu'un utilisateur presse un lien https pris en charge et pointant vers votre plateforme, l'application est automatiquement lancée et redirige vers la page correspondant. 

Le Universal link vous permet de créer des expériences intégrées entre les e-mails les applications, les systèmes de messagerie et les pages web de manière transparente et presque sans effort.

Ces liens sont appelés "app links" dans le système d'exploitation Android de Google, tandis que le nom utilisé par le système d'exploitation iOS d'Apple est "universal link". Dans cet article, vous trouverez le terme "universal link" pour désigner cette fonctionnalité, quel que soit le système d'exploitation pour lequel vous activez vos liens.

Reportez-vous aux tableaux du chapitre Supported Universal Links pour obtenir la liste complète des liens profonds pris en charge.

Cette fonctionnalité est uniquement disponible pour les applications personnalisées. Elle n'est pas disponible pour l'application Go.Learn. 

Le universal link est disponible pour les utilisateurs d'applications personnalisées utilisant le domaine *.docebosaas.com ainsi que pour ceux utilisant un domaine personnalisé, à condition que l'URL fasse référence au domaine de la manière suivante : domainname.docebosaas.com.

Afin que la fonctionnalité soit disponible pour les applications mobiles personnalisées, vous devez l'activer depuis la section dédiée des Paramètres de l'application personnalisée, comme décrit dans les chapitres suivants.

Activer le Universal link pour iOS

Afin d'activer le universal link dans votre application iOS, accédez à la section Universal Link dans l'onglet iOS et cochez la case Activer Universal link.  

Vous devez ensuite entrer l'ID de d'application dans la boite de texte. Vous trouverez l'ID de l'application en vous rendant sur Apple Developer's Console (s'ouvre dans un nouvel onglet) et dans la section Certificates, Identifiers & Profiles.

La valeur de l'ID de l'application est le team ID ou le préfixe de l'app ID suivi du bundle ID. Les deux parties sont séparées par un point. Format: "teamID.bundleID", exemple : "ABCD1234.com.apple.wwdc".

Par exemple, avec la configuration de l'app ID affichée dans l'image ci-dessous, vous devez entrer ceci dans le champ App ID :

9YR6YH8KLL.com.mycompany.myapp.client

Faites défiler la page, Certificates, Identifiers & Profiles, jusqu'à atteindre l'onglet Capabilities, où vous devez vous assurer que Associated Domains est activé.

Plus d'informations sur les domaines associés (s'ouvre dans un nouvel onglet).

Enfin, n'oubliez pas de générer une nouvelle version de l'application, de re-signer et de publier le fichier ipa signé sur l'Apple App Store. Veuillez noter que vous devez télécharger et exécuter la nouvelle version du resign.sh script (ZIP, 6KB). 

Activer les App links pour Android

Afin d'activer les app links dans votre application Android, accédez à la section App Links dans l'onglet Android et cochez la case Activez les App Links. 

Vous devez ensuite entrer l'empreinte du certificat SHA256 de votre certificat de connexion. Pour trouver l'empreinte, accédez au Google Play Console (s'ouvre dans un nouvel onglet) et accédez au menu Intégrité de l'Appli. Dans la section Fichier JSON Digital Asset Links de la page, copiez la valeur de sha256_cert_fingerprints.

Enfin, n'oubliez pas de générer une nouvelle version de l'application, de re-signer et publier le fichier .aab sur le Google Play Store. 

Images app 

Dans la section Images app, vous pouvez téléverser les images qui s’afficheront dans l’application mobile. Téléversez une image pour l’icône du Launcher, qui est l’icône que vous voyez dans le launcher de votre appareil. Android utilise généralement une icône carrée tandis que iOS utilise une icône aux bords arrondis.

Téléversez une image pour le Splash screen. Le Splash screen est l’image affichée quand l’utilisateur clique sur l’icône de l’image et que l’application se charge. Afin de choisir la bonne image, veuillez noter que l’image du splash screen est centrée dans un rectangle blanc.   

Veuillez noter que les dimensions de l’image pour l’icône launcher et le splash screen doivent être de 1024x1024px @72 DPI et que le format d’image requis est PNG 32 bit avec alpha-channel (transparence prise en charge). La taille maximale du fichier est de 4 Mo. 

En fonction de la configuration du domaine de votre application mobile personnalisée, vous pouvez également voir une section supplémentaire appelée Image de fond pré-connexion. Il s'agit de l'image utilisée pour l'arrière-plan de la page de pré-connexion, la page de l'application où l'utilisateur entre l'URL de la plateforme. 

Les dimensions de l'image de fond de pré-connexion doivent être de 720x1280px (en orientation portrait pour s'adapter aux mobiles) @72 DPI, et le format de fichier requis est PNG 24 bit avec alpha-channel (transparence prise en charge). La taille maximale du fichier est de 4 Mo.  

Générer la version et télécharger le paquet

Une fois prêt, cliquez sur Enregistrer les modifications pour enregistrer votre projet. Cliquez ensuite sur le bouton Générer version(s) pour continuer. Cliquez sur Générer dans la fenêtre pop-up. La génération de paquet commence. Elle peut durer quelques heures (jusqu’à 24 heures). 

La génération de la version peut échouer lorsqu’elle est lancée durant le processus de livraison hebdomadaire ou mensuel de Docebo. Si cela se produit, essayez de le générer à nouveau lorsque le processus de livraison est terminé. 

Le Statut version en haut des onglets iOS et/ou Android (dans les deux onglets si vous générez la version à la fois pour une application iOS et Android, uniquement dans l’onglet en question si vous générez une version) changera en Version demandée. Lorsque le processus est terminé, le statut affichera Version disponible. La date de création et la date d’expiration de la versuib sont affichées dans la barre de statut. Vous recevrez un e-mail lorsque le paquet sera prêt à être téléchargé. 

Vous pouvez télécharger votre paquet en cliquant sur Télécharger paquet dans la section Statut version.

Si vous ne téléchargez pas le paquet avant la date d’expiration, vous ne pourrez plus le télécharger. Vous devrez générer une nouvelle version. 

Modifier et supprimer votre application mobile personnalisée

Sur la page de l’Éditeur d’application mobile personnalisée, un tableau liste toutes les applications personnalisées que vous avez générées. Si vous souhaitez modifier ou supprimer une application ou générer ou télécharger des versions, sélectionnez le menu ellipsis, au bout de la ligne correspondant à l’application et choisissez une option depuis le menu déroulant. Chaque fois que vous modifiez l’application, vous devez demander une nouvelle version. Une fois le processus de génération de la version terminé, vous recevrez un e-mail. 

Lorsque vous modifiez l'un des paramètres de votre application personnalisée (dans les onglets Propriétés, iOS ou Android) et que vous cliquez sur Enregistrer les modifications, une fenêtre s'affiche pour vous informer qu'une fois que vous avez enregistré vos modifications, les versions précédentes ne sont plus disponibles au téléchargement. Ceci est fait pour éviter le téléchargement d'une version avec des paramètres différents de ceux qui sont actuellement remplis. Une fois que vous avez modifié et enregistré les paramètres de l'application, la version précédente est supprimée et n'est plus disponible, et dans le tableau répertoriant toutes les applications personnalisées sur la page de l’Éditeur d’application mobile personnalisée, vous verrez "Pas générée" comme statut dans la colonne Version iOS /Version Android, car la version n'a pas encore été générée avec les paramètres actuels. Une fois que vous aurez cliqué sur le bouton Générer version pour générer le buid avec les nouveaux paramètres, le statut passera à Disponible.

A noter :

Si vous supprimez une application et que vous en avez besoin plus tard, vous devrez configurer à nouveau tout le projet. Si vous supprimez une application qui a déjà été publiée, vous ne pouvez pas la recréer. De plus, l'application apparaît toujours dans l’App store. Par conséquent, pour supprimer l’application dans l’app store, vous devez la dépublier dans la console de l’app store.  

Mettre à jour votre application mobile personnalisée

Dans la plateforme, vous pouvez demander une version basée sur la nouvelle version de votre code source. Veuillez noter que les versions sont toujours générés en utilisant la version la plus récente disponible du codebase.  

Bonnes pratiques pour les mises à jour des applications personnalisées

Assurez-vous de suivre les mises à jour de la page Product Updates pour connaître les releases impactant votre application mobile personnalisée.

• Dans les 15 jours suivant la livraison mensuelle (surveillez la page Product Updates), Docebo propose l’application la plus fiable et avec les fonctionnalités les plus abouties possible - avec toutes les fonctionnalités incluses dans la livraison mensuelle de Go.Learn - à tous les détenteurs d’applications personnalisées, ayant un abonnement actif. Si vous le souhaitez, vous pouvez alors créer une nouvelle version de votre application et la téléverser dans votre app store pour livrer la mise à jour à vos utilisateurs. Vous n’êtes pas obligés de mettre à jour votre application mais cela est toujours fortement recommandé. Veuillez noter que vous avez accès au support uniquement si vous utilisez, sur votre appareil, la version la plus à jour de l’application mobile.  
• Dans le cas où la mise à jour de votre application mobile personnalisée est requise, pour des raisons spécifiques, nous vous prévenons à l'avance, via la page Product Updates et via les articles que vous pouvez consulter dans Docebo Help. De manière générale, nous vous suggérons de mettre à jour votre application (générant une nouvelle version et distribuant l'application) au moins une fois par trimestre.