Página 1 de 35 Tutorial: Usando o EGit Eclipse Plugin com o GitHub Loiane Groner - http://www.loiane.com Usando o EGit Eclipse Plugin com o GitHub O GitHub é um website que hospeda códigos fontes através de repositórios git, e você pode compartilhar seus projetos e códigos com todo mundo ou seja, é uma rede social para compartilhamento de código. Atenção! O GitHub não suporta oficialmente o EGit, a ferramenta com suporte oficial é o msysgit (openssh). Existe uma maneira de se trabalhar com o Git/GitHub diretamente do Eclipse, que é através do EGit. O que é o EGit? EGit é um plugin para o Eclipe que utiliza uma implementação Java do Git (JGit ) que possibilita controlar projetos do Eclipse com o software de controle de versão Git. O EGit está sob Rapid Application Development (RAD) – que utiliza o mínimo de planejamento, à favor da prototipação. A versão atual (10 de outubro de 2009) é a 0.5200908282229. O plugin ainda não está totalmente pronto, mas atende às funções básicas da ferramenta de controle Git. EGit foi movido para a área de incubação do Eclipse Project recentemente. Este tutorial está dividido nas seguintes partes: • Instalando EGit • Importando um Projeto Existente no GitHub • Exportando um Projeto Existente para o GitHub • Modificando um Projeto Existente no GitHub Instalando o EGit Você pode instalar o EGit como qualquer outro plugin para o eclipse. Basta adicionar o site http://www.jgit.org/updates ao Eclipse e proseguir com a instalação. Não sabe como fazer? Então siga o passo a passo abaixo:
Tutorial: Usando O EGit Eclipse Plugin Com O GitHub
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Página 1 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
Usando o EGit Eclipse Plugin com o GitHub O GitHub é um website que hospeda códigos fontes através de repositórios git, e você pode compartilhar seus projetos e códigos com todo mundo ou seja, é uma rede social para compartilhamento de código. Atenção! O GitHub não suporta oficialmente o EGit, a ferramenta com suporte oficial é o msysgit (openssh). Existe uma maneira de se trabalhar com o Git/GitHub diretamente do Eclipse, que é através do EGit. O que é o EGit? EGit é um plugin para o Eclipe que utiliza uma implementação Java do Git (JGit) que possibilita controlar projetos do Eclipse com o software de controle de versão Git. O EGit está sob Rapid Application Development (RAD) – que utiliza o mínimo de planejamento, à favor da prototipação. A versão atual (10 de outubro de 2009) é a 0.5200908282229. O plugin ainda não está totalmente pronto, mas atende às funções básicas da ferramenta de controle Git. EGit foi movido para a área de incubação do Eclipse Project recentemente. Este tutorial está dividido nas seguintes partes:
• Instalando EGit • Importando um Projeto Existente no GitHub • Exportando um Projeto Existente para o GitHub • Modificando um Projeto Existente no GitHub
Instalando o EGit Você pode instalar o EGit como qualquer outro plugin para o eclipse. Basta adicionar o site http://www.jgit.org/updates ao Eclipse e proseguir com a instalação. Não sabe como fazer? Então siga o passo a passo abaixo:
Página 2 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
1- Com o Eclipse aberto, vá no menu Ajuda e escolha a opção Install New Software:
2- A seguinte tela irá abrir. Clique no botão Add:
Página 3 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
3- Dê um nome para o site do EGit (escolhi Egit mesmo) e cole o endereço http://www.jgit.org/updates no campo Location. Depois clique em OK:
4- Espere alguns segundos, até o plugin aparecer (neste momento é feita uma busca de plugins no site informado):
Página 4 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
5- Selecione o check box do plugin:
6- Clique em Next:
Página 5 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
7- Espere alguns segundos, pois o Eclipse irá verificar a compatibilidade do plugin e os pacotes que são necessários para a instalação (pacotes dependentes/requeridos):
8- Clique em Next:
Página 6 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
9- Aceite a licença:
10- Clique em Finish:
Página 7 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
11- Espere alguns minutos. O download e a instalação podem demorar alguns minutos. (Quando instalei, levou cerca de 5-10 minutos para completar o processo):
12- É um pouco demorado mesmo, espere mais um pouco! ☺
Página 8 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
13- Instalação concluída! Clique em Yes para reiniciar o Eclipse e recarregar as moficações:
14- Está pronto para usar! Importando um projeto existente no GitHub Você tem alguns projetos no GitHub e quer importá-los para sua máquina? O processo é bem simples, exceto usuários Windows, que podem passar por um pequeno problema. Siga os seguintes passos para não ter nenhum problema ao importar seus projetos. 1- Abra o Eclipse:
Página 9 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
2- Na view Package Explorer, clique com o botão direito e escolha a opção Import:
Página 10 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
3- Ache a pasta chamada Git e escolha a opção Git Repository e clique em Next:
Página 11 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
4- Abra o link do projeto que deseja importar na página do GitHub e copie Your Clone URL:
5- Na próxima tela do Eclipse, cole a URL no campo URI:
Página 12 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
6- Note que na figura do passo 5, existe uma notificação de erro, vamos consertá-la. Para isso, mude o Protocol para git+ssh:
7- Deixe o User preenchido com git. Desse modo, você está informando que com sua chave ssh, a senha não é necessária. Clique em Next. 8- Se esta for a primeira vez que você está configurando o Egit na sua máquina, e você esteja usando o Windows, é possível que apareça o seguinte erro (Auth Fail).
Página 13 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
9- Caso apareça essa mensagem, clique em Yes e siga os próximos passos. Caso contrário, pule para o passo 15:
10- Clique em Yes:
11- Na próxima mensagem, clique em OK:
12- O seguinte erro deve aparecer, clique em OK:
Página 14 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
13- A seguinte tela deve aparecer, leia o passo 14 para consertar o erro:
14- Vamos explicar o porquê desse erro. Isso acontece pois quando você criou a chave pública, criou na pasta .ssh (C:\Documents and Settings\{user}\.ssh), e o Egit tenta obter a chave pública da pasta ssh (C:\Documents and Settings\{user}\ssh). Por isso, essas mensagens aparecem para que você dê permissão para o plugin criar este último diretório (C:\Users\{user}\ - para usuário do Windows Vista). Porém, até agora, você apenas criou o diretório, e se tentar novamente, vai obter a mesma mensagem de Auth Fail. Isso porque falta copiar os arquivos da chave ssh da pasta .ssh para a pasta ssh. Após copiar os arquivos, reinicie o Eclipse e siga os passos 1 a 7 de novo, e siga diretamente para o passo 15:
Página 15 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
15- Após ter clicado em Next na tela onde entrou com os dados da URL do respositório no GitHub, você deve ver a seguinte tela por alguns segundos. Aguarde, pois o plugin está buscando as informações no GitHub:
Página 16 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com 16- Selecione sua branch (Master) e clique em Next:
Página 17 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
17- Selecione a opção Import Projects after clone e preencha com os dados do diretório onde ficará o projeto, como mostra a figura abaixo, e clique em Next:
Página 18 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
18- Selecione o projeto a ser importado e clique em Next:
Página 19 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
19- Espere a importação e download do projeto:
20- Pronto! Seu projeto está pronto para ser usado, e o melhor, está sob o controle do Git.
Página 20 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
Exportando um projeto existente para o GitHub Você tem alguns projetos na sua máquina e gostaria de compartilhar com outras pessoas? O processo para compartilhar os projetos no GitHub é bem simples também. Vamos ver o passo a passo: 1- Escolha o projeto que quer compartilhar. Neste caso, vou compartilhar o projeto HelloWorld:
Página 21 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
2- O primeiro passo é compartilhar o projeto. Para isso, clique com o botão direito em cima do projeto (raiz/root), vá até o menu Team e escolha Share Project:
Página 22 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
3- Escolha o controle de versão desejado – GIT e clique em Next:
4- Na tela de configuração, escolha o projeto que deseja compartilhar e clique em Create para criar os arquivos de controle .git:
Página 23 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
5- Clique em Finish:
6- Repare que apareceu um sinal de interrogação ao lados dos arquivos. Isso porque até agora, apenas dissemos que queremos compartilhar o projeto. Agora temos que adicionar os arquivos ao controle de versão:
Página 24 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
7- Para adicionar todos os arquivos do projeto em apenas uma única ação, clique com o botão direito em cima do projeto, vá até o menu Team e escolha a opção Add to Version Control:
Página 25 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
8- Repare que agora os arquivos do projeto possuem um sinal de mais (+), isso indica que os arquivos foram adicionados ao controle de versão. O próximo passo, é fazer o commit dos arquivos.
Página 26 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
9- Para fazer o commit de todos os arquivos de uma vez só, clique com o botão direito em cima do projeto, vá até o menu Team e escolha a opção Commit:
Página 27 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
10- Digite uma mensagem (razão do commit/comentário) e clique em Commit. Repare que há uma listagem de todos os arquivos que serão “commitados”.
Página 28 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
11- Pronto. Agora precisamos fazer o push para “empurrar” todos os arquivos para o GitHub:
Página 29 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
12- A próxima tela é para preencher com os dados do repositório do GitHub:
13- Se voce ainda não criou um projeto no GitHub, vamos lá:
Página 30 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com 14- Após clicar em Create Repository, irá aparecer a seguinte tela e copie o link do Your
Clone URL:
15- Preencha com as informações e clique em Next:
Página 31 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com 16- Espere alguns segundos enquanto o plugin obtém algumas informações:
17- A seguinte tela irá aparecer. Apenas clique em Add all branches spec:
Página 32 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
18- Clique em Finish:
19- Pronto, seu projeto agora está no GitHub:
Página 33 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
20- Vamos conferir se no GitHub está tudo OK:
21- Pronto, tudo está certo! Modificando um projeto existente no GitHub Suponha que após ter importado ou exportado um projeto no GitHub, você queira fazer algumas modificações. Vamos ver o passo a passo: 1- Vamos modificar a classe HelloWorld adicionando um comentário e uma linha de código. Repara que ao lado do arquivo HelloWorld.java, apareceu um sinal de maior (>), isso significa que o arquivo sofreu alguma modificação.
Página 34 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
2- Após modificar, vamos fazer o commit, seguinto o passo 9 e 10 do tópico anterior, mas desta vez, clique com o botão direito em cima da classe HelloWorld (pois temos apenas uma classe. Se tiver mais de um arquivo modificado, pode clicar no projeto). Digite um comentário para o commit:
Página 35 de 35
Tutorial: Usando o EGit Eclipse Plugin com o GitHub
Loiane Groner - http://www.loiane.com
3- Faça o push, seguindo os passos 11 a 19 do tópico anterior. 4- E pronto, as modificações já estão no GitHub:
Agora você já sabe executar as ações básicas com o GitHub. Bons códigos e bom compartilhamento!