O painel Controle de origem

O painel Controle de origem fornece um fluxo de trabalho do Git completo dentro do Studio. O painel estará disponível sempre que um projeto que pertence a um repositório do Git estiver aberto. Ele está encaixado à esquerda do designer, junto com outros painéis (Explorer, Activities, Snippets etc.).

O painel Controle de origem funciona apenas com repositórios do Git. Os projetos gerenciados com TFS e SVN ainda são gerenciados a partir da guia Backstage da Equipe.

Na primeira vez que abre o painel, você recebe instruções para inicializar um repositório do Git local. Essa etapa é obrigatória e é realizada automaticamente ao selecionar o botão Inicializar repositório.

O painel contém duas seções distintas:

1. Alterações: lista todos os arquivos que foram modificados, adicionados, excluídos ou renomeados na árvore de trabalho e hospeda os controles de confirmação.
2. Gráfico: renderiza o histórico de confirmações do repositório como um gráfico visual interativo.

Clicar em cada cabeçalho de seção recolhe ou expande a seção correspondente. Quando uma seção é recolhida, seu cabeçalho exibe o número de itens que ela contém, permitindo que você monitore a atividade instantaneamente.

A seção Alterações

A seção Alterações lista todas as alterações pendentes de arquivos, separadas em grupos de alterações preparadas e não preparadas.

Cada entrada de arquivo apresenta uma letra de status codificada por cores (M – modificado, A – adicionado, D – excluído, R – renomeado, U – não rastreado).

Focalize ou clique com o botão direito do mouse em um arquivo para acessar opções específicas do arquivo:

• Abrir Arquivo, para abrir o arquivo no painel Designer.
• Descartar alterações, para reverter o arquivo a seu último estado confirmado.
• Preparar ou Desfazer preparação.
• Adicionar a .gitignore, para excluir o arquivo de rastreamentos futuros.
• Revelar no Explorador de Arquivos, para abrir o local do arquivo em sua máquina.
• Revelar na visualização do Explorer, para abrir o painel Explorer.

Use o campo Mensagem para escrever sua mensagem de confirmação. Após escrever sua mensagem, selecione Confirmar ou use o atalho de teclado CTRL + Enter. Se nenhum arquivo for explicitamente preparado no momento da confirmação, todas as alterações serão definidas automaticamente.

Selecione a seta ao lado do botão Confirmar para acessar mais opções:

• Confirmar: confirma alterações preparadas localmente.
• Confirmar (alterar): adiciona alterações preparadas à confirmação mais recente.
• Confirmar e efetuar push: confirma e, em seguida, efetua push para a ramificação remota.
• Confirmar e sincronizar: confirma alterações preparadas e, em seguida, efetua pull e push para sincronizar com a ramificação remota.

Selecione o botão Atualizar na parte superior da seção Alterações para recarregar a seção.

Você também pode selecionar o botão Mais opções para:

• Acessar as operações de Pull, Push e Fetch de todos os remotos.
• Preparar todas as alterações.
• Abrir a janela Gerenciar ramificações.

Um selo de à frente/atrás ao lado do nome da ramificação na barra de ferramentas mostra o número de confirmações que sua ramificação local está à frente e atrás da ramificação de rastreamento remoto.

A seção Gráfico

A seção Gráfico renderiza o histórico de confirmações de seu repositório como um gráfico visual de várias faixas. A seção exibe até 200 confirmações, com rótulos de ramificação e tag, linhas de ramificação codificadas por cores e curvas de Bézier para ilustrar as conexões de mesclagem.

Selecione o botão Filtro de ramificação para alternar entre quais confirmações devem ser exibidas:

• Auto: confirma na ramificação atual.
• Todos: confirma em todas as ramificações.
• Confirma apenas em uma ramificação específica.

Botões separados permitem que você acesse funções como:

• Buscar todos os remotos: baixa alterações remotas sem mesclá-las.
• Pull: baixa e mescla alterações remotas na ramificação atual.
• Push: carrega as alterações locais confirmadas para a ramificação remota.

Você também pode atualizar a seção a partir do botão dedicado.

Cada linha na seção Gráfico representa uma confirmação. Passar o mouse sobre uma confirmação mostra o autor da confirmação, a data, a mensagem e o SHA abreviado. Você também pode copiar o SHA completo para a área de transferência.

Os arquivos que foram alterados estão listados na lista Arquivos alterados. Clique com o botão direito do mouse em um arquivo da lista e selecione Comparar com confirmação anterior para abrir uma visualização de diferença no designer.

Clicar com o botão direito do mouse em uma confirmação dá acesso às seguintes opções:

• Fazer checkout da confirmação: verifica o repositório na confirmação selecionada.
• Fazer checkout da ramificação: alterna para a ramificação associada à confirmação selecionada.
• Selecionar confirmação: aplica as alterações da confirmação à ramificação atual.
• Reverter confirmação: cria uma nova confirmação que desfaz as alterações introduzidas pela confirmação selecionada.
• Redefinição temporária: move o ponteiro da ramificação para a confirmação selecionada, mantendo todas as alterações subsequentes preparadas.
• Redefinição definitiva: move o ponteiro da ramificação para a confirmação selecionada e descarta todas as alterações subsequentes.
• Comparar com árvore de trabalho: abre uma diferença entre a confirmação e seus arquivos locais atuais.
• Comparar com confirmação anterior: abre uma diferença entre a confirmação e sua confirmação pai.
• Copiar SHA de confirmação: copia o SHA de confirmação completo para a área de transferência.

Clicar em um arquivo em qualquer parte do painel Controle de origem (na área Alterações ou em uma linha de confirmação expandida na área Gráfico) abre a visualização de diferença.