Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
Comandos
A CLI npm de aplicativos de código tem quatro 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. |
find-dataverse-api |
Veja como adicionar uma ação ou função do Dataverse ao seu aplicativo de código |
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 de clientes Power Apps para aplicativos de código:
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 --display-name "App From Scratch" --environment-id <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 solicitações de origens públicas para pontos de extremidade 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:
Criar e publicar 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 depackage.json. Executatsc -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.