Usando o EGit Eclipse Plugin com o Github

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



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



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



5- Selecione o check box do plugin:

6- Clique em Next:

Página 5 de 35



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



9- Aceite a licença:

10- Clique em Finish:

Página 7 de 35



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



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



2- Na view Package Explorer, clique com o botão direito e escolha a opção Import:

Página 10 de 35



3- Ache a pasta chamada Git e escolha a opção Git Repository e clique em Next:

Página 11 de 35



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



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



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



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



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


Loiane Groner - http://www.loiane.com 16- Selecione sua branch (Master) e clique em Next:

Página 17 de 35



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



18- Selecione o projeto a ser importado e clique em Next:

Página 19 de 35



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



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



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



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




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



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



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



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



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



11- Pronto. Agora precisamos fazer o push para “empurrar” todos os arquivos para o GitHub:

Página 29 de 35



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


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


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




19- Pronto, seu projeto agora está no GitHub:

Página 33 de 35



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



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



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!