Introdução
O GitHub é um aplicativo baseado na Web que permite hospedar arquivos em repositórios, colaborar no trabalho e controlar alterações em arquivos ao longo do tempo. O controle de versão no GitHub é da plataforma de software de código aberto Git. Sempre que você atualiza um repositório no GitHub, o Git controla as alterações feitas.
Há muitas maneiras de trabalhar com o GitHub, e você pode escolher um método que se adapte ao seu nível de experiência, às suas preferências pessoais e aos repositórios com os quais trabalha. Por exemplo, você pode escolher se deseja trabalhar no navegador ou na área de trabalho, como deseja usar o Git e de quais recursos precisa no editor e em outros softwares. Você pode optar por trabalhar com repositórios diferentes de maneiras diferentes.
Se você é novo no GitHub, uma boa maneira de começar a contribuir é fazer alterações no navegador em GitHub.com. À medida que você se familiariza com o GitHub e começa a contribuir com alterações maiores, convém começar a trabalhar com outras ferramentas. Este artigo explica como progredir nesses estágios e ajuda você a escolher a melhor ferramenta para seus requisitos em cada estágio. Para comparar rapidamente todas as ferramentas disponíveis para trabalhar com o GitHub, confira Comparação de ferramentas para conexão com o GitHub.
Introdução
Na interface do usuário no GitHub.com, você pode executar todo o "fluxo do GitHub" para contribuir com um repositório, incluindo a criação de uma ramificação ou fork, a edição e a visualização de arquivos, o commit de alterações e a criação de uma pull request. Você também pode carregar arquivos de seu computador ou baixá-los do repositório. Para saber mais, confira Fluxo do GitHub.
Trabalhar diretamente em GitHub.com geralmente é a maneira mais rápida de contribuir para um repositório, pelos motivos a seguir.
- Você está trabalhando diretamente com o repositório hospedado em GitHub, assim, não é necessário baixar uma cópia do repositório no computador e manter essa cópia sincronizada.
- Se já está conectado ao GitHub, você tem acesso a qualquer repositório em que tem as permissões necessárias; portanto, não precisará configurar autenticação adicional em seu computador.
- Você pode confirmar alterações na interface do usuário, para que não precise usar a linha de comando nem memorizar comandos do Git.
Para obter um tutorial que o ajudará a começar a fazer alterações no navegador, confira Olá, Mundo.
Fazer alterações mais complexas no navegador
Trabalhar diretamente em GitHub.com é melhor para alterações pequenas e simples, geralmente direcionadas a um único arquivo em um repositório. Se deseja trabalhar no navegador, mas precisa fazer alterações mais complexas, como mover conteúdo entre arquivos, você pode escolher entre as ferramentas a seguir para abrir um repositório em um editor dedicado.
- Se quiser um editor em que possa abrir ou criar arquivos rapidamente, você poderá pressionar a tecla
.em qualquer repositório para abrir o editor github.dev. Esse é um editor leve baseado na Web que inclui muitos dos recursos do Visual Studio Code, como uma barra de pesquisa e botões para comandos do Git. Para saber mais, confira O editor github.dev baseado na web. - Se quiser permanecer no navegador, mas precisar realizar ações como executar comandos, criar uma compilação de teste de seu projeto ou instalar dependências, você poderá abrir um repositório em um codespace. Um codespace é um ambiente de desenvolvimento remoto com armazenamento e poder de computação. Ele inclui um editor e terminal integrado, e vem pré-instalado com ferramentas comuns de que você pode precisar para trabalhar com um projeto, incluindo o Git. Para saber mais, confira Visão geral do GitHub Codespaces.
Como alternativa, você pode se conectar ao GitHub por meio da área de trabalho e trabalhar com uma cópia local do repositório.
Trabalhar por meio da área de trabalho
Para trabalhar com um repositório por meio da área de trabalho, você precisará baixar (ou "clonar") uma cópia do repositório no computador e, em seguida, efetuar push de todas as alterações feitas para o GitHub. O trabalho por meio da área de trabalho pode ter várias vantagens em relação ao trabalho no navegador.
- Você pode trabalhar com todos os seus arquivos e ferramentas locais.
- Você tem acesso ao poder de computação. Por exemplo, talvez seja necessário executar um script para criar uma visualização local de um site, para que você possa testar as alterações que está fazendo.
- Você não precisa de uma conexão com a Internet para trabalhar em um projeto.
Se você não tiver trabalhado antes com um repositório do GitHub por meio da área de trabalho, precisará se autenticar no GitHub com o computador, para conseguir acessar os repositórios necessários. Talvez você também precise configurar seu ambiente de trabalho com as ferramentas necessárias para contribuir, como Git, um editor e dependências de um projeto. Por esses motivos, poderá levar mais tempo para começar se você quiser trabalhar em sua área de trabalho, em comparação com o trabalho no navegador.
Existem várias ferramentas que você pode usar para se conectar ao GitHub com a área de trabalho. Essas ferramentas permitem que você se autentique no GitHub, clone um repositório, rastreie suas alterações e efetue push das alterações para o GitHub.
- Se quiser muito controle e flexibilidade, você poderá usar a linha de comando. Você precisará instalar o Git e estar familiarizado com alguns comandos básicos do Git. Você também pode instalar a GitHub CLI, uma interface de linha de comando que permite executar muitas ações no GitHub, como criar uma pull request ou fazer fork de um repositório. Para saber mais, confira Configurar o git e Sobre o a CLI do GitHub.
- Se preferir usar uma interface visual, você poderá usar um cliente visual do Git, como o GitHub Desktop. Com o GitHub Desktop, você pode visualizar as alterações que está fazendo e acessar a maioria dos comandos do Git por meio de uma interface visual, para que não precise memorizar comandos. Para saber mais, confira Sobre o GitHub Desktop.
- Se deseja trabalhar em um só lugar, muitas vezes, você pode realizar a maioria das ações no editor. Um editor como o VS Code inclui um terminal integrado e botões para comandos comuns do Git, para que você possa editar arquivos e enviar suas alterações para o GitHub em um só lugar. Você também pode instalar uma extensão para trabalhar diretamente com pull requests e problemas no GitHub. Para começar, consulte Baixar o VS Code.
Comparação de ferramentas para conexão com o GitHub
A tabela a seguir fornece uma comparação entre as ferramentas que você pode usar para trabalhar com repositórios no GitHub, tanto no navegador quanto na área de trabalho.
Você pode executar todo o fluxo do GitHub com qualquer uma das ferramentas descritas aqui. Cada ferramenta inclui acesso não apenas aos comandos do Git para controlar as alterações feitas, mas também a recursos específicos do GitHub, para que você possa criar uma pull request com as alterações propostas de onde estiver trabalhando.
Para obter mais informações sobre como se autenticar no GitHub com cada uma dessas ferramentas, confira Sobre a autenticação no GitHub.
| Ferramenta | Caso de uso | Navegador ou área de trabalho |
|---|---|---|
| Em GitHub.com | Você deseja uma interface visual e precisa fazer alterações rápidas e simples, geralmente envolvendo uma única confirmação. Para obter uma introdução, confira Olá, Mundo. | Navegador |
| github.dev | Você quer fazer alterações mais complexas em um repositório do que é possível no GitHub.com, mas não precisa trabalhar com um terminal ou ferramentas instaladas no computador. Para saber mais, confira O editor github.dev baseado na web. | Navegador |
| GitHub Codespaces | Você precisa dos recursos de um computador para executar scripts, criar uma compilação de teste de seu projeto ou instalar dependências e deseja começar rapidamente trabalhando em um ambiente baseado em nuvem. Para saber mais, confira Visão geral do GitHub Codespaces. | Navegador ou área de trabalho |
| GitHub Desktop | Você deseja trabalhar com arquivos localmente e prefere uma interface visual para usar o Git, visualizar alterações e interagir com o GitHub. Para saber mais, confira Sobre o GitHub Desktop. | Área de trabalho |
| Editor de texto ou IDE | Você está trabalhando com arquivos e projetos mais complexos e quer que tudo esteja em um só lugar. | Desktop |
| Git de linha de comando e GitHub CLI | Você está acostumado a trabalhar por meio da linha de comando e quer evitar a mudança de contexto ou precisa acessar um comando Git complexo que não está integrado a interfaces visuais. Para saber mais, confira Configurar o git e Sobre o a CLI do GitHub. | Área de trabalho |
| GitHub API | Você quer automatizar tarefas comuns, como fazer backup de seus dados, ou criar integrações que estendem o GitHub. Para saber mais, confira Comparando a API REST do GitHub e a API GraphQL. | Navegador ou área de trabalho |