O painel Controle de origem

Painel de Controle de origem no Studio que fornece um fluxo de trabalho Git completo, incluindo confirmação, push, pull e gerenciamento de ramificação para projetos abertos.

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.

Estrutura e navegação do painel

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.
• Abra a caixa de diálogo Intervalo de alterações ou a janela Gerenciar Staging — consulte Armazenamento de alteraçõ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.

Armazenando alterações

Alternar ramificações ou extrair uma correção urgente em cima de um trabalho inacabado não significa mais sair do Studio para um cliente Git de terceiros. Selecione Alterações do Staging no menu Mais opções para deixar sua árvore de trabalho de lado ou Gerenciar Staging para trazê-la de volta.

A caixa de diálogo Armazenar alterações salva sua árvore de trabalho atual com duas opções:

• Mensagem de arquivo morto (opcional) — uma observação para identificar o arquivo posteriormente.
• Incluir arquivos não rastreados - também armazena arquivos que o Git ainda não está rastreando.

Selecione Armazenar para salvar a árvore de trabalho ou Cancelar para fechar sem ocultar.

A janela Gerenciar suportes lista cada um Staging, com sua mensagem e data de criação e três ações:

• Aplicar — aplique o cache e mantenha-o na lista.
• Pop - aplique o Assistant e remova-o da lista.
• Soltar - exclua o cache sem aplicá-lo. Isso pede confirmação primeiro: "Tem certeza de que deseja excluir este runtime? Essa ação não pode ser desfeita."

Se um hash não puder ser aplicado corretamente - porque há alterações treinadas ou porque os arquivos que ele toca têm modificações não confirmadas - nada é alterado e o Stash é mantido, com uma mensagem nomeando qual dos dois ele era. Por exemplo, a aplicação de um Stash que toca em um arquivo com modificações não confirmadas mostra: "O Stash não pôde ser aplicado porque alguns dos arquivos que ele altera têm modificações não confirmadas. Nada foi alterado e o Stash foi mantido. Confirme ou descarte essas modificações e tente novamente ."

Se a lista de cache foi alterada fora do Studio, a janela Gerenciar Stagings a atualizará e solicitará que você tente novamente em vez de agir em uma lista obsoleta.

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.