Criar o primeiro repositório usando o GitHub Desktop

Introdução

O GitHub Desktop é um aplicativo gratuito e de código aberto que ajuda você a trabalhar com o código hospedado no GitHub ou em outros serviços de hospedagem Git. Com o GitHub Desktop, você pode executar comandos do Git, como fazer commit e push de alterações, em uma interface gráfica do usuário, em vez de usar a linha de comando. Para saber mais, confira Sobre o GitHub Desktop.

Ao final deste guia, você terá usado GitHub Desktop para criar um repositório, fazer alterações no repositório e publicar as alterações em GitHub.

Depois de instalar GitHub Desktop e entrar em GitHub ou em GitHub Enterprise, você pode criar e clonar um repositório de tutorial. O tutorial apresentará os conceitos básicos para trabalhar com Git e GitHub, incluindo a instalação de um editor de texto, a criação de uma ramificação, fazer um commit, enviar para GitHub e abrir um pull request. O tutorial está disponível se você não tiver nenhum repositório em GitHub Desktop ainda.

É recomendável concluir o tutorial, mas se você quiser explorar GitHub Desktop criando um novo repositório, este guia o orientará usando GitHub Desktop para trabalhar em um repositório Git.

Parte 1: Instalar GitHub Desktop e autenticar sua conta

Você pode instalar GitHub Desktop em qualquer sistema operacional com suporte. Depois de instalar o aplicativo, você precisará fazer login e autenticar a sua conta em GitHub ou GitHub Enterprise antes de poder criar e clonar um repositório de tutorial.

Para obter mais informações sobre como instalar e autenticar, confira Configurar o GitHub Desktop.

Parte 2: Criando um novo repositório

Se você não tiver nenhum repositório associado a GitHub Desktop, você verá um "Vamos começar!" em que você pode optar por criar e clonar um repositório de tutorial, clonar um repositório existente da Internet, criar um novo repositório ou adicionar um repositório existente do disco rígido.

Criar e clonar um repositório de tutorial

Recomendamos que você crie e clone um repositório de tutoriais como seu primeiro projeto a ser praticado usando GitHub Desktop.

1. Clique em Criar um Repositório de Tutoriais... .
2. Siga as instruções do tutorial para instalar um editor de texto, criar uma branch, editar um arquivo, fazer um commit, publicar em GitHub e abrir um pull request.

Criar um repositório

Se você não desejar criar e clonar um repositório de tutorial, é possível criar um novo repositório.

1. Clique em Criar um Repositório no Disco Rígido... .
2. Na janela "Criar um Repositório", preencha os campos e selecione suas opções preferidas.
   • "Name" define o nome do seu repositório tanto localmente quanto 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, GitHub Desktop cria uma pasta GitHub dentro da pasta Documentos para armazenar seus repositórios, mas você pode escolher qualquer local em seu computador. O novo repositório será uma pasta dentro do local escolhido. Por exemplo, se você der o nome Tutorial ao repositório, será criada uma pasta chamada Tutorial dentro da pasta selecionada no caminho local. GitHub Desktop lembra o local escolhido na próxima vez que você criar ou clonar um novo repositório.
   • A opção Inicializar este repositório com um LEIAME cria um commit inicial com um arquivo LEIAME.md. Arquivos README 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 visita seu repositório no GitHub, o README é a primeira coisa que verá ao conhecer seu projeto. Para saber mais, confira Sobre o arquivo README do repositório.
   • O menu suspenso Git ignore permite incluir um arquivo personalizado para ignorar determinados arquivos no repositório local que você não deseja 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 saber mais, confira Ignorar arquivos.
   • O menu suspenso Licença permite adicionar uma licença de código aberto a um arquivo LICENSE do repositório. Não é preciso se preocupar em adicionar uma licença imediatamente. Para obter mais informações sobre as licenças de código aberto disponíveis e como adicioná-las ao repositório, confira Licenciar um repositório.
3. Clique em Criar repositório.

Parte 3: Explorando GitHub Desktop

No menu arquivo na parte superior da tela, você pode acessar configurações e ações que podem ser executadas em GitHub Desktop. A maioria das ações tem atalhos de teclado para aumentar a eficiência do seu trabalho. Para obter uma lista completa de atalhos de teclado, confira Atalhos de teclado do GitHub Desktop.

GitHub Desktop A barra do repositório

Na parte superior do GitHub Desktop aplicativo, você verá uma barra que mostra o estado atual do repositório.

• A opção Repositório atual mostra o nome do repositório em que você está trabalhando. Você pode clicar no repositório atual para alternar para um repositório diferente em GitHub Desktop.
• A opção Ramo atual mostra o nome do ramo em que está trabalhando. Clique em Ramo atual para ver todos os ramos do repositório, alternar para outro ramo ou criar um novo ramo. Depois de criar solicitações de pull no repositório, você também poderá vê-las clicando em Branch atual.
• Publicar repositório aparece porque você ainda não publicou seu repositório no GitHub, o que fará mais adiante, na próxima etapa. Esta seção da barra mudará com base no status de seu branch atual e repositório. Diferentes ações dependentes de contextos estarão disponíveis para o intercâmbio de dados entre repositórios locais e remotos.

Alterações e histórico

Na barra lateral esquerda, você encontrará as exibições Alterações e Histórico.

• A exibição Alterações mostra as alterações que você fez nos arquivos do branch atual, mas que ainda não foram commitadas no repositório local. Na parte inferior, há uma caixa com as caixas de texto "Resumo" e "Descrição" e um botão Fazer Commit no BRANCH. É nessa área que você fará o commit das novas alterações. O botão Fazer Commit no BRANCH é dinâmico e exibirá o branch no que você está fazendo o commit das alterações.
• A opção Histórico mostra os commits anteriores no branch atual do repositório. Você verá um "commit inicial" que foi criado por GitHub Desktop quando criou o seu repositório. À direita do commit, dependendo das opções escolhidas durante a criação do repositório, você poderá ver os arquivos .gitattributes, .gitignore, LICENSE ou README. Ao clicar em cada arquivo, você poderá ver um diff específico para aquele arquivo, que mostra as alterações feitas no arquivo no commit em questão. O diff não mostra todo o conteúdo do arquivo, mas somente as partes que foram alteradas

Parte 4: Publicando seu repositório para GitHub

Ao criar um novo repositório, ele existe apenas no seu computador e você é o único que pode acessar o repositório. Você pode publicar seu repositório para GitHub mantê-lo sincronizado em vários computadores e permitir que outras pessoas o acessem. Para publicar seu repositório, envie suas alterações locais por push para GitHub.

1. Na barra do repositório, clique em Publicar repositório.

1. Na janela "Publicar Repositório", insira os detalhes do novo repositório.
   • GitHub Desktop preenche automaticamente os campos "Nome" e "Descrição" com as informações inseridas quando você criou o repositório.
   • A opção Manter este código privado permite que você controle quem pode ver seu projeto. Se você deixar essa opção não selecionada, outros usuários GitHub poderão exibir seu código. Se você selecionar esta opção, o seu código não ficará disponível publicamente.
   • O menu suspenso Organização, se presente, permite que você publique seu repositório para uma organização específica da qual você faz parte no GitHub.
   1. Clique em Publicar Repositório.
   2. Você pode acessar o repositório no GitHub de dentro de GitHub Desktop. No menu Arquivo, clique em Repositório e em Exibir no GitHub. Fazer isso levará você diretamente para o repositório no seu navegador padrão.

Parte 5: Fazer commit e carregar as alterações

Agora que você criou e publicou seu repositório, você está pronto para fazer alterações no seu projeto e começar a criar seu primeiro commit no seu repositório.

1. Para iniciar o editor externo de dentro GitHub Desktop, na barra de menus "GitHub Desktop", selecione Repositório e clique em Abrir no EDITOR. Para saber mais, confira Configurar um editor padrão no GitHub Desktop.

1. Faça algumas alterações no arquivo README.md que você criou anteriormente. Você pode adicionar informações que descrevem o seu projeto, como o que ele faz e por que ele é útil. Quando estiver satisfeito com suas alterações, salve-as no editor de texto.
2. Em GitHub Desktop, navegue até a visualização Alterações. Na lista de arquivos, você verá o README.md. A caixa de seleção à esquerda do arquivo README.md indica que as alterações feitas no arquivo farão parte do commit que você fez. Talvez você queira fazer alterações em vários arquivos no futuro, mas sem fazer o commit das alterações de todos eles. Se você clicar na caixa de seleção ao lado de um arquivo, esse arquivo não será incluído no commit.

1. Na parte inferior da lista Alterações, insira uma mensagem de commit. À direita da sua foto de perfil, digite uma breve descrição do commit. Como estamos alterando o arquivo README.md, um bom resumo do commit será "Adição de informações sobre a finalidade do projeto". Abaixo do resumo, o campo de texto "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 você está fazendo uma atualização básica do arquivo README.md, ignore a descrição.

1. Abaixo da mensagem de confirmação, clique em Confirmar para NOME DO BRANCH. O botão do commit mostra o seu branch atual. Dessa forma, você pode ter certeza de que deseja fazer o commit no branch desejado.
2. Para enviar suas alterações para o repositório remoto no GitHub, clique em Push origin.

• O botão Push origin é o mesmo botão em que você clicou para publicar seu repositório em GitHub. Este botão muda contextualmente de acordo com o local em que você está no fluxo de trabalho do Git. Agora deve aparecer Push origin com um 1 ao lado dele, indicando que há um commit que ainda não foi enviado para GitHub.
• A "origem" na origem do push significa que você está enviando alterações por push para o remoto chamadoorigin, que nesse caso é o repositório do seu projeto.GitHub Até que você faça push de novos commits para GitHub, haverá diferenças entre o repositório do seu projeto no computador e o repositório do seu projeto em GitHub. Isso permite que você trabalhe localmente e só faça push das suas alterações para GitHub quando estiver pronto.

1. Na janela à direita da exibição Alterações, você verá sugestões de ações que poderá executar em seguida. Para abrir o repositório em GitHub no seu navegador, clique em Ver em GitHub.

1. No navegador, clique em 2 commits. Você verá uma lista das confirmações neste repositório em GitHub. O primeiro commit deve ser o commit que você acabou de fazer em GitHub Desktop.

Conclusão

Agora você criou um repositório, publicou o repositório para GitHub, fez uma confirmação e efetuou push de suas alterações para GitHub. Você pode seguir esse mesmo fluxo de trabalho ao contribuir para outros projetos os quais você cria ou nos quais você colabora.

Leitura adicional

• Noções básicas do Git
• Aprendendo sobre GitHub
• Introdução à documentação do GitHub