manual eclipse - java.pdf

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

2

Contenido

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

2. Configuracin de EclipseME .................................................................................... 8

3. Creacin de un proyecto Java ME........................................................................... 13

4. Referencias .............................................................................................................. 20


3

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:


4

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:


5

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.


6

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:


7

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:


8

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


9

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 pre-

procesamiento que ofrece eclipseME


10

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:


11

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:


12

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:


13

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


14

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


15

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.


16

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:


17

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).


18

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:


19

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

obtendremos la siguiente salida por pantalla


20

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/

manual eclipse - java.pdf

Documents