Ferramentas de componentes de Power Apps

Ao criar um componente de código do Power Apps, você usará uma combinação de ferramentas para agilizar as etapas necessárias do início ao fim.

Vamos conferir algumas das ferramentas que usamos.

Power Platform CLI

A Power Platform CLI (interface de linha de comando) é uma ferramenta de linha de comando voltada para o desenvolvedor que fornece comandos para a criação de código personalizado. Atualmente, isso inclui componentes de código e plug-ins. A ferramenta também possui comandos de ambiente admin disponíveis para gerenciamento de ambientes. Também é possível usar os comandos solution e package para implementar o gerenciamento do ciclo de vida do aplicativo com soluções.

A CLI tem apenas algumas etapas para instalação. É possível confirmar se você tem a versão mais recente usando o seguinte comando de atualização:

pac install latest

Ao começar a criar o componente de código, você usará a CLI para criar a base de seus arquivos iniciais usando um modelo. O comando a seguir é um exemplo de inicialização de um componente usando o modelo de campo:

pac pcf init --namespace Contoso --name Slider --template field

Um dos pré-requisitos para instalar a CLI é instalar o node package manager (npm). Você usa o npm para gerenciar dependências e criar seu componente de código. Quando você usa o comando init, ele cria um arquivo package.json configurado com as dependências do componente de código e vários comandos, como build, que é usado durante o desenvolvimento do componente. O primeiro comando npm que será executado após a inicialização do componente será install. Esse comando baixa todas as bibliotecas necessárias para dar suporte à Power Apps component framework.

npm install

Você também pode solicitar que, quando a inicialização for executada, ele também execute a instalação do npm adicionando --run-npm-install às opções do comando init.

pac pcf init --namespace Contoso --name Slider --template field --run-npm-install

Ao desenvolver seu componente de código, você pode verificar se há problemas de código usando o seguinte comando build:

npm run build

Esse comando valida seu manifesto, executa o transpilador TypeScript e informa sobre quaisquer problemas.

Um agente de teste também está disponível para que você possa testar seu componente de código localmente sem precisar implantá-lo em um ambiente. É possível iniciar o agente de teste com o componente de código usando o seguinte comando start:

npm start

Você também pode habilitar o modo de observação usando o comando npm start watch. Se você fizer alterações no seu código no modo de inspeção, o agente de teste vai selecioná-las automaticamente sem reiniciar.

Para agilizar o teste de componentes de código, a CLI pode realizar a autenticação em seu ambiente de desenvolvimento e enviar por push seu componente de código para teste em aplicativos reais. O comando a seguir cria e envia por push a versão mais recente de seu componente de código para o ambiente de desenvolvimento do Dataverse configurado no momento.

pac pcf push --publisher-prefix dev

Ferramentas para o Visual Studio Code

A extensão Power Platform do Visual Studio Code traz a CLI (Interface de linha de comando) do Power Platform para funcionar no contexto do ambiente do editor. Você pode instalar a extensão por meio do Visual Studio Marketplace. Depois de instalada, você pode usar o comando CLI pac na janela de terminal.

Ferramentas para o Visual Studio

Essas ferramentas são instaladas por meio da instalação autônoma ou como parte da instalação do Visual Studio. É possível encontrá-las no Download do Visual Studio 2022 para Windows e Mac .

O comando MSBuild é usado quando você empacota seu componente como parte de uma solução do Power Apps para implantação em um ambiente do Dataverse. Por exemplo, os comandos a seguir inicializam uma nova solução para seu componente e criam um arquivo de projeto msbuild que gerencia a criação dos arquivos de solução de saída durante uma compilação.

pac solution init --publisher-name Contoso --publisher-prefix contoso ‑‑outputDirectory vssolution

Para que seu componente de código seja empacotado na solução, você deve adicionar uma referência ao componente. Isso garante que, quando uma compilação for executada, seu componente seja incluído na solução de saída gerada. O comando a seguir adiciona a referência:

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

Você pode usar o comando msbuild para gerar os arquivos de solução com as referências de solução configuradas. O seguinte comando executa a compilação pela primeira vez:

msbuild /t:build /restore

Após a primeira compilação, você pode executar o comando msbuild para regenerar os arquivos da solução. Os arquivos de solução gerados estão localizados na pasta \bin\debug\ (ou \bin\release) após a compilação ser bem-sucedida. Assim que o arquivo zip de saída estiver pronto, você poderá importar a solução para o Dataverse manualmente ou implantá-la automaticamente usando as Microsoft Power Platform Build Tools.

Escolher um IDE

Recomendamos usar o Visual Studio Code ou o Visual Studio para escrever seus componentes. Porém, você pode usar qualquer IDE de sua escolha para criar componentes de código personalizados do Power Apps.