Criar e desenvolver um componente de código

Este artigo mostra como criar e compilar um componente de código usando Microsoft Power Platform CLI. Use estas etapas para configurar um projeto de componente, instalar suas dependências e compilá-lo para que você possa empacotá-lo e importá-lo para o Microsoft Dataverse.

Pré-requisitos

Instale os seguintes componentes:

1. Visual Studio Code (VSCode) (Verifique se você selecionou a opção Adicionar ao PATH)
2. node.js (use a versão LTS)
3. Microsoft Power Platform CLI (utilize a extensão do Visual Studio Code)

Criar um novo projeto de componente de código

Abra o Visual Studio Code e abra uma nova janela de terminal selecionando Terminal>Novo Terminal.

1. Na janela do terminal, crie uma nova pasta no computador local, por exemplo, C:\projects\My_code_Component usando o comando mkdir <Specify the folder name>.

2. Vá para a pasta recém-criada usando o comando cd <specify your new folder path>.

3. Crie um novo projeto de componente usando o comando pac pcf init . Este exemplo cria um field componente nomeado SampleComponent no Contoso namespace:

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

4. O comando anterior também executa o npm install comando para recuperar todas as dependências de projeto necessárias.

5. Abra sua pasta C:\projects\My_code_Component de projeto em qualquer ambiente de desenvolvedor de sua escolha e comece a desenvolver seus componentes de código. A maneira mais rápida de começar é executando code . no prompt de comando quando você estiver no C:\projects\My_code_Component diretório. Esse comando abre seu projeto de componente no Visual Studio Code.

6. Implemente os artefatos necessários para o componente, como manifesto, lógica de componente e estilo e, em seguida, crie o projeto de componente. Para obter mais informações, consulte Criar seu primeiro componente de código.

Criar o componente de código

Para criar o projeto de componente, abra a pasta de projeto que contém package.json no Visual Studio Code. Use o comando Ctrl+Shift+B e selecione as opções de build.

Como alternativa, você pode criar rapidamente o componente usando o npm run build comando na janela do terminal do Visual Studio Code para fins de desenvolvimento. Para criar uma versão de lançamento, use npm run build -- --buildMode production.

Dica

Para depurar o componente durante ou após a operação de build, consulte Depurar um componente de código.

Quando terminar de implementar a lógica do componente no TypeScript, agrupe todos os elementos de código do componente em um arquivo de solução. Você pode importar esse arquivo de solução para Microsoft Dataverse. Para obter mais informações, consulte Empacotar um componente de código.

Consulte também

Depurar componentes de código
Empacotar um componente de código
Adicionar componentes de código a uma coluna ou tabela
Referência da API da estrutura de componentes do Power Apps
visão geral da estrutura de componentes Power Apps