Étiquetage blanc dans l’application mobile Adobe Learning Manager

L’application mobile Adobe Learning Manager prend désormais en charge l’étiquetage blanc, ce qui signifie que vous pouvez désormais publier l’application sous votre propre marque.

Comment commencer à vous préparer au lancement de votre application marquée d’un blanc

Pour déployer et gérer votre propre application avec étiquette blanche, procédez comme suit :

  1. Préparez les ressources (comme l’image de l’écran de démarrage) et le texte afin que les deux puissent être utilisés dans l’application et la description sur l’App Store/Play Store.

  2. Attribuer une ressource technique capable de :

    • Génération des fichiers de certificat de notification push.
    • Signature des binaires d’application fournis par l’équipe ALM.
    • Chargement et gestion du processus de publication. Le processus de publication nécessite une communication entre votre gestionnaire d’applications et les équipes de l’app/play store pour que votre application soit conforme à toutes les directives de publication. À partir d’ALM, vous recevrez un binaire d’application entièrement conforme.

Vue d’ensemble

L’étiquetage blanc est une pratique consistant à renommer une application ou un service avec votre propre marque et à le personnaliser comme si vous en étiez le créateur d’origine. Dans Adobe Learning Manager, vous pouvez appliquer un étiquetage blanc à l’application mobile, afin de pouvoir renommer l’application et la rendre disponible pour vos utilisateurs sous votre propre marque.

Éléments personnalisables

Les éléments suivants peuvent être personnalisés :

Champs

code language-none
<p>ID de compte</p>
code language-none
<p>ID de votre compte. Notez que les élèves qui appartiennent à un autre compte n’auront pas accès à l’application avec étiquette blanche.</p>
code language-none
<p>Id De Compte Supplémentaires</p>
code language-none
<p>Ajoutez plusieurs comptes (sous-domaines) si vous le souhaitez. Ajoutez les sous-domaines en les séparant par des virgules, sans espaces. Par exemple, acc01,acc02,acc03, etc.<br> <b>Remarque :</b> Vous devez ajouter l’ID de compte lors de la spécification des sous-domaines.</br> </p>
code language-none
<p>Nom de l’application</p></td>
code language-none
<p>Nom à utiliser pour l’application.</p>
code language-none
<p>Nom court de l’application</p>
code language-none
<p>Si le nom de l’application est long, donnez à l’application un nom court qui apparaît sur l’appareil.</p>
code language-none
<p>Nom de l’application interne</p></td>
code language-none
<p>Nom sous lequel le système d’exploitation identifie l’application. Le format généralement utilisé est : com.company-name.product-name.</p>
code language-none
<p>Nom de l’application interne - iOS</p>
code language-none
<p>Donnez un autre nom à l’application si vos utilisateurs se trouvent sur iOS. Nous vous recommandons d’utiliser le même nom pour iOS et Android.</p>
code language-none
<p>Icône d’application</p>
code language-none
<p>L’icône de l’application est png. Cette icône s’affiche sur votre application. Le format à nommer est account-id_appIcon.png. Les dimensions de l’icône de l’application sont de 512 × 512 pixels.</p>
code language-none
<p>Écran de démarrage de l’application</p></td>
code language-none
<p>Dans l’écran de démarrage de votre application, indiquez une image (png) qui s’affiche lorsque vos utilisateurs lancent l’application. Le format à nommer est account-id_splashIcon.png. Les dimensions des écrans de démarrage à base carrée sont de 1 052 × 1 052 pixels et celles des écrans de démarrage à base circulaire sont de 768 x 768 pixels.</p>
code language-none
<p>ID client et secret client</p>
code language-none
<p>L’administrateur d’intégration de votre compte fournit les détails lors de l’enregistrement de l’application. L’administrateur de l’intégration doit utiliser les éléments suivants :<ul><li>learner:read, learner:write as role</li><li>application interne name://redirect comme URL de redirection</li></ul></p>
code language-none
<p>Logo du compte</p>
code language-none
<p>URL qui héberge le logo de votre organisation. Fournissez un lien vers le contenu comme logo du compte. L’URL doit être codée en Web.</p>
code language-none
<p>ID App Store de l’application (iOS)</p>
code language-none
<p>ID requis pour la mise à jour de force. L’application doit savoir que l’élève doit être redirigé vers l’App Store pour mettre à jour l’application.</p>
code language-none
<p>Identifiant Google Play Store pour l’application (Android)</p>
code language-none
<p>ID requis pour la mise à jour de force.</p>
code language-none
<p>Nom d’hôte pour la liaison approfondie</p>
code language-none
<p>Pour héberger vos liens profonds, utilisez learningmanager. Si vous souhaitez utiliser une autre URL de nom d’hôte comme lien profond, indiquez l’URL de l’hôte. Par exemple, learningmanager.adobe.com.</p>
NOTE
Fournissez les données à vos CSAM afin qu’ils puissent les ajouter dans votre binaire d’application personnalisé.

Mettre à jour l'association de site pour gérer les liens profonds personnalisés

Si vous utilisez un domaine personnalisé ou learningmanager*.adobe.com en tant qu’hôte, vous n’avez rien à faire. Toutefois, si vous utilisez une solution personnalisée ou un nom d’hôte spécifique pour les URL, ajoutez les fichiers d’association de sites.

CAUTION
Si les fichiers ne sont pas présents, les liens profonds ne fonctionneront pas. Vérifiez que les fichiers sont présents.

Reportez-vous aux liens suivants pour plus d’informations :

Générer des notifications push

L’envoi de notifications push aux applications Android et iOS nécessite deux mécanismes différents.

  • Pour iOS, générez les certificats de notification push.
  • Pour Android, fournissez une clé de serveur générée à partir du projet Firebase.

Suivez les instructions ci-dessous pour configurer les projets dans Firebase :

Notifications push sur iOS

Dans le développement d’applications iOS, un certificat de notification push est un identifiant cryptographique émis par Apple qui permet à un serveur d’envoyer de manière sécurisée des notifications push à un appareil iOS via le service de notification push d’Apple (APN).

Le certificat garantit une communication sécurisée entre votre serveur (ou fournisseur) et les APN Apple lors de l’envoi de notifications push aux appareils iOS.

Android et iOS utilisent Firebase Cloud Messaging (FCM) comme service d’envoi de notifications push aux appareils.

Génération du certificat sur iOS

Procédez comme suit :

  1. Générez ou téléchargez le fichier Certificat de notification Push et une clé privée (.p12). Pour plus d’informations, voir la section Document de développeur Apple.

  2. Installez le fichier p12 après son téléchargement. Utiliser le mot de passe pour installer dans votre Accès au trousseau.

  3. Accéder à Mes certificats et exportez le certificat. Veillez à sélectionner le type mime .cer.

  4. Une fois le fichier p12 et le fichier cer disponibles, exécutez les commandes suivantes :

- openssl pkcs12 -in privatekey.p12 -out myapnappkey.pem -nodes –clcerts

- openssl x509 -in privatekey.cer -inform DER -out myapnsappcert.pem

- openssl s_client -connect gateway.sandbox.push.apple.com:2195 -cert myapnsappcert.pem -key myapnappkey.pem

Si vous pouvez vous connecter au serveur, le certificat que vous avez créé est valide. Dans le fichier myapnappkey.pem, copiez les valeurs du certificat et de la clé privée.

Notifications Push sur Android

Pour Android, l’utilisateur doit fournir le fichier services.json à partir du projet Firebase pour ajouter l’entrée au service SNS.

Créez un projet dans Firebase et partagez le fichier services.json avec l’équipe CSM. Ce fichier est nécessaire pour l’entrée basée sur les jetons dans le SNS. Notez que la clé de serveur n’est plus utilisée. Voir Créer un projet dans Firebase.

Pour télécharger le fichier services.json, procédez comme suit :

  1. Connectez-vous à la Firebase console.

  2. Accéder à Paramètres du projet et sélectionnez Cloud Messaging.

  3. Rechercher API de messagerie Firebase Cloud et sélectionnez Gérer les comptes de service.

  4. Dans le panneau Comptes de service , sélectionnez la page Comptes de service dans le panneau de gauche.

  5. Recherchez l’entrée de projet, puis sélectionnez Gérer les détails sous actions.

    note note
    NOTE
    Le format d’entrée du projet sera <-accountname->@appspot.gserviceaccount.com.
  6. Accéder à la section Touches et sélectionnez Ajouter une clé.

  7. S’il n’y a pas de clé, sélectionnez Créer une clé et sélectionnez JSON comme type de clé. Cette opération génère et télécharge le fichier JSON.

  8. S’il existe déjà une clé, sélectionnez Télécharger la clé existante, collez la clé, puis téléchargez-la. Cette opération génère et télécharge le fichier JSON.

Contactez l’équipe CSM et partagez le fichier JSON pour ajouter l’entrée aux services SNS sur AWS. Les utilisateurs devront obtenir l’entrée enregistrée dans le service SNS pour la notification push, qui les obligera à partager les certificats générés ci-dessus pour validation.

Créer un projet dans Firebase create-project-in-firebase

Android

Réutilisez le même projet que celui que vous avez créé dans les étapes ci-dessus pour les notifications push.

Ajouter le projet dans Firebase et récupérer google-services.json fichier.

iOS

Ajouter le projet pour Firebase et récupérer le fichier GoogleService-Info.plist fichier.

IMPORTANT
Envoyez les fichiers à l’équipe Adobe Learning Manager CSAM pour les inclure dans la version de votre fichier binaire d’application.

Génération des fichiers binaires signés

iOS

sh""" xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath "ipa_path/" -exportOptionsPlist {ExportFile}

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
Vous aurez besoin de XCode 15.2 ou version ultérieure pour créer les fichiers binaires signés.

Android

sh""" ~/Library/Android/sdk/build-tools/30.0.3/apksigner sign --ks $storeFile --ks-pass "pass:$store\_password" --ks-key-alias $key\_alias --key-pass "pass:$key\_password" --out app-release-signed.apk -v app-release.apk """
NOTE
Vous aurez besoin des outils de construction du kit de développement logiciel Android pour créer les fichiers binaires signés.

Prochaine étape

Après avoir généré les fichiers binaires, insérez-les dans Play Store ou App Store.

Comment appliquer les modifications

Envoie les ressources et les fichiers requis à l’équipe CSM. L’équipe CSM remplit ensuite le formulaire avec les modifications requises et joint les ressources requises. L'équipe examinera ensuite les modifications et en informera les équipes d'ingénieurs. L’équipe d’ingénieurs génère ensuite une build et la partage avec l’équipe CSM.

L’équipe CSM partage la version avec le client.

Éléments non personnalisables

  • Écran Mettre à jour le mot de passe
  • Écran Création d’un compte
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d