Skip to main content

Clonagem e bifurcar repositórios do GitHub Desktop

É possível usar o GitHub Desktop para clonar e bifurcar os repositórios do GitHub.

Sobre repositórios locais

Repositórios em GitHub são repositórios remotos. É possível clonar ou bifurcar um repositório com GitHub Desktop para criar um repositório local no seu computador.

É possível criar uma cópia local de qualquer repositório em GitHub que que tem acesso ao clonar o repositório. Se você tem um repositório ou tem permissões de gravação, você pode fazer a sincronização entre os locais e os locais remotos. Para obter mais informações, confira "Como sincronizar seu branch".

Ao clonar um repositório, todas as alterações que você fizer push em GitHub afetarão o repositório original. Para fazer alterações sem afetar o projeto original, é possível criar uma cópia separada fazendo uma bifurcação do repositório. É possível criar uma pull request para propor que os mantenedores incorporem as alterações na sua bifurcação no repositório original ascendente. Para obter mais informações, confira "Sobre os forks".

Ao tentar usar GitHub Desktop para clonar um repositório no qual você não tem acesso de gravação, GitHub Desktop irá solicitar que você crie uma bifurcação automaticamente. Você pode optar por usar a sua bifurcação para contribuir para o repositório original a ascendente ou trabalhar de forma independente no seu próprio projeto. Todas as bifurcações existentes contribuem, por padrão, com alterações nos seus repositórios ascendentes. Você pode modificar esta escolha a qualquer momento. Para obter mais informações, confira "Como gerenciar o comportamento dos forks".

Também é possível clonar um repositório diretamente no GitHub ou no GitHub Enterprise. Para obter mais informações, confira "Como clonar um repositório do GitHub para o GitHub Desktop".

Clonar um repositório

  1. No menu Arquivo, clique em Clonar Repositório.

    Opção de menu Clone (Clonar) no app Mac

    Opção de menu Clone (Clonar) no app Windows

    1. Clique na aba que corresponde à localização do repositório que você deseja clonar. Clique também na **URL** para inserir o local do repositório manualmente.

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    1. Escolha o repositório que você quer clonar na lista.

    Clonar uma lista de repositórios

    Clonar uma lista de repositórios

    1. Clique em **Escolher…** e procure um caminho local em que deseja clonar o repositório.

    Botão Choose (Escolher)

    Botão Choose (Escolher)

    1. Clique em **Clonar**.

    Botão Clone (Clonar)

    Botão Clone (Clonar)

Bifurcar um repositório

Caso você clone um repositório que não tenha acesso de gravação, GitHub Desktop criará uma bifurcação. Depois de criar ou clonar uma bifurcação, GitHub Desktop perguntará como você planeja usar a bifurcação.

  1. No menu Arquivo, clique em Clonar Repositório.

    Opção de menu Clone (Clonar) no app Mac

    Opção de menu Clone (Clonar) no app Windows

    1. Clique na aba que corresponde à localização do repositório que você deseja clonar. Clique também na **URL** para inserir o local do repositório manualmente.

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    1. Escolha o repositório que você quer clonar na lista.

    Clonar uma lista de repositórios

    Clonar uma lista de repositórios

    1. Clique em **Escolher…** e procure um caminho local em que deseja clonar o repositório.

    Botão Choose (Escolher)

    Botão Choose (Escolher)

    1. Clique em **Clonar**.

    Botão Clone (Clonar)

    Botão Clone (Clonar)

    1. Se você pretende usar esse fork para contribuir com o repositório upstream original, clique em **Para contribuir com o projeto pai**.

    Contribuir com a opção do menu do projeto principal

    Contribuir com a opção do menu do projeto principal

  2. Se você pretende usar esse fork para um projeto não conectado ao upstream, clique em Para minhas próprias finalidades.

    Contribuir com uma opção independente de menu de projeto

    Contribuir com uma opção independente de menu de projeto

  3. Clique em Continuar.

    O botão continuar

    O botão continuar

Gerenciar o comportamento da bifurcação

Você pode alterar como uma bifurcação se comporta com o repositório ascendente em GitHub Desktop.

  1. Abra o menu Repositório e clique em Configurações do repositório... .

    Opção de menu de configurações do repositório no aplicativo Mac

    Opção do menu de configurações do repositório no aplicativo Windows

    1. Clique em **Comportamento do fork** e escolha como deseja usar o fork.

    A opção de contribuir para o repositório principal no menu de Comportamento da Bifurcação

    A opção de contribuir para o repositório principal no menu de Comportamento da Bifurcação

  2. Clique em Salvar.

    Botão salvar no menu de Comportamento da Bifurcação

    Botão salvar no menu de Comportamento da Bifurcação

Criando um alias para um repositório local

Você pode criar um alias para um repositório local para ajudar a diferenciar entre repositórios do mesmo nome em GitHub Desktop. Criar um alias não afeta o nome do repositório no GitHub. Na lista de repositórios, os aliases aparecem em itálico.

  1. No canto superior esquerdo de GitHub Desktop, à direita do nome atual do repositório, clique em .
  2. Clique com o botão direito do mouse no repositório para o qual deseja criar um alias e clique em Criar Alias.
  3. Digite um alias para o repositório.
  4. Clique em Criar Alias.

Leitura adicional