Skip to main content

Introdução ao GitHub Desktop

Saiba como definir, autenticar e configurar o GitHub Desktop para permitir que você contribua para projetos diretamente a partir da sua máquina.

Introdução

O GitHub Desktop é um aplicativo que permite que você interaja com o GitHub usando uma GUI em vez da linha de comando ou de um navegador web. GitHub Desktop incentiva você e sua equipe a colaborar usando as melhores práticas com Git e GitHub. Você pode usar GitHub Desktop para realizar a maioria dos comandos do Git a partir de seu computador com a confirmação visual das mudanças. Você pode fazer subir, extrair e clonar repositórios remotos com o GitHub Desktop e usar ferramentas colaborativas como atribuir commits e criar pull requests.

Este guia ajudará você a dar os primeiros passos com GitHub Desktop criando o aplicativo, autenticando sua conta, configurando as configurações básicas e introduzindo os fundamentos do gerenciamento de projetos com GitHub Desktop. Você poderá usar o GitHub Desktop para colaborar em projetos e conectar-se a repositórios remotos depois de trabalhar neste guia.

Você pode achar útil ter um entendimento básico do Git e do GitHub antes de começar a usar o GitHub Desktop. Para obter mais informações, consulte os seguintes artigos.

GitHub Desktop é um projeto de código aberto. Você pode ver o itinerário, contribuir com o projeto ou abrir um problema para dar feedback ou solicitações de recursos. Para obter mais informações, confira o repositório desktop/desktop.

Parte 1: Instalar e autenticar

Você pode instalar o GitHub Desktop em qualquer sistema operacional compatível. Para obter mais informações, confira "Sistemas operacionais compatíveis".

Para instalar o GitHub Desktop, acesse a página de download do GitHub Desktop. Para obter mais informações, confira "Como instalar o GitHub Desktop".

Depois de ter instalado o GitHub Desktop, você pode autenticar o aplicativo com sua conta no GitHub ou no GitHub Enterprise. A autenticação permite que você se conecte a repositórios remotos no GitHub ou no GitHub Enterprise.

  1. Antes de poder efetuar a autenticação em GitHub ou em GitHub Enterprise, você precisará de uma conta. Para obter mais informações sobre como criar uma conta, confira "Como se inscrever para uma nova conta do GitHub" ou entre em contato com o administrador do site do GitHub Enterprise.

  2. No menu suspenso do GitHub Desktop, clique em Preferências. Na janela de preferências, clique em Contas e siga as etapas para se conectar. Para obter mais informações sobre autenticação, confira "Autenticação no GitHub". Botão Entrar do GitHub

  1. Antes de poder efetuar a autenticação em GitHub ou em GitHub Enterprise, você precisará de uma conta. Para obter mais informações sobre como criar uma conta, confira "Como se inscrever para uma nova conta do GitHub" ou entre em contato com o administrador do site do GitHub Enterprise.

  2. No menu suspenso Arquivo, clique em Opções. Na janela de opções, clique em Contas e siga as etapas para se conectar. Para obter mais informações sobre autenticação, confira "Autenticação no GitHub". Botão Entrar do GitHub

Parte 2: Configurar e personalizar o GitHub Desktop

Depois de instalar o GitHub Desktop, você pode configurar e personalizar o aplicativo para melhor atender às suas necessidades.

Você pode conectar ou remover contas no GitHub ou no GitHub Enterprise, escolher um editor de texto padrão ou shell, editar a sua configuração do Git, alterar a aparência de GitHub Desktop, personalizar caixas de diálogo do sistema e configurar preferências de privacidade na janela Preferências do GitHub Desktop. Para obter mais informações, confira "Como definir configurações básicas".

As configurações básicas na janela de Preferências

Você pode conectar ou remover contas no GitHub ou no GitHub Enterprise, escolher um editor de texto padrão ou shell, editar a sua configuração do Git, alterar a aparência de GitHub Desktop, personalizar as caixas de diálogo do sistema e configurar preferências de privacidade na janela de Opções do GitHub Desktop. Para obter mais informações, confira "Como definir configurações básicas".

As configurações básicas na janela de Opções

Parte 3: Contribuir com projetos com GitHub Desktop

Após instalar, efetuar a autenticação e configurar o aplicativo, você está pronto para começar a usar o GitHub Desktop. Você pode criar, adicionar ou clonar repositórios e usar o GitHub Desktop para gerenciar as contribuições dos seus repositórios.

Criar, adicionando e clonar repositórios

Você pode criar um repositório selecionando o menu Arquivo e clicando em Novo repositório… . Para obter mais informações, confira "Como criar seu primeiro repositório usando o GitHub Desktop".

Você pode adicionar um repositório do computador local selecionando o menu Arquivo e clicando em Adicionar Repositório Local… . Para obter mais informações, confira "Como adicionar um repositório do computador local ao GitHub Desktop".

Você pode clonar um repositório do GitHub selecionando o menu Arquivo e clicando em Clonar Repositório… . Para obter mais informações, confira "Como clonar repositórios do GitHub Desktop e criar forks deles".

Opções do menu Arquivo para criar, adicionar e clonar repositórios

Opções do menu Arquivo para criar, adicionar e clonar repositórios

Fazer alterações em um branch

Você pode usar GitHub Desktop para criar um branch de um projeto. Os branches isolam o seu trabalho de desenvolvimento de outros branches no repositório, para que você possa experimentar com segurança as alterações. Para obter mais informações, confira "Como gerenciar branches".

O botão do Novo Branch

Após fazer alterações em um branch, você poderá revisá-las em GitHub Desktop e fazer um commit para acompanhar suas alterações. Para obter mais informações, confira "Como fazer commit das alterações no seu projeto e revisá-las".

Visualizar e fazer commits

Se você desejar acessar as suas alterações remotamente ou compartilhá-las com outras pessoas, você poderá fazer push dos seus commits para o GitHub. Para obter mais informações, confira "Como efetuar push de alterações para o GitHub".

Colaborar com GitHub Desktop

Você pode usar o GitHub Desktop para criar problemas ou pull requests para colaborar em projetos com outras pessoas. Os problemas ajudam você a monitorar as ideias e a discutir possíveis mudanças nos projetos. Os pull requests permitem que você compartilhe as suas alterações propostas com outras pessoas, receba feedback e mescle as alterações em um projeto. Para obter mais informações, confira "Como criar um problema ou uma solicitação de pull".

Você poderá visualizar os pull requests do seu próprio colaborador em GitHub Desktop. Visualizar um pull request no GitHub Desktop permite que você veja todas as alterações propostas e faça alterações adicionais abrindo os arquivos e repositórios do projeto no editor de texto padrão. Para obter mais informações, confira "Como ver uma solicitação de pull no GitHub Desktop".

Manter o seu repositório local em sincronia

Ao fazer as alterações nos seus repositórios locais ou quando outras pessoas fizerem alterações nos repositórios remotos, você precisará sincronizar sua cópia local do projeto com o repositório remoto. O GitHub Desktop pode manter sua cópia local de um projeto sincronizada com a versão remota, fazendo push e pull de commits. Para obter mais informações, confira "Como sincronizar seu branch".

Leitura adicional