Este artigo explica como configurar o ambiente de extensão, que possibilita a customização do liferay para suas necessidades.
Requisitos:
- Java 5.0+
- Ant 1.7 ou inferior
- Cliente SVN (TortoiseSVN)
- Código fonte do portal Liferay
- Servidor Web (tomcat)
Iniciando:
Primeiramente configure a variável JAVA_HOME para o diretório java configurado na máquina. ConfigureANT_HOME para o diretório Ant. Adicione JAVA_HOME\bin e ANT_HOME\bin no Path do sistema.
Criando e implantando:
Primeiramente faça diretório base para o Liferay (ex.: c:\Liferay). Desse ponto em diante utilizaremos esse diretório.
Descompacte o código do portal para {liferay}\portal.
Configurando as propriedades do servidor da aplicação
Copie o arquivo app.server.properties , localizado em {liferay}/portal, para o mesmo diretório com o nome de app.server.{nome_usuário}.properties, onde {nome_usuário} é o nome de login no sistema.
Para o servidor tomcat, deveremos setar a propriedade app.server.tomcat.dir=c:/portal/tomcat
Configurando seu Compilador
No Liferay-5 o compilador padrão é o Sun Java compiler, pois o Liferay-5 e posteriores são feitor para o JDK 5. Versões anteriores assumem o compilador Jikes como padrão.
Para utilizar o compilador java da Sum, coloque “modern” na propriedade javac.compiler no arquivo{Liferay}/portal/build.properties.
Copie o arquivo build.properties para build.{nome_usuario}.properties, no mesmo diretório.
Construção pelo Ant
Para construir o liferay, navegue até a pasta {liferay}\portal e execute:
ant clean start
O comando start irá construir todos os módulos de forma que garanta que tudo saia dentro do planejado.
Você deve executar esse comando sempre que ocorrer mudanças no código contigo em portal/ . Isso inclui mudanças no repositório.
Descompacte Tomcat em {Liferay}\tomcat se você ainda não tiver o tomcat instalado.
Configurando as propriedades da versão para o ambiente de desenvolvimento de extensões.
Vá para {Liferay}\portal e crie o arquivo release.{nome_usuario}.properties, onde nome_usuário é o nome de login no sistema. Fique atento que o nome de usuário é case sensitive até mesmo no Windows
Adicione a linha:
lp.ext.dir={Liferay}/portal/ext
Execute a seguinte em {liferay}\portal:
ant built-ext
Verifique que o ambiente EXT foi construido em {Liferay}/portal/ext
Copie ou mova os seguintes arquivos de propriedades para o ambiente de desenvolvimento:{Liferay}\portal\ext
{Liferay}\portal\build.{nome_usuário}.properties
{Liferay}\portal\release.{nome_usuario}.properties
{Liferay}\portal\app.server.{nome_usuario}.properties
Desenvolvendo
Agora você está pronto para usar o ambiente de desenvolvimento para customizar seu Liferay. Se puder, não crie portlets no ambiente EXT de desenvolvimento. Use os pugins SDK.
É aconselhado a nunca modificar o código fonte do core do Liferay, mas você pode copiar o código para o ambiente de desenvolvimento de extensão. Isso é recomendado para não ocorrer conflitos em futurosupdates e para manter um backup do codigo do core.
Se deseja realizar algumas mudanças no código do Liferay, copie a estrutura do diretorio para o ambiente de desenvolvimento.
Para implementar o servidor web, execute o seguinte em {Liferay}/portal/ext
ant deploy
Observações:
O comando “ant deploy” não copia {Liferay}/ext/servers/conf/Catalina/localhost/ROOT.xml no diretório do Tomcat. Você necessita editar esse arquivo para definir o código da sua base de dados e manualmente copiar isso para o servidor Tomcat {Tomcat}/conf/Catalina/localhost/ROOT.xml
OBS: O texto acima se baseia no artigo.
Veja também: