Compartilhar via

Controle do código-fonte para aplicativos de tela

Criadores e desenvolvedores usam a integração do Git no Power Platform para gerenciar o código-fonte de aplicativos de tela de forma eficaz usando o controle de versão. Este recurso ajuda você a revisar as alterações feitas pelos criadores no Power Apps Studio sem encontrar diferenças confusas. Além disso, ele permite que edições mínimas sejam feitas diretamente no repositório, garantindo um fluxo de trabalho simplificado e eficiente.

Como confirmar aplicativos de tela usando a integração com o Git

Você pode confirmar seus aplicativos de tela ao publicá-los. As alterações não estarão disponíveis para confirmação até que você publique seu aplicativo. Esse comportamento garante que o código-fonte reflita a versão publicada mais recente do seu aplicativo, deixando-o pronto para uso com a integração do Git.

Etapas para confirmar aplicativos de tela

  1. Abra o Power Apps Studio e faça alterações no seu aplicativo de tela.
  2. Publique o aplicativo para disponibilizar as alterações para integração com o Git.
  3. Navegue até seu repositório do Git e confirme as alterações.

Acessando arquivos de código-fonte

O código-fonte dos aplicativos de tela é armazenado em arquivos .pa.yaml. Esses arquivos são legíveis por humanos e projetados para uso com controle do código-fonte. Quando você usa a integração com o Git, o código-fonte dos aplicativos de tela fica automaticamente disponível no repositório sem exigir nenhuma conversão. O código-fonte é armazenado na pasta canvas no repositório.

Estrutura de arquivo para aplicativos de tela

Os arquivos de código-fonte extraídos estão localizados na pasta \Src e incluem:

  • App.pa.yaml: representa o aplicativo.
  • [screen Name].pa.yaml: um arquivo para cada tela, representando a tela.
  • \Component: uma pasta que contém um arquivo para cada componente, representado como [component Name].pa.yaml.

Use apenas arquivos .pa.yaml dentro da pasta \Src com controle do código-fonte. Não use outros arquivos, como arquivos JSON, como código-fonte porque eles não são estáveis entre os ciclos de salvamento e carregamento.

Editando arquivos .pa.yaml

Você pode fazer pequenas edições diretamente no repositório. Todas as alterações são restauradas com o aplicativo quando você aplica alterações no seu ambiente. Você deve considerar qualquer código em sua ramificação como um aplicativo publicado.

Melhores práticas para edição

  • Evite fazer alterações significativas diretamente nos arquivos .pa.yaml.
  • Sempre teste as alterações em um ambiente de desenvolvimento antes de mesclá-las na ramificação principal.

Limitações conhecidas

Você não poderá editar os .pa.yaml arquivos diretamente no repositório se o aplicativo contiver componentes de código.

Editar arquivos com esses componentes impede a execução do aplicativo. Se você alterar esses arquivos por engano, poderá carregar a versão anterior do seu aplicativo de tela no Maker portal.

Solução de Problemas

Esta seção contém problemas comuns e dicas para ajudar você a ter mais sucesso usando a integração do Git com aplicativos de tela.

Problemas comuns

  • Mesclar conflitos: resolva os conflitos com cuidado para evitar corromper os arquivos .pa.yaml.
  • O aplicativo falha ao carregar: certifique-se de que nenhuma edição não suportada tenha sido feita nos arquivos .pa.yaml.

Dicas

  • Use um cliente de Git com ferramentas de comparação visual para revisar as alterações antes de confirmá-las.
  • Faça backup regularmente do seu repositório para evitar perda de dados.

Próximas etapas

  • Last updated on