Strumenti per componenti Power Apps
Quando si crea un componente di codice Power Apps, si usa una combinazione di strumenti per semplificare i passaggi necessari dall'inizio alla fine.
| Passaggio | Descrizione | Strumenti |
|---|---|---|
| Creazione | Creare e inizializzare il progetto componente usando un modello. | Interfaccia della riga di comando di Power Platform |
| Implementazione | Descrivere e implementare il comportamento e lo stile del componente. | Editor di codice o IDE (ambiente di sviluppo integrato) come desiderato |
| Creazione | Convalidare ed estrarre il codice TypeScript, personalizzare un manifesto del componente. | Interfaccia della riga di comando di Power Platform o Visual Studio Code |
| Debug | Convalidare e risolvere i problemi del comportamento del componente senza distribuirlo in un ambiente Dataverse. | Interfaccia della riga di comando di Power Platform |
| Pacchetto | Creare un file della soluzione Dataverse e comprimere il componente in un pacchetto come parte della soluzione. | Interfaccia della riga di comando di Power Platform e msbuild di Visual Studio |
Di seguito vengono illustrati alcuni degli strumenti comunemente usati.
Interfaccia della riga di comando di Power Platform
L'interfaccia della riga di comando di Power Platform è uno strumento della riga di comando dedicato agli sviluppatori che fornisce comandi per la creazione di codice personalizzato. Attualmente include componenti di codice e plug-in. Lo strumento dispone anche dei comandi di amministrazione per la gestione degli ambienti. È anche possibile usare i comandi solution e package per implementare la gestione del ciclo di vita delle applicazioni con le soluzioni.
L'installazione dell'interfaccia della riga di comando richiede pochi passaggi. È possibile verificare di disporre della versione più recente usando il seguente comando di aggiornamento:
pac install latest
Quando si inizia a creare il componente di codice, si usa l'interfaccia della riga di comando per eseguire lo scaffolding dei file iniziali usando un modello. Il comando di seguito è un esempio di inizializzazione di un componente mediante il modello di campo:
pac pcf init --namespace Contoso --name Slider --template field
Uno dei prerequisiti per l'installazione dell'interfaccia della riga di comando è l'installazione di Node Package Manager (npm). Si usa npm per gestire le dipendenze e creare il componente di codice. Usando il comando init, si crea un file package.json configurato con le dipendenze per il componente di codice e diversi comandi, ad esempio il comando build che si usa durante lo sviluppo del componente. Il primo comando npm che si esegue dopo l'inizializzazione del componente è install. Questo comando scarica tutte le librerie necessarie per supportare Power Apps Component Framework.
npm install
È anche possibile richiedere che, quando si esegue l'inizializzazione, si esegua anche l'installazione di npm aggiungendo --run-npm-install alle opzioni del comando init.
pac pcf init --namespace Contoso --name Slider --template field --run-npm-install
Durante lo sviluppo del componente di codice, è possibile verificare la presenza di eventuali problemi di codice usando il seguente comando build:
npm run build
Questo comando convalida il manifesto, esegue il transpiler TypeScript e notifica eventuali problemi.
È disponibile anche un test harness in modo da poter testare il componente di codice in locale senza doverlo distribuire in un ambiente. È possibile avviare il test harness con il componente di codice usando il seguente comando start:
npm start
È inoltre possibile abilitare la modalità di controllo usando il comando npm start watch. Se si apportano modifiche al codice nella modalità di controllo, il test harness le raccoglie automaticamente senza riavvio.
Per velocizzare il test dei componenti di codice, l'interfaccia della riga di comando può eseguire l'autenticazione nell'ambiente di sviluppo e inviare il componente di codice per il test in app reali. Il comando seguente crea e invia l'ultima versione del componente di codice all'ambiente di sviluppo Dataverse attualmente configurato.
pac pcf push --publisher-prefix dev
Strumenti per Visual Studio Code
L'estensione Power Platform per Visual Studio Code consente di usare l'interfaccia della riga di comando di Power Platform nel contesto dell'ambiente dell'editor. È possibile installare l'estensione da Visual Studio Marketplace. Una volta installato, è possibile usare il comando pac di CLI dalla finestra del terminale.
Strumenti per Visual Studio
Installare questi strumenti tramite l'installazione autonoma o come parte dell'installazione di Visual Studio. Sono disponibili alla pagina Download di Visual Studio 2022 per Windows e Mac.
Il comando msbuild viene usato quando si crea il pacchetto del componente come parte di una soluzione Power Apps per la distribuzione in un ambiente Dataverse. Ad esempio, i seguenti comandi inizializzano una nuova soluzione per il componente e creano un file di progetto msbuild che gestisce la creazione dei file della soluzione di output durante una compilazione.
pac solution init --publisher-name Contoso --publisher-prefix contoso ‑‑outputDirectory vssolution
Per fare in modo che il componente di codice venga inserito in un pacchetto della soluzione, occorre aggiungere un riferimento al componente. In tal modo quando si esegue una compilazione, il componente viene incluso nella soluzione di output generata. Il comando seguente aggiunge il riferimento:
pac solution add-reference --path \<path to your Power Apps component framework project\>
È possibile usare il comando msbuild per generare i file della soluzione con i riferimenti della soluzione configurati. Il comando seguente esegue la compilazione per la prima volta:
msbuild /t:build /restore
Suggerimento
Se si verifica un errore che indica che il comando msbuild non è riconosciuto, provare a eseguire il comando dal Prompt dei comandi per gli sviluppatori di Visual Studio. Questo collegamento viene creato come parte dell'installazione di Visual Studio o Tools per Visual Studio.
Dopo la prima compilazione, è possibile eseguire il comando msbuild per rigenerare i file della soluzione. I file della soluzione generati si trovano nella cartella \bin\debug\ (o \bin\release) una volta completata la compilazione. Quando il file zip di output è pronto, è possibile importare manualmente la soluzione in Dataverse o distribuirla automaticamente usando Microsoft Power Platform Build Tools.
Scelta di un IDE
Si consiglia di usare Visual Studio Code o Visual Studio per scrivere i componenti. Tuttavia è possibile usare qualsiasi IDE per creare componenti di codice Power Apps personalizzati.