Présentation
Lorsque vous modifiez une application canevas dans Microsoft Power Apps Studio, une représentation visuelle de l’application s’affiche.
Vous pouvez glisser-déplacer un contrôle sur l’écran, utiliser la barre de formule pour modifier vos expressions et utiliser le volet Propriétés pour modifier les valeurs des propriétés de contrôle. La plupart des créateurs utilisent ces outils pour créer et modifier des applications.
Vous pouvez enregistrer une copie d’application canevas sur votre ordinateur sous forme de fichier unique avec l’extension .msapp. Si l’application canevas fait partie d’une solution Microsoft Dataverse, vous pouvez utiliser Microsoft Power Platform CLI (interface de ligne de commande) pour télécharger la solution et extraire l’application. Le fichier d’application est autonome et représente l’intégralité de l’application, y compris les écrans, les contrôles, les composants, les connexions, les formules, etc. Cependant, en interne, l’application contient de nombreux fichiers distincts, chacun décrivant une partie de l’application. Vous pouvez utiliser la commande unpack de Power Platform CLI pour extraire ces fichiers. Une fois les fichiers décompressés, vous pouvez modifier la plupart des fichiers à l’aide de n’importe quel éditeur de texte. La capture d’écran suivante montre un exemple de la même application ouverte dans Microsoft Visual Studio Code après décompression.
La décompression de l’application canevas en fichiers texte individuels activera les scénarios suivants, dans lesquels vous pouvez effectuer les tâches suivantes :
Modifier le code source directement dans un éditeur de texte au lieu d’un concepteur visuel. Par exemple, un éditeur de texte est plus efficace pour effectuer une recherche et un remplacement global.
Stocker des fichiers texte individuels dans le contrôle de code source, ce qui permet un suivi granulaire des modifications dans une application. Par exemple, vous pouvez réévaluer le moment où une étiquette dans l’application est passée de X à Y et qui a effectué la modification.
Utiliser des outils de développement automatisés qui reposent sur le code source, tels que l’analyse de code statique, les générateurs de code, les modèles, etc.
La source de votre application est représentée par un sous-ensemble de YAML, qui est un langage convivial de sérialisation de données. Nous verrons comment utiliser YAML ultérieurement dans ce module.
CLI Power Platform
Power Platform CLI (ou CLI) est un outil de ligne de commande que vous pouvez utiliser pour de nombreuses tâches de développement et d’administration dans Microsoft Power Platform, par exemple, pour créer des composants Power Apps Component Framework, gérer des environnements, utiliser des solutions et des portails, etc. Vous pouvez utiliser la CLI à partir d’une simple invite de commande, dans le cadre d’un build automatisé, ou à partir du terminal dans Visual Studio Code.
Ce module porte sur l’application canevas et la fonctionnalité de solution de Power Platform CLI. Vous pouvez examiner les autres fonctionnalités et leur fonctionnement dans la documentation du produit. Vous pouvez télécharger et installer Power Platform CLI. Si la CLI est déjà installée, assurez-vous d’avoir téléchargé la dernière version à l’aide de la commande suivante :
pac install latest
Commande canvas unpack
Lorsque vous téléchargez une application canevas à partir du cloud, il s’agit d’un fichier unique avec une extension .msapp. La commande canvas unpack utilise ce fichier comme entrée et le décompresse en plusieurs fichiers qui représentent les différentes parties de l’application. Par exemple, chaque écran de l’application aura son propre fichier dans la sortie de la commande.
Pour décompresser le fichier .msapp d’une application canevas, utilisez la commande suivante :
pac canvas unpack --msapp "Account Manager.msapp" --sources src
Le dossier de sortie cible est identifié par le commutateur de la source en utilisant la structure de dossier suivante.
Commande canvas pack
La commande canvas pack est l’inverse de la commande canvas unpack. Elle compresse le dossier contenant des fichiers individuels en un seul fichier .msapp. Pour compresser l’application afin qu’elle soit prête à être téléchargée dans le cloud, ou pour qu’elle soit incluse dans une solution, utilisez cette commande :
pac canvas pack --msapp "Account Manager.msapp" --sources src
Commandes solution
Vous pouvez obtenir le fichier .msapp de votre application canevas à partir du portail des créateurs en téléchargeant l’application individuelle. Si vous utilisez des solutions pour stocker vos applications et vos flux, la solution exportée contiendra le fichier .msapp de chaque application canevas de la solution. En utilisant la CLI et la commande solution unpack, vous pouvez extraire les fichiers .msapp individuels de la solution. L’exemple suivant présente la commande solution unpack :
pac solution unpack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Le dossier SampleSolutionUnpacked contiendra un sous-dossier CanvasApps qui contient le fichier .msapp de chaque application incluse dans votre solution.
De même que canvas pack, la commande solution pack rassemble les fichiers en une solution que vous pouvez importer dans un environnement cloud. L’exemple suivant présente la commande solution pack :
pac solution pack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Power Platform ou extension du code
L’extension Microsoft Power Platform vous permet d’utiliser Power Platform CLI à l’intérieur de Visual Studio Code. Lorsque vous installez l’extension, elle installe la dernière version de Power Platform CLI pour une utilisation dans une fenêtre de terminal Visual Studio Code.
En utilisant l’extension, vous pouvez compresser et décompresser vos applications canevas sans quitter Visual Studio Code. Utilisez les mêmes commandes que celles décrites précédemment avec la CLI autonome.
Contrôle de code source
La décompression d’une application canevas crée de nombreux fichiers et vous permet de valider les fichiers individuels dans le contrôle de code source pour chaque modification. Ces étapes peuvent faire partie de votre stratégie globale de gestion du cycle de vie des applications (ALM) avec Microsoft Power Platform. En validant les fichiers individuels dans le contrôle de code source, vous obtenez un meilleur suivi granulaire des modifications que vous avez apportées. Plus précisément, si vous ne validez que le fichier .msapp, la seule différence entre les versions que vous pouvez constater est que « quelque chose » a changé. En décompressant et en validant les fichiers individuels, vous pouvez obtenir une différenciation ligne par ligne et mettre en évidence les changements dans chaque validation. En association avec le suivi des éléments de travail, vous obtiendrez également une traçabilité des exigences jusqu’à la modification apportée pour prendre en charge l’élément de travail.
La suite de ce module explique comment utiliser le contrôle de code source à partir de votre application canevas.