Étiquetage blanc dans l’application mobile Adobe Learning Manager

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 :

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.
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

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>`

<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

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.<div>Veuillez noter qu’Apple n’autorise pas le canal Alpha dans les icônes d’application. Assurez-vous donc de supprimer le canal Alpha de la ressource avant de la soumettre.</div></p>`

<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.<div>Veuillez noter qu’Apple n’autorise pas le canal Alpha dans les icônes d’application. Assurez-vous donc de supprimer le canal Alpha de la ressource avant de la soumettre.</div></p>

code language-none
`<p>Écran de démarrage de l’application</p></td>`

code language-none

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>`

<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

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>`

<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

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>`

<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 :

Android
iOS

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 :

Générez ou téléchargez le certificat de notification Push et la clé privée (.p12). Pour plus d'informations, consultez le document du développeur Apple.
Installez le fichier p12 après son téléchargement. Utilisez le mot de passe pour installer dans votre accès au trousseau.
Accédez à Mes certificats et exportez le certificat. Veillez à sélectionner le type mime .cer.
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 :

Connectez-vous à la console Firebase.
Accédez aux paramètres du projet et sélectionnez Cloud Messaging.
Recherchez l'API Firebase Cloud Messaging et sélectionnez Gérer les comptes de service.
Dans la page Comptes de service, sélectionnez Comptes de service dans le panneau de gauche.

Recherchez l'entrée de votre projet et sélectionnez Gérer les détails sous Actions.

note note
NOTE
Le format d’entrée du projet sera <-accountname->@appspot.gserviceaccount.com.

Accédez à l'onglet Touches et sélectionnez Ajouter une touche.
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.
S'il existe déjà une clé, sélectionnez Télécharger la clé existante, collez la clé, puis 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 le fichier google-services.json.

iOS

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

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

Le dossier <root> contient le fichier Runner.xcarchive.zip. Exécutez les commandes ci-dessous pour générer le binaire signé :

Exécutez la commande suivante pour décompresser l'archive :

code language-none
`unzip Runner.xcarchive.zip`

Accédez au répertoire de l’application :

code language-none
`cd Runner.xcarchive/Products/Applications/Runner.app`

Copiez le fichier d’approvisionnement mobile :

code language-none
`cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision`

Revenez au dossier <root> (où se trouve Runner.xcarchive.zip) :

code language-none
`cd <root>`

Exportez l’archive à l’aide de xcodebuild :

code language-none
`xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath ipa_path/ -exportOptionsPlist <path>/<ExportOptions-file>.plist`

Recherchez le fichier .ipa dans le dossier ipa_path.
Chargez le fichier .ipa sur le site Web Diawi.
Une fois le téléchargement terminé, sélectionnez le bouton Envoyer.
Une fois l’opération terminée, vous recevrez un code QR et un lien.
Ouvrez le code QR ou le lien directement dans Safari.

Si le périphérique est inclus dans le profil d’approvisionnement, l’installation doit se poursuivre sur le périphérique.

NOTE

Vous aurez besoin de XCode 15.2 ou version ultérieure pour créer les fichiers binaires signés.

Android

Pour le fichier apk

sh""" <path>/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 """

Pour le fichier aab

NOTE

Vous aurez besoin des outils de construction du kit de développement logiciel Android pour créer les fichiers binaires signés.

Le Play Store nécessite des binaires Android au format aab pour la publication. Par conséquent, nous fournirons le fichier .aab non signé.

NOTE

Lors de la création d’un fichier KeyStore, vous devez générer un mot de passe KeyStore, un alias de clé de signature et un mot de passe d’alias de clé de signature.

Procédez comme suit pour signer le fichier .aab :

Exécutez la commande suivante :

<path>/jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore <keystore-file> app-release.aab <signingKeyAlias>

NOTE

jarsigner est inclus dans Java. Assurez-vous d’utiliser Java 21.

À l’invite, entrez les mots de passe suivants :

Mot de passe KeyStore
mot de passe pour l’alias de clé de signature

Vous pouvez utiliser l’application fournie. Cependant, si vous devez générer une apk à partir d’un fichier aab, veuillez suivre ces étapes :

NOTE

Vous devrez installer bundletool pour générer des API.

Exécutez la commande suivante pour créer le fichier apk :

java -jar <path>/bundletool-all.jar  build-apks --bundle=app-release.aab --output=my_app.apks --mode=universal

Pour décompresser le fichier, exécutez la commande suivante :

unzip my_app.apks -d output_dir

Vous obtiendrez le fichier apk à partir du dossier output_dir.

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