Compartilhar via

Usar o controle de versão Git para editar aplicativos de tela (experimental)

  • Artigo

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Importante

  • Este recurso está sendo implementado e, dependendo da sua região, pode ainda não estar disponível para o seu locatário. Verifique a opção experimental descrita em Habilitar controle de versão do Git para saber se o recurso está disponível no seu locatário.
  • Este é um recurso experimental. Ele é desabilitado por padrão e deve ser habilitado antes do uso.
  • Os recursos experimentais não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Você pode usar o recurso experimental de controle de versão do Git para permitir que mais de uma pessoa edite um aplicativo de tela ao mesmo tempo. Com esse recurso, outras pessoas não serão bloqueadas do aplicativo enquanto uma pessoa o estiver editando. Conforme as alterações são feitas e sincronizadas, elas são automaticamente mescladas com outras alterações e disponibilizadas para todas as outras pessoas que estiverem editando o aplicativo.

O Git é usado como o repositório de backup deste recurso. Após a configuração inicial com a conexão ao Git, qualquer usuário pode utilizar este recurso sem nenhuma etapa de configuração extra, exceto para autenticar com o Git.

Qualquer provedor de Git pode ser usado com o Power Apps Studio, como o GitHub ou o Azure DevOps. Use as ferramentas de Git existentes para ver o histórico de versões, criar e gerenciar solicitações de pull e realizar outras tarefas de controle de versão.

Observação

  • Antes de começar, leia as limitações conhecidas deste recurso. O uso do Git está evoluindo e pode mudar a forma como esse recurso funciona. Para obter atualizações e compartilhar seus comentários sobre este recurso, visite o fórum da comunidade do Power Apps.
  • O controle de versão do Git é gerenciado por aplicativo. Cada aplicativo deve ser adicionado individualmente ao controle de versão do Git.
  • Depois que o controle de versão do git estiver ativado, o salvamento automático do seu aplicativo será desativado. Você terá que salvar ou sincronizar manualmente suas alterações.

Habilitar controle de versão do Git

Siga estas etapas para habilitar o controle de versão do Git no seu aplicativo.

  1. Crie um novo aplicativo ou abra um aplicativo existente que você gostaria de adicionar ao controle de versão do Git.

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

  3. Selecione Recursos futuros.

  4. Selecione Experimentais.

  5. Role para baixo até Mostrar a configuração de controle de versão do Git e defina-o como Ativado.

  6. Você verá um novo item Controle de versão do Git no lado esquerdo do painel de configurações.

    Alternar para habilitar o controle de versão do Git.

    Dica

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

Conectar um aplicativo ao Git

Siga estas etapas para conectar seu aplicativo ao Git.

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

  2. Selecione Controle de versão do Git.

    Botão para iniciar uma conexão com o git para este aplicativo.

  3. Selecione Conectar e preencha as informações de conexão do Git para este aplicativo.

    Caixas de entrada de texto para fornecer informações de conexão do git.

    • URL do Repositório Git: a URL que você normalmente usaria com ferramentas de Git. Para o Azure DevOps, inclua a parte /_git/repo da URL, como. por exemplo, https://contoso.visualstudio.com/_git/repo.
    • Ramificação: o nome da ramificação a ser usada.
    • Diretório: o diretório dentro da ramificação a ser usada. Você não pode armazenar um aplicativo de tela na raiz da ramificação.

    Você será solicitado a criar a ramificação ou o diretório, caso ainda não exista. Se a ramificação e o diretório já contiverem um aplicativo de tela, o aplicativo atual será fechado e o aplicativo existente será carregado do Git.

    Depois de conectado, as informações de conexão serão exibidas.

Autenticar com o Git

O Power Apps requer que você use um token de acesso pessoal em vez da senha da conta do provedor de controle de versão.

Observação

Um token de acesso pessoal não é igual à sua senha, seja do Power Apps ou do seu provedor de Git. Você deve criar um token de acesso pessoal para usar este recurso.

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

Durante a edição de aplicativos conectados ao Git, será solicitado o nome de usuário e a senha. Insira seu nome de usuário e o token de acesso nesta caixa de diálogo para autenticar com o Git.

A caixa de diálogo solicita o nome de usuário e o token de acesso (como senha) do Git.

Observação

As credenciais do Git não são armazenadas pelo Power Apps entre as sessões. Se desejar, você pode usar as configurações do navegador para salvar as informações do formulário para reutilização, evitando a inserção frequente de credenciais.

Fazer alterações no aplicativo

Depois que um aplicativo é conectado ao Git, tudo o que você precisa fazer é a autenticação com as credenciais do Git para abrir e editar esse aplicativo. Você não precisa revisar os conceitos do Git ao usar este recurso para carregar, editar, salvar, publicar e compartilhar o aplicativo.

Use o novo botão de sincronização na parte superior da tela do Studio (entre os botões Verificador de Aplicativo e Desfazer) para mesclar quaisquer alterações atuais com o que está no Git e trazer o resultado para o Studio para edição adicional.

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

Importante

O aplicativo precisará ser carregado sempre que houver uma mesclagem. Se o aplicativo for grande, esse carregamento pode levar algum tempo.

Depois de conectado ao Git, as alterações são armazenadas no Git em vez do Power Apps. Versões não publicadas não aparecerão no portal do criador do Power Apps.

Mesclar resultados

No momento, não há nenhuma opção para resolver conflitos de mesclagem. O Studio tentará mesclar e corrigir conflitos automaticamente por meio do conhecimento semântico do aplicativo (por exemplo, os tipos de objetos e outras alterações no aplicativo). Como todas as alterações ainda estão armazenadas no Git, você sempre pode recuperar as alterações no aplicativo para reaplicá-las se a mesclagem automática não atender aos seus requisitos de negócios.

Publicar o aplicativo

Os aplicativos conectados ao Git continuam funcionando normalmente para publicação e experiência do usuário, sem alterações nesse processo. Quando você publica um aplicativo, a versão dele é armazenada no Power Apps, pois o Power Apps precisa de uma cópia executável do aplicativo para compartilhar com os usuários.

Solicitações de pull, histórico de exibição, responsabilização e outros recursos do Git

O trabalho com solicitações de pull ou qualquer outra operação de Git deve ser feito por meio de outras ferramentas de Git, incluindo o site do provedor de Git. Não há nenhuma opção disponível para executar essas operações de Git para confirmações de pull ou push.

Todo salvamento ou sincronização que incluir alterações resultará em uma confirmação no Git. Se outras alterações tiverem ocorrido no Git, por exemplo por outros criadores, serão feitas confirmações adicionais para mesclar os resultados de todas as alterações. Nenhuma alteração será perdida, mesmo se uma mesclagem substituir uma edição. As alterações feitas por cada criador são armazenadas no Git por meio de confirmações.

Limitações conhecidas

Como este recurso é experimental, seus comentários são bem-vindos. A seguir, veja as limitações conhecidas. Planejamos remover a maioria dessas limitações em versões futuras.

  • Este recurso não é compatível com componentes de código. Não use este recurso com aplicativos que fazem uso de componentes de código.
  • Este recurso não é compatível com repositórios Git locais. O repositório Git deve ser hospedado na Web e acessado com nome de usuário e token de acesso pessoal.
  • As edições na mesma propriedade no mesmo controle não são mescladas. A última edição feita vencerá.
  • Você não pode restaurar um aplicativo de tela para uma versão anterior usando as etapas descritas no artigo Restaurar um aplicativo. Em vez disso, você terá que usar o Git para restaurar o aplicativo para uma versão anterior. Para obter mais informações, consulte os seguintes recursos:
  • Conectar vários aplicativos ao mesmo diretório git pode causar problemas. Isso inclui fazer cópias do seu aplicativo e exportá-las e importá-las.
  • Quaisquer arquivos existentes no repositório com nomes que excedam 180 caracteres em tamanho podem causar problemas na conexão. Recomendamos usar um repositório dedicado para aplicativos conectados ao Git.
  • Selecionar Fechar no menu Arquivo pode parecer excluir suas personalizações no aplicativo. No entanto, as personalizações não são excluídas. Atualize a página para ver todas as personalizações novamente.
  • Se você abrir um aplicativo não conectado ao git (por exemplo, Aplicativo A) dentro de um aplicativo conectado ao git (por exemplo, Aplicativo B) (Arquivo > Abrir) e tentar conectar o Aplicativo A a um repositório, os parâmetros de controle de versão do git do Aplicativo A serão os mesmos do Aplicativo B. Quando isso acontecer, atualize sua página e tente conectar o Aplicativo A ao repositório novamente.
  • Esse recurso não oferece suporte à renomeação de componentes personalizados.
  • Se você vir uma mensagem sobre o aplicativo sendo aberto para edição por outro usuário, peça ao usuário referenciado para atualizar o aplicativo. Depois, atualize seu aplicativo para remover o bloqueio.
  • Este recurso não é compatível com testes do Test Studio e páginas personalizadas para aplicativos baseados em modelo
  • Esse recurso não oferece suporte ao uso de tokens de acesso pessoal autorizados para uso com logon único SAML.

Comentários para o fórum da comunidade

Queremos ouvir sua opinião! Este recurso é a primeira etapa de uma longa jornada para possibilitar uma ótima experiência de desenvolvimento em equipe. Visite o fórum da comunidade do Power Apps para obter atualizações e fornecer comentários.