Partager via

Assistant Inclure dans un wrapper : guide étape par étape pour créer votre application mobile native

Utilisez ce guide pour convertir une ou plusieurs applications canevas en un seul package d’applications personnalisées que vous pouvez déployer sur Google Play et l’App Store pour iOS.

La fonction Inclure dans un wrapper dans Power Apps vous permet de créer des versions mobiles natives de vos applications canevas en tant qu’applications mobiles Android et iOS personnalisées (packages IPA, APK, AAB). Vous pouvez distribuer ces applications mobiles natives incluses dans un wrapper aux utilisateurs finaux via Google Play, Apple Business Manager ou d’autres méthodes de distribution natives.

Lorsque vous mettez à jour et republiez votre application, l’application incluse dans un wrapper est automatiquement mise à jour pour les utilisateurs.

Étapes pour créer une application native personnalisée à l’aide de l’assistant Inclure dans un wrapper

1. Se connecter et démarrer un projet d’inclusion dans un wrapper

  1. Connectez-vous à Power Apps Maker Portal.
  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 inclure dans un wrapper, puis sélectionnez Inclure dans un wrapper dans la barre de commandes.

2. Sélectionner des applications

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

    • Application principale : application principale que les utilisateurs finaux voient au lancement de l’application mobile.
    • Application(s) secondaire(s) : autres applications facultatives regroupées dans le même package d’applications mobiles.

    Capture d’écran montrant la première étape pour sélectionner l’application.

    Nonte

    • Vous pouvez utiliser la même application principale dans plusieurs projets d’inclusion dans un wrapper.
    • Si le nom de l’application principale semble incorrect, passez à l’étape suivante et revenez pour actualiser le nom.

  2. Sélectionnez Suivant.

3. Choisir la plateforme cible

  1. Sur l’écran Choisir la plateforme mobile à cibler, saisissez un ID de pack.

    Nonte

    L’ID de pack est un identificateur unique pour votre application. Il doit contenir un point (.) et aucun espace. Utilisez ce même ID de pack lors de la création de l’Azure Key Vault après avoir généré et chargé vos certificats iOS ou Android. Si vous avez déjà créé l’Azure Key Vault, vérifiez l’ID de pack dans la section Balises du portail Azure.

  2. Sous Plateforme(s) cible(s), sélectionnez toutes les plateformes mobiles que vos utilisateurs finaux utilisent sur leurs appareils mobiles.

  3. Vous devez avoir Azure Key Vault pour charger votre build dans le stockage blob Azure. Si vous ne l’avez pas encore créé, créez-en un. Pour plus d’informations, voir Créer un Azure Key Vault. Ajoutez les balises, les secrets et les certificats requis. Ajoutez la variable d’environnement si elle n’est pas déjà créée.

    a. Pour créer la variable d’environnement, accédez à Power Apps>Solutions>Solution par défaut. Ensuite, sélectionnez Nouveau>Plus>Variable d’environnement, ajoutez le nom d’affichage « PA_Wrap_KV_ResourceID ». Capture d’écran montrant l’écran pour ajouter une nouvelle variable d’environnement. Le nom de la nouvelle variable d’environnement doit comporter le préfixe « nouveau ». Si ce n’est pas le cas, consultez Définir le préfixe de la variable d’environnement pour obtenir des instructions détaillées. Capture d’écran montrant l’écran avec le préfixe comme étant nouveau b. Pour ajouter des informations du coffre à vos variables d’environnement, accédez au portail Azure en tant qu’administrateur. Naviguez jusqu’à Toutes les ressources>Votre coffre de clés>Propriétés, puis copiez l’ID de ressource. Capture d’écran montrant l’ID de ressource à copier.

    c. Pour ajouter l’entrée à la variable d’environnement, accédez à Power Apps>ApplicationName>Tout>Variable d’environnement. Cliquez sur les trois points, sélectionnez Modifier, ajoutez la valeur copiée à Valeur par défaut et enregistrez.

    d. Pour vérifier si la valeur de la table a été mise à jour, accédez à Power Apps>Tables>Définition de la variable d’environnement>new_PA_Wrap_KV_ResourceID. La valeur de Valeur par défaut doit être la même que celle de l’ID de ressource pour lequel vous souhaitez ajouter le coffre.

    Nonte

    Instructions pour ajouter l’entrée derrière les variables d’environnement pour les informations du coffre de clés :

    • Les variables d’environnement ne doivent pas être vides ou peuvent contenir plusieurs entrées.
    • Assurez-vous que l’ID de ressource ajouté est correct (vérifiez l’orthographe).
    • Assurez-vous que l’ID de ressource ajouté contient des balises non vides et inclut toutes les balises attendues avec l’ID de bundle utilisé dans l’assistant d’encapsulation.

    e. Suivez les étapes de la rubrique Étapes pour la signature de code automatisée pour créer les balises, les secrets et les certificats nécessaires pendant le processus de signature automatique.

  4. Vous devez disposer d’un compte et d’un conteneur de stockage d’objets blob Azure pour charger votre build dans le stockage d’objets blob Azure. Si vous ne l’avez pas encore créé, créez-en un.

    1. Dans votre coffre de clés dans le portail Azure, accédez à Secrets pour créer un secret pour la clé d’accès à votre stockage blob Azure. Pour plus d’informations, voir Ajouter un secret au coffre de clés. Capture d’écran montrant comment créer des secrets Azure

    2. Pour afficher et copier votre clé d’accès, consultez Afficher les clés d’accès au compteCapture d’écran montrant la clé d’accès

    3. Entrez la clé d’accès au stockage blob Azure dans le champ Valeur du secret. Capture d’écran montrant les secrets Azure

    4. Dans votre coffre de clés, accédez à Balises et créez une balise avec la même valeur de secret que ci-dessus. Capture d’écran montrant les balises Azure

  5. Activez la signature automatique de l’application (facultatif). Capture d’écran montrant la deuxième étape pour choisir la plateforme cible.

    Nonte

    Options de signature manuelle :

    Vous devez signer manuellement les fichiers AAB, quelle que soit l’option de signature sélectionnée dans l’Assistant.

  6. Sélectionnez Suivant.

Définir le préfixe de la variable d’environnement

Le nom de la nouvelle variable d’environnement doit comporter le préfixe « nouveau ». Si ce n’est pas le cas, procédez comme suit :

  1. Accédez à Solutions>Nouvelle solution.
  2. Sélectionnez un éditeur ou créez-en un.
  3. Sélectionnez l’icône de modification à côté de l’éditeur pour afficher ou modifier le préfixe.
  4. Si le préfixe n’est pas « nouveau », modifiez-le pour définir le préfixe sur « nouveau ».
  5. Enregistrez les modifications.

4. Enregistrer votre application

Sur l’écran Enregistrer votre application, enregistrez votre application dans Azure pour établir une relation de confiance avec la plateforme d’identités Microsoft.

  • Si vous avez déjà enregistré une application :

    • Recherchez votre enregistrement dans le champ d’enregistrement propriétaire.

  • Si votre application enregistrée ne s’affiche pas :

    1. Sélectionnez Nouvel enregistrement d’application pour créer un enregistrement.

    2. Fournissez :

      • Nom de l’application : nom de votre application destiné au client
      • Hachage de signature Android (si Android est ciblé) : chaîne alphanumérique de 28 caractères Capture d’écran montrant le nouvel écran d’enregistrement d’application

    3. Dans le centre d’administration Microsoft Entra, accédez à Enregistrements d’applications et sélectionnez votre application. Dans la section Essentiels, localisez l’option Types de comptes pris en charge, définissez-la sur Comptes dans n’importe quel répertoire organisationnel (Tout répertoire Microsoft Entra - Multi-locataire). Capture d’écran montrant l’écran d’enregistrement multilocataire

    4. Enregistrez vos modifications.

      Nonte

      Si la clé de hachage de signature existe déjà, vous pouvez la réutiliser.

Configurer les applications tierces autorisées par l’administrateur en tant qu’administrateur de client Azure

L’assistant d’encapsulation configure automatiquement les autorisations d’API requises. Pour accorder un accès administrateur :

  1. Ouvrez Windows PowerShell en tant qu’administrateur.
  2. Exécutez ces commandes : 
    Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
Import-Module -Name Microsoft.PowerApps.Administration.PowerShell
Add-AdminAllowedThirdPartyApps
Get-AdminAllowedThirdPartyApps
  3. Fournissez l’ID de l’application lorsque vous y êtes invité.

Une fois ces étapes terminées, l’écran d’inscription ressemblera à ceci :

Capture d’écran montrant l’écran d’inscription avec des coches vertes pour les étapes terminées

Accorder des autorisations d’API en tant qu’administrateur de client Azure

L’administrateur Azure accorde des autorisations d’API lors de l’enregistrement. Assurez-vous que DeviceManagementManagedApplication est défini sur Oui lorsque vous accordez le consentement administrateur pour votre application. Pour plus d’informations, voir Accorder le consentement administrateur à l’échelle du client dans le volet Applications d’entreprise. Capture d’écran montrant les autorisations d’API pour l’application.

Autorisations API requises

Type API API spécifique Motif
API Microsoft Dynamics CRM L’application a besoin de user_impersonation pour appeler Dataverse pour l’utilisateur.
API utilisées par mon organisation Connexions API Azure L’application a besoin de Runtime.All pour appeler n’importe quel connecteur de Power Platform.
API utilisées par mon organisation Service PowerApps L’application a besoin de l’autorisation User pour contacter les services back-end de Power Apps à partir de Power Platform.
API utilisées par mon organisation Power BI L’application a besoin des autorisations Power BI pour accéder au contenu Power BI ou l’intégrer.
API utilisées par mon organisation Gestion des applications mobiles Microsoft L’application a besoin de cette autorisation, car Power Apps utilise le Kit de développement logiciel (SDK) Intune en interne.

Pour les étapes détaillées, voir Demander les autorisations dans le portail d’enregistrement de l’application.

Exécutez ces commandes PowerShell en tant qu’administrateur Azure si vous ne voyez pas d’autorisations sous API utilisées par mon organisation :

  1. Assurez-vous que le module Microsoft Graph est disponible ou installez-le :

    Install-Module -Name Microsoft.Graph

  2. Accordez l’autorisation Connexions de l’API Azure pour l’AppId statique fe053c5f-3692-4f14-aef2-ee34fc081cae :

    Connect-MgGraph -TenantId <your tenant ID>
New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"

  3. Accordez l’autorisation Service PowerApps pour l’AppId statique 475226c6-020e-4fb2-8a90-7a972cbfc1d4 :

    Connect-MgGraph -TenantId <your tenant ID>
New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"

Nonte

Si seul le champ Nom de l’application est visible, passez aux étapes suivantes et sélectionnez Android comme plateforme cible pour afficher le champ de hachage de signature.

Configurer manuellement les autorisations d’API (facultatif)

Si vous obtenez des erreurs, configurez manuellement les autorisations d’API. Pour plus d’informations, consultez Ajouter et configurer.

Ajouter des URI de redirection en tant qu’administrateur d’application

  1. Dans le portail Azure, accédez à votre enregistrement d’application >Authentification.
  2. Sélectionnez Ajouter une plateforme et choisissez iOS ou Android.
  3. Pour iOS, entrez l’ID de pack. Pour Android, entrez l’ID de pack et la Clé de hachage de signature. Capture d’écran montrant les URI de redirection pour l’application.

5. Configurer la personnalisation

  1. À l’étape Configurer la personnalisation, définissez les options suivantes pour votre application :

Nonte

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

Paramètre Description Configuration requise
Icônes d’application Icônes de votre application iOS : 1024x1024 px ou plus
Android : 432x432 px ou plus
Image de l’écran de démarrage Image affichée pendant le chargement de l’application Format .png
Image de l’écran d’accueil Image affichée sur l’écran de connexion Format .png
Couleur de remplissage de l’arrière-plan Couleur de l’arrière-plan de l’écran d’accueil Code de couleur hexadécimal
Couleur de remplissage du bouton Couleur des boutons Code de couleur hexadécimal
Thème du texte de la barre d’état Couleur du texte de la barre d’état Clair ou Foncé
  1. Sélectionnez Suivant.

6. Gérer la sortie

  1. Entrez le nom de votre compte de stockage blob Azure et le nom de votre conteneur.
  2. Une fois la génération terminée, téléchargez votre fichier APK ou IPA à partir de l’emplacement de stockage d’objets blob Azure.

Capture d’écran montrant la cinquième étape de la gestion de la sortie à l’aide du stockage d’objets blob Azure.

7. Inclure dans un wrapper et créer

  1. Sur l’écran Inclure dans un wrapper, passez en revue les détails de votre application et sélectionnez Créer.
  2. Une fois la génération réussie, votre package d’application sera disponible dans le stockage d’objets blob Azure que vous avez spécifié.

Afficher votre build

Vous pouvez afficher votre build de plusieurs façons :

  • Après la création, sélectionnez Afficher les builds
  • Accédez à Projets d’inclusion dans un wrapper dans le volet latéral, pointez sur le projet requis et sélectionnez-le
  • Sélectionnez l’option Afficher les builds dans l’en-tête supérieur

Capture d’écran montrant comment afficher les builds.

Nonte

Pour signer manuellement le code d’une application iOS, décompressez le fichier IPA à l’aide d’un appareil Mac.

Tester et distribuer votre application

Testez votre application et distribuez-la si nécessaire. Si vous rencontrez des problèmes, consultez la page de résolution des problèmes.

Inscrire votre application manuellement sur le portail Azure (facultatif)

Vous pouvez créer l’enregistrement de votre application automatiquement dans l’assistant ou manuellement dans Azure. Pour plus d’informations : Démarrage rapide : enregistrer une application avec la plate-forme d’identité Microsoft.

Nonte

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.

Lors de l’enregistrement, sélectionnez un type de compte contenant Tout répertoire Microsoft Entra - Multi-locataire :

  • 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 - Multi-locataire) et les comptes Microsoft personnels, par exemple, Skype ou Xbox

Enregistrement de l’application - types de compte pris en charge pour la fonctionnalité Inclure dans un wrapper.

Important

  • Inclure dans un wrapper ne prend actuellement en charge que les comptes de type Mutualisé. Le compte de type Client unique n’est pas encore pris en charge. Pour plus d’informations, voir Types de comptes dans la plateforme d’identités Microsoft.
  • Vous devez créer un URI de redirection distinct pour chaque plateforme (iOS, Android).

Signer manuellement votre package d’application mobile (facultatif)

Vous pouvez signer votre application automatiquement à l’Étape 2 ou manuellement après la création. La signature de code est différente pour Android et iOS.

Avantages de la signature automatique pour iOS et Android (APK) :

  • Vous n’avez pas besoin de répéter le processus de signature lors de la réencapsulation.
  • Vous n’avez pas besoin d’attendre que les développeurs d’applications aient terminé le processus.
  • Vous n’avez pas besoin de configurer Android Studio ou de mémoriser les mots de passe.
  • Vous n’avez pas besoin d’un appareil Mac pour la signature iOS.
Plateforme Méthode de signature
iOS Signature manuelle de code pour iOS
Android Signature manuelle de code pour Android
Google Play Store Signature de code pour Google Play Store

Voir aussi

  • Last updated on