Início Rápido: Criar um aplicativo de código do zero usando a nova CLI do npm (versão prévia)

Começando com Power Apps biblioteca de clientes para aplicativos de código versão 1.0.4, a biblioteca de clientes inclui uma CLI baseada em npm para aplicativos de código. Essa nova CLI reduz os pré-requisitos para criar aplicativos de código e substitui os comandos da CLI do pac code Power Platform, que são preteridos em uma versão futura.

Este artigo mostra como instalar a biblioteca de clientes Power Apps para aplicativos de código, configurar um aplicativo em branco do Vite e convertê-lo em um aplicativo de código Power Apps usando os novos comandos da CLI baseada em npm.

Pré-requisitos

• Ambiente do Power Platform com aplicativos de código habilitados
• Node.js (versão lts)
• Git

Comandos

A CLI npm de aplicativos de código-fonte tem três comandos:

Comando	DESCRIÇÃO
init	Inicialize seu aplicativo de programação.
run	Inicia um servidor de desenvolvimento local.
push	Publica uma nova versão do aplicativo de código em seu ambiente.

Saiba como usar esses comandos seguindo as etapas deste artigo.

Etapa 1: Inicializar o projeto

Abra um terminal e execute o seguinte comando:

npx degit github:microsoft/PowerAppsCodeApps/templates/vite my-app
cd my-app

Saiba mais sobre o comando degit .

Etapa 2: instalar dependências e inicializar o aplicativo de código

Instale as dependências do projeto e a biblioteca cliente do Power Apps para aplicativos de código-fonte.

npm install

Inicialize seu aplicativo de programação. Você pode fornecer opções diretamente ou usar prompts interativos:

Opção A: modo interativo (a CLI solicita informações necessárias):

npx power-apps init

Opção B: passar as opções diretamente:

npx power-apps init --displayName "App From Scratch" --environmentId <Your environment ID>

Quando você executa o init comando, a CLI autentica você automaticamente. Entre usando sua conta do Power Platform quando solicitado.

Etapa 3: Testar localmente

Execute o aplicativo de código-fonte para desenvolvimento localmente:

npm run dev

Isso inicia um servidor de desenvolvimento local. Abra a URL rotulada Local Play.

Importante

Abra a URL no mesmo perfil de navegador que o tenant do Power Platform.

Observação

Restrições de Acesso à Rede Local

Desde dezembro de 2025, os navegadores Chrome e Microsoft Edge bloqueiam requisições de origens públicas para endpoints locais por padrão.

• Como seu aplicativo de código se conecta ao localhost durante o desenvolvimento, talvez seja necessário conceder permissão ao navegador ou configurar políticas empresariais.
• Para cenários inseridos, inclua allow="local-network-access" em tags iframe.
• Para obter mais informações, consulte Controle o acesso de um site à rede local no Microsoft Edge e o novo prompt de permissão para Acesso à Rede Local usando o Chrome.

Você deve ver o aplicativo aberto de forma semelhante a:

Compilar e implantar no Power Apps

Crie seu aplicativo e envie-o por push para seu ambiente de Power Apps:

npm run build
npx power-apps push

Detalhes do comando:

• npm run build – Executa scripts a partir de package.json. Executa tsc -b && vite build.
• npx power-apps push - Publica uma nova versão do aplicativo de código em seu ambiente.

Quando o comando for concluído com êxito, ele retornará uma URL Power Apps para executar o aplicativo.

Opcionalmente, vá para Power Apps para exibir, reproduzir, compartilhar ou examinar os detalhes do aplicativo.