Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Criar o primeiro repositório usando o GitHub Desktop

Você pode usar o GitHub Desktop para começar a trabalhar com um repositório Git sem depender da linha de comando.

Neste artigo

Introdução

Este guia documenta o processo de uso do GitHub Desktop para trabalhar em um repositório Git. O GitHub Desktop amplia e simplifica o fluxo de trabalho no GitHub.com com uma interface visual, em vez de comandos de texto na linha de comando. Ao fim da leitura deste guia, você terá usado o GitHub Desktop para criar um repositório, alterá-lo e publicar as alterações no GitHub.com ou no GitHub Enterprise Server.

Depois de baixar o GitHub Desktop e entrar no GitHub ou GitHub Enterprise, você pode criar e clonar um repositório de tutorial. O tutorial apresentará os conceitos básicos de trabalhar com o Git e o GitHub, incluindo instalar um editor, criar um branch, fazer um commit, enviar para o GitHub.com e criar uma pull request. O tutorial será disponibilizado desde que você ainda não tenha repositórios no GitHub Desktop.

Etapa 1. Instalar e entrar no GitHub Desktop

  1. Baixe o GitHub Desktop em https://desktop.github.com/. O GitHub Desktop dá suporte às versões mais recentes do Windows e do Mac. Para obter as instruções específicas de instalação no seu sistema operacional, consulte "Instalar o GitHub Desktop."

  2. Inicie o GitHub Desktop e siga o fluxo inicial de boas-vindas para acessar sua conta do GitHub. Na etapa "Configure Git" (Configurar Git), será possível definir seu nome e endereço de e-mail. Para garantir a atribuição adequada dos commits à sua conta do GitHub, use o endereço de e-mail associado à conta do GitHub. Para obter mais informações sobre a atribuição de commits, consulte "Configurar o endereço de e-mail do commit".

Etapa 2. Criar um repositório

Você verá uma exibição "Let's get started!" (Vamos começar!), onde é possível optar por criar e clonar um repositório de tutorial, clonar um repositório existente, criar um repositório ou adicionar um repositório existente.

Criar e clonar um repositório de tutorial

  1. Clique em Create a tutorial repository and clone it (Criar um repositório de tutorial e cloná-lo).
    Botão Create and clone a tutorial repository (Criar e clonar um repositório de tutorial)
  2. Siga as solicitações no tutorial.

Criar um repositório

  1. Clique em Create a New Repository on your hard drive (Criar um repositório no disco rígido).
    Criar um repositório
  2. To create a new repository, fill out the fields:

    Opções de criar um repositório

    • "Name" (Nome) define o nome do repositório no local e no GitHub.
    • "Description" (Descrição) é um campo opcional com mais informações sobre o propósito do repositório.
    • "Local path" (Caminho local) define o local do repositório no computador. Por padrão, o GitHub Desktop cria uma pasta GitHub dentro da pasta Documents (Documentos) para armazenar seus repositórios, mas é possível escolher qualquer local no computador. O novo repositório será uma pasta dentro do local escolhido. Por exemplo, se você nomear o repositório como Tutorial, será criada uma pasta de nome Tutorial dentro da pasta no caminho selecionado. O GitHub Desktop registra o local escolhido para as próximas vezes que você criar ou clonar repositórios.
    • A opção Initialize this repository with a README (Inicializar este repositório com um LEIAME) cria o commit com um arquivo LEIAME.md. Arquivos LEIAME ajudam as pessoas a entenderem o objetivo do seu projeto. Portanto, é recomendável usar esse item e adicionar informações úteis a ele. Quando alguém acessar seu repositório no GitHub, a primeira informação exibida será o LEIAME. Para obter mais informações, consulte "Sobre LEIAME".
    • O menu suspenso Git ignore (Git para ignorar) permite incluir um arquivo personalizado para ignorar determinados arquivos no repositório local, isto é, informações que você não quer armazenar no controle de versão. Se houver uma linguagem ou framework específico para uso, você poderá selecionar uma opção na lista disponível. Se você estiver começando agora, fique à vontade para ignorar essa opção. Para obter mais informações, consulte "Ignorar arquivos".
    • O menu suspenso License (Licença) permite adicionar uma licença de código aberto a um arquivo LICENSE no repositório. Não se preocupe em adicionar uma licença de imediato. Para obter mais informações sobre as licenças de código aberto disponíveis e sobre como adicioná-las ao repositório, consulte "Criar a licença de um repositório."
  3. Clique em Create Repository (Criar repositório).

Etapa 3. Explorar o GitHub Desktop

Agora que você criou um repositório, o menu de arquivos aparecerá na parte superior da tela. É nele que você pode acessar as configurações e ações possíveis no GitHub Desktop. A maioria das ações tem atalhos de teclado para aumentar a eficiência do seu trabalho. Para obter a lista completa dos atalhos, consulte "Atalhos de teclado no GitHub Desktop."

  1. Abaixo do menu, uma barra mostra o estado atual do repositório no GitHub Desktop:

    • Current repository (Repositório atual) mostra o nome do repositório em que você está trabalhando. Você pode clicar em Current repository (Repositório atual) para alternar entre repositórios no GitHub Desktop.
    • Current branch (Branch atual) mostra o nome do branch em que você está trabalhando. Você pode clicar em Current branch (Branch atual) para exibir todos os branches do repositório, alternar entre branches ou criar um branch. Depois de criar pull requests no repositório, você também poderá exibi-las clicando em Current branch (Branch atual).
    • A opção Publish repository (Publicar repositório) aparece porque você ainda não publicou o repositório no GitHub. A publicação será feita depois, em outra etapa.

    Explorar o GitHub Desktop

  2. Na barra lateral à esquerda, você verá Changes (Alterações) e History (Histórico).

    • A opção Changes (Alterações) mostra as mudanças que você fez nos arquivos do branch atual, mas que ainda estão sem commit no repositório local. Na parte inferior, você verá as caixas "Summary" (Resumo) e "Description" (Descrição), além do botão Commit to master (Fazer commit para o mestre). É nessa área que você fará o commit das novas alterações. O botão Commit (Fazer commit) mostra para qual branch você fará o commit das alterações.

      Área do commit

    • A opção History (Histórico) mostra os commits anteriores no branch atual do repositório. Provavelmente você verá um "Initial commit" (Commit inicial) criado pelo GitHub Desktop quando você criou o repositório. À direita do commit, dependendo das opções escolhidas durante a criação do repositório, você poderá ver arquivos .gitattributes, .gitignore, LICENÇA ou LEIAME. Ao clicar em cada arquivo você verá o diff, que consiste no registro das alterações feitas no arquivo do commit em questão. O diff não mostra todo o conteúdo do arquivo, mas somente as partes que foram alteradas.

      Exibição de histórico

Etapa 4. Fazer push do repositório para o GitHub

No momento, o repositório só existe no seu computador e somente você pode acessá-lo. Publicar o repositório no GitHub vai mantê-lo sincronizado em vários computadores e para todos os integrantes das equipes do projeto em questão. Para publicar o repositório, você fará o "push" dele no GitHub, o que também o deixará disponível no GitHub.com.

  1. Clique em Publish repository (Publicar repositório).

    Publicar repositório

    • Você verá alguns campos familiares. "Name" (Nome) e "Description" (Descrição) são os mesmos que você preencheu ao criar o repositório.
    • Você verá a opção Keep this code private (Manter este código privado). Selecione-a se não quiser compartilhar seu código publicamente com outros usuários no GitHub.
    • A opção suspensa Organization (Organização), se houver, permite publicar o repositório em uma organização específica a que você pertença no GitHub. Não tem problema se você ainda não for integrante de uma organização.
      Etapas para publicar repositório
  2. Clique em Publish repository (Publicar repositório).
  3. É possível acessar o repositório no GitHub pelo GitHub Desktop. No menu do arquivo, clique em Repository (Repositório) e em View on GitHub (Exibir no GitHub). Fazer isso levará você diretamente para o repositório no seu navegador padrão.

Agora que o repositório foi publicado, vamos voltar ao GitHub Desktop e fazer mais alterações no repositório local. Começaremos mostrando como configurar um editor de texto padrão.

Etapa 5. Configurar um editor de texto

Para reduzir o tempo de configuração do ambiente de desenvolvimento, é possível iniciar vários editores de texto e ambientes de desenvolvimento integrado (IDE) diretamente no GitHub Desktop. Em um repositório no GitHub Desktop, você pode abrir a pasta do projeto no seu editor de texto favorito.

  1. Clique em File (Arquivo), Options (Opções) e Advanced (Avançado).
  2. Use o menu suspenso External editor (Editor externo) e selecione um editor. A lista mostrará todos os editores instalados. Se a lista estiver vazia, instale um editor compatível, como o Atom. Para obter uma lista dos editores compatíveis, consulte a integração "Abrir editores externos" no repositório do GitHub Desktop.
    Editor externo
  3. Caso tenha instalado um editor, reinicie o GitHub Desktop para fazê-lo aparecer na lista suspensa External editor (Editor externo).

Etapa 6. Fazer commit e push das alterações

Agora que você configurou um editor padrão, será possível fazer alterações no projeto e começar a criar seu primeiro commit no repositório.

  1. Para iniciar o editor externo pelo GitHub Desktop, clique em Repository (Repositório) e em Open in EDITOR (Abrir no EDITOR).

    Abrir no editor

  2. Comece fazendo algumas alterações no arquivo README.md criado anteriormente. Adicione informações que descrevam o projeto, como a função, a relevância e a utilidade dele. Lembre-se de que esta será a primeira interação das pessoas com o seu projeto. Depois disso, estará tudo pronto para fazer o seu primeiro commit!

  3. Saia do editor de texto, volte para o GitHub Desktop e navegue até a guia Changes (Alterações). Na lista de arquivos, você verá o README.md alterado. A marca de verificação no arquivo README.md indica que as alterações feitas serão parte do seu commit. Talvez você queira fazer alterações em vários arquivos no futuro, mas sem fazer o commit das alterações de todos eles. O GitHub Desktop permite selecionar somente as alterações que você pretende incluir no commit.

    Exibir alterações

  4. Na parte inferior da lista Changes (Alterações), adicione uma mensagem ao commit. À direita da sua foto de perfil, digite uma breve descrição do commit. Já que estamos alterando o arquivo README.md, algo como "Adicionar informações sobre o propósito do projeto" seria um bom resumo. Abaixo do resumo, o campo de texto "Description" (Descrição) permite digitar uma descrição mais longa das alterações feitas no commit. Essa descrição pode ser útil para analisar o histórico de um projeto e entender o motivo das alterações. Como estamos fazendo uma atualização básica do arquivo README.md, fique à vontade para ignorar a descrição.

    Mensagem do commit

  5. Clique em Commit to master (Fazer commit para o mestre). O botão do commit mostra o branch atual (mestre, neste caso) para que você tenha certeza de fazer commit para o branch desejado.

    Fazer commit para o mestre

  6. Para fazer push das alterações no repositório remote no GitHub, clique em Push origin (Fazer push da origem).

    Fazer push de origem

    • Você se lembra do botão Publish (Publicar) usado para publicar o repositório no GitHub? Agora, ele deve mostrar Push origin (Fazer push da origem) com um número 1 ao lado, indicando que ainda não foi feito o push de um commit para o GitHub.
    • O termo "origem" na opção Push origin (Fazer push da origem) indica que estamos fazendo push das alterações para o remote chamado origem que, neste caso, é o repositório do seu projeto no GitHub.com. Até você fazer o push de qualquer commit para o GitHub, haverá diferenças entre o repositório do seu projeto no computador e o repositório do seu projeto no GitHub.com. Assim, você pode trabalhar no local e deixar para fazer push do seu trabalho no GitHub.com quando estiver tudo pronto.
  7. Na área aberta ao lado da guia Changes (Alterações), você verá uma série de sugestões das suas próximas ações. Para abrir o repositório no GitHub no navegador, clique em View on GitHub (Exibir no GitHub).

    Exibir no GitHub

  8. No navegador, clique em 2 commits. Você verá uma lista dos commits neste repositório no GitHub. O primeiro commit deve ser o que você acabou de fazer no GitHub Desktop!

    Clicar em dois commits

Conclusão

Parabéns! Você acabou de criar e publicar um repositório no GitHub, e também fez um commit e fez push das alterações. Isso é apenas o começo! Você pode fazer muito mais com o GitHub e o GitHub Desktop. Esperamos que esse exercício estimule a sua vontade de conhecer ainda mais nossos recursos e possibilidades.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato