Exibir arquivos de código-fonte para aplicativos de tela

Use o código-fonte de um aplicativo de tela para revisar as alterações feitas pelos criadores no Power Apps Studio. O código YAML do aplicativo de tela gerado é somente leitura e não pode ser modificado. Quaisquer alterações no arquivo são ignoradas e podem ser perdidas.

• O esquema YAML está em desenvolvimento ativo e o conteúdo pode estar incompleto.
• O esquema estático atual para arquivos *.pa.yaml está disponível aqui.

O Power Fx e i YAML são as linguagens usadas para o código-fonte do Power Apps. O YAML é valorizado por seu formato legível por humanos e se beneficia de uma ampla gama de editores, ferramentas e bibliotecas para manipulação.

Acessar arquivos de código-fonte

Você terá acesso aos arquivos de código-fonte se estiver usando a Integração Git do Power Platform, eliminando a necessidade de arquivos .msapp.

O Power Apps Studio cria o código-fonte para aplicativos de tela, que é armazenado como arquivos *.pa.yaml dentro do arquivo . msapp. O arquivo .msapp é um arquivo binário que contém uma coleção de arquivos, incluindo o código-fonte.

Você também pode obter os arquivos de código-fonte do arquivo .msapp ou usando a CLI do Power Platform.

Os arquivos *.pa.yaml podem ser encontrados na pasta \Src do .msapp extraído.

Baixar e extrair os arquivos pa.yaml usando a CLI do Power Platform

Conecte-se ao seu ambiente usando a CLI do Power Platform e use os seguintes comandos:

1. Para listar os aplicativos de tela em seu ambiente atual, use o comando: pac canvas list.
2. Para extrair os arquivos de código-fonte, use o comando: pac canvas download com o parameter -d.

Extrair arquivos de código-fonte de um arquivo .msapp

Para extrair arquivos de código-fonte de um arquivo .msapp, você tem duas opções:

1. Descompacte manualmente o arquivo .msapp.
2. Como alternativa, você pode usar o seguinte comando:

 Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"

Estrutura de um arquivo .msapp

Para arquivos .msapp anteriores sem a pasta \src, siga estas etapas para gerar arquivos de código-fonte:

1. Importe, salve novamente e baixe o .msapp novo no Power Apps Studio.
2. Depois disso, você poderá prosseguir para extrair os arquivos de código-fonte.

Na pasta \src, encontre os seguintes arquivos e pastas:

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

Somente arquivos *.pa.yaml dentro da pasta \src podem ser usados como código-fonte. Qualquer outro arquivo não deve ser usado como código-fonte.

Versões de esquema do YAML do Power Apps

Atualmente, a única versão de esquema ativa do código-fonte do Power Apps é o Código-Fonte (*.pa.yaml). A tabela a seguir mostra os outros formatos históricos:

Formato experimental (*.fx.yaml)

Esse esquema foi desativado.

Esse esquema descreve um formato experimental usado pelo Power Platform CLI para processar e converter aplicativos tela em um formato de código-fonte. Esse formato não é mais desenvolvido ativamente.

Você não pode converter diretamente arquivos *.fx.yaml nos novos formatos. Para converter aplicativos mais antigos, empacote o aplicativo de tela como um arquivo msapp e importe-o para o Power Apps Studio.

Versão Prévia

Esse esquema foi desativado.

Essa versão foi usada pela vista de código durante o período de pré-visualização. Ela foi projetada para criar aplicativos de tela no Power Apps Studio, permitindo que você copie e cole controles facilmente. Nesta versão, o código-fonte é usado no Power Apps Studio, em vez de ser convertido, como o formato experimental.

O formato durante a versão preliminar era temporário e não está mais em uso. Não é possível colar o código do formato de visualização.

Aqui estão as mudanças feitas a partir do formato experimental:

1. Remoção da propriedade ZIndex: a propriedade ZIndex é removida. Em vez disso, uma tela é representada como uma matriz de controles. A ordem dos controles determina sua ordem de empilhamento. Os controles normais são ordenados em ordem crescente, enquanto os controles responsivos são ordenados em ordem decrescente.
2. Substituição da representação de objeto JSON: a sintaxe "As" não é mais usada para definir o tipo de controle. Em vez disso, o lado esquerdo do identificador de nome do controle permanece exclusivo. Somente as propriedades que diferem dos valores padrão são serializadas. Duas novas propriedades definem o tipo de controle e os valores padrão:

• Controle: representa o tipo de controle em YAML.
• Variante: identifica uma variante de um tipo de controle, que pode alterar valores de propriedade padrão, adicionar ou remover propriedades ou modificar o comportamento ou o layout do controle.

Essas propriedades são usadas para instanciar controles e não aceitam expressões do Power Fx.

Código-fonte (*.pa.yaml)

Esse esquema é projetado para fins de controle do código-fonte e permite o uso de um único arquivo YAML.

As atualizações do formato anterior incluem:

1. Agrupamento dos elementos do nó de nível superior:
   • As palavras-chave de nível superior "Aplicativo" e "Telas" são exemplos de como os elementos agora são agrupados em um nó de nível superior.
2. Especificação da versão de controle:
   • Agora você pode especificar a versão de um controle usando a palavra-chave Controle seguida do operador @. Se nenhuma versão for especificada, a versão mais atual do controle será usada. A versão é usada para desserializar as propriedades do código-fonte. A versão de tempo de execução do controle é definida pela versão de criação.
3. Nomes de variante simplificados:
   • Nem todos os controles exigem uma variante.
4. ZIndex consistente para todos os controles:
   • Todos os controles agora usam uma ordem crescente para determinar o valor ZIndex, começando em 1. Esse comportamento se alinha com a especificação CSS 2.