{"meta":{"title":"Introdução ao GitHub Desktop","intro":"Saiba como definir, autenticar e configurar o GitHub Desktop para permitir que você contribua para projetos diretamente a partir da sua máquina.","product":"GitHub Desktop","breadcrumbs":[{"href":"/pt/desktop","title":"GitHub Desktop"},{"href":"/pt/desktop/overview","title":"Visão geral"},{"href":"/pt/desktop/overview/getting-started-with-github-desktop","title":"Introdução"}],"documentType":"article"},"body":"# Introdução ao GitHub Desktop\n\nSaiba como definir, autenticar e configurar o GitHub Desktop para permitir que você contribua para projetos diretamente a partir da sua máquina.\n\n## Introdução\n\nO 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](/pt/desktop/installing-and-configuring-github-desktop/overview/about-github-desktop).\n\nEste 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.\n\nVocê 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 artigos a seguir.\n\n* [Usar o Git](/pt/get-started/using-git)\n* [Aprendendo sobre GitHub](/pt/get-started/learning-about-github)\n* [Introdução à documentação do GitHub](/pt/get-started)\n\nGitHub 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`](https://github.com/desktop/desktop).\n\n## Parte 1: Instalar e autenticar\n\nVocê pode instalar o GitHub Desktop em qualquer sistema operacional compatível. Para saber mais, confira [Sistemas operacionais compatíveis com o GitHub Desktop](/pt/desktop/overview/supported-operating-systems-for-github-desktop).\n\nPara instalar o GitHub Desktop, acesse a página de download do [GitHub Desktop](https://desktop.github.com/). Para saber mais, confira [Instalar o GitHub Desktop](/pt/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop).\n\nDepois 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.\n\n<div class=\"ghd-tool mac\">\n\n1. Para se autenticar no GitHub ou no GitHub Enterprise, você precisará ter uma conta. Para obter mais informações, confira [Criando uma conta no GitHub](/pt/get-started/start-your-journey/creating-an-account-on-github).\n2. Na barra de menus, selecione **GitHub Desktop** e selecione **Configurações**.\n\n   ![Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.](/assets/images/help/desktop/mac-choose-settings.png)\n3. Na janela “Configurações”, no painel **Contas**, selecione o botão “Entrar” apropriado. Use **Entrar no GitHub Enterprise** para entrar no GitHub Enterprise Server ou no GitHub Enterprise Cloud com residência de dados.\n\n   ![Captura de tela do painel “Contas” na janela “Configurações”. Botões azuis rotulados “Entrar no github.com” e “Entrar no GitHub Enterprise” são mostrados.](/assets/images/help/desktop/sign-in-github.png)\n4. Siga as etapas para entrar. Para obter mais informações sobre autenticação, confira [Autenticar para o GitHub no GitHub Desktop](/pt/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop).\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n1. Para se autenticar no GitHub ou no GitHub Enterprise, você precisará ter uma conta. Para obter mais informações, confira [Criando uma conta no GitHub](/pt/get-started/start-your-journey/creating-an-account-on-github).\n2. Use o menu **Arquivo** e clique em **Opções**.\n\n   ![Captura de tela da barra de menus \"GitHub Desktop\" no Windows. No menu suspenso \"File\" que é expandido, o item \"Options\" está contornado em laranja.](/assets/images/help/desktop/windows-choose-options.png)\n3. Na janela “Opções”, no painel **Contas**, selecione o botão “Entrar” apropriado. Use **Entrar no GitHub Enterprise** para entrar no GitHub Enterprise Server ou no GitHub Enterprise Cloud com residência de dados.\n\n   ![Captura de tela do painel “Contas” na janela “Opções”. Botões azuis rotulados “Entrar no github.com” e “Entrar no GitHub Enterprise” são mostrados.](/assets/images/help/desktop/windows-sign-in-github.png)\n4. Siga as etapas para entrar. Para obter mais informações sobre autenticação, confira [Autenticar para o GitHub no GitHub Desktop](/pt/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop).\n\n</div>\n\n## Parte 2: Configuração e personalização do GitHub Desktop\n\nDepois de instalar o GitHub Desktop, você pode configurar e personalizar o aplicativo para melhor atender às suas necessidades.\n\n<div class=\"ghd-tool mac\">\n\nVocê 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 Configurações do GitHub Desktop. Para saber mais, confira [Definir configurações básicas no GitHub Desktop](/pt/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop).\n\n![Captura de tela da janela “Configurações”. A primeira opção na barra lateral esquerda é selecionada e mostrada em azul.](/assets/images/help/desktop/sign-in-github.png)\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\nVocê 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 saber mais, confira [Definir configurações básicas no GitHub Desktop](/pt/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop).\n\n![Captura de tela da janela \"Opções\". A primeira opção na barra lateral esquerda é selecionada e mostrada em azul.](/assets/images/help/desktop/windows-sign-in-github.png)\n\n</div>\n\n## Parte 3: Contribuir com projetos com GitHub Desktop\n\nApó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.\n\n### Criar, adicionando e clonar repositórios\n\nVocê pode criar um repositório selecionando **Arquivo** na barra de menus do \"GitHub Desktop\" e clicando em **Novo repositório...**. Para saber mais, confira [Criar o primeiro repositório usando o GitHub Desktop](/pt/desktop/overview/creating-your-first-repository-using-github-desktop).\n\nVocê pode adicionar um repositório por meio do seu computador local selecionando **Arquivo** e clicando em **Adicionar Repositório Local...**. Para saber mais, confira [Adicionar um repositório do computador local ao GitHub Desktop](/pt/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop).\n\nVocê pode clonar um repositório por meio do GitHub selecionando **Arquivo** e clicando em **Clonar Repositório...**. Para saber mais, confira [Clonar e realizar fork de repositórios com o GitHub Desktop](/pt/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop).\n\n<div class=\"ghd-tool mac\">\n\n![Captura de tela da barra de menus no Mac. As ações dos repositórios estão listadas no menu suspenso \"Arquivo\" aberto.](/assets/images/help/desktop/mac-file-menu.png)\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n![Captura de tela da barra de menus \"GitHub Desktop\" no Windows. As ações dos repositórios estão listadas no menu suspenso \"Arquivo\" aberto.](/assets/images/help/desktop/windows-file-menu.png)\n\n</div>\n\n### Fazer alterações em um ramo\n\nVocê 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 saber mais, confira [Gerenciar branches no GitHub Desktop](/pt/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop).\n\nApós fazer alterações em um branch, você poderá revisá-las em GitHub Desktop e fazer um commit para acompanhar suas alterações. Para saber mais, confira [Realizar o commit e revisar as alterações no seu projeto no GitHub Desktop](/pt/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop).\n\nSe 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 saber mais, confira [Enviar alterações por push para o GitHub do GitHub Desktop](/pt/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop).\n\n### Colaborar com GitHub Desktop\n\nVocê pode usar o GitHub Desktop para criar problemas ou pull requests para colaborar em projetos com outras pessoas. Questões ajudam a acompanhar 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 saber mais, confira [Criar um problema ou solicitação de pull do GitHub Desktop](/pt/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop).\n\nVocê pode visualizar seus próprios pull requests ou os dos seus colaboradores 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 saber mais, confira [Visualizar um pull request no GitHub Desktop](/pt/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop).\n\n### Manter o seu repositório local em sincronia\n\nAo 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 através do envio e recepção de commits. Para saber mais, confira [Sincronizar seu ramo no GitHub Desktop](/pt/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop)."}