Power Apps component framework
Être accessible aux créateurs Power Apps, les composants de Power Apps component framework doivent être empaquetés dans une solution, exportés, puis importés dans un environnement Power Apps avec Dataverse. Les sections suivantes décrivent comment procéder.
Pour plus d’informations sur l’utilisation des techniques ALM avec des composants de code, consultez Gestion du cycle de vie des applications (ALM) des composants de code.
Empaqueter et déployer un composant de code
Cette section décrit comment importer des composants de code dans Microsoft Dataverse afin que les composants soient disponibles pour les créateurs Power Apps.
Après avoir implémenté les composants de code à l’aide de la CLI Power Platform, l’étape suivante consiste à regrouper tous les éléments du composant de code dans un fichier de solution et à importer le fichier de solution dans Dataverse afin que vous puissiez voir les composants de code dans l’expérience d’exécution du fabricant.
Pour créer et importer un fichier de solution :
Créez un dossier dans le dossier contenant le fichier cdsproj et nommez-le Solutions (ou n’importe quel nom de votre choix) en utilisant la commande CLI
mkdir Solutions
. Accédez au répertoire à l’aide de la commandecd Solutions
.Créez un projet de solution à l’aide de la commande suivante. Le projet de solution est utilisé pour regrouper le composant de code dans un fichier zip de solution (compressé) utilisé pour l’importation dans Dataverse.
pac solution init --publisher-name \<enter your publisher name\> --publisher-prefix \<enter your publisher prefix\>
Note
Les valeurs publisher-name et publisher-prefix doivent être uniques à votre environnement. Pour plus d’informations : Éditeur de solutions et Préfixe de l’éditeur de solutions
Une fois le projet de solution créé, faites référence au dossier Solutions à l’emplacement où l’exemple de composant créé est situé. Vous pouvez ajouter la référence à l’aide de la commande affichée ci-dessous. Cette référence informe le projet de solution dont les composants de code doivent être ajoutés au cours de la création. Vous pouvez ajouter des références à plusieurs composants dans un projet simple de solution.
pac solution add-reference --path \<path to your Power Apps component framework project\> ```dotnetcli
Pour générer un fichier zip du projet de solution, accédez au répertoire de votre projet de solution, puis générez le projet en utilisant la commande suivante. Cette commande utilise le programme MSBuild pour générer votre projet de solution en explorant les dépendances NuGet dans le cadre de la restauration. Utilisez
/restore
uniquement la première fois que le projet de solution est créé. Pour chaque build après cela, vous pouvez exécuter la commandemsbuild
.msbuild /t:build /restore
Pourboire
- Si MSBuild 15.9.* ne se trouve pas dans le chemin d’accès, ouvrez l’invite de commandes de développeur pour Visual Studio 2017 pour exécuter les commandes
msbuild
. - La génération de la solution dans la configuration de débogage génère un package de solution non gérée. Un package de solution non gérée est généré lors de la création de la solution dans la configuration de version. Ces paramètres peuvent être remplacés en spécifiant la propriété SolutionPackageType dans le fichier cdsproj.
- Vous pouvez définir la configuration de
msbuild
sur Version pour publier une build de production. Exemple :msbuild /p:configuration=Release
- Si vous rencontrez une erreur indiquant « Nom de projet ambigu » lors de l’exécution de la commande msbuild sur votre solution, assurez-vous que le nom de votre solution et le nom du projet ne sont pas identiques.
- Si MSBuild 15.9.* ne se trouve pas dans le chemin d’accès, ouvrez l’invite de commandes de développeur pour Visual Studio 2017 pour exécuter les commandes
Les fichiers de solution générés se trouvent dans le dossier \bin\debug\ (ou \bin\release) une fois le build terminé.
Vous pouvez utiliser les outils Microsoft Power Platform Build Tools pour automatiser l’importation de la solution dans un environnement Dataverse ; sinon, vous pouvez manuellement importer la solution dans Dataverse à l’aide du portail web.
Tâches supplémentaires que vous pouvez effectuer avec le cadre et les solutions
Vous trouverez ci-dessous des liens vers des tâches courantes supplémentaires que vous pouvez effectuer lorsque vous travaillez avec le cadre et les solutions.
Créer un projet de solution basé sur une solution existante dans Dataverse
Créez un projet de plug-in et ajoutez-y une référence dans votre solution