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.