Power Apps component framework
Para ser acessível pelos fabricantes do Power Apps, os componentes do Power Apps component framework deve ser empacotada em uma solução, exportada e importada para um ambiente do Power Apps com Dataverse. As seções a seguir descrevem como fazer isso.
Para obter mais informações sobre como usar técnicas de ALM com componentes de código, consulte ALM (gerenciamento do ciclo de vida de um aplicativo) de componentes do código.
Empacotar e implantar um componente de código
Esta seção descreve como importar componentes de código para o Microsoft Dataverse, de forma que os componentes estejam disponíveis para fabricantes do Power Apps.
Após implementar os componentes de código usando o comando CLI do Power Platform, a próxima etapa é compactar todos os elementos do componente de código em um arquivo de solução e importar o arquivo de solução para o Dataverse, de forma que você possa ver os componentes de código na experiência de tempo de execução do criador.
Para criar e importar um arquivo de solução:
Crie uma pasta na pasta que tem o arquivo cdsproj e nomeie-a como Soluções (ou qualquer nome de sua escolha) usando o comando CLI
mkdir Solutions
. Navegue para o diretório usando o comandocd Solutions
.Crie um novo projeto de solução usando o seguinte comando. O projeto da solução é usado para agrupar o componente de código em um arquivo zip (compactado) da solução usado para importar para o Dataverse.
pac solution init --publisher-name \<enter your publisher name\> --publisher-prefix \<enter your publisher prefix\>
Nota
Os valores de publisher-name e publisher-prefix devem ser exclusivos para seu ambiente. Mais informações: Fornecedor de soluções e Prefixo do fornecedor de soluções
Depois que o novo projeto da solução for criado, consulte a pasta Soluções para o local no qual o componente de exemplo criado está localizado. É possível adicionar a referência usando o comando mostrado abaixo. Esta referência informa o projeto da solução sobre quais componentes de código devem ser adicionados durante a compilação. Você pode adicionar referências a vários componentes em um único projeto de solução.
pac solution add-reference --path \<path to your Power Apps component framework project\> ```dotnetcli
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 seguinte comando. Este comando usa o programa MSBuild para compilar o projeto de solução puxando para baixo as dependências do NuGet como parte da restauração. Use apenas
/restore
na primeira vez que o projeto de solução é criado. Para cada compilação depois disso, você pode executar o comandomsbuild
.msbuild /t:build /restore
Gorjeta
- Se MSBuild 15.9* não estiver no caminho, abra o Prompt de Comando do Desenvolvedor para Visual Studio 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. Um pacote de solução gerenciada é gerado na criação da solução na configuração da versão. Essas configurações podem ser substituídas pela especificação da propriedade SolutionPackageType no arquivo cdsproj.
- Você pode definir a configuração
msbuild
para Versão para emitir uma compilação de produção. Exemplo:msbuild /p:configuration=Release
- Se você encontrar um erro que diz "Nome ambíguo do projeto" ao executar o comando msbuild em sua solução, verifique se o nome da solução e o nome do projeto não são os mesmos.
- Se MSBuild 15.9* não estiver no caminho, abra o Prompt de Comando do Desenvolvedor para Visual Studio 2017 para executar os comandos
Os arquivos de solução gerados estão localizados a pasta \bin\debug\ (or \bin\release) após a compilação ser bem-sucedida.
Você pode usar as Ferramentas de desenvolvimento do Microsoft Power Platform para automatizar a importação da solução para um ambiente do Dataverse; ou você pode importar a solução manualmente para o Dataverse usando o portal da Web.
Tarefas adicionais que você pode executar com a estrutura e as soluções
Abaixo estão os links para tarefas comuns adicionais que você pode executar ao trabalhar com a estrutura e as soluções.
Crie um projeto de solução com base em uma solução existente em Dataverse
Crie um projeto de plug-in e adicione uma referência a ele em sua solução