Empacotar um componente de código

Saiba como empacotar um componente de código em um arquivo de solução e importá-lo para Microsoft Dataverse para que ele esteja disponível em runtime. Você também aprenderá a se conectar a um ambiente, implantar atualizações com Microsoft Power Platform CLI e remover componentes de uma solução.

Processo

Para criar e importar um arquivo de solução:

1. Crie uma nova pasta dentro da pasta de componente de exemplo e nomeie-a como Soluções (ou qualquer nome escolhido) usando o comando mkdir Solutions. Navegue até o diretório usando o comando cd Solutions.

2. Crie um projeto de soluções usando o comando pac solution init . Use o projeto de solução para agrupar o componente de código em um arquivo ZIP de solução que você importa para o Dataverse.

   pac solution init --publisher-name developer --publisher-prefix dev
   

   Note

   Os valores de publisher-name e publisher-prefix devem ser únicos no seu ambiente.

3. Depois de criar o novo projeto de solução, defina a pasta Soluções como o local do componente de exemplo criado. Adicione a referência usando o comando pac solution add-reference. Essa referência informa o projeto de solução sobre quais componentes de código adicionar durante o build. Você pode adicionar referências a vários componentes em um único projeto de solução.

    pac solution add-reference --path c:\downloads\mysamplecomponent
   

4. Para gerar um arquivo ZIP do projeto de solução, vá para o diretório do projeto de solução e crie o projeto usando o comando a seguir. Esse comando usa o MSBuild para criar o projeto de solução puxando para baixo as dependências do NuGet como parte da restauração. Use o /restore sinalizador apenas na primeira vez que você criar o projeto de solução. Para cada build depois disso, execute o comando msbuild.

   msbuild /t:restore
   

   msbuild
   

   Ou se você instalou o SDK do .NET, versão 6 ou posterior:

   dotnet build
   

   Dica

   • Se o msbuild 15.9.* não estiver no PATH, abra o Prompt de Comando do Desenvolvedor do VS 2017 para executar os comandos msbuild.
   • Criar a solução na configuração de depuração gera um pacote de solução não gerenciada. A criação da solução na configuração de versão gera um pacote de solução gerenciada. Você pode sobrescrever essas configurações especificando a propriedade SolutionPackageType no arquivo cdsproj.
   • Defina a configuração do msbuild como Release para gerar uma compilação de produção. Exemplo: msbuild /p:configuration=Release
   • Se você encontrar um erro que diga o nome do projeto ambíguo ao executar o msbuild comando em sua solução, verifique se o nome da solução e o nome do projeto não são os mesmos.

5. Depois que o build for bem-sucedido, localize os arquivos de solução gerados dentro da \bin\debug\ pasta.

6. Importe a solução no Dataverse manualmente por meio do portal web ou automaticamente por meio do Microsoft Power Platform Build Tools.

Conectar-se ao seu ambiente

Você pode implantar os componentes de código diretamente de Microsoft Power Platform CLI conectando-se ao ambiente do Dataverse e, em seguida, enviando por push os componentes atualizados.

Siga as etapas na lista a seguir para criar o perfil de autenticação, conectar-se ao Dataverse e efetuar push dos componentes atualizados.

1. Crie seu perfil de autenticação usando o comando pac auth create .

   pac auth create --url https://xyz.crm.dynamics.com 
   

2. Se você criou anteriormente um perfil de autenticação, exiba todos os perfis existentes usando o comando pac auth list .

    pac auth list 
   

3. Alterne entre perfis de autenticação criados anteriormente usando o comando pac auth select .

    pac auth select --index <index of the active profile>
   

4. Obtenha informações básicas sobre o ambiente usando o comando pac org who. A conexão usa o perfil de autenticação padrão.

   pac org who 
   

5. Exclua um perfil de autenticação específico usando o comando pac auth delete com a pac auth delete --index <index of the profile> sintaxe.

6. Desmarque todos os perfis de autenticação do computador local usando o comando pac auth clear . Essa ação é irreversível porque exclui completamente o arquivo authprofile.json e o arquivo de cache de token da sua máquina local.

Implantar componentes de código

Depois de criar um perfil de autenticação, comece a enviar por push os componentes de código para a instância do Dataverse com todas as alterações mais recentes.

A push funcionalidade acelera o desenvolvimento do ciclo do desenvolvedor interno porque ignora os requisitos de controle de versão do componente de código e não exige que você crie sua solução (cdsproj) para importar o componente de código.

Para usar a push funcionalidade, siga estas etapas:

1. Verifique se você tem um perfil de autenticação válido.

2. Vá para o diretório em que o arquivo de componente de exemplo está localizado.

3. Execute o comando pac pcf push .

   pac pcf push --publisher-prefix <your publisher prefix>
   

   Note

   O prefixo do editor que você usa com o comando push deve corresponder ao prefixo do editor da sua solução na qual você inclui os componentes.

Remover componentes de uma solução

Se você quiser remover um componente de código de um arquivo de solução:

1. Edite o cdsproj arquivo no diretório do projeto da solução e remova as referências ao componente. Aqui está um exemplo de uma referência de componente:

   <ItemGroup>
       <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
         <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
         <Name>pcf_component</Name>
         <Targets>Build</Targets>
         <referenceOutputAssembly>false</referenceOutputAssembly>
         <OutputItemType>Content</OutputItemType>
         <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       </Projectreference>
   </ItemGroup>
   

2. Execute uma recompilação (ou limpe) usando o seguinte comando:

   msbuild /t:rebuild
   

Consulte também

Adicionar componentes de código a uma coluna ou tabela em aplicativos baseados em modelo
Adicionar componentes a um aplicativo de tela
Referência da API da estrutura de componentes do Power Apps
visão geral da estrutura de componentes Power Apps
Microsoft Power Platform CLI: grupos de comandos