Como conectar o SourceTree a um repositório GitHub

Editado 1 Uma semana atrás por ExtremeHow Equipe Editorial

SourceTreeGitHubRepositórioConexãoIntegraçãoConfiguraçãoGitControle de VersãoFerramentasJanelasMac

Conectar o SourceTree a um repositório GitHub pode simplificar a gestão de versões e os esforços de colaboração para quem trabalha com código. O SourceTree é um cliente de interface gráfica de usuário (GUI) popular para gerenciar repositórios Git. Ele suporta tanto Windows quanto macOS, proporcionando uma maneira amigável de interagir e gerenciar seu repositório de código. O GitHub, por outro lado, é uma plataforma onde você pode hospedar seu repositório Git online, sendo amplamente usado para projetos de código aberto e privados. Abaixo, você encontrará um guia detalhado sobre como vincular o SourceTree a um repositório GitHub. Vamos entrar no processo passo a passo de configuração, garantindo que você não tenha problemas para gerenciar seu repositório.

Pré-requisitos

Antes de começar, certifique-se de ter os seguintes pré-requisitos:

• Uma conta no GitHub que já tenha um repositório configurado.
• O aplicativo SourceTree instalado em seu computador. Você pode baixá-lo do site oficial do SourceTree.
• Compreensão básica dos conceitos do Git, como repositórios, branches, commits, etc.

Instalando o SourceTree

Se você ainda não instalou o SourceTree, siga estas etapas:

1. Visite o site oficial do SourceTree e baixe a versão compatível com seu sistema operacional, Windows ou macOS.
2. Assim que o download for concluído, execute o instalador.
3. Siga as instruções na tela para instalar o SourceTree em sua máquina.
4. Após a instalação, abra o SourceTree e faça sua configuração inicial.

Conectando-se ao GitHub

Agora que você instalou o SourceTree, pode conectar-se diretamente à sua conta do GitHub. Siga estas etapas para isso:

Passo 1: Abra o SourceTree

Inicie o SourceTree a partir do seu computador. Você verá a interface principal, que inclui opções para gerenciar seu repositório.

Passo 2: Acesse a guia 'Contas'

Dentro do SourceTree, clique na opção 'Ferramentas' no menu principal na parte superior da tela. A partir daí, clique em 'Opções', e uma nova janela aparecerá. Localize e selecione a guia 'Contas' desta janela.

Passo 3: Adicione uma nova conta

Na guia 'Contas', você encontrará a opção de 'adicionar' uma nova conta. Clique neste botão. Um formulário aparecerá e você precisará preenchê-lo com suas credenciais do GitHub.

Passo 4: Preencha os detalhes da conta

Agora, você precisa fornecer os seguintes detalhes:

• Serviço de Hospedagem: No menu suspenso, selecione 'GitHub'.
• Nome de usuário: Insira seu nome de usuário do GitHub.
• Senha: Em vez da sua senha do GitHub, você deve usar um Token de Acesso Pessoal (PAT). Este é um método seguro para autenticar no GitHub.

Para criar um token de acesso pessoal, siga estas etapas:

1. Faça login em sua conta do GitHub.
2. Vá para 'Configurações', que pode ser encontrada clicando na sua foto de perfil no canto superior direito.
3. Em 'Configurações do Desenvolvedor', encontre e selecione 'Token de Acesso Pessoal'.
4. Clique em 'Gerar Novo Token'.
5. Nomeie o token e marque os escopos ou permissões que deseja que o token tenha acesso. Para o SourceTree, dar acesso a 'repo' deve ser suficiente.
6. Uma vez criado, você receberá uma string de token. Copie essa string de token imediatamente, pois por motivos de segurança, você não poderá vê-la novamente.

Retorne ao formulário de conta do SourceTree e cole seu token de acesso pessoal no campo de senha.

Passo 5: Salve a conta

Após preencher todos os campos, clique em 'OK' ou 'Adicionar' para salvar sua conta do GitHub no SourceTree. Sua conta agora deve estar conectada.

Clonando seu repositório

Depois de vincular a conta com sucesso, você pode agora clonar seu repositório do GitHub para sua máquina local usando o SourceTree:

Passo 1: Vá para a guia 'Remoto'

No SourceTree, mude para a guia 'Remotos'. Isso exibirá uma lista de seus repositórios do GitHub, já que sua conta agora está vinculada.

Passo 2: Selecione o repositório para clonar

Navegue pela lista de repositórios para encontrar o repositório que deseja clonar. Uma vez encontrado, clique no repositório para selecioná-lo.

Passo 3: Clone o repositório

Depois de destacar o repositório desejado, clique no botão 'Clonar', que geralmente fica localizado no canto superior direito. Um prompt solicitando o caminho de destino aparecerá.

• Caminho de Destino: Escolha o local em seu disco local onde deseja clonar o repositório.
• Nome: Opcionalmente, forneça um nome para a pasta local.
• Favorito: Se desejar acesso fácil a esse repositório no futuro, considere adicioná-lo aos favoritos.

Depois de preencher esses detalhes, clique em 'Clonar'. Agora o SourceTree procederá a buscar seu código do GitHub.

Realizando operações básicas do Git

Após clonar seu repositório localmente, você pode começar a realizar operações básicas como commit, push, pull, entre outras. O SourceTree simplifica essas tarefas por meio de sua interface gráfica:

Realizando commits de alteração

Faça alterações no seu código e volte para o SourceTree:

1. Vá para a guia 'Status do Arquivo'.
2. Aqui, você verá a lista de arquivos que foram modificados.
3. Selecione os arquivos que deseja fazer commit.
4. Adicione uma mensagem de commit para descrever quais mudanças foram feitas.
5. Clique em 'Commit'.

Enviando alterações para o GitHub

Depois que as alterações são commitadas localmente, você pode enviá-las para o GitHub:

1. Clique no botão 'Push' na parte superior do SourceTree.
2. Selecione o branch que deseja enviar (geralmente master ou main).
3. Confirme a ação, e o SourceTree fará o upload de seus commits para o GitHub.

Removendo atualizações do GitHub

Se o repositório remoto tiver atualizações que você deseja receber:

1. Clique na opção 'Pull' no SourceTree.
2. Selecione o branch remoto do qual deseja buscar mudanças.
3. Após confirmar, o SourceTree fará o download das alterações para seu repositório local.

Resolvendo problemas comuns

Embora conectar o SourceTree a um repositório GitHub seja geralmente fácil, problemas podem surgir. Aqui estão soluções para problemas comuns:

Problemas de autenticação

Se você encontrar problemas com autenticação (como credenciais incorretas), certifique-se de que:

• Seu token de acesso pessoal não expirou. Se sim, gere um novo token.
• Você inseriu a combinação correta de nome de usuário e token nas configurações de conta do SourceTree.

Repositório não encontrado

Se seu repositório não aparecer na lista remota do SourceTree:

• Verifique sua conexão de rede. Uma boa conexão é necessária para buscar o repositório remoto.
• Certifique-se de que sua conta no GitHub tenha os direitos de acesso necessários para visualizar o repositório.

Erros de push e pull

Para erros relacionados a push e pull:

• Verifique se você está trabalhando no branch correto.
• Verifique se há conflitos de merge que podem surgir quando o branch diverge do branch remoto.

Conclusão

Seguindo este guia, você poderá conectar com sucesso o SourceTree ao seu repositório GitHub e realizar operações básicas do Git com facilidade. Aproveitando a interface gráfica do SourceTree, você pode simplificar os processos de controle de versão, permitindo um melhor fluxo de trabalho ao gerenciar código em equipes. Lembre-se de puxar atualizações do repositório remoto regularmente para se manter em sincronia com sua equipe e enviar suas alterações com frequência. Feliz codificação!

  Compartilhe Este Artigo

Se você encontrar algo errado com o conteúdo do artigo, você pode solicitar uma atualização