Como gerenciar projetos com o GIR

A integração do GIT no Studio requer o pacote redistribuível do Microsoft Visual C++ para Visual Studio 2015, 2017, 2019 e 2022. Verifique a página Requisitos de software.

Autenticação para o GIT

Os métodos de autenticação no Studio diferem de acordo com os métodos usados para clonar um repositório do GIT, seja ele o HTTPS ou o SSH. Verifique esta página para ver qual você deve usar se estiver trabalhando com o GitHub.

Observação:

• As credenciais do GIT que você fornecer no Studio ficam armazenadas no Gerenciador de Credenciais do Windows.
• A integração do GIT com o Studio atualmente só oferece suporte à autenticação de dois fatores para o GitHub se você se autenticar fazendo login no serviço. Para outras ferramentas, use o método de autenticação SSO com um token pessoal, ou o método de autenticação básica de acesso.

O guia atual detalha os passos de autenticação para um repositório do GitHub, mas a integração do GIT no Studio não fica limitada somente a este serviço.

No HTTPS

Ao clonar um repositório remoto do GIT ou copiar o projeto atual para um repositório existente do GIT usando o HTTPS pela primeira vez, é necessário fornecer suas credenciais do GIT. Essas credenciais devem ser inseridas nos campos Usar Credenciais:

Você pode se autenticar usando as seguintes opções:

• Entrar com o GitHub — entre com sua conta do GitHub.
• Usuário/senha — insira seu usuário e senha.

• Token — insira seu usuário e token de acesso pessoal.

  Siga as etapas detalhadas nesta página para gerar um token GIT para seu repositório do GitHub.

  Importante: a opção Entrar com o GitHub está disponível apenas para os repositórios hospedados em github.com e exige que o aplicativo UiPath GitHub esteja instalado em sua organização ou conta.

Sobre o SSH

Ao clonar um repositório ou copiar o projeto atual para um repositório do GIT existente usando o SSH pela primeira vez, você tem a opção de usar uma chave privada:

Adicione o Caminho da Chave Privada e a Senha e clique em Abrir para clonar seu repositório remoto do GIT. Para gerar uma chave SSH para seu repositório do GITHub, verifique as etapas detalhadas aqui.

Falha na autenticação

No HTTPS

Ao clonar um repositório GIT, a janela Inserir Credenciais é exibida com a mensagem Autenticação falhou se as credenciais fornecidas estiverem incorretas:

Insira as credenciais corretas e tente novamente. Você também pode usar o Git Bash, por exemplo, para clonar seu repositório remotamente e, assim, verificar se o nome do usuário e a senha estão corretos.

Na imagem a seguir, tentamos clonar um repositório no HTTPS, mas inserimos uma senha incorreta. A janela Git Bash mostra que as credenciais estavam incorretas.

Sobre o SSH

A janela Inserir Credenciais a seguir é exibida quando a autenticação em SSH falhar:

Digite o Caminho da Chave Privada e a Senha corretos e tente novamente. Você também pode usar o Git Bash, por exemplo, para clonar seu repositório remotamente e, assim, verificar se o token e/ou a senha estão corretos.

Na imagem a seguir, tentamos clonar um repositório com SSH, mas não tínhamos nenhuma chave SSH pública configurada em nossa conta.

Clonar um repositório remoto de GIT

1. Na guia Equipe, selecione Clonar Repositório. A opção Clonar um repositório remoto do GIT remoto. será exibida.
2. Selecione Usar HTTPS ou Usar SSH.
3. Digite a URL do repositório e escolha um diretório vazio de verificação.
4. Selecione Usar Credenciais / Usar Chave e configure a autenticação (entrando com o GitHub, inserindo o usuário e a senha, inserindo o usuário e o token para HTTPS, ou inserindo o caminho da chave privada e a senha para SSH).
5. Clique em Abrir e o Studio abre o projeto no painel Designer.
6. Na janela Abrir, selecione um arquivo project.json para abrir no Studio.

Depois de clonar um repositório do GIT para um diretório local de trabalho, o subdiretório .git é criado contendo os metadados do GIT necessários. Os metadados incluem subdiretórios para os arquivos de objetos, referências e modelos. Além disso, um arquivo HEAD também é criado, o qual aponta para a confirmação dos verificados no momento.

Adicionar um Projeto ao GIT

O recurso GIT Init adiciona o projeto atual em um repositório GIT local. Acesse o comando na guia Equipe ou a barra de status.

1. Crie ou abra um projeto no Studio. Clique na guia Iniciar > Equipe. A aba Equipe será mostrada.

2. Clique no botão GIT Init e, depois, selecione o caminho onde o repositório deve ser inicializado. O local pode ser o mesmo do projeto ou a pasta parent. A janela Confirmar alterações se abrirá.

   
   

   

   
   
3. A seção Arquivos Modificados exibe os arquivos do projeto que devem ser adicionados ao repositório do GIT. Desmarque a caixa ao lado dos arquivos que não deseja adicionar ou use as opções Selecionar Todos, Selecionar Nenhum.

4. Selecione a caixa Mostrar Arquivos Não Versionados para adicionar arquivos não versionados à lista.

   Grave em Confirmar Mensagem. Clique no botão Confirmar para confirmar as alterações ao repositório local do GIT.

Quando um projeto for adicionado ao GIT, o menu de contexto no painel Projeto incluirá opções específicas do GIT. Para obter mais informações, consulte Opções de Menu de Contexto para o GIT.

Observação: A pasta .local, que contém dados armazenados em cache localmente para o projeto, não deve ser adicionada ao GIT.

Confirmação e Envio por push para o GIT

1. A partir da mesma janela Confirmar alterações, clique no botão Confirmar e enviar para confirmar as alterações e enviá-las para o repositório remoto. A janela Gerenciar Remotos é exibida. A janela também fica disponível na barra de status.

   
   

   

   
   
2. Na seção Nome, adicione o nome do repositório remoto.
3. Na seção URL, adicione a URL remota.

Se você quiser realizar modificações nos repositórios adicionados, basta clicar em uma entrada, alterar o nome e URL e depois clicar no botão Atualizar. Quando estiver tudo pronto clique em Adicionar e depois em Salvar. A seguinte caixa de mensagem será aberta. Isso significa que o repositório local não está sincronizado com o remoto.

• Clique no botão Substituir conteúdo remoto para enviar por push as versões locais dos arquivos para o repositório remoto, substituindo os arquivos que estiverem ali.
• Clique no botão Efetuar Pull (trocar a base) para fazer o pul dos arquivos remotos e trocar a base da ramificação atual.
• Clique no botão Cancelar para descartar a operação inteira.

O número de alterações não enviadas por push e os arquivos recém-adicionados ficam visíveis na barra de status. Clique no ícone para abrir a janela Confirmar alterações ou o ícone para enviar alterações por push.

Observação: se você editar um arquivo de um projeto, adicionado ao controle de origem em um editor externo, a alteração ficará visível no painel Projeto e na barra de status somente depois de clicar em Atualizar no painel Projeto.

Alterar a Última Confirmação

A integração do Studio com o Git também vem com uma opção para Corrigir Confirmação para alterar a última confirmação realizada, antes que o envio por push for realizado.

1. Clique com o botão direito do mouse em um arquivo modificado no painel Projeto e selecione a opção Confirmar. A janela Confirmar alterações será mostrada.

   
   

   

   
   
2. Selecione a caixa Corrigir Confirmação. A última mensagem de confirmação é exibida, junto com os arquivos que foram confirmados. Para visualizar as alterações entre o arquivo atual e a última confirmação, utilize a opção Mostrar Alterações.
3. Altere a mensagem de confirmação e selecione os arquivos que deseja incluir. Clique no botão Confirmar e Enviar por Push ou Confirmar.

Desfazer alterações pendentes

O Studio vem com a opção de desfazer alterações feitas aos arquivos versionados, antes de confirmá-las e enviá-las por push para o repositório remoto.

Após fazer as alterações a um arquivo no repositório local, clique em Desfazer no menu de contexto do GIT para abrir a janela Desfazer Alterações Pendentes.

Selecione a caixa de seleção ao lado dos arquivos e clique em Desfazer. Os arquivos agorão são revertidos para o estado de antes das alterações.

Observação: Desfazer não cobre arquivos não versionados. Se você criar novos arquivos e depois selecionar Desfazer, os arquivos não serão removidos do projeto. Uma vez adicionados à árvore do projeto, os novos arquivos permanecerão ali, a menos que forem excluídos manualmente.

Copiar um Projeto para o GIT

O botão Copiar para o GIT na exibição de Backstage do Studio e a barra de status permite copiar o projeto atual para um repositório GIT existente.

Para tanto, primeiro abra ou crie um projeto no Studio. Na guia Equipe, selecione Copiar para o GIT e escolha uma pasta de repositório do GIT existente em sua máquina. O projeto é adicionado ao repositório local do GIT e a caixa de mensagem Copiar para o GIT será aberta.

• Selecione Sim para abrir o projeto no novo local. A janela Confirmar Alterações se abrirá. Grave uma Mensagem de Confirmação e clique em Confirmar e Enviar por Push ou apenas Confirmar.
• Selecione Não para retornar para a interface de usuário do Studio.

Criar e Gerenciar Ramificações

Adicione e gerencie as ramificações na janela Gerenciar Ramificações. Para acessá-la, clique com o botão direito do mouse no nó do projeto ou no painel Projeto e selecione Gerenciar ramificações ou use o menu de ramificação na barra de status.

• Para adicionar uma ramificação:

  1. Selecione uma ramificação na tabela e clique no sinal de mais no topo da janela.

  2. Digite um nome para a ramificação, clique em Criar ramificação em branch_name e clique em Salvar.

     A ramificação será adicionada à lista.

• Para atualizar a lista de ramificações, clique em Atualizar no topo da janela.
• Para excluir uma ramificação local, selecione-a e clique em Excluir no topo da janela.

• Para gerenciar ramificações, clique com o botão direito do mouse em qualquer ramificação e selecione uma das opções no menu:

  • A opção Fazer check-out de ramificação alterna para a ramificação selecionada.
  • A opção Trocar base troca a base da ramificação atual para a ramificação selecionada.

  • A opção Mesclar mescla a ramificação selecionada na ramificação atual.

    Para fundir uma ramificação na master de um repositório remoto do GIT, você precisa que a ramificação master passe pelo check-out no Studio, para então fundir a ramificação modificada na mestre.

• Para alternar entre as ramificações, abra o menu ramificação na barra de status e selecione a ramificação para a qual deseja alternar a partir da lista de ramificações.

Observação: as ramificações precisam ser adicionadas localmente no Studio a partir da janela Gerenciar Ramificações . Adicionar ramificações a partir do repositório remoto do GIT pode causar problemas ao tentar alternar entre as ramificações.

Exibir o histórico de commits

Para visualizar o histórico de commits para um projeto ou arquivo ou pasta específica em um projeto, clique com o botão direito no nó do projeto, um arquivo ou pasta no painel Projeto, e selecione Mostrar Histórico. Isso abre a janela Histórico, que exibe uma lista de revisões existentes para o arquivo, pasta ou projeto selecionado. Para cada commit, o hash do commit, mensagem, autor e data são exibidos em uma tabela na parte superior da janela. Você pode visualizar mais informações sobre uma confirmação selecionada nas guias Detalhes e Alterações na parte inferior da janela.

Comparar duas versões de um arquivo

Para comparar duas versões do mesmo arquivo:

• Se você abriu o histórico para um arquivo, clique com o botão direito do mouse em um commit na janela Histórico, e então selecione Comparar com Anterior, Comparar com Local ou Comparar com Mais Recente.
• Se você abriu o histórico para uma pasta ou projeto, selecione um commit na janela Histórico e, em seguida, na guia Alterações, clique duas vezes em um arquivo para compará-lo com a sua versão anterior.

Criar uma ramificação a partir de uma confirmação anterior

Para criar uma ramificação a partir de uma confirmação específica:

1. Clique em uma confirmação na janela Histórico e selecione Criar ramificação.

2. Na janela Criar ramificação:

   • Insira um nome para a nova ramificação.
   • Para verificar a nova ramificação, certifique-se de que a opção Verificar após a criação esteja selecionada.
3. Clique em OK.

Solução de conflitos

A integração do GIT com o Studio vem com um recurso para resolver conflitos que podem ocorrer ao se executar os comandos Trocar Base ou Enviar por Push, encontrados na janela Confirmar Alterações.

Sempre que o Studio detectar um conflito entre o arquivo local e um arquivo encontrado no repositório remoto, a janela Resolver conflitos será exibida.

A janela é semelhante à Dif. do fluxo de trabalho, que mostra as diferenças entre a versão Remota do arquivo e a versão Local.

A tabela a seguir descreve as opções disponíveis na janela Solucionar conflitos.

Opção	Description
Escolher à Esquerda	Selecione o arquivo à esquerda, que representa o arquivo no repositório remoto para enviar por push.
Escolher à Direita	Selecione o arquivo à direita, que representa o arquivo no repositório local para enviar por push.
Salvar	Depois de escolher o arquivo à esquerda ou à direita, clique em Salvar.
Cancelar	Cancele a operação e saia da janela Solucionar conflitos.
Anterior	Segue para a alteração anterior nos arquivos comparados.
Avançar	Segue para a próxima alteração nos arquivos comparados.
Recolher Tudo	Fecha todos os nós nos arquivos .xaml.
Expandir Tudo	Expande todos os nós nos arquivos .xaml.

Desconectar-se do GIT

A opção Desconectar em Exibição Backstage do Studio > na guia Equipe fica disponível em relação aos arquivos versionados nos dois casos a seguir:

1. Um processo é inicializado como um repositório local do GIT. Crie um novo processo, use o GIT Init para adicioná-lo a um repositório local do GIT e, em seguida, use a opção Desconectar para remover an tag da subversão.
2. É possível remover a tag da subversão, clicando em Desconectar em relação ao repositório do GIT, o que inclui projetos parent e child.
3. Se você desconectar um projeto child, então o repositório GIT inteiro contendo o projeto aberto será desconectado do controle de origem. Será exibida uma caixa de mensagem no Studio, solicitando sua confirmação antes que a ação de desconectar seja executada.

Alteração de assinatura

É possível alterar a assinatura de confirmação do GIT a partir da guia Equipe > Alterar Assinatura. Preencha seu nome e endereço de e-mail e clique em OK.

Alterando as credenciais

Para atualizar as credenciais usadas para se conectar a um repositório remoto:

1. A partir do menu de ramificação na barra de status, selecione Gerenciar Remotos.
2. Na caixa de diálogo Gerenciar Remotos, clique com o botão direito do mouse em um repositório remoto e selecione Alterar Credenciais.

3. Dependendo de como o repositório foi clonado (via HTTPS ou SSH), faça login em uma conta do GitHub (apenas para repositórios hospedados em github.com), insira o nome de usuário e senha ou nome de usuário e token, ou aponte para uma nova chave privada e clique em OK.

   As credenciais são atualizadas no Gerenciador de Credenciais do Windows.

Uso do GIT com um Servidor Proxy

A integração do GIT no Studio oferece suporte ao acesso de repositórios remotos se o acesso à Internet for realizado através de um servidor proxy. Isso pode ser feito de duas maneiras: seja configurado em nível da máquina na janela de Configurações de Proxy ou fazendo alterações aos comandos git.

Os detalhes do Proxy, configurados na janela Configurações de Proxy são considerados, sem a necessidade de inseri-los no arquivo .gitconfig.

Para configurar os detalhes do proxy com os comandos git, adicione-os aos arquivos de configuração do GIT no formulário a seguir:

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

Os arquivos de configuração do GIT podem ser encontrados nos seguintes locais:

• config arquivo: %ProgramData%\Git
• .gitconfig arquivo: %UserProfile%
• arquivo config local do nível do projeto, como por exemplo, o %UserProfile%\Desktop estproject\.git.