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.

Platform navigation

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 saber mais, confira Sincronizar seu branch no GitHub Desktop.

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 saber mais, confira Sobre bifurcações.

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 saber mais, confira Como gerenciar o comportamento dos forks.

Também é possível clonar um repositório diretamente no GitHub ou no GitHub Enterprise. Para saber mais, confira Clonar um repositório do GitHub para o GitHub Desktop.

Clonar um repositório

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

    Captura de tela da barra de menus no Mac. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

  2. 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.

    Captura de tela da janela "Clonar um repositório". Na parte superior da janela, as guias rotuladas como "GitHub.com", "GitHub Enterprise" e "URL" são realçadas com um contorno laranja.

  3. Na lista de repositórios, clique no repositório que você deseja clonar.

    Captura de tela da janela "Clonar um repositório". O repositório "github/docs" está realçado com um contorno laranja.

  4. Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.

    Captura de tela da janela "Clonar um repositório". O botão, rotulado como "Escolher", está realçado com um contorno laranja.

  5. Na parte inferior da janela "Clonar um Repositório", clique em Clonar.

Bifurcar um repositório

É possível criar fork do repositório no GitHub ou no GitHub Desktop. Para saber mais sobre criação de fork no GitHub, confira Criar fork de um repositório.

No GitHub Desktop, se você tentar clonar um repositório ao qual não tem acesso de gravação, um fork será criado automaticamente para você.

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

    Captura de tela da barra de menus no Mac. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. O menu suspenso "Arquivo" é expandido e a opção "Clonar Repositório" está realçada com um contorno laranja.

  2. 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.

    Captura de tela da janela "Clonar um repositório". Na parte superior da janela, as guias rotuladas como "GitHub.com", "GitHub Enterprise" e "URL" são realçadas com um contorno laranja.

  3. Na lista de repositórios, clique no repositório que você deseja clonar.

    Captura de tela da janela "Clonar um repositório". O repositório "github/docs" está realçado com um contorno laranja.

  4. Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.

    Captura de tela da janela "Clonar um repositório". O botão, rotulado como "Escolher", está realçado com um contorno laranja.

  5. Na parte inferior da janela "Clonar um Repositório", clique em Clonar.

  6. Leia as informações em "Como você está planejando usar essa bifurcação?" .

    • Se você pretende usar esse fork para contribuir com o repositório upstream original, clique em Para contribuir com o projeto pai.
    • Se você pretende usar esse fork para um projeto não conectado ao upstream, clique em Para minhas próprias finalidades.
  7. Clique em 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. Na barra de menus, selecione Repositório e clique em Configurações do repositório... .

    Captura de tela da barra de menus no Mac. No menu suspenso "Repositório" que é expandido, o cursor do mouse está sobre "Configurações do repositório", realçado em azul.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Repositório" que é aberto, há uma opção rotulada "Configurações do repositório" com o contorno em laranja.

  2. Na janela "Configurações do repositório", na barra lateral esquerda, clique em Configuração do Fork.

  3. Em "Vou usar este fork...", use os botões de opção para selecionar como você deseja usar o fork.

    Captura de tela do painel "Comportamento do Fork". Dois botões de opção, rotulados como "Para contribuir com o repositório pai" e "Para meus próprios propósitos", estão contornados em laranja.

  4. Clique em Save (Salvar).

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