Partilhar via

Utilizar o controlo Git version para editar aplicações de tela (experimental)

  • Artigo

[Este artigo inclui documentação pré-versão e está sujeito a alterações.]

Importante

  • Esta funcionalidade está a ser implemente e, consoante a sua região, poderá ainda não estar disponível para o seu inquilino. Verifique o interruptor experimental descrito em Ativar controlo de versões de Git para saber se a funcionalidade está disponível no seu inquilino.
  • Esta é uma funcionalidade experimental. Está desativado por predefinição e tem de ser ativado antes da utilização.
  • As funcionalidades experimentais não se destinam à produção e poderão ter funcionalidades restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Agora pode utilizar a caraterística experimental de controlo Git version para permitir que mais do que uma pessoa edite uma aplicação de tela ao mesmo tempo. Com esta funcionalidade, os outros utilizadores não ficarão bloqueados fora da aplicação enquanto uma pessoa a estiver a editar. À medida que as alterações são feitas e sincronizadas, são automaticamente unidas com as outras alterações e disponibilizadas para todas as outras a editar a aplicação.

O Git é utilizado como arquivo de reserva para esta funcionalidade. Após a configuração inicial com a ligação ao Git, qualquer utilizador poderá utilizar esta funcionalidade sem quaisquer passos de configuração extra, exceto para autenticar com o Git.

Qualquer fornecedor do Git pode ser utilizado com o Power Apps Studio - como o GitHub ou o Azure DevOps. Utilize as ferramentas do Git existentes para ver o histórico de versões, crie e faça a gestão dos pedidos de pull e execute outras tarefas de controlo de versões.

Nota

  • Antes de começar, certifique-se de que leu as limitações conhecidas desta funcionalidade. A utilização do Git está a evoluir e pode alterar a forma como esta funcionalidade funciona. Para atualizações e para partilhar os seus comentários sobre esta funcionalidade, viste o Fórum da comunidade do Power Apps.
  • O controlo de versões do Git é gerido numa base por aplicação. Cada aplicação tem ser adicionada individualmente ao controlo de versões do Git.
  • Depois de ativado o controlo git version, a caraterística Guardar automaticamente da sua aplicação será desativada. Terá de guardar ou sincronizar manualmente as alterações.

Ativar o controlo de versões do Git

Siga estes passos para ativar o controlo de versões do Git na sua aplicação.

  1. Crie uma nova aplicação ou abra uma aplicação existente que gostaria de adicionar ao controlo de versões do Git.

  2. Selecione Definições no Power Apps Studio.

  3. Selecione Próximas funcionalidades.

  4. Selecione Experimental.

  5. Desloque-se para baixo para Mostrar definição de controlo de versões do Git e mude-a para Ativado.

  6. Verá um novo item de Controlo de versões do Git no lado esquerdo do painel de definições.

    Mudar para ativar o Controlo de versões do Git.

    Dica

    Para qualquer outro problema com esta funcionalidade, visite o fórum da comunidade do Power Apps.

Ligar uma aplicação ao Git

Siga estes passos para ligar a sua aplicação ao Git.

  1. Selecione Definições no Power Apps Studio.

  2. Selecione Controlo de versões do Git.

    Botão para iniciar uma ligação ao Git para esta aplicação.

  3. Selecione Ligar e preencha as informações de ligação ao Git para esta aplicação.

    Caixas de entrada de texto para fornecer informações sobre a ligação ao Git.

    • URL do Repositório do Git: o URL que normalmente utilizaria com ferramentas do Git. Para o Azure DevOps, certifique-se de que inclui a parte /_git/repo do URL, tal como https://contoso.visualstudio.com/_git/repo.
    • Ramo: o nome do ramo a utilizar.
    • Diretório: o diretório no ramo a utilizar. Não é possível armazenar uma aplicação de tela na raiz do ramo.

    Ser-lhe-á solicitado que crie o ramo ou o diretório, se não existir. Se o ramo e o diretório já contiverem uma aplicação de tela, a aplicação atual será fechada e a aplicação existente será carregada a partir do Git.

    Uma vez estabelecida a ligação, serão apresentadas as informações de ligação.

Autenticar com o Git

O Power Apps exige a utilização de um token de acesso pessoal em vez da palavra-passe da conta de fornecedor de controlo de versões.

Nota

Um token de acesso pessoal não é o mesmo que a sua palavra-passe, seja para o Power Apps ou para o seu fornecedor do Git. Tem de criar um token de acesso pessoal para utilizar esta funcionalidade.

Diferentes fornecedores de controlo de versões têm diferentes métodos para gerar tokens de acesso pessoal. Siga abaixo as instruções para obter o token de acesso pessoal.

Quando edita as aplicações ligadas ao Git, é-lhe solicitado o nome de utilizador e a palavra-passe. Introduza o seu nome de utilizador e o token de acesso nesta caixa de diálogo para autenticar com o Git.

A caixa de diálogo solicita-lhe o nome de utilizador do Git e o token de acesso (como palavra-passe).

Nota

As credenciais do Git não são armazenadas pelo Power Apps entre sessões. Se pretende, pode utilizar as definições do browser para guardar as informações do formulário para reutilização para evitar a introdução de credenciais com frequência.

Fazer alterações à aplicação

Depois de uma aplicação estar ligada ao Git, tudo o que terá de fazer é autenticar com as credenciais do Git para abrir e editar a aplicação. Não é necessário analisar os conceitos do Git quando utiliza esta funcionalidade para carregar, editar, guardar, publicar e partilhar a aplicação.

Utilize o novo botão de sincronização na parte superior do ecrã do Studio (entre os botões Verificador de Aplicações e Anular) para unir quaisquer alterações atuais com o que está no Git, e para trazer o resultado para o Studio para edição posterior.

Botão para sincronizar as alterações com o repositório do Git.

Importante

A aplicação terá de ser carregada de cada vez que houver uma união. Se a aplicação for grande, este carregamento poderá demorar algum tempo.

Depois de ligado ao Git, as alterações são armazenadas no Git e não no Power Apps. As versões não publicadas não aparecerão no portal do criador do Power Apps.

Unir resultados

Atualmente, não há opção para resolver conflitos de união. O Studio tentará unir e corrigir os conflitos automaticamente através do conhecimento semântico da aplicação (por exemplo, os tipos de objetos e outras alterações de aplicações). Uma vez que todas as alterações ainda estão armazenadas no Git, pode sempre obter as alterações à aplicação para as reaplicar, caso a união automática não cumpra os requisitos do seu negócio.

Publicar a aplicação

As aplicações ligadas ao Git continuam a funcionar normalmente para publicação e a experiência de utilizador, sem alterações neste processo. Quando publica uma aplicação, a versão da aplicação é armazenada no Power Apps, uma vez que o Power Apps precisa de uma cópia executável da aplicação para partilhar com os utilizadores.

Pedidos Pull, histórico de visualizações, responsabilização e outras funcionalidades do Git

Trabalhar com pedidos Pull ou quaisquer outras operações do Git tem de ser feito através de outras ferramentas do Git, incluindo o Web site do fornecedor do Git. Não há uma opção disponível para executar estas operações do Git para solicitar ou emitir compromissos.

Cada operação para guardar ou sincronizar que inclua alterações resultará num compromisso no Git. Se tiverem ocorrido outras alterações no Git, por exemplo, por outros criadores, haverá compromissos adicionais para unir os resultados de todas as alterações. Não serão perdidas quaisquer alterações, mesmo que uma união defina manualmente uma edição. As alterações por cada criador são armazenadas no Git através de compromissos.

Limitações conhecidas

Uma vez que esta funcionalidade é experimental, agradecemos os seus comentários. São listadas as limitações conhecidas. Planeamos remover a maioria destas limitações nas versões futuras.

  • Esta funcionalidade não é compatível com os componentes de código. Não utilize esta caraterística com aplicações que utilizem componentes de código.
  • Esta caraterística não é compatível com repositórios Git no local. O repositório do Git tem de ser alojado na Web e estar acessível com o nome de utilizador e o token de acesso pessoal.
  • As edições à mesma propriedade no mesmo controlo não são unidas. A última edição feita vai ganhar.
  • Não pode restaurar uma aplicação de tela para uma versão anterior utilizando os passos descritos no artigo Restaurar uma aplicação. Em vez disso, terá de utilizar o Git para restaurar a aplicação para uma versão anterior. Para obter mais informações, consulte os seguintes recursos:
  • Ligar várias aplicações ao mesmo diretório Git pode causar problemas. Isto inclui fazer cópias da aplicação e exportá-las e importá-las.
  • Quaisquer ficheiros existentes no repositório com nomes com mais de 180 carateres de comprimento poderão causar problemas ao ligar. Recomendamos a utilização de um repositório dedicado para aplicações ligadas por Git.
  • A seleção de Fechar no menu Ficheiro poderá aparecer para eliminar as personalizações na aplicação. No entanto, as personalizações não são eliminadas. Atualize a página para ver novamente todas as personalizações.
  • Se abrir uma aplicação não ligada a Git (por exemplo, Aplicação A) a partir de uma aplicação ligada a Git (por exemplo, Aplicação B) (Ficheiro > Abrir) e tentar ligar a Aplicação A a um repositório, os parâmetros de controlo da versão Git da Aplicação A serão iguais aos da Aplicação B. Quando isto acontecer, atualize a sua página e, em seguida, tente ligar novamente a Aplicação A ao repositório.
  • Esta funcionalidade não suporta mudar o nome de componentes personalizados.
  • Se encontrar uma mensagem sobre a aplicação que está a ser aberta para edição por outro utilizador, peça ao utilizador referenciado para atualizar a aplicação. Posteriormente, atualize a aplicação para remover o bloqueio.
  • Esta caraterística não é compatível com Testes do Test Studio e páginas personalizadas para aplicações condicionadas por modelo
  • Esta caraterística não suporta a utilização de tokens de acesso pessoal que estão autorizados a utilizar com início de sessão único SAML.

Comentários ao fórum comunitário

Diga-nos o que pensa! Esta funcionalidade é um primeiro passo num longo percurso para permitir uma grande experiência de desenvolvimento de equipas. Visite o fórum comunitário do Power Apps para obter atualizações e fornecer comentários.