Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O ALM (Gerenciamento do Ciclo de Vida do Aplicativo) é o processo de gerenciamento do ciclo de vida de um aplicativo desde o planejamento inicial por meio do desenvolvimento, implantação e manutenção contínua. O ALM para aplicativos de código baseia-se nos mesmos princípios usados em toda a Plataforma Power, estendendo-os a cenários em que o código personalizado faz parte da solução.
Para aplicativos de código, o ALM garante:
- Consistência entre ambientes: mova os aplicativos diretamente do desenvolvimento para a produção.
- Governança e conformidade: impor padrões organizacionais e políticas de segurança.
- Implantações previsíveis: reduza o risco e melhore a confiabilidade.
Pré-requisitos
- Um aplicativo de código inicializado do Power Apps. Confira o Início Rápido: Criar um aplicativo de código usando a CLI do Power Apps.
- Power Apps CLI instalada. Verifique se você tem a versão mais recente.
- Para adicionar o aplicativo a uma solução, é necessário um ambiente do Power Platform com Dataverse. Em ambientes sem o Dataverse, o aplicativo publica sem uma solução.
Publique em uma solução
A CLI do Power Apps pode colocar automaticamente seu aplicativo dentro de uma solução do Dataverse ao executarpa app push.
Colocar um aplicativo em uma solução o torna portátil entre ambientes por meio do ALM padrão. Quando você exporta a solução de um ambiente e a importa para outro, o aplicativo se move com ela.
É possível:
- Permitir que a CLI selecione uma solução automaticamente na primeira publicação.
- Direcione para uma solução específica pela ID em qualquer publicação.
- Publicar em um ambiente sem o Dataverse. O aplicativo publica sem uma solução.
O comportamento é idêntico se você executar o comando interativamente ou em um pipeline de CI/CD.
Publicar com seleção automática de solução
Execute o comando na raiz do seu projeto de aplicativo de código:
pa app push
A CLI relata qual solução usa ou explica por que publica o aplicativo sem uma.
Publicar em uma solução específica
Use a opção --solution-id para direcionar uma solução específica:
pa app push --solution-id <solution-id>
| Opção | Alias | Obrigatório | Description |
|---|---|---|---|
--solution-id |
-s |
Não | A ID (GUID) da solução à qual adicionar o aplicativo. Você também pode defini-lo com a variável de SOLUTION_ID ambiente. Se você omitir essa opção, a CLI selecionará uma solução automaticamente. |
Para localizar uma ID da solução:
Vá para Power Apps.
Abra soluções e selecione sua solução.
Copie a ID da solução da URL:
https://make.powerapps.com/environments/<environment-id>/solutions/<solution-id>/overview
Como funciona a seleção automática de solução
Quando você omite --solution-id, o comportamento da CLI depende se essa é a primeira publicação do aplicativo ou uma publicação subsequente.
Primeira publicação
Quando o aplicativo não existe no ambiente, a CLI resolve uma solução de destino nesta ordem:
Solução preferencial: se o ambiente tiver o Dataverse habilitado, a CLI usará a solução preferencial. Se você não definir explicitamente um, o Dataverse usará a Solução Padrão do Common Data Service.
Dica
Para o ALM previsível, defina uma solução preferencial para o ambiente. A primeira publicação adiciona aplicativos de código à solução esperada sem exigir
--solution-id.Solução padrão: se nenhuma solução preferencial estiver disponível, a CLI usará a solução padrão de todos os componentes.
Nenhuma solução: se o Dataverse não estiver habilitado ou nenhuma solução puder ser resolvida, o aplicativo publicará sem uma solução.
Publicações posteriores
Quando o aplicativo já existir:
-
Sem
--solution-id: a CLI não altera a associação de solução existente do aplicativo. -
Com
--solution-id: a CLI adiciona o aplicativo a essa solução. Você pode adicionar um aplicativo existente a outra solução em qualquer publicação.
Direcionar uma solução específica explicitamente
A passagem --solution-id tem precedência sobre a seleção automática:
pa app push --solution-id <solution-id>
A CLI valida a ID da solução antes de carregar:
| Problema | Resultado |
|---|---|
| O valor não é um GUID | O comando interrompe e relata que a ID da solução não é válida. |
| A solução não existe no ambiente | O comando interrompe e relata que não consegue encontrar a solução. |
| O ambiente não tem o Dataverse | O comando para e direciona você a publicar novamente sem --solution-id. |
Adicionar a uma solução no Power Apps
Se você já tiver publicado seu aplicativo de código em um ambiente compa app push, adicione-o a uma solução em Power Apps:
- Vá para Power Apps.
- Navegue até Soluções.
- Selecione a solução.
- Selecione Adicionar existente>App>Code app e selecione o app que deseja adicionar.
Use o direcionamento por solução em CI/CD
Para especificar uma solução em um pipeline de compilação, defina a variável de ambiente SOLUTION_ID:
SOLUTION_ID=<solution-id> pa app push
Esse comportamento é determinístico, nãointerativo e idêntico à publicação local.
Implantar usando pipelines
Depois de adicionar o aplicativo a uma solução, use o Power Platform Pipelines para implantar entre estágios (Des. → Teste → Prod.) com verificações de pré-lançamento para dependências, referências de conexão e muito mais.
Saiba como usar pipelines no Power Platform.
Use referências de conexão no seu aplicativo de código
Para obter informações sobre referências de conexão, consulte Usar referências de conexão para adicionar uma fonte de dados.
Limitações
Neste momento, aplicativos de código:
- Exija uma ID de solução (GUID) quando você tiver como destino explicitamente uma solução. Nomes de soluções não são aceitos.
- Não dê suporte à integração de código-fonte.