Manual de Eclipse

para el desarrollo de
aplicaciones Java ME

Manuel Caballo Gil

Diciembre 2007

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Contenido
1.
2.
3.
4.

Instalacin de EclipseME .......................................................................................... 3

Configuracin de EclipseME .................................................................................... 8
Creacin de un proyecto Java ME........................................................................... 13
Referencias .............................................................................................................. 20

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

1. Instalacin de EclipseME
En primer lugar, para instalar el plugin deberemos buscar nuevas actualizaciones
para nuestro IDE de Eclipse, tarea que se hace en el men Help/Software Updates/Find
and Install:

Seleccionaremos la opcin Search new features to install y daremos a siguiente.

Nos aparecer una ventana con todos los sitios remotos en los que se buscarn
actualizaciones. El sitio del plugin no estar seleccionado por defecto as que tendremos
que aadirlo pinchando en ew Remote Site y completando la ventana que se abrir
del siguiente modo:

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Una vez hecho esto comprobaremos que el sitio se ha aadido correctamente si en la
ventana de sitios de actualizaciones aparece el que acabamos de crear:

Pincharemos en Finish para iniciar la bsqueda y posteriormente seleccionaremos

todas las actualizaciones disponibles. Pulsaremos en siguiente y aceptaremos los
trminos de la licencia para comenzar la descarga:

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Una vez finalizada la descarga pulsaremos el botn siguiente (ext) para confirmar
los trminos de la licencia para la instalacin del plugin:

En este punto pulsaremos en el botn ext, y aparecer en pantalla informacin

detallada del plugin a instalar y el directorio de instalacin.

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Eclipse intentar, por defecto, instalar eclipseME en el directorio de los
plugins habitual, por lo que deberemos seleccionar un directorio de nuestra
cuenta para que la instalacin sea completada satisfactoriamente. Esto se
har haciendo click en el botn change location.
Cuando hagamos esto aparecer una ventana en la que podremos aadir un nuevo
directorio adicional donde instalaremos nuestras nuevas utilidades. Pincharemos en
Add Location y selecionaremos en la ventana que aparecer el directorio deseado.
Pulsamos Aceptar y la ventana quedar como se muestra a continuacin:

Una vez cambiado esto en la ventana de instalacin aparecer algo parecido a esto:

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Pulsamos Finish y comenzar la descarga de las utilidades de eclipseME. Una vez
termine la descarga comenzaremos con la instalacin pulsando el botn install all de
la ventana que se muestra a continuacin:

Cuando finalice la instalacin eclipse mostrar un mensaje diciendo que para que
los cambios surtan efecto se debe reiniciar el IDE. Pulsaremos Yes.

Para comprobar que la instalacin se ha realizado con xito deberemos seleccionar

el men File/ew/Other donde se nos dar la posibilidad de crear nuevos proyectos
de J2ME:

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

2. Configuracin de EclipseME
Antes de crear nuestro primer proyecto de J2ME en eclipse deberemos configurar el
plugin eclipseME para poder conectarlo al Wireless Toolkit (en adelante WTK) que
previamente deberemos tener instalado en nuestra cuenta. Para ello deberemos acudir al
men Window/Preferences

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

En la ventana que se abrir seleccionaremos las opciones de J2ME, donde

tendremos que configurar la ruta del WTK as como la de una funcin de preprocesamiento que ofrece eclipseME

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

La ruta de instalacin del WTK la conoceremos de antemano, as como el directorio
en el que est ubicado el preprocesador. En el caso de Linux se encontrar en el
directorio de instalacin de plugins de eclipse que hemos especificado anteriormente en
nuestra
cuenta
y
la
librera
tendr
un
nombre
parecido
a
antenna.preprocessor.v2_1.7.7.jar

Una vez hecho esto deberemos aadir un nuevo dispositivo que ser aquel en el que
desplegaremos nuestros futuros proyectos. Para esto deberemos seleccionar la opcin
Devices Management que en principio aparecer vaca:

10

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Pincharemos sobre el botn import y se nos pedir un directorio en el que buscar.

De nuevo aqu seleccionaremos el directorio de instalacin del WTK y pincharemos
sobre el botn Refresh para que busque los dispositivos disponibles. Si todo va bien
obtendremos una ventana como esta:

Pincharemos sobre Finish y seleccionaremos el dispositivo que queramos en la

ventana Device Management que antes nos apareca vaca:
11

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

En este punto ya estaramos en condiciones de crear nuevos proyectos pero

si nos fijamos en la pgina de eclipseME (http://eclipseme.org) se especifica
que para un correcto funcionamiento del plugin deberemos hacer un ltimo
cambio. En el mismo men Window/Preferences Seleccionaremos la
opcin Java/Debug:

12

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Donde deberemos deseleccionar las opciones Suspend execution on uncaught
exceptions y Suspend execution on compilation errors, tal y como aparece en la
captura anterior.

3. Creacin de un proyecto Java ME

Si hemos seguido correctamente los pasos anteriores podremos crear sin ningn
problema proyectos J2ME. Para ello seleccionaremos el men File/ew/Other y
dentro de las opciones J2ME Midlet Suite:

Daremos a siguiente y seleccionaremos el nombre de nuestro proyecto

13

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

En principio no nos interesan las opciones de preprocesamiento por lo que no

seleccionaremos la casilla correspondiente. En caso de necesitar estas funcionalidades
las podremos habilitar ms adelante.
En la pantalla siguiente no deberemos cambiar nada, ya que se nos muestran las
opciones de configuracin referentes al WTK y al dispositivo en el que se emular al
MIDlet, y que ya habremos configurado previamente durante la instalacin de
eclipseME

14

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Como podemos ver se puede personalizar el nombre del descriptor jad del MIDlet
pero lo dejaremos por defecto, para evitar posibles confusiones. Pulsamos el botn
siguiente y aparecer una pantalla con los distintos directorios con los que contar
nuestra aplicacin, las libreras utilizadas y los proyectos relacionados con nuestra
aplicacin.
A no ser que deseemos alguna configuracin especial de nuestro proyecto las
opciones seleccionadas por defecto en esta pantalla sern vlidas suficientes para el
correcto despliegue de la aplicacin en el WTK.

15

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Estamos solo a un paso de finalizar la creacin de nuestro proyecto, si pulsamos el

botn Finish se cerrar la ventana y volveremos al espacio de trabajo de nuestro IDE
de eclipse, mostrndose en la ventana de proyectos nuestro nuevo proyecto J2ME, tal y
como se muestra en la siguiente captura:

16

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Hasta ahora solo hemos creado el proyecto general, es decir, hemos especificado el
conjunto de directorios y libreras que utilizar nuestro MIDlet, pero todava no hemos
explicado cmo se crearn las clases correspondientes al mismo. Este ser el siguiente
punto a abordar.
Si desplegamos el proyecto tal y como apareca en la captura anterior podremos ver
una carpeta con el nombre src. Pulsamos con el botn derecho esta carpeta y
aadimos un nuevo J2ME MIDlet:

Si seguimos estos pasos se abrir esta ventana, en la que podremos elegir aspectos
como dnde se almacenarn las clases java del MIDlet (por defecto ser
ombre_Proyecto/src), el nombre del paquete que contendr todas las clases (muy til
si son varios los archivos .java) y el nombre de la clase principal del MIDlet, que en
nuestro caso ser HolaMundo.java.
Pulsamos Finish y se abrir automticamente la clase que acabamos de crear
dentro de la carpeta src. Tan solo tendremos que implementar los mtodos
correspondientes
de
esta
clase
(los
heredados
de
la
superclase
javax.microedition.midlet.MIDlet).

17

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

En nuestro caso, la aplicacin a crear es un MIDlet simple que mostrar por la
pantalla del terminal mvil el mensaje Hola Mundo, por lo que tendremos que
modificar la clase tal y como se muestra en la siguiente captura:

Una vez hayamos guardado todas las clases del proyecto y puesto todos los archivos
adicionales en la carpeta res (en caso de que los haya) ya tenemos todo preparado para
el despliegue de nuestra aplicacin.
Para ejecutar el MIDlet en el WTK deberemos pinchar con el botn derecho sobre la
clase principal del proyecto, en nuestro caso HolaMundo.java y seleccionaremos la
opcin Run As/ Emulated J2ME MIDlet, cuya ubicacin podemos apreciar en la
siguiente captura:

18

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

Si el proceso se ha seguido y como hemos explicado, al ejecutar este ltimo paso

obtendremos la siguiente salida por pantalla

19

Manual de instalacin de Eclipse para el desarrollo de aplicaciones J2ME

4. Referencias
[1] Eclipse site. http://www.eclipse.org/
[2] EclipseME site. http://www.eclipseme.org/
[3] Documentacin EclipseME. http://eclipseme.org/docs/index.html
[4] Instalacin del plugin EclipseME. http://eclipseme.org/docs/installEclipseME.html
[5] Configuracin del plugin EclipseME. http://eclipseme.org/docs/configuring.html
[5] Wireless Toolkit. http://java.sun.com/products/sjwtoolkit/

20