Outils de composant Power Apps
Lorsque vous concevez un composant de code Power Apps, vous rationalisez les étapes requises de A à Z à l’aide d’une combinaison d’outils.
| Étape | Description | Outils |
|---|---|---|
| Créer | Créez et initialisez le projet de composant en utilisant un modèle. | Interface de ligne de commande (CLI) Power Platform |
| Implémenter | Décrivez et implémentez le comportement et le style de vos composants. | Éditeur de code ou environnement de développement intégré (IDE) de votre choix |
| Créer | Validez et transpilez le code TypeScript, personnalisez un manifeste de composant. | CLI Power Platform ou Visual Studio Code |
| Déboguer | Validez et dépannez le comportement du composant sans le déployer dans un environnement Dataverse. | CLI Power Platform |
| Packager | Créez un fichier de solution Dataverse et regroupez le composant dans le cadre de cette solution. | CLI Power Platform et msbuild Visual Studio |
Jetons un œil à certains des outils que nous utilisons.
CLI Power Platform
La CLI (interface de ligne de commande) Power Platform est un outil de ligne de commande axé sur les développeurs qui fournit des commandes pour créer du code personnalisé. Cela inclut actuellement les composants de code et les plug-ins. L’outil dispose également de commandes admin d’environnement disponibles pour la gestion des environnements. Vous pouvez également implémenter Application Lifecycle Management avec des solutions à l’aide des commandes solution et package.
L’installation de la CLI ne prend que quelques étapes. Vous pouvez vérifier que vous disposez de la dernière version à l’aide de la commande update suivante :
pac install latest
Lorsque vous commencez à créer votre composant de code, la CLI vous permet de créer une structure de vos fichiers initiaux à l’aide d’un modèle. La commande suivante est un exemple d’initialisation d’un composant à l’aide du modèle de champ :
pac pcf init --namespace Contoso --name Slider --template field
L’une des conditions préalables à l’installation de la CLI consiste à installer le gestionnaire de packages de nœuds (npm) vous permettant de gérer les dépendances et créer votre composant de code. Lorsque vous utilisez la commande init, elle crée un fichier package.json configuré avec les dépendances de votre composant de code et plusieurs commandes comme build que vous utilisez lors du développement de votre composant. La première commande npm que vous exécutez après l’initialisation du composant est install. Cette commande télécharge toutes les bibliothèques nécessaires pour prendre en charge Power Apps Component Framework.
npm install
Vous pouvez également demander que lors de l’exécution de l’initialisation, elle exécute également la commande npm install en ajoutant --run-npm-install à vos options de commande init.
pac pcf init --namespace Contoso --name Slider --template field --run-npm-install
Au fur et à mesure que vous développez votre composant de code, vous pouvez vérifier les problèmes de code à l’aide de la commande build suivante :
npm run build
Cette commande valide votre manifeste, exécute le transpilateur TypeScript et vous informe de tout problème.
Un atelier de test est également disponible afin que vous puissiez tester votre composant de code localement sans avoir à le déployer dans un environnement. Vous pouvez lancer l’atelier de test avec votre composant de code à l’aide de la commande start suivante :
npm start
Vous pouvez également activer le mode de surveillance à l’aide de la commande npm start watch. Si vous modifiez votre code en mode Surveillance, l’atelier de test le récupère automatiquement sans redémarrer.
Pour accélérer vos tests de composants de code, la CLI peut s’authentifier auprès de votre environnement de développement et transmettre votre composant de code pour des tests dans des applications réelles. La commande suivante génère et transmet la dernière version de votre composant de code à votre environnement de développement Dataverse actuellement configuré.
pac pcf push --publisher-prefix dev
Outils pour Visual Studio Code
L’extension Power Platform pour Visual Studio Code intègre l’interface de ligne de commande (CLI) Power Platform pour travailler dans le cadre de l’environnement de l’éditeur. Vous pouvez installer l’extension à partir de Visual Studio Marketplace. Une fois l’extension installée, vous pouvez utiliser la commande CLI pac à partir de la fenêtre du terminal.
Outils pour Visual Studio
Vous installez ces outils soit à l’aide de l’installation autonome, soit dans le cadre de l’installation de Visual Studio. Vous pouvez les trouver sur Télécharger Visual Studio 2022 pour Windows et Mac.
La commande msbuild est utilisée lorsque vous packagez votre composant dans le cadre d’une solution Power Apps pour le déploiement dans un environnement Dataverse. Par exemple, les commandes suivantes initialisent une nouvelle solution pour votre composant et créent un fichier de projet msbuild qui gère la création des fichiers de sortie de la solution pendant une génération.
pac solution init --publisher-name Contoso --publisher-prefix contoso ‑‑outputDirectory vssolution
Afin que votre composant de code soit packagé dans la solution, vous devez ajouter une référence à votre composant. Cela garantit que lorsqu’une build est exécutée, votre composant est inclus dans la solution de sortie générée. La commande suivante ajoute la référence :
pac solution add-reference --path \<path to your Power Apps component framework project\>
La commande msbuild vous permet de générer les fichiers de solution avec les références de solution configurées. La commande suivante exécute la build la première fois :
msbuild /t:build /restore
Conseil
Si vous obtenez une erreur indiquant que la commande msbuild n’est pas reconnue, essayez d’exécuter la commande à partir de l’invite de commandes développeur pour Visual Studio. Ce raccourci est créé dans le cadre d’une installation de Visual Studio ou d’outils pour Visual Studio.
Après la première build, vous pouvez exécuter la commande msbuild pour régénérer les fichiers de solution. Les fichiers de solution générés se trouvent dans le dossier \bin\debug\ (ou \bin\release) une fois la build terminée. Une fois que le fichier zip de sortie est prêt, vous pouvez importer la solution dans Dataverse manuellement ou effectuer le déploiement automatiquement à l’aide de Microsoft Power Platform Build Tools.
Choisir un IDE
Nous vous recommandons d’écrire vos composants à l’aide de Visual Studio Code ou Visual Studio. Mais vous pouvez utiliser tout IDE de votre choix pour créer des composants de code Power Apps personnalisés.