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
Connectez-vous à Power Apps.
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é.
Sélectionnez l’application que vous souhaitez encapsuler, puis dans la barre de commandes, sélectionnez Encapsuler.
Étape 1 : sélectionner les applications
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.
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.
Nonte
Dans cette étape, parfois pour les nouveaux clients, seul le champ Nom de l’application est visible. Le champ permettant d’ajouter le Hachage de signature Android ne s’affiche pas. Pour résoudre ce problème, passez aux étapes suivantes et sélectionnez Android comme Plateforme(s) cible(s) dans l’étape Plateformes cibles.
Étape 3 : Configurer la personnalisation de marque
À 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.
Sélectionnez Suivant.
Étape 4 : plateforme cible
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.
Sous Plateformes cibles, sélectionnez toutes les plateformes mobiles que vos utilisateurs finaux utilisent sur leurs appareils mobiles.
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
Note
L’Assistant d’encapsulation fournit un processus de connexion automatique. Cependant, les développeurs familiarisés avec les processus mobiles peuvent se connecter manuellement à leurs applications Android ou iOS en utilisant des mécanismes différents pour chaque plateforme. Si vous vous connectez via le processus manuel, vous n’avez pas besoin de créer un coffre de clés Azure.
- Sélectionnez Suivant.
Étape 5 : Stockage blob Azure
- 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
- 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
- Ajoutez l’URI Key Vault Azure en cliquant sur la liste déroulante.
- 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.
- 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.
Note
Les clients à locataire unique et à locataires multiples peuvent utiliser la fonctionnalité Inclure dans un wrapper pour créer des applications mobiles natives en fonction de leurs applications canevas Power Apps.
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).
Important
- Inclure dans un wrapper ne prend actuellement en charge que les comptes de type Mutualisé. Le type de compte Client unique n’est pas encore pris en charge. En savoir plus sur les types de compte : Types de compte de la plateforme d’identités Microsoft.
- Vous devez créer une URI de reidrection distincte pour chaque plateforme (iOS, Android) que vous souhaitez cibler.
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)
Note
Si vous ne trouvez pas les autorisations sous API utilisées par mon organisation, exécutez les commandes PowerShell suivantes, le cas échéant, puis réessayez :
- Assurez-vous que le module Microsoft Graph est disponible ou installez-le en utilisant la commande suivante :
Install-Module -Name Microsoft.Graph
- Autorisation Connexions à l’API Azure manquante :
Connect-MgGraph -TenantId <your tenant ID> New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
- Autorisation Service PowerApps manquante :
Connect-MgGraph -TenantId <your tenant ID> New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
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
Astuce
Pour plus d’informations sur App Center, accédez à Documentation Visual Studio App Center.
Accédez à App Center.
Connectez-vous avec votre compte professionnel ou scolaire.
Si vous n’avez pas d’organisation existante, sélectionnez Ajouter nouveau>Ajouter une nouvelle organisation pour créer une nouvelle organisation.
Sélectionnez l’organisation depuis la liste dans le volet gauche.
Sélectionnez Applications>Ajouter une application.
Entrez un nom d’application.
Sélectionnez le type de version de l’application.
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.
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.
Sélectionnez Ajouter une nouvelle application.
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