Partilhar via

Power Apps component framework

  • Artigo

Para poder ser acedido por criadores do Power Apps, os componentes da arquitetura de componentes do Power Apps têm de ser embalados numa solução, exportados e, em seguida, importados para um ambiente Power Apps com o Dataverse. Os seguintes capítulos descrevem como o fazer.

Para obter mais informações sobre a utilização de técnicas ALM com componentes de código consulte Gestão do ciclo de vida da aplicação de componentes de código (ALM).

Embalar e implementar um componente de código

Este capítulo descreve como importar componentes de código para o Microsoft Dataverse, para que os componentes fiquem disponíveis para os criadores de Power Apps.

Depois de implementar os componentes de código utilizando a CLI de Power Platform, o passo seguinte é embalar todos os elementos de componente de código num ficheiro de solução e importar o ficheiro de solução para o Dataverse, para que possa ver os componentes de código na experiência de runtime do criador.

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

  1. Crie uma nova pasta na pasta que tem o ficheiro cdsproj e atribua-lhe o nome Soluções (ou qualquer nome que prefira) utilizando o comando CLI mkdir Solutions. Navegue para o diretório utilizando o comandocd Solutions.

  2. Crie um novo projeto de solução utilizando o comando seguinte. O projeto da solução é utilizado para agrupar o componente de código num ficheiro zip de solução (comprimido) que é utilizado para importar para o Dataverse.

    pac solution init --publisher-name \<enter your publisher name\>
--publisher-prefix \<enter your publisher prefix\>

    Nota

    Os valores nome e prefixo do editor devem ser exclusivos do seu ambiente. Mais informações: fabricante de soluções e prefixo do fabricante de soluções

  3. Depois do novo projeto de solução ser criado, consultar a pasta Soluções na localização onde se encontra o componente de exemplo criado. Pode adicionar a referência utilizando o comando mostrado abaixo. Esta referência informa o projeto de solução sobre os componentes de código que devem ser adicionados durante a compilação. Pode adicionar referências a vários componentes num único projeto de solução.

    pac solution add-reference --path \<path to your Power Apps component framework project\>
```dotnetcli

  4. Para gerar um ficheiro zip a partir do projeto de solução, aceda ao diretório do projeto da solução e crie o projeto utilizando o comando seguinte. Este comando utiliza o programa MSBuild para criar o projeto da solução puxando as dependências NuGet para baixo como parte da restauração. Utilize apenas /restore a primeira vez que o projeto da solução for criado. Para cada compilação depois disto, pode executar o comando msbuild.

    msbuild /t:build /restore

    Gorjeta

    • Se MSBuild 15.9.* não estiver no caminho, abra a Linha de comandos para programadores para o 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 gerida. Um pacote de solução gerida é gerado ao criar a solução na configuração de versão. Estas definições podem ser substituídas especificando a propriedade SolutionPackageType no ficheiro cdsproj.
    • Pode definir a configuração msbuild para Versão emitir uma compilação de produção. Exemplo: msbuild /p:configuration=Release
    • Se encontrar um erro que diga "nome do projeto ambíguo" ao executar o comando msbuild na solução, certifique-se de que o nome da sua solução e o nome do projeto não são os mesmos.

  5. Os ficheiros de solução gerados estão localizados na pasta de \depuração\do bin\ (ou\versão\do bin) após o êxito da compilação.

  6. Pode utilizar as Ferramentas de Compilação do Microsoft Power Platform para automatizar a importação da solução para um ambiente Dataverse; caso contrário, poderá importar a solução para o Dataverse manualmente utilizando o portal Web.

Tarefas adicionais que pode efetuar com a estrutura e as soluções

Abaixo encontram-se hiperligações para tarefas comuns adicionais que pode efetuar quando trabalha com a estrutura e as soluções.

Consulte também

Plug-ins