Creazione di un pacchetto della soluzione dei componenti di codice

  • 15 minuti

È necessario distribuire un componente di codice in un ambiente Microsoft Dataverse prima di usarlo in Power Apps o Power Pages. Per distribuire un componente di codice è innanzitutto necessario comprimerlo in un pacchetto di una soluzione, per poterlo importare in un ambiente. A questo scopo sono disponibili due metodi. È possibile usare il comando Push dell'interfaccia della riga di comando in modo che una soluzione temporanea esegua il push del componente in un ambiente per facilitarne il test. Si consiglia di usare questo approccio durante lo sviluppo del componente. L'altra opzione consiste nel creare una soluzione per il componente e importarla separatamente nell'ambiente Dataverse. Questa opzione è utile per l'uso in pipeline di compilazione o distribuzioni manuali in ambienti diversi dall'ambiente di sviluppo. Esaminiamo entrambe le opzioni in modo più dettagliato.

Nei passaggi seguenti si metteranno in pratica entrambe le tecniche usando il componente di codice creato nell'ultimo argomento o uno dei componenti di esempio disponibili.

Prerequisiti

È necessario disporre di un progetto di componente di codice creato in precedenza. È possibile effettuare questi passaggi per qualsiasi altro progetto del componente di codice, ad esempio i componenti di esempio.

Push di un componente in un ambiente Dataverse durante lo sviluppo

Per eseguire il push di un componente di codice con Power Platform CLI, effettuare i seguenti passaggi:

  1. Avviare Visual Studio Code e selezionare Esplora risorse.

  2. Selezionare Apri cartella.

    Screenshot del pulsante Apri cartella di Visual Studio Code.

  3. Selezionare la cartella del progetto editable-pcf creata nel lab precedente, quindi selezionare Seleziona cartella.

  4. Selezionare la scheda Power Platform e selezionare Aggiungi il profilo di autenticazione.

    Screenshot di VSCode e del pulsante Aggiungi il profilo di autenticazione quando si fa clic sull'icona Power Platform nel menu di spostamento a sinistra.

  5. Cercare una finestra popup Accedi al tuo account e selezionare l'account che si desidera usare. Immettere il nome utente appropriato, selezionare AVANTI e immettere la password. Potrebbe essere necessario fornire MFA se è stato configurato nel tenant.

    Screenshot dell'accesso standard al tenant Microsoft.

  6. Il profilo aggiunto verrà visualizzato in Profili di autenticazione, assieme agli Ambienti e soluzioni associati. Assicurarsi di selezionare l'ambiente appropriato in Ambiente e soluzioni. A tale scopo, selezionare la stella. Accertarsi che per l'ambiente selezionato sia abilitato anche Component Framework nella sezione Funzionalità ambiente dell'interfaccia di amministrazione di Power Platform per l'ambiente selezionato.

    Screenshot delle sezioni PROFILI DI AUTENTICAZIONE e AMBIENTI E SOLUZIONI.

  7. Selezionare Nuovo terminale dal menu Terminale.

  8. Creare il progetto eseguendo il comando riportato di seguito e assicurarsi che l'operazione avvenga correttamente.

    npm run build

    Screenshot dei risultati dell'esecuzione del comando NOM RUN BUILD.

  9. Eseguire il push del controllo personalizzato nell'ambiente usando il comando riportato di seguito.

    pac pcf push --publisher-prefix msl

    Screenshot della build iniziale A e dell'importazione nell'ambiente.

    Notare nell'immagine il riquadro rosso che indica le sezioni Connesso come e Connesso a. Accertarsi che corrispondano al PROFILO DI AUTORIZZAZIONE e all'AMBIENTE selezionato nei passaggi precedenti.

  10. Importare la soluzione nel proprio ambiente e pubblicarla.

    Screenshot del terminale di Visual Studio Code.

    È possibile ignorare l'eventuale messaggio di avviso giallo.

  11. Accedere a Power Apps Maker Portal e verificare di trovarsi nell'ambiente corretto.

  12. Selezionare Soluzioni.

  13. Viene visualizzata la soluzione PowerAppsTools_msl. Selezionare per aprire la soluzione.

    Screenshot di un elenco di soluzioni ambientali con un rettangolo rosso intorno alla soluzione Power Apps Tools.

  14. Viene visualizzato il controllo personalizzato creato.

    Screenshot dei componenti di una soluzione con un rettangolo rosso intorno a un controllo personalizzato.

Creazione di un file della soluzione con Power Platform CLI

Per creare un file della soluzione con l'interfaccia della riga di comando di Power Platform, effettuare i seguenti passaggi:

  1. Tornare a Visual Studio Code e assicurarsi che il progetto EDITABLE-PCF sia aperto.

  2. Andare al terminale e aprire il Prompt dei comandi.

  3. Creare una nuova cartella eseguendo il comando riportato di seguito.

    md Solution

  4. Cambiare la directory e impostarla sulla cartella Solution creata. Eseguire il comando riportato di seguito.

    cd Solution

  5. Inizializzare il progetto della soluzione Dataverse con il seguente comando:

    pac solution init --publisher-name mslearn --publisher-prefix msl

  6. Comunicare al progetto della soluzione che i componenti saranno aggiunti durante la compilazione. Per eseguire questa attività, usare il seguente comando:

    pac solution add-reference --path ..

  7. Per generare il file ZIP della soluzione, usare Microsoft Build Engine, denominato anche msbuild. Usare il flag /restore solo la prima volta che si compila il progetto della soluzione. Nelle compilazioni successive sarà sufficiente eseguire solo msbuild. Il percorso di MSBuild.exe può essere diverso a seconda della versione di Visual Studio installata sul computer.

    "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe\" /t:build /restore

  8. La build dovrebbe venire completata correttamente.

  9. Individuare la cartella Solution creata ed espanderla.

  10. Espandere la cartella bin\debug.

  11. Dovrebbe contenere il file solution.zip.

    Screenshot della soluzione creata.

Nota

Per eseguire MSBuild, è necessario che sia installato Visual Studio o Visual Studio Build Tools. È possibile installare gli strumenti di compilazione dalla pagina Download di Visual Studio. Per accedere a MSBuild, potrebbe essere necessario aggiungerlo alla directory del percorso delle variabili di ambiente di Windows. Ad esempio, Visual Studio 2022 archivia MSBuild in C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin. È anche possibile usare il Prompt dei comandi per gli sviluppatori di Visual Studio per accedere a MSBuild o eseguirlo usando il percorso completo ("C:\Programmi (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin\MSBuild.exe"/t:build /restore).

Il tipo di pacchetto predefinito è una soluzione gestita. Per esportare il pacchetto come Non gestito (o Entrambi), è possibile annullare o rimuovere il commento nella sezione seguente da Solutions.cdsproj e modificare il nodo SolutionPackageType di conseguenza:

   <!-- Solution Packager overrides un-comment to use: SolutionPackagerType Managed, Unmanaged, Both)-->
        <PropertyGroup>
        <SolutionPackageType>Unmanaged</SolutionPackageType>
        </PropertyGroup>

È possibile impostare la configurazione di msbuild su Release per emettere una build di produzione, ad esempio msbuild /p:configuration=Release.

A seconda della configurazione della versione è possibile importare manualmente il file zip che si trova in bin\Debug o bin\Release. È anche possibile distribuire a livello programmatico i componenti di codice con Power Platform CLI. Per altre informazioni, vedere le sezioni Connessione all'ambiente e Distribuzione dei componenti di codice del documento Creazione di un pacchetto di un componente di codice.