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.

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.

Neste artigo

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Ou, learn how to contribute.

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, consulte 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, consulte "Sistemas operacionais compatíveis".

Para instalar o GitHub Desktop, acesse a página de download para o GitHub Desktop. Para obter mais informações, consulte "Installing 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 criar uma conta, consulte "Inscrever-se em uma nova conta do GitHub" ou entre em contato com o administrador de seu site GitHub Enterprise.

  2. No menu suspenso GitHub Desktop, clique em Preferências. Na janela de preferências, clique em Contas e siga os passos para fazer o login. Para obter mais informações sobre a autenticação, consulte "Efetuar a autenticação no GitHub".

    Botão Sign In (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 criar uma conta, consulte "Inscrever-se em uma nova conta do GitHub" ou entre em contato com o administrador de seu site GitHub Enterprise.

  2. No menu suspenso do arquivo, clique em Opções. Na janela de opções, clique em Contas e siga as etapas para fazer o login. Para obter mais informações sobre a autenticação, consulte "Efetuar a autenticação no GitHub".

    Botão Sign In (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 diálogos do sistema e configurar preferências de privacidade na janela Preferências do GitHub Desktop. Para obter mais informações, consulte "Definindo as 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 diálogos do sistema e configurar preferências de privacidade na janela de Opções do GitHub Desktop. Para obter mais informações, consulte "Definindo as 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

É possível criar um novo repositório selecionando o menu Arquivo e clicando em Novo repositório.... Para obter mais informações, consulte "Criar seu primeiro repositório usando o GitHub Desktop".

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

Você pode clonar um repositório a partir do GitHub selecionando o menu Arquivos e clicando em Clonar Repositório.... Para obter mais informações, consulte "Clonar e bifurcar repositórios do GitHub Desktop".

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, consulte "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, consulte "Fazer o commit e revisar as alterações no seu projeto".

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, consulte "Enviar 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, consulte "Criando um problema ou um pull request."''

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, consulte "Visualizar um pull request 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, consulte "Sincronizando seu branch".

Leia mais

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Ou, learn how to contribute.