Partilhar via


Controlo de código fonte para aplicações de tela

Criadores e desenvolvedores usam a integração do Git para Power Platform para gerir o código-fonte das aplicações de tela de forma eficaz usando o controlo de versão. Esta funcionalidade ajuda-o a rever as alterações feitas pelos criadores no Power Apps Studio sem encontrar diferenças ruidosas. Além disso, permite que edições mínimas sejam feitas diretamente no repositório, garantindo um fluxo de trabalho simplificado e eficiente.

Como confirmar aplicações de tela usando a integração do Git

Pode confirmar as suas aplicações de tela ao publicá-los. As alterações não estão disponíveis para confirmação até que publique a sua aplicação. Este comportamento garante que o código-fonte reflita a versão publicada mais recente da sua aplicação, tornando-o pronto para uso com a integração do Git.

Passos para confirmar aplicações de tela

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

Acede a ficheiros de código-fonte

O código-fonte das aplicações de tela é armazenado em .pa.yaml ficheiros. Esses ficheiros são legíveis por humanos e projetados para uso com controlo de código fonte. Quando usa a integração Git, o código-fonte para aplicações de tela fica automaticamente disponível no repositório sem exigir qualquer conversão. O código-fonte é armazenado dentro da pasta canvas no repositório.

Estrutura de ficheiros para aplicações de tela

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

  • App.pa.yaml: Representa a aplicação.
  • [screen Name].pa.yaml: Um ficheiro para cada ecrã, representando o ecrã.
  • \Component: Uma pasta contendo um ficheiro para cada componente, representado como [component Name].pa.yaml.

Utilize apenas ficheiros .pa.yaml dentro da pasta \Src com controlo de código fonte. Não use outros ficheiros, como arquivos JSON, como código-fonte porque não são estáveis entre os ciclos de gravação e carregamento.

Edição de ficheiros .pa.yaml

Pode fazer pequenas edições diretamente no repositório. Todas as alterações são restauradas com a aplicação quando solicita alterações para o seu ambiente. Deve considerar qualquer código no seu ramo como uma aplicação publicada.

Melhores práticas para edição

  • Evite fazer alterações significativas diretamente nos ficheiros .pa.yaml.
  • Teste sempre as alterações num ambiente de desenvolvimento antes de fundi-las no ramo principal.

Limitações conhecidas

Não é possível editar os .pa.yaml arquivos diretamente no repositório se o aplicativo contiver componentes de código.

A edição de ficheiros com esses componentes impede que a aplicação seja executada. Se alterar esses ficheiro por engano, poderá carregar a versão anterior da sua aplicação de tela no Maker Portal.

Resolução de Problemas

Esta secção contém problemas comuns e sugestões para ajudá-lo a ter mais sucesso usando a integração do Git com aplicações de tela.

Problemas comuns

  • Unir conflitos: resolva conflitos cuidadosamente para evitar corromper os ficheiros .pa.yaml.
  • A aplicação não é carregada: Certifique-se de que nenhuma edição não suportada foi feita nos ficheiros .pa.yaml.

Sugestões

  • Utilize um cliente Git com ferramentas de comparação visual para rever as alterações antes de confirmar.
  • Faça regularmente cópias de segurança do seu repositório para evitar a perda de dados.

Próximos passos