Utiliser l’assistant d’encapsulation pour créer votre application mobile

Utilisez la fonction d’encapsulation pour empaqueter une ou plusieurs applications canevas en un seul package d’application mobile native à l’aide de l’assistant pas à pas.

La fonctionnalité d’encapsulation de Power Apps vous permet de créer des versions mobiles natives de vos applications canevas sous la forme d’applications mobiles Android et iOS personnalisées à votre marque. Vous pouvez distribuer ces applications mobiles natives encapsulées aux utilisateurs finaux via Microsoft App Center, Google Play ou Apple Business Manager ou d’autres méthodes de distribution natives.

La fonctionnalité d’encapsulation vous permet de créer des applications mobiles pour iOS, Android ou Google Play Store :

• iOS (package IPA)
• Android (package APK)
• Pour la distribution Google Play Store (package AAB)

La fonctionnalité d’encapsulation permet d’inclure vos applications canevas dans un shell d’application mobile natif que vous pouvez signer et distribuer numériquement. Lorsque vous mettez à jour votre application et que vous la republiez, l’application est automatiquement mise à jour.

Créer des applications mobiles natives pour iOS et Android à l’aide de l’assistant

1. Connectez-vous à Power Apps.

2. Sélectionnez Inclure dans un wrapper dans le volet de navigation de gauche. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.

3. Sélectionnez l’application que vous souhaitez encapsuler, puis dans la barre de commandes, sélectionnez Encapsuler.

Étape 1 : sélectionner les applications

1. Sur l’écran Sélectionner les applications à encapsuler , sélectionnez votre application principale et secondaire.

   • Application principale : sélectionnez l’application que vos utilisateurs finaux voient lorsque l’application mobile est lancée.

   • Application(s) secondaire(s) : les autres applications facultatives que vous pouvez inclure dans le package d’applications mobiles ainsi que l’application principale.

     

     Note

     • Vous pouvez utiliser la même application principale dans plusieurs projets d’encapsulation.
     • Dans l’assistant d’encapsulation, si le nom de l’Application principale apparaît incorrect, passez à l’étape suivante, puis revenez pour voir le nom correct.

2. Sélectionnez Suivant.

Étape 2 : inscrire l’application

Sur l’écran Inscrire votre application, inscrivez votre application manuellement dans Azure pour établir une relation de confiance entre votre application et la plateforme d’identité Microsoft. Pour plus d’informations : Enregistrement manuel de votre application sur le portail Azure.

Votre application doit être enregistrée dans Microsoft Entra afin que les utilisateurs de votre application puissent se connecter. Si vous l’avez déjà enregistrée, vous trouverez votre enregistrement dans le champ d’enregistrement propriétaire.

Si vous ne voyez pas le nom de votre application enregistrée dans la liste déroulante Enregistrements propriétaires, procédez comme suit.

• Sélectionnez Nouvel enregistrement d’application pour créer automatiquement un enregistrement pour votre application.

• Vous devrez fournir le Nom de l’application et le Hachage de signature Android, car ce sont des champs obligatoires. Le Nom de l’application est obligatoire car il s’agit du nom orienté client de l’application. Le Hachage de signature Android est nécessaire si vous avez sélectionné Android comme l’une de vos plateformes lors de la création et de la génération de votre projet d’encapsulation.

  Note

  Le format de la clé de hachage Android est un numéro de hachage alphanumérique à 28 chiffres, par exemple –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=. Si la clé de hachage de signature existe déjà, il n’est pas nécessaire d’en créer une nouvelle. Vous pouvez réutiliser la clé de hachage de signature précédemment générée lors de la création d’un enregistrement d’application.

  

Configurer les applications tierces autorisées par l’administrateur

L’assistant d’encapsulation configure automatiquement toutes les autorisations d’API requises pour votre application. Vous pouvez également configurer manuellement les autorisations de l’API si vous devez résoudre cette étape. Pour plus d’informations : Configurer manuellement les autorisations d’API pour votre application.

Lorsque vous enregistrez l’application, l’administrateur Azure doit fournir l’accès pour continuer. Suivez ces étapes pour accorder l’accès :

• Ouvrez Windows PowerShell et exécutez-le en tant qu’administrateur.
• Exécutez la commande- Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force.
• Définissez la stratégie d’exécution avec : Set-ExecutionPolicy -ExecutionPolicy RemoteSigned.
• Importez le module à l’aide de : Import-Module -Name Microsoft.PowerApps.Administration.PowerShell.
• Exécutez Add-AdminAllowedThirdPartyApps et fournissez l’ID d’application pour laquelle l’accès administrateur est nécessaire.
• Exécutez Get-AdminAllowedThirdPartyApps pour vérifier si le nom de votre application apparaît dans la liste.

Une fois que vous avez terminé les étapes précédentes, l’écran d’enregistrement ressemble à la capture d’écran suivante.

Autorisations API

Lorsque vous enregistrez l’application, l’administrateur Azure doit également accorder l’accès aux autorisations d’API pour l’application. Reportez-vous à la capture d’écran suivante pour obtenir des instructions sur l’octroi d’accès et les raisons pour lesquelles les autorisations d’API sont requises.

Étape 3 : Configurer la personnalisation de marque

1. À l’étape de configuration de la marque, définissez les options d’apparence suivantes pour votre application :

   Note

   Toutes les images doivent être au format .png. Une image par défaut est utilisée si aucune image personnalisée n’est sélectionnée.

   • Icônes d’application : chargez les icônes à utiliser pour votre application. Taille recommandée pour iOS : image .png de 1024 px par 1024 px ou plus grande. Taille d’image recommandée pour Android : image .png de 432 px par 432 px ou plus grande.
   • Image de l’écran de démarrage : image utilisée sur l’écran de démarrage de votre application mobile pendant son chargement. Image par défaut utilisée quand elle n’est pas fournie.
   • Image de l’écran d’accueil : image utilisée sur l’écran d’accueil (signature) de votre application mobile pendant son chargement. Image par défaut utilisée quand elle n’est pas fournie.
   • Couleur de remplissage de l’arrière-plan : code couleur hexadécimal utilisé pour l’arrière-plan de l’écran d’accueil.
   • Couleur de remplissage des boutons : code couleur hexadécimal utilisé pour remplir la couleur du bouton.
   • Thème du texte de la barre d’état : couleur du texte de la barre d’état en haut de l’application.

2. Sélectionnez Suivant.

Étape 4 : plateforme cible

1. Sur l’écran Choisir la plateforme mobile à cibler , saisissez un ID d’offre groupée de votre choix.

   Note

   L’ID d’offre groupée est un identifiant unique que vous créez pour votre application. Un ID d’offre groupée doit contenir un point (.) et aucun espace.

2. Sous Plateformes cibles, sélectionnez toutes les plateformes mobiles que vos utilisateurs finaux utilisent sur leurs appareils mobiles.

3. Définissez le bouton bascule Signer mon application sur ACTIVÉ pour signer automatiquement le code de votre application mobile, puis sélectionnez l’URI Azure Key Vault dans la liste et sélectionnez Suivant. Si vous n’avez aucune entrée dans la liste URI Azure Key Vault , vous devez tout d’abord créer Azure Key Vault. Pour plus d’informations : Créer un Azure Key Vault pour l’encapsulation pour Power Apps.

   

Vous pouvez également signer manuellement le package de votre application mobile au lieu d’utiliser la signature de code automatique disponible dans l’assistant d’encapsulation. Pour plus d’informations sur la signature manuelle du code de votre application, consultez :

• Signature manuelle de code pour iOS
• Signature manuelle de code pour Android
• Signature de code pour Google Play Store

4. Sélectionnez Suivant.

Étape 5 : Stockage blob Azure

1. Créez un coffre de clés Azure si vous ne l’avez pas déjà fait. Pour plus d’informations, voir Créer un Azure Key Vault pour l’encapsulation à l’aide de l’abonnement par défaut
2. Créez un compte de stockage d’objets blob Azure et un nom de conteneur. Pour plus d’informations, voir Créer un compte de stockage Azure
3. Ajoutez l’URI Key Vault Azure en cliquant sur la liste déroulante.
4. Ajoutez le nom du compte de stockage d’objets blob Azure et le nom du conteneur créés lors de l’étape de création du compte de stockage d’objets blob Azure.
5. Téléchargez l’APK/IPA généré à partir de l’emplacement de stockage d’objets blob Azure créé ci-dessus une fois les étapes de génération terminées.

Étape 6 : encapsuler

Sur l’écran Encapsuler, passez en revue les détails de l’application, puis sélectionnez Créer. Une fois la création réussie, votre application mobile s’affiche dans l’emplacement de stockage blob Azure que vous avez sélectionné à l’étape précédente.

Tester et distribuer le package d’application mobile

Testez et distribuez votre application. Si vous rencontrez des problèmes lors des tests, consultez la page de résolution des problèmes.

Inscrire votre application manuellement sur le portail Azure (facultatif)

Vous pouvez créer automatiquement l’enregistrement de votre application dans l’assistant d’encapsulation, comme indiqué à l’étape 4. Ou, vous pouvez créer manuellement un enregistrement pour votre application sur le portail Azure. Pour plus d’informations : Démarrage rapide : enregistrer une application avec la plate-forme d’identité Microsoft.

Que vous soyez un créateur à locataire unique ou à locataires multiples, vous devez sélectionner l’une des options contenant Tout répertoire Microsoft Entra - Mutualisé lorsque vous choisissez le type de compte pris en charge pour votre application afin de l’activer pour l’encapsulation. Choisissez l’une des types de compte suivants :

• Comptes de n’importe quel répertoire organisationnel (tout répertoire Microsoft Entra - Mutualisé)
• Comptes dans n’importe quel répertoire organisationnel (tout répertoire Microsoft Entra - mutualisé) et les comptes Microsoft personnels (par exemple, Skype ou Xbox).

Configurer manuellement les autorisations d’API pour votre application (facultatif)

Lorsque vous avez terminé l’étape 4, l’assistant d’encapsulation configure automatiquement toutes les autorisations d’API requises pour votre application.

Si vous obtenez des erreurs dans l’assistant d’encapsulation, vous pouvez configurer manuellement les autorisations de l’API. Pour plus d’informations : Ajouter et configurer

Les autorisations d’API suivantes sont requises lors de la configuration manuelle des autorisations d’API :

• API Microsoft
  • Dynamics CRM
• API utilisées par mon organisation
  • Connexions API Azure
  • Service PowerApps
  • Power BI (requis uniquement si vos applications canevas utilisent des données Power BI)
  • Gestion des applications mobiles Microsoft (requis uniquement si vous souhaitez utiliser Microsoft Intune pour la distribution d’applications mobiles)

Pour les étapes détaillées, reportez-vous à Demander les autorisations dans le portail d’enregistrement de l’application.

Créer manuellement un emplacement App Center pour votre application mobile (facultatif)

Vous pouvez créer manuellement un emplacement du centre d’applications pour votre application mobile directement dans le centre d’applications. Pour plus d’informations : Emplacement App Center

1. Accédez à App Center.

2. Connectez-vous avec votre compte professionnel ou scolaire.

3. Si vous n’avez pas d’organisation existante, sélectionnez Ajouter nouveau>Ajouter une nouvelle organisation pour créer une nouvelle organisation.

4. Sélectionnez l’organisation depuis la liste dans le volet gauche.

5. Sélectionnez Applications>Ajouter une application.

6. Entrez un nom d’application.

7. Sélectionnez le type de version de l’application.

8. Sélectionnez un SE Personnalisé pour les applications iOS, ou un SE Android pour les applications Android.

   Note

   Vous devez créer des conteneurs App Center distincts pour chaque plate-forme.

9. Pour le système d’exploitation Android, sélectionnez pour Plateforme, React Native.

   Note

   La Plateforme doit être définie sur React Native pour toutes les applications dans App Center.

   

10. Sélectionnez Ajouter une nouvelle application.

11. Copiez l’URL du centre d’applications de l’application. Vous en aurez besoin ultérieurement, pour configurer le projet d’encapsulation dans Power Apps.

    Par exemple, https://appcenter.ms/orgs/Contoso-sales/apps/Sample-canvas-app-for-Android-OS/

    

Signer manuellement votre package d’application mobile (facultatif)

Vous pouvez signer automatiquement votre package d’application mobile pendant le processus d’encapsulation à l’étape 2, mais vous pouvez également le faire manuellement une fois le package d’application mobile créé. Le processus de signature de code est différent pour les appareils Android et iOS.

• Signature manuelle de code pour iOS
• Signature manuelle de code pour Android
• Signature de code pour Google Play Store

Voir aussi

• Résoudre les problèmes liés à la fonctionnalité d’inclusion dans un wrapper dans Power Apps
• Vue d’ensemble de l’inclusion dans un wrapper
• Signature manuelle de code pour iOS
• Signature manuelle de code pour Android
• Signe de code pour Google Play Store
• Créer votre Azure Key Vault pour la signature de code automatisée
• Forums aux questions pour l’inclusion dans un wrapper
• Résoudre les problèmes liés à la fonctionnalité d’inclusion dans un wrapper dans Power Apps