Power Apps component framework
Per essere accessibili ai creatori di app Power Apps, i componenti nel Power Apps component framework devono essere inseriti in una soluzione come pacchetti, esportati e quindi importati in un ambiente Power Apps con Dataverse. Nelle sezioni seguenti viene descritto come eseguire questa operazione.
Per ulteriori informazioni sull'utilizzo delle tecniche ALM con i componenti di codice, vedi Gestione del ciclo di vita delle applicazioni (ALM) con i componenti di codice.
Inserire in un pacchetto e distribuire un componente di codice
Questa sezione descrive come importare componenti di codice in Microsoft Dataverse in modo che i componenti siano disponibili per i creatori di app Power Apps.
Dopo aver implementato i componenti di codice usando l'interfaccia della riga di comando di Power Platform, è necessario creare un pacchetto con tutti gli elementi del componente di codice in un file di soluzione e importare tale file in Dataverse di modo che sia possibile vedere i componenti di codice nell'esperienza di runtime del creatore.
Per creare e importare un file di soluzione:
Crea una nuova cartella nella cartella che contiene il file cdsproj e denominalo Soluzioni (o qualsiasi nome a tua scelta) utilizzando il comando
mkdir Solutions
dell'interfaccia della riga di comando. Vai alla directory utilizzando il comandocd Solutions
.Crea un nuovo progetto di soluzione utilizzando il comando seguente. Il progetto di soluzione viene utilizzato per il bundling del componente di codice in un file di soluzione zip (compresso) utilizzato per l'importazione in Dataverse.
pac solution init --publisher-name \<enter your publisher name\> --publisher-prefix \<enter your publisher prefix\>
Nota
I valori publisher-name and publisher-prefix devono essere univoci per l'ambiente. Ulteriori informazioni: Autore di soluzioni e Prefisso dell'autore di soluzioni
Dopo la creazione del nuovo progetto di soluzione, fai riferimento alla cartella Soluzioni nella posizione in cui si trova il componente d'esempio creato. Puoi aggiungere il riferimento utilizzando il comando mostrato di seguito. Questo riferimento informa il progetto di soluzione su quali componenti di codice devono essere aggiunti durante la compilazione. Puoi aggiungere riferimenti a più componenti in un singolo progetto di soluzione.
pac solution add-reference --path \<path to your Power Apps component framework project\> ```dotnetcli
Per generare un file zip dal progetto della soluzione, vai alla directory del progetto della soluzione e compila il progetto usando il comando seguente. Questo comando utilizza il programma MSBuild per compilare il progetto della soluzione estraendo le dipendenze NuGet come parte del ripristino. Usa solo
/restore
la prima volta che viene compilato il progetto della soluzione. Per ogni build successiva, puoi eseguire il comandomsbuild
.msbuild /t:build /restore
Mancia
- Se MSBuild 15.9.* non è nel percorso, apri il prompt dei comandi per gli sviluppatori per Visual Studio 2017 per eseguire i comandi
msbuild
. - La compilazione della soluzione nella configurazione di debug genera un pacchetto di soluzione non gestita. Un pacchetto di soluzione gestita viene generato compilando la soluzione nella configurazione di versione. Queste impostazioni possono essere ignorate specificando la proprietà SolutionPackageType nel file cdsproj.
- Puoi impostare la configurazione
msbuild
su Versione per emettere una compilazione di produzione. Esempio:msbuild /p:configuration=Release
- Se si verifica un errore "Nome di progetto ambiguo" durante l'esecuzione del comando msbuild sulla soluzione, assicurati che il nome della soluzione e il nome del progetto non siano uguali.
- Se MSBuild 15.9.* non è nel percorso, apri il prompt dei comandi per gli sviluppatori per Visual Studio 2017 per eseguire i comandi
I file di soluzione generati si trovano nella cartella \bin\debug\ (o \bin\release) dopo il completamento della compilazione.
Puoi usare gli strumenti Microsoft Power Platform per automatizzare l'importazione della soluzione in un ambiente di Dataverse; in caso contrario, puoi importare manualmente la soluzione in Dataverse utilizzando il portale Web.
Attività aggiuntive che è possibile eseguire con il framework e le soluzioni
Di seguito sono riportati i collegamenti ad attività comuni aggiuntive che puoi eseguire quando utilizzi il framework e le soluzioni.
Crea un progetto di soluzione basato su una soluzione esistente in Dataverse
Crea un progetto plug-in e aggiungi un riferimento ad esso nella tua soluzione