Você está na página 1de 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 1 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 2 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 3 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 4 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 5 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 6 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 7 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 8 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 9 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 10 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 11 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 12 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 13 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 14 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 15 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 16 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 17 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 18 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 19 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 20 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 21 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 22 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 23 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 24 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 25 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 26 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 27 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 28 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 29 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 30 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 31 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 32 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 33 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 34 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!

Página 35 de 35