Embed Size (px)
Citation preview
DESARROLLO DE PORTLETS PARA LIFERAY EN ECLIPSE
PREPARACION DE ENTORNO DE DESARROLLO
Autor: Hernán Thiers García Manuel López Llantén
Fecha: Febrero, 2010
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
1. Índice de Contenido
DESARROLLO DE PORTLETS PARA LIFERAY EN ECLIPSE............................................1PREPARACION DE ENTORNO DE DESARROLLO........................................................1
2. Descripción de sistema usado..............................................................................33. Descarga, Instalación y Organización..................................................................34. Configuración de Eclipse (Librerías Requeridas).................................................6
Página 2
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
2. Descripción de sistema usado
◦ Sistema Operativo: Linux 2.6.31▪ OpenSUSE 11.2 – KDE 4.3.4▪ Ubuntu 9.10 GNOME 2.28
◦ Web Container : Apache Tomcat 6◦ IDE Desarrollo: Eclipse Galileo◦ CMS: Liferay 5.2.3◦ SDK : Liferay Plugins SDK 5.2.3◦ Sun Java 6 JDK 1.6.015 (Requisito previo al desarrollo del tutorial)◦ Sun Java 6 JRE 1.6.015 (Requisito previo al desarrollo del tutorial)
3. Descarga, Instalación y Organización
◦ Desde http://www.eclipse.org/downloads/ descargamos el Eclipse IDE para JAVA EE escogiendo nuestro sistema de archivos (linux 32 bits para este caso).
(imagen 1)
◦ Para instalar basta con descomprimir el directorio de Eclipse en cualquier lugar (se recomienda mantener bajo nuestro directorio de usuario “/home”).
◦ Desde http://www.liferay.com/downloads/liferayportal/overviewdescargamos el portal de Liferay CMS que incluye tomcat 6 (Imagen 2).
Página 3
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
(Imagen 2)
◦ Descomprimimos y llevamos la carpeta idealmente bajo nuestro directorio de usuario bajo “/home”.
◦ Desde http://www.liferay.com/web/guest/downloads/additional descargamos el Software Development Kit (SDK) para construir nuestros portlets en Eclipse sobre Liferay.
(imagen 3)
◦ Descomprimimos el Liferay SDK en una carpeta cuyo nombre asignado puede ser algo como “liferay sdk”.
Página 4
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
◦ La organización de carpetas que se explica a continuación debe ser seguida tal cual puesto que influye al momento de ejecutar la construcción de un portlet.
◦ El directorio de Eclipse contiene la carpeta “plugins” donde almacenaremos nuestro portal y sdk.
◦ Antes de mover/copiar las carpetas debemos crear dentro de /plugins una nueva carpeta de nombre “bundles”, como se ve en la imagen 4.
(Imagen 4)
◦ El directorio de Liferay contiene la carpeta de Tomcat “tomcat6.0.18” que se necesita en el entorno de construcción de Portlets.
◦ Copiar y pegar esta carpeta dentro de la carpeta “bundles” antes creada.◦ Ahora que el portal ya esta dentro del entorno, se debe copiar la carpeta de
Liferay SDK a la carpeta “plugins” de Eclipse, como se ve en la 4ª posición de la imagen 4.
◦ Finalmente si tenemos la carpeta de Tomcat en eclipse/plugins/bundles y la carpeta con los archivos del SDK en eclipse/plugins se debería estar listo para comenzar con la configuración del entorno en Eclipse.
Página 5
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
4. Configuración de Eclipse (Librerías Requeridas)
◦ En Eclipse Galileo ir a Window > Preferences◦ Entrar en Server > Runtime Environments (imagen 5).
(Imagen 5)
◦ Clic en Add y escoger “Apache Tomcat v6.0” (Next) (imagen 5a).
(Imagen 5a)
Página 6
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
◦ Clic en Browse e ir al directorio donde se alojo la carpeta “tomcat6.0.18” (eclipse/plugins/bundles/tomcat6.0.18).
◦ Es recomendable cambiar el nombre del portal para evitar confusión si se desea configurar mas de un servidor. Nombre de Ejemplo: “Liferay Apache Tomcat”.
◦ En JRE debemos seleccionar “jdk1.6.0_18”. ◦ Finalmente hacer clic en Finish. (Imagen 6).
(Imagen 6)
(Imagen 6a)
Página 7
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
◦ Antes de comenzar con la creación y construcción y de un nuevo portlet es necesario agregar las librerías requeridas
◦ En Window > Preferences ir a Java > Build Path > User Libraries. Clic en New y como nombre podemos dar: “ROOT_PORTAL” puesto a que estas librerías corresponden precisamente a la raíz de las aplicaciones web en Tomcat. (Imagen 7).
(Imagen 7)
(Imagen 7a)
Página 8
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
◦ Clic en OK para luego hacer clic en “Add JARs”.◦ Buscar y agregar todas las librerías correspondientes que se encuentran
en el directorio ROOT del tomcat copiado en bundles de eclipse (eclipse/plugins/bundles/tomcat/webapps/ROOT/WEBINF/lib) como se muestra en la ruta en la imagen 8.
(Imagen 8)
◦ Terminar haciendo clic en Aceptar y luego OK.◦ De la misma forma se agregan dos librerías de usuario mas:◦ Nueva librería de nombre “LIB_PORTAL” cuyos JARs se encuentran en
eclipse/bundles/tomcat/lib◦ Nueva librería de nombre “EXT_PORTAL” cuyos JARs se encuentran en
eclipse/bundles/tomcat/lib/ext◦ Finalmente se debería contar con tres librerías de usuario (Imagen 9) que
serán requeridas para compilar los portlets.
(Imagen 9)
Página 9
Desarrollo de Portlets para Liferay en Eclipse Preparación de entorno de desarrollo
◦ Haciendo clic en OK se finaliza la configuración de Eclipse para soportar la construcción de portlets en forma básica. Para cada proyecto de tipo portlet es necesario seguir otros cambios detallados en el tutorial de creación de portlets (Imagen 9).
Página 10
