Gerenciar branches no GitHub Desktop

Você pode usar o GitHub Desktop para criar uma nova ramificação de uma já existente no seu repositório, permitindo que você experimente com mudanças de forma segura.

Platform navigation

Neste artigo

Sobre o gerenciamento de branches

Você pode usar ramificações para experimentar de forma segura alterações em seu projeto. Os branches permitem isolar seu trabalho de desenvolvimento dos demais ramos dentro do repositório. Por exemplo, você poderia usar um branch para desenvolver um novo recurso ou corrigir um erro.

Você sempre cria um ramo a partir de um ramo existente. Normalmente, você pode criar um branch a partir do branch-padrão do seu repositório. Você poderá então trabalhar nesse novo ramo, isolado das mudanças que outras pessoas estão fazendo no repositório.

Você também pode criar um branch a partir de um commit anterior no histórico de um branch. Isso pode ser útil se você precisar retornar a um estado anterior do repositório para investigar um erro ou para criar uma correção rápida sobre sua versão mais recente.

Quando seu trabalho estiver satisfatório, você poderá criar um pull request para fazer merge nas suas alterações na ramificação atual em outra ramificação. Para saber mais, confira Criar um problema ou solicitação de pull do GitHub Desktop e Sobre solicitação de pull.

É sempre possível criar um branch no GitHub Desktop, se tiver acesso de leitura a um repositório, mas você só pode fazer push do branch para o GitHub se você tiver acesso de gravação no repositório.

Os administradores de repositório podem habilitar proteções em um branch. Se estiver trabalhando em um branch que é protegido, não será possível excluir nem forçar o push no branch. Os administradores de repositório podem ativar outras configurações protegidas de branch para aplicar fluxos de trabalho específicos antes que um branch possa ser mesclado. Para saber mais, confira Sobre branches protegidos.

Os administradores de repositório também podem habilitar conjuntos de regras. Os conjuntos de regras podem ser usados para exigir nomes de ramificação específicos ao criar uma nova ramificação ou para permitir que apenas usuários com permissões de bypass publiquem uma nova ramificação no repositório remoto. GitHub Desktop mostrará um aviso e impedirá que a ramificação seja criada se a ramificação não seguir os conjuntos de regras. Para saber mais, confira Sobre os conjuntos de regras.

Criar um branch

Dica

O primeiro branch criado será baseado no branch padrão. Se você tiver mais de uma ramificação, você pode escolher basear a nova ramificação na ramificação atualmente verificada ou na ramificação padrão.

  1. Na parte superior do aplicativo, clique em Current Branch e, na lista de branches, clique no branch no qual deseja basear o novo branch.

    Captura de tela da exibição suspensa "Branch Atual". Em "Branches Recentes", um branch, chamado "my-feature", está realçado com um contorno laranja.

  2. Clique em Novo Branch.

    Captura de tela da exibição suspensa "Ramificação atual". Ao lado do campo "Filtro", um botão, rotulado como "Novo Branch", é descrito em laranja.

  3. Na janela "Criar um branch", em "Nome", digite o nome do novo branch.

  4. Em "Criar branch com base em...", selecione um branch base para o novo branch.

  5. Clique em Criar Branch.

Criando um ramo a partir de um commit anterior

  1. Na barra lateral esquerda, clique em Histórico.

    Captura de tela da guia "Histórico" na barra lateral. Acima de uma lista de confirmações, o botão da guia "Histórico" está realçado com um contorno laranja.

  2. Clique com o botão direito do mouse no commit com base no qual deseja criar um branch e selecione Criar Branch com base no Commit.

    Captura de tela de uma lista de commits na guia "Histórico". Ao passar o cursor sobre um commit, a opção "Criar ramificação a partir do commit" aparece no menu de contexto.

  3. Na janela "Criar um branch", em "Nome", digite o nome do novo branch.

  4. Clique em Criar Branch.

Publicar um branch

Se você criar um branch no GitHub Desktop, você deverá publicá-lo para disponibilizá-lo para colaboração no GitHub.

  1. Na barra do repositório, clique em Current Branch e, em seguida, no branch que deseja publicar.

    Captura de tela da exibição suspensa "Ramificação atual". Em "Branches Recentes", uma ramificação, chamada "my-feature", está realçada com um contorno laranja.

  2. Clique em Publicar branch.

           ![Captura de tela da barra do repositório. No lado direito, um botão, rotulado como "Publicar branch", é realçado com uma estrutura de tópicos laranja.](/assets/images/help/desktop/publish-branch-button.png)

Alternar entre branches

É possível exibir e fazer commits em qualquer branch do seu repositório. Se houver alterações salvas sem commit, você terá que decidir o que fazer com elas antes de poder alternar entre os branches. Você pode fazer o commit das alterações na ramificação atual, ocultar as suas alterações para salvá-las temporariamente na ramificação atual ou trazer as mudanças para sua nova ramificação. Se você deseja confirmar suas alterações antes de mudar de branch, veja Realizar o commit e revisar as alterações no seu projeto no GitHub Desktop.

Dica

Você pode definir um comportamento padrão nas configurações de Prompts para alternar branches. Para saber mais, confira Definir configurações básicas no GitHub Desktop.

  1. Na barra do repositório, clique em Current Branch e, em seguida, no branch para o qual deseja alternar.
    Captura de tela da exibição suspensa "Ramificação atual". Em "Branches Recentes", uma ramificação, chamada "my-feature", está destacada com um contorno laranja.
  2. Se você salvou alterações não confirmadas na janela "Alternar Branch", selecione Deixar minhas alterações em CURRENT-BRANCH ou Trazer minhas alterações para NEW-BRANCH e clique em Alternar Branch.

Excluir um branch

Não é possível excluir um branch se ele estiver atualmente associado a uma pull request aberta. Não é possível desfazer a exclusão de um branch.

  1. Na barra do repositório, clique em Current Branch e, em seguida, no branch que deseja excluir.
    Captura de tela da exibição suspensa "Branch Atual". Em "Branches Recentes", um branch, chamado "my-feature", está realçado com um contorno laranja.
  2. Na barra de menus, clique em Branch e em Excluir... . Você também pode pressionar Shift+Command+D.
    Captura de tela da barra de menus em um Mac. No menu suspenso "Branch" expandido, o cursor passa o mouse sobre a opção "Excluir", realçada em azul.
  1. Na barra do repositório, clique em Current Branch e, em seguida, no branch que deseja excluir.
    Captura de tela da exibição suspensa "Branch Atual". Em "Branches Recentes", um branch, chamado "my-feature", está realçado com um contorno laranja.
  2. Na barra de menus, clique em Branch e em Excluir... . Você também pode pressionar Ctrl+Shift+D.
    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Branch" que é expandido, há uma opção rotulada "Excluir" com o contorno em laranja.

Leitura adicional