Instalación de un entorno de trabajo de ZK Studio en Ubuntu 12.04

En este pequeño tutorial se tratará de explicar la instalación y configuración de un entorno de desarrollo

para Zkoss en Ubuntu 12.04 utilizando Eclipse Juno y Apache Tomcat 7. Primero que todo, existen

algunos paquetes que son necesarios antes de comenzar la instalación de ZK Studio.

1. Instalar Java SE Development Kit

Para ejecutar eclipse se requiere la versión 5 o superior. Se puede descargar desde el sitio oficial de

Oracle:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

También se puede instalar directamente con apt-get:

apt-get install openjdk-7-jdk

apt-get install openjdk-7-jre

2. Eclipse IDE for Java EE Developers

ZK Studio es un Plug-in para el entorno de desarrollo Eclipse, se recomienda el Eclipse IDE para

desarrolladores Java EE (Eclipse Juno). Éste se descarga de la página oficial de Eclipse:

http://www.eclipse.org/downloads/packages/release/juno/sr1

Aquí escogeremos el paquete adecuado para Ubuntu, ya sea para sistemas de 32 bits o 64 bits.

En Ubuntu no es necesario instalar Eclipse, lo único que debemos hacer es descomprimir el archivo que

acabamos de descargar y ubicarlo en el directorio que mejor nos convenga; recomendablemente en el

disco donde se encuentra instalado el sistema operativo o en la carpeta personal del usuario ya que de

esta forma podremos iniciarlo sin tener que montar otro disco o partición del disco duro físico. Antes

de iniciarlo debemos asegurarnos de que el archivo tiene los permisos de ejecución. Esto podemos

hacerlo haciendo click derecho en el archivo eclipse, nos dirigimos a las propiedades y en la pestaña

‘Permisos’ activar la pestaña de ejecución:

O podemos hacerlo desde la terminal con el comando chmod, para ello tenemos que loguearnos antes

con el usuario root:

sudo su

cd /ruta/hacia/eclipse

ls -l (este paso es opcional, nos permite ver los permisos que tiene el archivo).

chmod 755 eclipse (le agregamos permisos completos para el propietario, y permisos

de lectura y ejecución para el grupo y otros, también podemos ponerle 777 en lugar de 755).

Con esto ya podemos iniciar el eclipse, primeramente nos pedirá que ingresemos el área de trabajo

donde se guardarán los proyectos que hagamos.

En esta ventana activamos la opción ‘Use this as the default and do not ask again’ para que no tengamos

que indicarle a Eclipse dónde se encuentra nuestra área de trabajo cada vez que iniciemos el programa.

Opcionalmente podemos crear una carpeta nueva o indicarle nuestra antigua carpeta de trabajo, en el

caso de que ya se posea una o que se desee migrar de Windows a Ubuntu. Se recomienda que el área

de trabajo esté en el mismo disco o partición donde se ubicó Eclipse, para no tener que montar otro

disco al momento de trabajar con Eclipse. Yo personalmente prefiero crear una carpeta dentro del

directorio de Eclipse.

Y finalmente podremos ver la página de bienvenida del entorno de eclipse.

3. Instalación del servidor de aplicaciones Apache Tomcat7

Las versiones 6 y 7 del Servidor Tomcat son compatibles. Nosotros trabajaremos con la versión 7. Desde

la terminal, con el usuario root:

apt-get install default-jdk

Agregamos unas variables de entorno en el archive .bashrc para poder iniciar Tomcat:

Añadimos las siguientes 2 líneas:

Guardamos y salimos del archivo .bashrc seguidamente comprobamos que se haya instalado bien el

servidor tecleando lo siguiente en la terminal:

Esto probablemente nos muestre un mensaje de error indicando que no se pudo crear el archivo

catalina.out porque no existe la ruta o el directorio, para solucionarlo simplemente creamos la carpeta

‘logs’ dentro del directorio de tomcat7 y también creamos dicho archivo:

mkdir /usr/share/tomcat7/logs

nano catalina.out

Guardar el archivo presionando Ctrl+o y salimos con Ctrl+x .

Ahora abrimos el navegador y tecleamos en la barra de direcciones la dirección IP de nuestra máquina

o escribimos localhost (en el caso que estemos instalando y probando todo en nuestra propia pc),

seguido por el puerto al que nos conectaremos, debe aparecernos algo así:

4. Instalación de ZK Studio

Este puede instalarse de varias maneras, pero nosotros lo haremos desde el Marketplace de Eclipse.

Para ello nos dirigimos al menú > Help > Eclipse Marketplace, allí buscamos ZK Studio, cuando termine

de buscarlo hacemos click en ‘Install’:

Con esto se empezará a instalar el plug-in de zkoss:

Durante el proceso se nos presentará una advertencia de seguridad a la cual tendremos que darle click

en ‘OK’:

Cuando termine la descarga e instalación de ZK Studio nos aparecerá una ventana para reiniciar el

eclipse, hacemos click en ‘Yes’:

Luego de reiniciar eclipse, se mostrará una ventana en la que se pide activar el ZK Studio, este paso es

opcional, lo único que hay que hacer es crear una cuenta ZK e ingresar los datos de la nueva cuenta en

esa ventana de diálogo para tener nuestro entorno de trabajo activado.

5. Obtener ZK Framework Comunity Edition

Para no tener el problema de comprar la versión Profesional o Enterprise de ZK, existe una

distribución de uso libre mantenida por la comunidad de desarrolladores. Ésta la descargamos de

la página oficial http://www.zkoss.org/download/zk, aquí hacemos click en el siguiente botón de

descarga:

Esto nos descarga un archivo comprimido que contiene la versión CE del Framework. Ahora hay que

agregar este archivo al Eclipse, para ello hacemos click en el menú > Windows > Preferences, en la

ventana que se mostrará en la barra lateral izquierda nos dirigimos a la entrada ZK, allí

seleccionamos la opción ZK Packages. Aquí hacemos click en el botón ‘Add File / Directory’ y

buscamos la ruta del archivo recién descargado (también recomiendo que lo pongan en el mismo

disco o partición, en mi caso, me creé una carpeta llamada ‘ZK Packages’ dentro del directorio de

Eclipse).

Esto importará el archivo, el cual aparecerá en la lista de la derecha, lo seleccionamos y hacemos

click en ‘OK’.

6. Agregar Apache Tomcat a Eclipse

Finalmente lo único que nos falta es integrar Tomcat a Eclipse, igual que el procedimiento anterior

nos dirigimos al menú > Windows > Preferences > Servers > Runtime Environment. Nos aparecerá

una tabla vacía de los servidores habilitados y a su derecha un botón ‘Add’. Hacemos click en éste

botón para agregar el Apache Tomcat. Esto nos presentará otra ventana en la cual seleccionaremos

la versión de Tomcat que vamos a utilizar, en nuestro caso la versión 7, y hacemos click en ‘Next’:

El siguiente formulario lo llenamos de la siguiente manera:

Y damos click en ‘Finish’. Con esto ya deberíamos tener un entorno totalmente funcional, para probarlo

creamos un nuevo proyecto y modificamos el archivo ‘index.zul’ escribiendo cualquier cosa que se nos

ocurra:

Para ejecutarlo hacemos click derecho sobre la carpeta del archivo y damos click en ‘Run as’ > ‘Run on

Server’, seleccionamos el servidor tomcat que acabamos de integrar y hacemos click en el botón ‘Finish’,

esto nos abrirá el navegador y nos mostrará el mensaje que escribimos en el archivo ‘index.zul’. Si en

la ventana de selección de Apache Tomcat aparece inactivo el botón ‘Next’ y el botón ‘Finish’ y no nos

permite seleccionar ninguna opción, debemos cerrar el Eclipse y borrar los siguientes archivos:

Como se ve en la imagen, los encontramos en la ruta:

<workspace-directory>\.metadata\.plugins\.org.eclipse.core.runtime\.settings

Luego iniciamos de Nuevo el eclipse y volvemos a intentar. También es probable que el eclipse nos

muestre un error como este:

Para resolver este problema debemos eliminar el archivo ‘.snap’ ubicado en el siguiente directorio:

<workspace-directory>\.metadata\.plugins\.org.eclipse.core.resources

Para poder visualizar estos directorios tenemos que activar la opción de mostrar las carpetas ocultas

en Ubuntu, esto podemos hacerlo simplemente presionando Ctrl + h en el directorio de Eclipse. Luego

reiniciamos el eclipse y ya debería ejecutarse correctamente.