corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Guia do Usuário do Git

O NetBeans IDE fornece o suporte ao cliente de controle de versão GIT. O Suporte ao Git do IDE permite executar tarefas de controle de versão diretamente de seu projeto dentro do IDE. Este documento demonstra como executar tarefas básicas de controle de versão no IDE orientando você pelo fluxo de trabalho padrão ao usar o software de controle de versão.

O Git é um sistema de controle de versão grátis e de código-fonte aberto, projetado para tratar de tudo de um projeto pequeno a muito grande com rapidez e eficiência. Cada clone do Git é um repositório com todos os recursos com histórico completo e recursos completos de rastreamento de versão, não dependente de acesso à rede ou de um servidor central. A ramificação e a mesclagem são rápidas e fáceis de serem feitas. O Git é usado para o controle de versão de arquivos, de forma similar a ferramentas como Mercurial, Subversion, CVS, Perforce etc.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 7.1

Requisitos

Para concluir este tutorial, você precisa dos seguintes recursos e softwares.

Software ou recurso Versão necessária
NetBeans IDE Versão 7.1
Java Development Kit (JDK) Versão 6 ou 7

Inicializando um repositório Git

Para inicializar um repositório Git a partir de arquivos existentes que ainda não estão sob o controle de versão, é preciso completar as seguintes etapas:

  1. Na janela Projetos, selecione um projeto sem controle de versão e clique com o botão direito do mouse no nome do projeto.
  2. No menu de contexto, escolha Controle de versão > Inicializar o repositório Git (alternativamente, no menu principal escolha Equipe > Git > Inicializar).

    Caixa de diálogo de plug-ins

  3. Especifique o caminho para o repositório onde irá armazenar seus arquivos com controle de versão na caixa de diálogo Inicializar repositório do Git ou clique em Procurar e navegue para o diretório requerido.
  4. Clique em OK.

    Uma subpasta .git é criada na pasta especificada na etapa 3 acima (sua pasta do projeto NetBeans por padrão), que é seu repositório Git onde todos os dados dos instantâneos de seu projeto são armazenados. O Git inicia o controle de versão de todos os arquivos na pasta que você especificou.
    Você pode abrir Janela > Saída > Saída para visualizar o relatório do IDE sobre o andamento da criação do repositório sob seu diretório local de trabalho.

    Janela Saída

Todos os projetos são marcados como Adicionados em sua Árvore de trabalho. Para ver o status de um arquivo, coloque o cursor sobre o nome do arquivo na janela Projetos. O status do arquivo na Árvore de trabalho é exibido em verde na direita da barra, como mostrado na figura a seguir.

Novo da árvore de trabalho

Após ter inicializado o repositório Git, você adiciona arquivos ou confirma-os diretamente no repositório Git.

Clonando um repositório Git

Para obter uma cópia de um repositório Git já existente, é preciso cloná-lo. Assegure que você conheça o URL do repositório Git antes de iniciar o assistente Clonar repositório no IDE.

  1. Escolha Equipe > Git > Clonar no menu principal. O assistente Clonar repositório é exibido.

    Assistente Clonar repositório

  2. Na página Repositório, especifique o caminho da localização do repositório Git, o nome de usuário e senha (você pode salvá-los para uso futura se necessário).
  3. (Opcional) Clique em Configuração de proxy para exibir a caixa de diálogo Opções e definir as configurações do servidor proxy. Clique em OK quando terminar.
  4. Clique em Próximo para ir para a próxima etapa do assistente.
  5. Na página Ramificações remotas, selecione as ramificações de repositório a serem obtidas (baixadas) para seu repositório local. Clique em Próximo.
  6. Na página Diretório de destino, especifique o seguinte:
    • No campo Diretório pai, o caminho do diretório desejado para o repositório clonado em seu disco rígido (alternativamente, clique no botão Procurar e navegue para o diretório).
      O campo Diretório principal é pré-preenchido com o caminho para o diretório padrão NetBeansProjects onde todos os projetos do NetBeans são armazenados.
    • No campo Nome do clone, o nome da pasta local onde o projeto original será clonado.
      Por padrão, o Nome do clone é preenchido com o nome real do repositório Git.
    • No campo Ramificação de retirada, selecione a ramificação a ser retirada na árvore de trabalho.
    • No campo Nome remoto, o nome que representa o repositório original sendo clonado.
      origin é o codinome padrão do repositório sendo clonado. Esse é o valor recomendado.
    • Deixe selecionada a caixa de seleção Varrer por projetos do NetBeans após clonar para ativar a pós-varredura assim que a clonagem terminar. (O plug-in procura projetos NetBeans nos recursos clonados e oferece para abrir os projetos encontrados).
  7. Clique em Terminar.
    Após o repositório do Git tiver sido clonado, a pasta de metadados .git é criada dentro da pasta selecionada no assistente.

Clonando um repositório a partir do GitHub através do Protocolo SSH

Para clonar um repositório a partir do GitHub através do Protocolo SSH, faça o seguinte:

Observação: É preciso ter uma conta do GitHub e ser membro do projeto para poder clonar via SSH.

  1. Escolha Equipe > Git > Clonar no menu principal. O assistente Clonar repositório é exibido.
  2. Na página Repositório remoto do assistente Clonar repositório, especifique o caminho para o repositório requerido no campo URL do repositório, por exemplo, :tstupka/koliba.git.
  3. Verifique se git está especificado no campo de texto Nome de usuário.
  4. Selecione a opção Chave privada/pública.
  5. Especifique o caminho para o arquivo da chave, por exemplo C:\Users\key.
  6. Insira a senha para o arquivo da chave, por exemplo abcd.
  7. (Opcional) Selecione a opção Salvar senha, se necessário.
  8. (Opcional) Clique em Configuração de proxy para exibir a caixa de diálogo Opções e definir as configurações do servidor proxy. Clique em OK quando terminar.

    Página Repositório remoto do assistente Clonar repositório

  9. Clique em Próximo.
  10. Na página Ramificações remotas, selecione as ramificações de repositório a serem obtidas (baixadas) para seu repositório local, por exemplo master.

    Página Ramificações remotas do assistente Clonar repositório

  11. Clique em Próximo.
  12. Na página Diretório de destino, especifique o seguinte:
    • No campo Diretório pai, o caminho do diretório desejado para o repositório clonado em seu disco rígido (alternativamente, clique no botão Procurar e navegue para o diretório).
      O campo Diretório principal é pré-preenchido com o caminho para o diretório padrão NetBeansProjects onde todos os projetos do NetBeans são armazenados.
    • No campo Nome do clone, o nome da pasta local onde o projeto original será clonado.
      Por padrão, o Nome do clone é preenchido com o nome real do repositório Git.
    • No campo Ramificação de retirada, selecione a ramificação a ser retirada na árvore de trabalho.
    • No campo Nome remoto, o nome que representa o repositório original sendo clonado.
      origin é o codinome padrão do repositório sendo clonado. Esse é o valor recomendado.
    • Deixe selecionada a caixa de seleção Varrer por projetos do NetBeans após clonar para ativar a pós-varredura assim que a clonagem terminar. (O plug-in procura projetos NetBeans nos recursos clonados e oferece para abrir os projetos encontrados).

      Diretório de destino do assistente Clonar repositório

  13. Clique em Terminar.
    Após o repositório ter sido clonado, a mensagem Clonagem completada é exibida.

    Mensagem Clonagem completada

  14. Escolha a opção desejada.

Adicionando arquivos em um repositório Git

Para começar a rastrear um novo arquivo e também colocar em armazenamento temporário as alterações de um arquivo já rastreado no repositório do Git, é preciso adicioná-lo no repositório.

Ao adicionar arquivos em um repositório do Git, o IDE compõe e salva instantâneos primeiro de seu projeto no Índice. Após você executar o comprometimento, o IDE salva estes instantâneos no HEAD. O IDE permite escolher entre os dois fluxos de trabalho descritos na tabela a seguir.

Descrição do fluxo de trabalho Adicione explicitamente arquivos novos ou modificados ao Índice e confirme somente os arquivos em armazenamento temporário no Índice para o HEAD Pule a adição de arquivos novos ou modificados para o Índice e comprometa os arquivos requeridos diretamente para o HEAD
Etapas a seguir no fluxo de trabalho
  1. Na janela Projetos, clique com o botão direito do mouse no arquivo que deseja adicionar.
  2. No menu de contexto, escolha Git > Adicionar.
    Isso adiciona o conteúdo do arquivo no Índice antes de comprometê-lo.
  3. Na janela Projetos, clique com o botão direito do mouse no arquivo que deseja confirmar.
  4. Na caixa de diálogo Confirmar, selecione o botão Alterações entre o HEAD e o Índice ( ícone Alterações entre o HEAD e o Índice ).
    Isso exibe uma lista dos arquivos que já estão em armazenamento temporário.
  5. Confirme os arquivos como descrito na seção Confirmando código-fonte em um repositório abaixo.
  1. Na janela Projetos, clique com o botão direito do mouse no arquivo que deseja confirmar.
  2. No menu de contexto, escolha Git > Confirmar.
  3. Na caixa de diálogo Confirmar, selecione o botão Alterações entre o Índice e a Árvore de trabalho (ícone Alterações entre o Índice e a Árvore de trabalho).
    Isso exibe uma lista dos arquivos que não estão em armazenamento temporário.
  4. Confirme os arquivos como descrito na seção Confirmando código-fonte em um repositório abaixo.

Observação: O status do arquivo no HEAD é exibido em verde na esquerda da barra, como mostrado na figura a seguir.

Novo no armazenamento temporário

A ação funciona de forma recursiva se chamada em pastas enquanto respeita a estrutura de conteúdo de pasta plana do IDE.

Editando arquivos

Após ter um projeto com controle de versão Git aberto no IDE, é possível começar a fazer alterações no código-fonte. Como acontece com qualquer projeto aberto no NetBeans IDE, você pode abrir os arquivos no editor de código-fonte, clicando duas vezes em seus nós, conforme eles aparecem nas janelas do IDE (ou seja, janelas Projetos (Ctrl-1), Arquivos (Ctrl-2), Favoritos (Ctrl-3)).

Ao trabalhar com códigos-fonte no IDE, há vários componentes de IU a sua disposição, o que ajuda a visualizar e usar os comandos de controle de versão:

Visualizando alterações no editor de código-fonte

Quando abre um arquivo com controle de versão no editor de código-fonte do IDE, você pode ver alterações em tempo real acontecendo em seu arquivo, conforme ele é modificado em relação à versão base do repositório do Git. Conforme você trabalha, o IDE usa a codificação de cor nas margens do editor de código-fonte para fornecer as seguintes informações:

Azul (       ) Indica as linhas alteradas desde a revisão anterior.
Verde (       ) Indica as linhas adicionadas desde a revisão anterior.
Vermelho (       ) Indica as linhas removidas desde a revisão anterior.

A margem esquerda do editor de código-fonte mostra as alterações ocorrendo linha por linha. Quando você modifica uma determinada linha, as alterações são imediatamente mostradas na margem esquerda.

Margem esquerda

Observação: Você pode clicar em um agrupamento colorido na margem para chamar todos os comandos de controle de versão. Por exemplo, a figura abaixo mostra os widgets disponíveis quando você clica em um ícone vermelho, indicando que linhas foram removidas de sua cópia local:

Widgets disponíveis

A margem direita do editor de código-fonte fornece uma visão geral que exibe as alterações feitas no arquivo como um todo, do início ao fim. A codificação de cor é gerada imediatamente quando você altera o arquivo.

Margem direita

Observação: Você pode clicar em um ponto específico na margem para trazer imediatamente o seu cursor em linha para esse local no arquivo. Para ver o número de linhas afetadas, passe o mouse sobre os ícones coloridos na margem direita:

Widgets disponíveis

Exibindo informações de status do arquivo

Quando você está trabalhando nas janelas Projetos (Ctrl-1), Arquivos (Ctrl-2), Favoritos (Ctrl-3) ou nas vistas de Controle de versão, o IDE fornece alguns recursos visuais que ajudam a visualizar as informações de status sobre seus arquivos. No exemplo abaixo, observe como o emblema (ou seja, emblema azul), a cor do nome do arquivo e o rótulo de status adjacente coincidem um com o outro para fornecer uma forma simples, mas eficaz, de manter o controle das informações de controle de versão sobre seus arquivos:

Informações de status do arquivo

Os emblemas, a codificação de cor, as legendas de status do arquivo e, talvez o mais importante, o Visualizador de comparação Git, ajudam você a visualizar e gerenciar as informações de controle de versão no IDE.

Emblemas e codificação de cor

Os emblemas são aplicados ao projeto, pasta e nós do pacote e informam o status dos arquivos contidos nesse nó:

A tabela seguinte exibe o esquema de cores usado nos emblemas:

Componente de UI descrição
Emblema azul (Emblema azul) Indica a presença de arquivos que forma modificados, adicionados ou excluídos de sua árvore de trabalho. No caso de pacotes, esse emblema se aplica somente ao pacote em si e não aos seus subpacotes. Para projetos ou pastas, o emblema indica as alterações nesse item, ou qualquer uma das subpastas contidas.
" />Emblema vermelho (</strong>Emblema vermelho<strong>)</td>
                        <td class=Marca projetos, pastas ou pacotes que contêm arquivos conflitantes. No caso de pacotes, esse emblema se aplica somente ao pacote em si e não aos seus subpacotes. Para projetos ou pastas, o emblema indica os conflitos nesse item ou em qualquer uma das subpastas contidas.

A codificação de cor é aplicada aos nomes de arquivo para indicar seu status atual em relação ao repositório:

Cor Exemplo descrição
Sem cor específica (preto) Texto preto Indica que o arquivo não tem alterações.
Azul Texto azul Indica que o arquivo foi modificado localmente.
Verde Texto verde Indica que o arquivo foi adicionado localmente.
Vermelho Texto vermelho Indica que o arquivo tem conflito de mesclagem.
Cinza Texto cinza Indica que os arquivo é ignorado pelo Git e não será incluído nos comandos de controle de versão (ou seja, Atualizar e Comprometer). Os arquivos não podem ser ignorados se estiverem sob controle de versão.

Rótulos de status do arquivo

O IDE exibe dois valores de status para um arquivo:

  • Um status que descreve as diferenças entre os arquivos na Árvore de trabalho e no estado de Índice,
  • Um status que descreve as diferenças entre os arquivos no estado de Índice e o comprometimento atual no HEAD.

Os rótulos de status do arquivo fornecem uma indicação textual do status dos arquivos com controle de versão nas janelas do IDE:

Legenda do status Significado
- Não modificado
A Adicionado
U Atualizado mas não mesclado
M Modificado
D Excluído
I Ignorado
R Renomeado

Por padrão, o IDE exibe as informações de status (novo, modificado, ignorado etc.) e de pastas em texto cinza à direita dos arquivos, à medida que eles são listados em janelas.

Rótulos de arquivo exibidos junto aos nomes de arquivos

Os arquivos com conflito de mesclagem têm o status de não mesclado que é normalmente anotado em vermelho até que os arquivos não sejam solucionados por sua ação explícita. O rótulo de de status para arquivos não mesclados depende do cenário (por exemplo, A/A - não mesclado, ambos adicionados).

Os rótulos de status do arquivo podem ser ativados e desativados ao escolher Exibir > Mostrar legendas de controle de versão no menu principal.

Vista Controle de versão do Git

A vista Controle de versão do Git fornece uma lista em tempo real de todas as alterações feitas nos arquivos em uma pasta selecionada da sua árvore de trabalho local. Ela é aberta por padrão no painel inferior do IDE, listando os arquivos adicionados, excluídos ou modificados.

Para abrir a vista Controle de versão, selecione um arquivo ou pasta com controle de versão (ou seja, na janela Projetos, Arquivos ou Favoritos) e escolha Git > Mostrar alterações no menu do botão direito do mouse ou escolha Equipe > Controle de versão > Mostrar alterações no menu principal. A janela seguinte aparece na parte inferior do IDE:

vista Controle de versão exibindo as alterações entre o HEAD e a árvore de trabalho

Por padrão, a vista Controle de versão exibe uma lista de todos os arquivos modificados dentro do pacote ou pasta em sua Árvore de trabalho. Usando o botões da barra de ferramentas, é possível decidir exibir a lista de arquivos que têm diferenças entre o Índice e o HEAD, entre a Árvore de trabalho e o Índice ou entre a Árvore de trabalho e o HEAD. É possível clicar nos cabeçalhos das colunas acima dos arquivos listados para classificá-los por nome, status ou local.

A barra de ferramentas da vista Controle de versão também inclui botões que permitem chamar as tarefas mais comuns do Git em todos os arquivos exibidos na lista. A tabela a seguir lista os comandos do Git disponíveis na barra de ferramentas da vista Controle de versão:

Ícone Nome Função
Alterações entre HEAD e o ícone da árvore de trabalho Alterações entre HEAD e a árvore de trabalho Exibe uma lista de arquivos que já estão em armazenamento temporário ou somente modificados/criados e ainda não estão em armazenamento temporário.
Alterações entre HEAD e o ícone do Índice Alterações entre HEAD e o Índice Exibe uma lista de arquivos que estão em armazenamento temporário.
Alterações entre o Índice e o ícone da árvore de trabalho Alterações entre o Índice e a árvore de trabalho Exibe os arquivos que têm diferenças entre seus estados de armazenamento temporário e na Árvore de trabalho.
Ícone Atualizar situação Atualizar situação Atualiza o status dos arquivos e pastas selecionados. Os arquivos exibidos na vista Controle de versão podem ser atualizados para refletir quaisquer alterações que possam ter sido feitas externamente.
Ícone Abrir comparação Abrir comparação Abre o Visualizador de comparação fornecendo uma comparação lado a lado de suas cópias locais e das versões mantidas no repositório.
Ícone Caminhos de retirada Reverter modificações Exibe a caixa de diálogo Reverter modificações.
Ícone Confirmar alterações Confirmar alterações Exibe a caixa de diálogo Confirmar.

Você pode acessar outros comandos do Git na vista Controle de versão, selecionando uma linha da tabela que corresponde a um arquivo modificado, e escolhendo um comando do menu com o botão direito do mouse:

Menu do botão direito do mouse exibido no arquivo selecionado na vista Controle de versão

Comparando revisões de arquivos

Comparar versões de arquivo é uma tarefa comum ao se trabalhar com projetos com controle de versão. O IDE permite comparar versões ao usar o comando Comparar:

  1. Selecione um arquivo ou pasta com versão (por exemplo, na janela Projetos, Arquivos ou Favoritos).
  2. Escolha Team > Diff no menu principal.
    Um visualizador gráfico de comparação é aberto para os arquivos selecionados na janela principal do IDE. O visualizador de comparação exibe duas cópias em painéis lado a lado. Quanto mais atual a cópia aparecer no lado direito, ou seja, você está comparando uma versão no repositório contra sua árvore de trabalho, a árvore de trabalho é exibida no painel direito:

    Visualizador de comparação

    O visualizador de comparação usa a mesma codificação de cor usada para exibir alterações de controle de versão. Na captura de tela exibida acima, o bloco verde indica o conteúdo que foi adicionado à revisão mais atual. O bloco vermelho indica que o conteúdo da revisão anterior foi removido da última revisão. Azul indica que as alterações ocorreram na(s) linha(s) realçada(s).

A barra de ferramentas do Visualizador de a vista Controle de versão também inclui botões que permitem chamar as tarefas mais comuns do Git em todos os arquivos exibidos na lista. A tabela a seguir lista os comandos do Git disponíveis na barra de ferramentas da vista Controle de versão:

Ícone Nome Função
Alterações entre HEAD e o ícone da árvore de trabalho Alterações entre HEAD e a árvore de trabalho Exibe uma lista de arquivos que já estão em armazenamento temporário ou somente modificados/criados e ainda não estão em armazenamento temporário.
Alterações entre HEAD e o ícone do Índice Alterações entre HEAD e o Índice Exibe uma lista de arquivos que estão em armazenamento temporário.
Alterações entre o Índice e o ícone da árvore de trabalho Alterações entre o Índice e a árvore de trabalho Exibe os arquivos que têm diferenças entre seus estados de armazenamento temporário e na Árvore de trabalho.
Ícone Ir para a próxima diferença Ir para a próxima diferença Exibe a próxima diferença no arquivo.
Ícone Ir para a diferença anterior Ir para a diferença anterior Exibe a diferença anterior no arquivo.
Ícone Atualizar situação Atualizar situação Atualiza o status dos arquivos e pastas selecionados. Os arquivos exibidos na janela Controle de versão podem ser atualizados para refletir quaisquer alterações feitas externamente.
Ícone Caminhos de retirada Reverter modificações Exibe a caixa de diálogo Reverter modificações.
Ícone Confirmar alterações Confirmar alterações Exibe a caixa de diálogo Confirmar.

Se você estiver executando uma comparação em sua cópia de trabalho local, o IDE permite fazer alterações diretamente no visualizador de comparação. Para fazer isso, você pode colocar o cursor no painel direito do visualizador de comparação e modificar seu arquivo de acordo, caso contrário, use os ícones in-line exibidos ao lado de cada alteração realçada:

Ícone Nome Função
Ícone Substituir Substituir Insere o texto realçado em sua cópia da Árvore de trabalho.
Ícone Mover todos Mover todos Reverte toda a cópia local da árvore de trabalho.
Ícone Remover Remover Remove o texto realçado da cópia local da Área de trabalho.

Revertendo alterações

Para descartar as alterações locais feitas nos arquivos selecionados em sua árvore de trabalho e substituir os arquivos usando os que estejam no Índice ou HEAD:

  1. Selecione um arquivo ou pasta com versão (por exemplo, na janela Projetos, Arquivos ou Favoritos).
  2. Escolha Equipe > Reverter modificações no menu principal.
    A caixa de diálogo Reverter modificações é exibida.

    Caixa de diálogo Reverter modificações

  3. Especificar opções adicionais (por exemplo, Reverter somente as alterações confirmadas no Índice para o HEAD) .
  4. Clique em Reverter.

O IDE substitui os arquivos selecionados pelos usando os especificados na etapa 3 acima.

Confirmando código-fonte em um repositório

Para comprometer arquivos para o repositório Git:

  1. Na janela Projetos, clique com o botão direito do mouse no arquivo que deseja confirmar.
  2. No menu de contexto, escolha Git > Confirmar.

    Exibe a caixa de diálogo Confirmar.

    Caixa de diálogo Confirmar

    A caixa de diálogo Confirmar contém os seguintes componentes:

    • A área de texto Mensagem da confirmação descreve a alteração sendo confirmada
    • As listas suspensas Autor e Confirmador permitem diferenciar entre quem fez a alteração e que m confirmou fisicamente o arquivo, se necessário.
    • A seção Arquivos a serem confirmados que lista:
      • todos os arquivos modificados,
      • todos os arquivos que foram excluídos da Árvore de trabalho (localmente),
      • todos os arquivos novos (ou seja, arquivos que ainda não existem no repositório Git),
      • todos os arquivos que você renomeou.

        Dois botões de alternância que alternam o modo no qual o comprometimento de fato dever ser executado, estão aqui disponíveis:

        Componente de UI Nome descrição
        Alterações entre HEAD e o Índice Alterações entre HEAD e o Índice Exibe uma lista de arquivos que estão em armazenamento temporário.
        Alterações entre HEAD e a árvore de trabalho Alterações entre HEAD e a árvore de trabalho Exibe uma lista de arquivos que já estão em armazenamento temporário ou somente modificados/criados e ainda não estão em armazenamento temporário.

      Observação: para especificar se os arquivos individuais devem ser excluídos da confirmação, cancele a seleção da caixa de seleção na primeira coluna denominada Confirmmar ou clique com o botão direito do mouse em uma linha de arquivo na coluna Ação de confirmaçãp e escolha Excluir da confirmação no menu suspenso. Para exibir aqui o Visualizador de comparação, clique com o botão direito do mouse em uma linha de arquivo na coluna Ação de confirmação e escolha Comparar no menu suspenso.

    • A seção Atualizar questão acompanha as questões relativas à alteração sendo confirmada.

      Nota: é preciso instalar o plug-in JIRA ou Subversion para iniciar o rastreamento de questões no IDE.

  3. Digite uma mensagem de confirmação na área de texto Mensagem de confirmação. Alternativamente, você pode fazer qualquer um dos seguintes:
    • clique no ícone Mensagens recentes" /> ( ícone Mensagens recentes ) localizado no canto superior direito da vista e selecione em uma lista de mensagens que tenha anteriormente utilizado,</li>
					<li>clique no ícone <tt>Carregar modelo</tt> (<img src=) localizado no canto superior direito para selecionar um modelo de mensagem.
  4. Depois de especificar ações para arquivos individuais, clique em Confirmar.
    O IDE executa o comprometimento e armazena seus instantâneos no repositório. A barra de status do IDE, localizada na parte inferior direita da interface, é exibida conforme a ação de confirmação ocorre. Com uma confirmação bem-sucedida, os emblemas de controle de versão desaparecem nas janelas Projetos, Arquivos e Favoritos e a codificação de cor dos arquivos confirmados volta a ser preta.

Trabalhando com ramificações

O suporte ao Git do IDE permite manter diferentes versões de toda uma base de códigos usando ramificações.

Ao trabalhar com ramificações no IDE, as seguintes ações são suportadas:

Criando uma ramificação

Para criar uma ramificação local, caso deseje trabalhar em uma versão separada de seu sistema de arquivos para fins de estabilização ou experimento sem perturbar o tronco principal, complete as seguintes etapas:

  1. Na janela Projetos ou Arquivos, escolha um projeto ou pasta do repositório no qual deseja criar a ramificação.
  2. No menu principal, escolha Equipe>Git>Ramificação>Criar ramificação.

    Observação: como alternativa, clique com o botão direito do mouse no projeto ou pasta com controle de versão e escolha Git > Ramificação > Criar ramificação a partir do menu pop-up.

    A caixa de diálogo Criar Ramificação é exibida.

    Caixa de diálogo Criar ramificação

  3. No campo Nome da ramificação, insira o nome da ramificação sendo criada.
  4. Especifique a versão necessária ao inserir uma ID de comprometer, ramificação existente, ou nome do identificador no campo Versão, ou pressione Selecionar para visualizar uma lista das versões mantidas no repositório.
  5. (Opcional) Na caixa de diálogo Selecionar versão, expanda Ramificações e escolha a ramificação necessária, especifique a ID de comprometer na lista adjacente e pressione Selecionar.
  6. Reveja as informações dos campos ID do confirmador, Autor e Mensagem específicos da versão sendo ramificada.
    A ramificação é adicionada à pasta Ramificações/Local do repositório Git.

    Ramificação adicionada

Retirando

Se precisar editar arquivos em uma ramificação existente, você pode retirar a ramificação para copiar os arquivos para sua Árvore de trabalho.

Para retirar uma versão, execute o seguinte:

  1. Escolha Equipe > Git> Retirar > Retirar versão a partir do menu principal.
    A caixa de diálogo Retirar versão selecionada é exibida.

    Retirar versão selecionada

  2. Especifique a versão necessária ao inserir uma ID de confirmação, uma ramificação existente ou o nome do identificador no campo Revisão, ou pressione Selecionar para visualizar uma lista das revisões mantidas no repositório.
  3. Ignore se você não pressionou Selecionar na etapa anterior. Na caixa de diálogo Selecionar versão, expanda Ramificações e escolha a ramificação necessária, especifique a ID de confirmação na lista adjacente, se necessário, e pressione Selecionar.

    Observação: se a versão especificada se refere a uma confirmação válida que não esteja marcada com um nome de ramificação, seu HEAD se torna desanexado e você não mais está em nenhum ramificação.

  4. Reveja as informações dos campos ID do comprometedor, Autor e Mensagem específicos a versão sendo retirada.
  5. Para criar uma nova ramificação da versão retirada, escolha a opção Retirara uma nova ramificação e insira o nome no campo Nome da ramificação.
  6. Pressione Retirar para retirar a versão.
    Os arquivos na Árvore de trabalho e no Índice são atualizados para coincidirem com a versão na versão especificada.

Observação: caso deseje alternar seus arquivos para uma ramificação existente (por exemplo, para uma confirmação que não esteja no topo de uma de suas ramificações), você pode usar o comando Equipe > Git > Ramificação > Alternar para a ramificação, especificar a ramificação na caixa de diálogo Alternar para a ramificação selecionada, retirá-la como uma nova ramificação (opcionalmente) e pressionar Alternar.

O IDE suporta a retirada sensível ao contexto de arquivos, pastas ou projetos no momento selecionados no IDE. Para retirar alguns arquivos (não uma ramificação), complete as seguintes etapas:

  1. Escolha Equipe > Git> Retirar > Retirar arquivos a partir do menu principal.
    A caixa de diálogo Retirar caminhos selecionados é exibida.

    Retirar caminhos selecionados

  2. Escolha a opção Atualizar índice com entradas da versão selecionada.
    Caso selecionada, o Índice é atualizado com o estado da versão selecionada antes de retirar o arquivo (ou seja, os arquivos selecionados na Árvore de trabalho e Índice são atualizados).
  3. Especifique a versão necessária ao inserir uma ID de confirmação, uma ramificação existente ou o nome do identificador no campo Revisão, ou pressione Selecionar para visualizar uma lista das revisões mantidas no repositório.
  4. Ignore se você não pressionou Selecionar na etapa anterior. Na caixa de diálogo Selecionar versão, expanda Ramificações e escolha a ramificação necessária, especifique a ID de comprometer na lista adjacente se necessário, e pressione Selecionar.
  5. Pressione Retirar para completar a retirada.

Mesclando

Para portar as modificações de uma revisão do repositório para a Árvore de trabalho, faça o seguinte:

  1. Escolha Equipe > Git> Retirar > Mesclar versões a partir do menu principal.
    A caixa de diálogo Mesclar versões é exibida.

    Mesclar revisões

  2. Especifique a versão necessária ao inserir uma ID de confirmação, uma ramificação existente ou o nome do identificador no campo Revisão, ou pressione Selecionar para visualizar uma lista das revisões mantidas no repositório.
  3. Ignore se você não pressionou Selecionar na etapa anterior. Na caixa de diálogo Selecionar versão, expanda Ramificações e escolha a ramificação necessária, especifique a ID de confirmação na lista adjacente, se necessário, e pressione Selecionar.
  4. Pressione Mesclar.
    Uma mescla de três vias entre a ramificação atual, o conteúdo de sua Árvore de trabalho e a ramificação especificada é feita.

    Observação: caso ocorra um conflito de mesclagem, o arquivo conflitante é marcada com um emblema vermelho para indicar isso.

    Observação: Depois da mesclagem, ainda é necessário confirmar as alterações para que sejam adicionadas ao HEAD.

Excluindo uma ramificação

Para excluir uma ramificação local desnecessária, complete as seguintes etapas:

  1. Escolha Equipe > Git> Retirar > Navegador de repositório a partir do menu principal.
  2. No Navegador do repositório Git, escolha a ramificação a ser excluída.

    Observação; a ramificação precisa estar inativa, ou seja, não retirada para a Árvore de trabalho.

  3. Clique com o botão direito do mouse na ramificação selecionada e escolha Excluir ramificação a partir do menu suspenso.
  4. Na caixa de diálogo Excluir ramificação, pressione OK para confirmar a exclusão da ramificação.
    A ramificação é excluída do repositório local, assim como do Navegador de repositório Git.

Trabalhando com repositórios remotos

Quando você trabalha com outros desenvolvedores precisa compartilhar seu trabalho, que envolva, obter, empurrar e puxar dados de e para repositórios remotos hospedados na Internet ou rede.

Obtendo

A obtenção recebe as alterações do repositório remoto original que você ainda não tem. Ela nunca altera quaisquer de suas ramificações locais. Obtendo recebe todas as ramificações dos repositórios remotos, que você pode mesclar com sua ramificação ou apenas inspecionar a qualquer momento.

Para obter as atualizações, faça o seguinte:

  1. Escolha Equipe > Git > Remoto > Obter.
    O assistente Obter do repositório remoto é exibido.

    assistente Obter do repositório remoto

  2. Na página Repositório remoto do assistente, selecione a opção Repositório configurado (para usar o caminho para o repositório anteriormente configurado) ou Especificar repositório Git (para definir o caminho para um repositório remoto que ainda não foi acessado, seu nome, e login e senha, e qualquer configuração de proxy necessária) e clique em Avançar.
  3. Na página Ramificações remotas do assistente, escolha as ramificações para obter as alterações e clique em Concluir.
    Uma cópia local da ramificação remota é criada. A ramificação selecionada é atualizada no diretório Ramificações > Remotas no Navegador de repositório Git.
    A seguir, as atualizações obtidas podem ser mescladas em uma ramificação local.

Extraindo

Ao puxar algumas atualizações de um repositório Git remoto, as alterações são obtidas do mesmo e mescladas no HEAD atual de seu repositório local.
Para executar o puxar, complete as seguintes etapas:

  1. Escolha Equipe > Git > Remoto > Puxar.
    O assistente Puxar do repositório remoto é exibido.

    assistente Obter do repositório remoto

  2. Na página Repositório remoto do assistente, selecione a opção Repositório configurado (para usar o caminho do repositório anteriormente configurado) ou Especificar local do repositório Git (para definir o caminho de um repositório remoto que ainda não foi acessado, seu nome, login e senha, se necessário) e clique em Avançar.
  3. Na página Ramificações remotas do assistente, escolha as ramificações a serem puxadas com as alterações e clique em Concluir.
    Seu repositório local é sincronizado com o repositório de origem.

Expandindo

Para contribuir com alterações de seu repositório Git local para um repositório Git local, execute as seguintes etapas:

  1. Escolha Equipe > Git > Remoto > Empurrar.
    O assistente Empurrar para o repositório remoto é exibido.

    assistente Enviar para o repositório remoto

  2. Na página Repositório remoto do assistente, selecione a opção Repositório configurado (para usar o caminho do repositório anteriormente configurado) ou Especificar local do repositório Git (para definir o caminho de um repositório remoto que ainda não foi acessado, seu nome, login e senha, se necessário) e clique em Avançar.
  3. Na página Selecionar ramificações locais, escolha a ramificações para onde empurrar suas edições e clique em Avançar.
  4. Na página Atualizar referências locais, escolha as ramificações a serem atualizadas no diretório Remoto de seu repositório local e clique em Concluir.
    A ramificação do repositório remoto especificada é atualizada com o estado mais recente de sua ramificação local.

Resumo

Este tutorial demonstrou como executar tarefas de controle de versão básicas no IDE ao guiá-lo através do fluxo de trabalho padrão ao usar o suporte Git do IDE. Ele mostrou como configurar um projeto com controle de versão e como executar tarefas básicas em arquivos com controle de versão e apresentando-o alguns dos novos recursos do Git incluídos no IDE.


Consulte também

Para ver o material relacionado, consulte os seguintes documentos: