Introduzione
Quando si modifica un'app canvas in Microsoft Power Apps Studio, verrà visualizzata una rappresentazione visiva dell'app.
È possibile trascinare e rilasciare un controllo sulla schermata, usare la barra della formula per modificare le espressioni e usare il pannello Proprietà per modificare i valori delle proprietà di controllo. La maggior parte dei creatori usa questi strumenti per creare e modificare app.
È possibile salvare una copia di un'app canvas sul computer come singolo file con estensione .msapp. Se l'app canvas fa parte di una soluzione Microsoft Dataverse, allora è possibile usare l'interfaccia della riga di comando di Microsoft Power Platform per scaricare la soluzione ed estrarre l'app. Il file dell'app è autonomo e rappresenta l'intera app, inclusi schermate, controlli, componenti, connessioni, formule e così via. Tuttavia, internamente, l'app contiene molti file separati, ognuno dei quali descrive una parte dell'app. È possibile usare il comando unpack dell'interfaccia della riga di comando di Power Platform per estrarre questi file. Una volta decompressi i file, è modificare la maggior parte di essi usando qualsiasi editor di testo. Lo screenshot seguente mostra un esempio della stessa app aperta in Microsoft Visual Studio Code dopo la decompressione.
La decompressione dell'app canvas in singoli file di testo abiliterà i seguenti scenari, in cui è possibile:
Modificare il codice sorgente direttamente in un editor di testo anziché in una finestra di progettazione grafica. Ad esempio, eseguire una ricerca e una sostituzione globali sarebbe più efficiente in un editor di testo.
Archiviare singoli file di testo nel controllo del codice sorgente, consentendo il monitoraggio granulare delle modifiche in un'app. Ad esempio, si potrebbe conoscere quando un'etichetta nell'app è stata modificata da X a Y e chi ha apportato la modifica.
Usare strumenti di sviluppo automatizzati che si basano sul codice sorgente, come analisi del codice statico, generatori di codice, modelli e così via.
L'origine dell'app è rappresentata da un sottoinsieme di YAML, un linguaggio di serializzazione dei dati di facile uso. L'uso di YAML verrà trattato più avanti in questo modulo.
Interfaccia della riga di comando di Power Platform
L'interfaccia della riga di comando di Power Platform (o CLI) è uno strumento da riga di comando che è possibile usare per molte attività di sviluppo e amministrative in Microsoft Power Platform, quali creazione di componenti Power Apps component framework, gestione degli ambienti, uso di soluzioni e portali e altro ancora. È possibile usare l'interfaccia della riga di comando da un semplice prompt dei comandi, come parte di una build automatizzata o dal terminale in Visual Studio Code.
Questo modulo si concentra sulla funzionalità di soluzione e app canvas dell'interfaccia della riga di comando di Power Platform. È possibile rivedere le altre funzionalità e come operano nella documentazione del prodotto. È possibile scaricare e installare l'interfaccia della riga di comando di Power Platform. Se l'interfaccia della riga di comando è già installata, assicurarsi di disporre della versione più recente usando il comando seguente:
pac install latest
Comando di decompressione del canvas
Quando si scarica un'app canvas dal cloud, si tratta di un singolo file con estensione .msapp. Il comando canvas unpack accetta questo file come input e lo decomprime in più file che rappresentano le diverse parti dell'app. Ad esempio, ogni schermata dell'app avrà il proprio file nell'output del comando.
Per decomprimere il file .msapp di un'app canvas, usare il comando seguente:
pac canvas unpack --msapp "Account Manager.msapp" --sources src
La cartella di output di destinazione è identificata dall'interruttore dell'origine usando la seguente struttura di cartelle.
Comando di compressione del canvas
Il comando canvas pack è l'opposto del comando canvas unpack, in quanto comprime la cartella che contiene i singoli file in un unico file .msapp. Per compattare l'app in modo che sia pronta per il caricamento nel cloud o che sia inclusa in una soluzione, usare questo comando:
pac canvas pack --msapp "Account Manager.msapp" --sources src
Comandi della soluzione
È possibile ottenere il file .msapp per l'app canvas da Maker Portal scaricando la singola app. Se si usano delle soluzioni per contenere app e flussi, la soluzione esportata conterrà il file .msapp per ogni app canvas nella soluzione. Usando l'interfaccia della riga di comando e il comando solution unpack è possibile estrarre i singoli file .msapp dalla soluzione. L'esempio seguente mostra il comando solution unpack:
pac solution unpack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
La cartella SampleSolutionUnpacked conterrà una sottocartella CanvasApps che include il file .msapp per ogni app inclusa nella soluzione.
Allo stesso modo di canvas pack, il comando solution pack riassembla i file in una soluzione che è possibile importare in un ambiente cloud. L'esempio seguente mostra il comando solution pack:
pac solution pack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Power Platform ed estensione di codice
L'estensione Microsoft Power Platform permette di usare l'interfaccia della riga di comando di Power Platform dall'interno di Visual Studio Code. Quando si installa l'estensione, viene installata l'interfaccia della riga di comando Power Platform più recente per l'uso all'interno di una finestra del terminale di Visual Studio Code.
Usando l'estensione, è possibile comprimere e decomprimere le app canvas senza chiudere Visual Studio Code. Usare gli stessi comandi discussi in precedenza con l'interfaccia della riga di comando autonoma.
Controllo del codice sorgente
La decompressione di un'app canvas crea molti file e rende possibile salvare i singoli file nel controllo del codice sorgente per ogni modifica. Questi passaggi possono diventare parte della strategia generale per la gestione del ciclo di vita dell'applicazione (ALM) con Microsoft Power Platform. Il commit dei singoli file nel controllo del codice sorgente permette di ottenere un monitoraggio granulare migliore delle modifiche apportate. In particolare, se si esegue il commit solo del file .msapp, l'unica differenza tra le versioni da notare è che "qualcosa" è cambiato. Decomprimendo ed eseguendo il commit dei singoli file, è possibile ottenere le differenze riga per riga ed evidenziare le modifiche in ogni commit. In combinazione con il monitoraggio degli elementi di lavoro, si otterrà anche la tracciabilità dei requisiti fino alla modifica apportata per supportare l'elemento di lavoro.
Il resto del modulo prende in esame come lavorare con il controllo del codice sorgente da un'app canvas.