O Painel de Controle de Origem

O painel Controle de origem fornece um fluxo de trabalho completo do Git dentro do Studio. O painel fica disponível sempre que um projeto que pertence a um repositório Git está aberto. Ele é ancorado à esquerda do designer junto com outros painéis (Explorador, Atividades, Fragmentos, etc.).

O painel Controle de origem funciona apenas com repositórios Git. Projetos gerenciados com TFS e SVN ainda são gerenciados na aba Backstage equipe .

A primeira vez que você abre o painel, você é instruído a inicializar um repositório Git local. Essa etapa é obrigatória e é realizada automaticamente selecionando 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 commits 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 contém, permitindo que você monitore a atividade rapidamente.

A seção Alterações

A seção Alterações lista todas as alterações de arquivo pendentes, separadas em grupos em estágios e não em estágios.

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

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

• Open File - para abrir o arquivo no painel Designer .
• Descartar Alterações, para reverter o arquivo para seu último estado confirmado.
• Preparar ou Remover teste.
• Adicione a .gitignore, para excluir o arquivo do rastreamento futuro.
• Revelar no Explorador de Arquivos para abrir o local do arquivo na sua máquina.
• Revelar na Exibição do Explorer para abrir o painel do 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 estiver testado explicitamente quando você confirmar, todas as alterações serão testadas automaticamente.

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

• Confirmar: confirma as alterações preparadas localmente.
• Confirmar (Amenizar): adiciona alterações em estágios à confirmação mais recente.
• Confirmar e Enviar por push: confirma e, em seguida, envia por push para a ramificação remota.
• Confirmar e sincronizar: confirma as alterações em estágios e, em seguida, faz pulls e pushes 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:

• Acesse pull, push e busca de todas as operações remotas .
• Preparar todas as alterações.
• Abra a janela Gerenciar Ramificações .

Um selo à 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 commits do seu repositório como um gráfico visual de várias linhas. A seção exibe até 200 confirmações, com rótulos de ramificação e tag, linhas de ramificação codificadas por cores e curva de Bézier para ilustrar conexões de mesclagem.

Selecione o botão de filtro de ramificação para alternar entre quais confirmações exibir:

• Auto: confirma na ramificação atual.
• All: confirmações 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 as alterações remotas sem mesclá-las.
• pull: baixa e mescla as 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 em um arquivo da lista e selecione Comparar com Confirmação Anterior para abrir uma exibição de diferenças no designer.

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

• Fazer check-out: faz check-out do repositório na confirmação selecionada.
• Fazer check-out da ramificação: alterna para a ramificação associada à confirmação selecionada.
• Cherry-Pick Confirmar: aplica as alterações de confirmação à ramificação atual.
• Reverter Confirmação: cria uma nova confirmação que desfazer as alterações introduzidas pela confirmação selecionada.
• Redefinir de forma suave: move o ponteiro de ramificação para a confirmação selecionada, mantendo todas as alterações subsequentes em teste.
• Redefinição total: move o ponteiro de ramificação para a confirmação selecionada e descarta todas as alterações subsequentes.
• Comparar com Árvore de trabalho: abre uma comparação entre a confirmação e seus arquivos locais atuais.
• Comparar com Confirmação anterior: abre uma comparação 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 lugar no 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ças.