O documento fornece instruções sobre como usar o plugin EGit do Eclipse para trabalhar com projetos no GitHub, incluindo como instalar o EGit, importar projetos existentes no GitHub para o Eclipse, exportar projetos do Eclipse para o GitHub, e modificar projetos existentes no GitHub.
1. 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 1 de 35
2. 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 2 de 35
3. 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 3 de 35
4. 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 4 de 35
5. 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 5 de 35
6. 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 6 de 35
7. 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 7 de 35
8. 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 8 de 35
9. 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 9 de 35
10. 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 10 de 35
11. 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 11 de 35
12. 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 12 de 35
13. 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 13 de 35
14. 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 14 de 35
15. 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 15 de 35
16. 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 16 de 35
17. 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 17 de 35
18. 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 18 de 35
19. 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 19 de 35
20. 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 20 de 35
21. 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 21 de 35
22. 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 22 de 35
23. 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 23 de 35
24. 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 24 de 35
25. 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 25 de 35
26. 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 26 de 35
27. 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 27 de 35
28. 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 28 de 35
29. 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 29 de 35
30. 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 30 de 35
31. 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 31 de 35
32. 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 32 de 35
33. 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 33 de 35
34. 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 34 de 35
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!
Página 35 de 35