Comentários
Como fazer um fork de um repositório usando o GitHub Desktop
Editado 3 Semanas atrás por ExtremeHow Equipe Editorial
GitHub DesktopRamificaçãoRepositórioControle de VersãoGitFluxo de TrabalhoProjetosJanelasMacColaboraçãoProgramação
Tradução atualizada 3 Semanas atrás
O GitHub é uma plataforma cada vez mais popular usada por desenvolvedores para hospedar, compartilhar e gerenciar projetos. Com sua interface fácil de usar e muitos recursos, o GitHub fornece um repositório ideal para desenvolvedores que desejam contribuir para projetos de código aberto ou colaborar com outros desenvolvedores. Um dos muitos recursos úteis do GitHub é a capacidade de 'fazer um fork' de um repositório. Um 'fork' é essencialmente uma cópia pessoal do projeto de outra pessoa que fica na sua conta do GitHub. Você pode modificá-lo sem afetar o projeto original. Este guia irá guiá-lo através do processo abrangente de fazer um fork de um repositório usando o GitHub Desktop, o cliente desktop do GitHub que simplifica a interação com repositórios do GitHub.
Entendendo forks e o GitHub Desktop
Antes de mergulhar no processo passo a passo, é essencial entender o que significa fazer um fork de um repositório. Quando você faz um fork de um repositório, você está criando uma cópia dele na sua conta do GitHub. Isso permite que você experimente alterações sem afetar o repositório de origem. Fazer um fork é muito útil para contribuidores de código aberto, permitindo que eles trabalhem de forma independente nas alterações propostas e, quando estiverem prontos, podem enviar uma pull request para que suas alterações sejam revisadas e possivelmente integradas ao repositório original.
O GitHub Desktop é um aplicativo que fornece uma interface visual para trabalhar com repositórios no GitHub. Ele simplifica as operações de fork, clone e commit, fornecendo uma interface de usuário intuitiva. A ferramenta está disponível para Windows e macOS e facilita o processo de gerenciamento de repositórios sem depender somente de operações de linha de comando.
Passos para fazer um fork de um repositório usando o GitHub Desktop
Nas seções a seguir, discutiremos as etapas necessárias para fazer um fork de um repositório usando o GitHub Desktop. Uma condição obrigatória é que você deve ter uma conta do GitHub e o GitHub Desktop deve estar instalado no seu computador. Vamos começar!
Passo 1: Acesse sua conta do GitHub
Para começar a fazer um fork de um repositório, você precisa garantir que está logado na sua conta do GitHub. Se você não tiver uma conta, poderá criar uma rapidamente visitando a página de cadastro do GitHub. Depois de criar sua conta, baixe e instale o GitHub Desktop do site oficial do GitHub Desktop. Após a instalação, abra o GitHub Desktop e faça login com suas credenciais do GitHub.
Passo 2: Encontre o repositório que deseja fazer o fork
Agora, abra seu navegador da web e vá para o site do GitHub. Navegue pelos projetos e identifique o repositório que deseja fazer o fork. Se você tiver um projeto específico em mente, use a barra de pesquisa para encontrá-lo rapidamente pelo nome do repositório ou pelo seu proprietário. Clicar no nome do repositório o levará à sua página principal, onde você encontrará informações detalhadas sobre o projeto, incluindo o arquivo README, issues, pull requests, branches e colaboradores.
Passo 3: Faça o fork do repositório
Na página principal do repositório, encontre o botão "Fork" localizado no canto superior direito da página. Clicar no botão de Fork cria uma cópia do repositório na sua conta do GitHub. Você será redirecionado para sua cópia do repositório, indicando que o fork foi bem-sucedido. O repositório agora faz parte da sua conta e você tem a liberdade de fazer alterações nele. Você também verá uma indicação na página do seu repositório forkado de que ele é um fork do repositório original.
Passo 4: Abra o GitHub Desktop
Depois que o repositório for forkado com sucesso, o próximo passo é clonar o repositório forkado para a sua máquina local usando o GitHub Desktop, permitindo que você trabalhe nesse código a partir do seu computador. Abra o GitHub Desktop no seu computador. Você deve estar logado automaticamente; se não, certifique-se de fazer login com suas credenciais do GitHub.
Passo 5: Clone o repositório forkado
No GitHub Desktop, clique em “File” na barra de menu e selecione “Clone Repository…”. Esta ação abrirá um prompt onde você pode encontrar o repositório associado à sua conta do GitHub. Na janela pop-up, você verá guias rotuladas como “GitHub.com”, “Enterprise” e “URL”. Para encontrar o seu repositório forkado, permaneça na guia “GitHub.com”.
Você verá uma lista de repositórios presentes na sua conta do GitHub. Procure o novo repositório forkado nesta lista. Depois de encontrá-lo, selecione-o para visualizar os detalhes e clique no botão "Clone" no canto inferior direito da janela. Você pode ser solicitado a selecionar um caminho de arquivo ou localização na sua máquina local onde deseja clonar este repositório. Selecione um diretório local apropriado e confirme a operação de clone. Ao clonar o repositório forkado, você está baixando todos os arquivos e dados para a sua máquina local, permitindo que você trabalhe offline.
Passo 6: Comprometendo alterações no repositório local
Com o repositório forkado clonado na sua máquina local, agora você pode começar a fazer modificações sem afetar o repositório original. Você pode abrir a pasta do seu editor de código ou ambiente de desenvolvimento integrado (IDE), como Visual Studio Code, Sublime Text, Atom ou qualquer outro ambiente com o qual você se sinta confortável.
Faça as alterações necessárias nos arquivos do seu repositório local. Isso pode incluir a edição de código, a adição de novos arquivos, a correção de bugs ou a implementação de novos recursos. Como a versão local é um clone do seu fork, você tem total liberdade para testar e implementar as alterações antes de compartilhá-las novamente.
Passo 7: Commit suas alterações
Após fazer as modificações na sua cópia local, é hora de salvar essas alterações. No jargão do Git, salvar alterações é chamado de "commit". Volte para o GitHub Desktop e visualize o repositório atual se ele ainda não estiver aberto. No painel esquerdo, você verá uma lista de arquivos que você modificou, rotulados como “Uncommitted Changes”.
Selecione as alterações que deseja commitar e, no campo "Summary", forneça uma breve descrição do que você modificou. Dar mensagens claras e significativas para seus commits ajuda outros desenvolvedores a entenderem por que essas alterações foram feitas. Adicione quaisquer detalhes ou contexto adicional no campo "Description", se necessário. Quando estiver pronto, clique no botão "Commit to main". Fazer isso salva suas alterações no seu repositório local, mas ainda não as envia para o seu fork remoto do GitHub.
Passo 8: Envie as alterações para o GitHub
Após um commit bem-sucedido, o próximo passo envolve empurrar essas alterações para o seu repositório forkado no GitHub. Localize o botão “Push Origin” no GitHub Desktop – geralmente encontrado na parte superior da janela do aplicativo – e clique nele para enviar as alterações cometidas localmente do branch principal local para o repositório remoto.
Enviar alterações garante que o seu repositório forkado no GitHub esteja atualizado com todos os desenvolvimentos que você fez localmente. Neste ponto, sua versão forkada do repositório está atualizada com suas últimas alterações.
Passo 9: Crie o Pull Request
Depois de enviar suas alterações para o seu repositório forkado, você pode querer contribuir com essas alterações de volta para o repositório original, se apropriado. Este processo é chamado de criação de um "pull request". Volte para a página da web do GitHub onde seu repositório forkado está hospedado. Procure um botão ou link que sugira que você compare alterações ou crie um pull request.
Clique para abrir a página de pull request, onde o GitHub mostra uma comparação de alterações entre seu fork e o repositório original. Certifique-se de que as edições que você fez estão corretas e seguem as diretrizes de contribuição do repositório original. Forneça um título significativo e descritivo para seu pull request, com uma descrição detalhada de todas as alterações feitas e qualquer contexto adicional que seria benéfico para os revisores.
Enviar um pull request notifica os mantenedores do repositório original, dando a eles a opção de visualizar suas alterações, revisá-las, fornecer feedback ou mesclá-las com seu código. Isso é uma parte vital para contribuir com o software de código aberto, permitindo melhorias colaborativas de projetos de código.
Conclusão
Parabéns! Você aprendeu com sucesso como fazer um fork de um repositório usando o GitHub Desktop. Fazer forks, clones, fazer alterações, cometer, enviar e introduzir essas alterações via pull requests são fundamentais no desenvolvimento colaborativo de software. Esse fluxo de trabalho facilita experimentação, contribuições e melhorias na base de código. Seja para fazer contribuições regulares ou apenas brincar livremente com o código, você agora se sentirá mais preparado para mergulhar no vasto mundo de projetos hospedados no GitHub.
Sempre certifique-se de seguir as diretrizes definidas pelo repositório para o qual você está contribuindo, pois eles podem ter fluxos de trabalho específicos ou estilos de codificação que esperam que os contribuidores sigam. Boas práticas, comunicação respeitosa e participação ativa ajudam a criar uma comunidade acolhedora de código aberto. Feliz codificação!
Se você encontrar algo errado com o conteúdo do artigo, você pode