|
[ Tutorial ] Eclipse + Maven + Ant
09-05-2009, 05:39 PM
O Objetivo deste tutorial é ajudar a todos os novatos a usarem o Eclipse para compilar as revisions dos seus server packs favoritos.
Seguem abaixo informações bem detalhadas e completas de como proceder, quais programas usar, erros comuns etc...
Neste tutorial usaremos a plataforma Windows 32-bits como exemplo.
No caso de algum possivel erro no tutorial, correções serão bem vindas.
Dúvidas tambêm podem ser acrescentadas ao final deste tutorial.
Caso alguem peça mais alguma informação sobre determinado recurso, incrementarei o tutorial com tal informação com detalhes.
************************************************** **************************************************
Parte 1 - Ferramentas Necessárias: (Programas)
************************************************** **************************************************
* Eclipse Classic SDK WIN32 3.3.1.1
[Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
Apenas escolha um link na lista, caso seu link escolhido falhe, tente outro.
* Java JDK 6 Update 3
[Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
Clic no botão "download a direita da tela", aceite a licensa marcando-a depois escolha "Windows Offline Installation, Multi-language".
* Maven 2.0.8
[Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
Apenas escolha "Maven 2.0.8 (zip)" e clic ao seu lado em "apache-maven-2.0.8-bin.zip"
************************************************** **************************************************
Parte 2 - Preparação e Instalação:
************************************************** **************************************************
1 - Criando Pasta do Projeto:
Crie uma pasta (diretório) em uma das suas unidades de disco (de preferência uma raiz para fácil acesso).
Exemplo: C:\L2J_Servers
2 - Instalando Eclipse:
O Eclipse não precisa ser instalado, apenas descompacte-o na pasta do projeto que você criou no passo 1.
PS: nao use-o ainda, aguarde até que seja pedido nos passos seguintes.
3 - Instalando Maven:
Como o Eclipse, o Maven tambêm não precisa ser instalado, apenas descompacte-o na pasta do projeto que você criou no passo 1.
PS: nao use-o ainda, aguarde até que seja pedido nos passos seguintes.
4 - Instalando Java JDK:
Execute o instalador do Java JDK e siga as informações e instruções na tela até o final.
PS: Não altere nenhuma das opções padrão para evitar problemas futuros.
************************************************** **************************************************
Parte 3 - Executando e Configurando Eclipse:
************************************************** **************************************************
Vá até a pasta do projeto criada por você; (C:\L2J_Servers no meu exemplo);
Agora vá até a pasta do Eclipse que você descompactou nos passos anteriores;
Dentro dela execute o "eclipse.exe"; (duplo clic);
Você ira ser apresentado a esta janela abaixo;
Clique nessa barra para ver em tamanho máximo.
O Eclipse está solicitando que você escolha uma pasta (diretório) onde será seu "Workspace"
Workspace = área de trabalho do eclipse onde serão depositados os arquivos de seus projetos a serem baixados.
Para isso clic em "Browse", escolha sua pasta e após marque a opção "Use this as the default and not ask again", após feito isso clic em "ok".
Clique nessa barra para ver em tamanho máximo.
PS: Eu aconselho a usarem uma partição (unidade de disco separada do sistema operacional evitando assim backups desnecessários ou perda de dados em caso de falha do sistema operacional).
Você agora será levado a tela de boas vindas do eclipse, simplesmente FECHE-A clicando no "X" ao lado da palavra WELCOME como na imagem abaixo;
Clique nessa barra para ver em tamanho máximo.
Agora feche no "X" todas as abas abertas na janela seguinte:
[Package Explorer] - [Outline] - [problems] - [Javadoc] - [Declaration] - [Hierarchy] (TODAS);
Se você fez corretamente seu "workspace deve estar assim:
Clique nessa barra para ver em tamanho máximo.
PS: Antes de continuarmos com a configuraçao do "workspace" precisamos fazer algumas configurações básicas do Eclipse;
************************************************** **************************************************
1 - Fazer o download do plugin para svn:
No Eclipse clic no menu "HELP" e siga as imagems abaixo:
Clique nessa barra para ver em tamanho máximo.
Marque "search for new features to install" e clic "Next";
Clique nessa barra para ver em tamanho máximo.
Agora clic em "new remote site" e uma nova janela com dados a serem preenchidos se abrirá.
Clique nessa barra para ver em tamanho máximo.
No campo "Name" preencha como quiser, no meu caso coloquei "SVN".
No campo "URL você deverá por este link > [Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
< ou siga imagem abaixo:
Clique nessa barra para ver em tamanho máximo.
Agora clic em "finish";
Clique nessa barra para ver em tamanho máximo.
Uma nova janela aparecerá com os updates a serem instalados, por padrão estarão desmarcados.
Marque a opção "SVN" ou o nome que você deu no passo anterior e clic "NEXT".
Clique nessa barra para ver em tamanho máximo.
Na próxima janela marque "i accept the terms of license agreement" e clic "next".
Clique nessa barra para ver em tamanho máximo.
Na próxima janela apenas clic em "finish" e aguarde até os downloads serem concluidos.
Clique nessa barra para ver em tamanho máximo.
Ao final uma nova janela confirmando os downloads com sucesso aparecerá, agora clic em "Install All".
Clique nessa barra para ver em tamanho máximo.
Ao termino da operação uma mensagem pedindo para que você reinicie o Eclipse será exibida, clic em "YES", seu Eclipse será fechado e re-aberto.
Clique nessa barra para ver em tamanho máximo.
Após seu Eclipse reabrir devemos configurar o java nele.
************************************************** **************************************************
2 - Configurando o Java Para Uso Do Eclipse:
Com Eclipse aberto vá ate o menu "Window" depois em "Preferences";
Clique nessa barra para ver em tamanho máximo.
Depois clic no simbolo "+" em "Java" e selecione "Installed JREs";
Clique nessa barra para ver em tamanho máximo.
Na janela que aparecerá clic sobre o local onde está "jre1.6.0_xx" para o botão "Edit" na direita ser habilitado;
Agora clic no botão "Edit";
Clique nessa barra para ver em tamanho máximo.
Clic em "browse" e aponte a pasta (diretório) onde o java JDK está instalado;
Sua janela deverá ficar como a imagem abaixo, após isso clic "OK", e "OK" novamente na próxima janela;
Clique nessa barra para ver em tamanho máximo.
************************************************** **************************************************
SVN e Java Prontos no Eclipse.
************************************************** **************************************************
Agora vamos continuar a configurar o "workspace" para facilitar nosso trabalho e tutorial;
Vamos habilitar as janelas que usaremos;
Nossa inicial e mais importante janela é a que usaremos para baixar as revisions dos packs l2j a serem usados em nossos projetos.
1 - SVN Repository - Como Habilitar:
Vá no menu "Window" depois em "Show View" depois em "Other...";
Clique nessa barra para ver em tamanho máximo.
Ao clicar a janela abaixo aparecerá para a escolha da nossa opção que será "SVN Repository", selecione e clic "OK";
Agora você já pode ver a janela "SVN Repository", mas vamos continuar com as demais janelas.
Vá no menu "Window" depois em "Show View" depois em "Package Explorer";
Clique nessa barra para ver em tamanho máximo.
Agora você já pode ver a janela "Package Explorer", vamos continuar com as demais janelas.
Vá no menu "Window" > "Show View" > "Ant";
Clique nessa barra para ver em tamanho máximo.
Agora você já pode ver a janela "Ant", vamos continuar com as demais janelas.
Vá no menu "Window" > "Show View" > "Console";
Clique nessa barra para ver em tamanho máximo.
Agora redimensione sua "workspace" a seu gosto e vamos aprender para que serve e como usamos cada uma das janelas abertas.
Se você fez tudo certo deve ter algo parecido com a imagem abaixo em sua tela;
Clique nessa barra para ver em tamanho máximo.
Caso esteja tudo certo, vamos aos passos finais e mais importantes, para isso "FECHE" o Eclipse.
Será exibida uma mensagem de confirmaçao, simplesmente clic em "OK" e seu Eclipse será fechado.
************************************************** **************************************************
Parte 4 - Configurando Variavel do Sistema Para Uso Com Eclipse & Maven:
************************************************** **************************************************
Este passo é um dos mais simples, mas tambem um dos mais importantes e sempre esquecidos por muitos.
No seu windows faça o seguintes passos:
clic no botão "Iniciar" > "Configurações" > "Painel de Controle";
Clique nessa barra para ver em tamanho máximo.
Agora ache o icone de um computador com o nome "Sistema", clic duas vezes nele:
Clique nessa barra para ver em tamanho máximo.
Agora na janela que se abriu vá na aba "Avançado" e depois clic em "Variáveis de Ambiente";
Clique nessa barra para ver em tamanho máximo.
Agora na janela que se abriu na parte de baixo (variaveis do sistema) clic em "Nova" como mostra a imagem;
Uma nova janela com campos a serem preenchidos se abrirá, preencha da seguinte forma:
NOME DA VARIAVEL = JAVA_HOME
VALOR DA VARIÁVEL = C:\Arquivos de programas\Java\jdk1.6.0_03
PS: Valor da variável será a pasta onde você instalou o java jdk
Após feito isso clic em "OK" depois "OK" novamente, agora REINICIE seu sistema operacional, REBOOT seu pc.
************************************************** **************************************************
Parte 5 - Baixando e Compilando as Revisions L2J
************************************************** **************************************************
Primeiramente para podermos baixar os arquivos a serem compilados precisamos saber onde encontra-los;
Abaixo algums dos endereços de repositórios svn dos projetos de l2j mais conhecidos:
* L2J > [Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
* L2JDP > [Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
* L2J-Free > svn://l2jfree.com/repo/l2j-free
* L2Oneo > [Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
* L2Emu > [Somente Usuários Registrados Podem Visualizar os Links Desta PáginaClique aqui para se Registrar]
************************************************** **************************************************
Agora de posse dos links para as svn's vamos adiciona-las ao Eclipse para podermos baixar os arquivos.
Abre o Eclipse;
Você terá 4 janelas abertas se seguiu o tutorial corretamente;
Package Explorer - SVN Repository - Ant - Console;
Vá ate a janela "SVN Repository" e clic com botão direito do mouse nela para a janela de opções aparecer;
Escolha a opção "New" depois "New Repository Location";
Clique nessa barra para ver em tamanho máximo.
Agora na janela seguinte digite um dos endereços de SVN citados acima que deseja usar:
Usarei como exemplo o do L2J-Free, após adicionar o endereço clic em "Finish";
Clique nessa barra para ver em tamanho máximo.
Após alguns segundos o processo estará terminado e você poderá notar na janela do SVN Repository o endereço adicionado.
Clic no simbolo de "+" ao lado do endereço para expandir os links ate chegar em "Trunk", que no caso é a revisão que está sendo utilizada no momento.
Clique nessa barra para ver em tamanho máximo.
Agora já podemos baixar os LoginServer, GameServer e Datapack;
Vamos começar pelo login, para isso clic com botao direito do mouse sobre "L2_LoginServer_CT1" na janela do SVN Repository;
Após feito isso um menu de opções aparecerá, escolha a opção "Checkout";
Clique nessa barra para ver em tamanho máximo.
Marque a opção "Check out as a project in the workspace";
Caso queira ou possua multiplos packs você pode renomear onde diz "Project Name";
Feito o citado acima clic em "Finish";
Clique nessa barra para ver em tamanho máximo.
Será exibida uma janela com o progresso do processo, o Login costuma ser rápido, mas o gameserver não e o datapack demora bastante, tenha paciência.
Clique nessa barra para ver em tamanho máximo.
Após o termino você agora verá que a janela "Package Explorer contem novos arquivos na lista, no caso os arquivos do LoginServer para serem compilados.
Repita o precesso acima para o "GameServer_CT1" e para o "DataPack_CT1";
Ao final o resultado na sua janela do Package Explorer deve parecido ou igual a este:
Clique nessa barra para ver em tamanho máximo.
************************************************** **************************************************
Agora vocês estão prontos para compilar.
No caso de algums packs como o L2J-Free, o LoginServer e Gameserver precisam ser compilados usando "Maven" e o DataPack usando "Ant", explicarei abaixo quais usam oque e como você deve compilar cada um deles.
* L2J - Login+Server+DataPack => ANT
* L2Oneo - Login+Server+Datapack => ANT
* L2Emu - Login+Server => MAVEN - Datapack => ANT
* L2J-Free - Login+Server => MAVEN - Datapack => ANT
Agora que vocês já sabem quem usa oque vamos a "como" usar oque.
1 - Compilando com ANT:
Irei usar como exemplo o DataPack pois em todos os projetos ele é compilado com "Ant";
Com seu eclipse aberto vá ate a janela "Ant" e clic com botão direito do mouse para aparecer o menu de opções;
Escolha a opção "Add Buildfiles";
Clique nessa barra para ver em tamanho máximo.
Na janela seguinte clic no simbolo de "+" para expandir o projeto do DataPack;
Agora você pode ver uma pequena lista de pastas (2) e (1) arquivo "BUILD.XML";
Selecione o arquivo "Build.xml" e clic em "OK";
Agora na sua janela do Ant deverá existir um projeto no caso do tutorial o DataPack L2J-Free;
Clic no simbolo de "+" para expandir as opções a serem usadas;
Clique nessa barra para ver em tamanho máximo.
2 clics em "CLEAN" = limpa a pasta de compilaçao antiga deixando-a vazia para nova compilação.
2 clics em "DIST [DEFAULT] = compila automaticamente o Datapack seja qual for o projeto.
Caso tenha feito corretamente os passos acima algo com a imagem abaixo estara em sua tela;
Clique nessa barra para ver em tamanho máximo.
O console mostra o progresso da compilação assim como possiveis erros.
O produto final ou seja o projeto pronto para uso você encontrará zipado na pasta do seu workspace / projeto / build (no caso dos datapacks e algumas builds baseadas em ANT)
Exemplo > C:\L2J_Servers\workspace\L2_DataPack_CT1\build (l2jfree_datapack_ct1.zip)
PS: sempre faça "CLEAN" antes de compilar usando "DIST [DEFAULT] para evitar erros causados por residuos de antigas compilações.
2 - Compilando com MAVEN:
Nosso próximo passo é compilar os projetos que usam MAVEN;
Existe apenas duas (2) maneiras de fazer isso;
1 - usando MAVEN versão plugin para Eclipse (não aconselho e não usaremos neste tutorial pois possui muitos problemas de compatibilidade e bugs)
2 - usando MAVEN versão de linha de comando (um poco mais chato no inicio mas com tempo notarão a simplicidade e segurança)
Caso você tenha seguido o tutorial desde o inicio você ja deve ter o MAVEN descompactado na pasta do projeto;
Preste muita atenção nesta parte pois um minimo de falta de atenção aqui e não dará certo;
FECHE O ECLIPSE
Vá no menu "iniciar" do windows depois clic em "Executar" e digite "cmd" e clic "ok";
PS: você pode apertar simultaneamente as teclas WIN+R;
Ao clicar "ok" o resultado será esta janela de linha de comando;
Clique nessa barra para ver em tamanho máximo.
Agora digite nesta janela o caminho para a pasta onde guardamos nosso projeto com as pastas L2_LoginServer ou L2_GameServer;
Como o exemplo usado no tutorial abaixo, mas apontando para seu caminho caso seja diferente:
cd C:\L2J_Servers\workspace
e pressione "enter"
Clique nessa barra para ver em tamanho máximo.
Agora devemos entrar na pasta do projeto que queremos compilar no caso do tutorial usamos l2j-free entao ambos login e game server devem ser compilados usando MAVEN.
na mesma janela de comando ainda aberta digite:
cd L2_LoginServer_CT1
e pressione "enter"
Clique nessa barra para ver em tamanho máximo.
Pronto estamos na pasta correta para compilar o loginserver, agora devemos dizer ao maven que estamos usando eclipse;
para isso você precisa apontar o caminho completo ate onde foi descompactado o maven na pasta do nosso projeto;
No meu caso esta em > C:\L2J_Servers\maven-2.0.8\bin
PS: Eu mudei o nome da pasta original que era "apache-maven-2.0.8"
************************************************** **************************************************
De posse desta imformação digite o seguinte comando na mesma janela de comandos ainda aberta;
C:\L2J_Servers\maven-2.0.8\bin\mvn eclipse:eclipse
Seu comando completo ficará assim:
Código:
C:\L2J_Servers\workspace\L2_LoginServer_CT1>C:\L2J _Servers\maven-2.0.8\bin\mvn eclipse:eclipsePS: Este comando só deve ser usada na primeira vez que se baixou o projeto.
O resultado caso ocorra tudo certo deve ser este abaixo ao final da janela de comandos:
Clique nessa barra para ver em tamanho máximo.
************************************************** **************************************************
Pronto o Maven já sabe que usamos Eclipse, agora podemos compilar;
Mas como dito acima sempre é aconselhado usar um "clean" antes de compilar para evitar problemas com residuos;
Para isso use esta linha de comando ainda na mesma janela de comandos anterior;
C:\L2J_Servers\maven-2.0.8\bin\mvn clean:clean
Seu comando completo ficará assim:
Código:
C:\L2J_Servers\workspace\L2_LoginServer_CT1>C:\L2J _Servers\maven-2.0.8\bin\mvn clean:cleanPS: Este comando irá limpar as compilações antigas.
O resultado caso ocorra tudo certo deve ser este abaixo ao final da janela de comandos:
Clique nessa barra para ver em tamanho máximo.
************************************************** **************************************************
E agora o comando final para finalmente compilar nosso pack:
C:\L2J_Servers\maven-2.0.8\bin\mvn assembly:assembly -Dmaven.test.skip=true -U -e
Seu comando completo ficará assim:
Código:
C:\L2J_Servers\workspace\L2_LoginServer_CT1>C:\L2J _Servers\maven-2.0.8\bin\mvn assembly:assembly -Dmaven.test.skip=true -U -ePS: Este comando ira atualiazar as libs (bibliotecas) e compilar o projeto gerando um arquivo zip ao final do processo nas apsta do projeto.
O resultado caso ocorra tudo certo deve ser este abaixo ao final da janela de comandos:
Clique nessa barra para ver em tamanho máximo.
************************************************** **************************************************
PS: Observer sempre a mensagem "BUILD SUCCESSFULL" caso ela nao apareça oa final da sua janela após um destes comandos é porque algo saiu errado;
Possiveis Motivos:
1 - comando digitado errado;
2 - caminho errado;
3 - problemas com código que você baixou da svn;
PS: 99% das vezes em que a compilação falha o motivo é o numero 3.
Agora caso tenha obetido sucesso nas 3 etapas basta conferir o resultado na pasta do projeto, no meu caso:
Exemplo > C:\L2J_Servers\workspace\LoginServer_CT1\target (l2j-loginserver-dist.zip)
Agora basta repetir estes mesmos passos para compilar o GameServer.
************************************************** **************************************************
Parte 6 - Consultar Timeline Via Eclipse
************************************************** **************************************************
Para saber se houveram atualizações sem precisar visitar o site do seu projeto é bem simples:
Abre o Eclipse, vá na janela Package Explorer e clic com botão direito do mouse sobre o projeto que deseja verificar se houveram atualizações:
Exemplo > clic com botão direito do mouse sobre GameServer, aparece uma menu com muitas opções;
Dentre elas escolha "Team" > "Show in Resource History"
Clique nessa barra para ver em tamanho máximo.
Aparecerá para você uma nova janela, nela você terá todas as informações que precisa.
PS: A revision com asterisco "*" do lado é a que você está usando atualmente.
************************************************** **************************************************
************************************************** **************************************************
Parte 7 - Como alternar ou reverter as revisions (aguarde)
************************************************** **************************************************
Parte 8 - Como aplicar ou criar "patches" (aguarde)
************************************************** **************************************************
Espero ter esclarecido e ajudado algumas pessoas.
Sei que o tutorial é um poco extenso, mas queria que fosse bem completo.
Caso tenham dúvidas postem aqui neste tópico que tentarei ajudar sempre que possivel.
Caso encontrem algum erro, me notifiquem e irei corrigi-lo.
Boa Sorte a Todos !
Breve mais Tutoriais Meus !
Façam seus Pedidos !
************************************************** **************************************************
CRÉDITOS: BRUNA 2008
************************************************** **************************************************
|
 Lawliet
Banido
Registrado em: May 2009
Posts: 10
|
|