● Introducción. ● Herramientas de software. ● Estructura de los directorios. ● Variables de ambiente. ● Compilación. ● Preverificación. ● Empaquetamiento. – Creación del archivo de manifiesto. – Creación del archivo JAR. – Creación del archivo JAD. ● Ejecución (emulación). ● Enlaces de interés.

1. Generación del midlet HolaMundo utilizando las herramientas de línea de comando Jorge Iván Meza Martínez < [email_address] > http://www.jorgeivanmeza.com/ http://educacion.misservicios.net/

3. Introducción KToolBar es una herramienta muy útil provista por el JWTK ya que permite abstraer al desarrollador de varias de las actividades necesarias para la generación de los midlets . Como ejercicio académico es interesante poder realizar estas actividades una a una y desde la línea de comandos para poder observar con precisión su papel e importancia dentro del proceso de desarrollo de las aplicaciones móviles. A continuación se realizarán las actividades necesarias para compilar, preverificar, empaquetar y ejecutar al midlet HolaMundo de manera similar a lo realizado durante la sesión anterior, sin embargo ahora utilizando únicamente los comandos básicos provistos por la plataforma Java. Para la elaboración de este documento se utilizará Windows Vista , motivo por el cual ciertas ubicaciones o comandos relacionados con el shell podrán variar de acuerdo con el sistema operativo utilizado.

5. Estructura de los directorios Por facilidad se va a utilizar la estructura de directorios creada durante la generación del midlet en la sesión anterior, sin embargo no es necesario seguirla con rigurosidad. Los directorios existentes son los siguientes. in - Archivos binarios resultantes. ib - Librerías de terceros. es - Archivos de recursos. rc - Código fuente. Recuerde que la ruta específica del proyecto se modifica de acuerdo a varias condiciones. c:sersUSUARIO 2mewtkVERSIÓN ppsHolaMundo

6. Limpieza de los directorios Como primer paso vamos a remover cualquier archivo binario producto de la generación del midlet con el KtoolBar . Abra una ventana de Símbolo del Sistema o shell y ejecute los siguientes comandos. cd c:sersimezam2mewtk2.5.2 ppsHolaMundo Recuerde adaptar la ruta según corresponda. del bin del classes del tmpclasses

7. Variables de ambiente El segundo paso es la actualización de las variables de ambiente para incluír al JWTK. set J2ME_HOME=C:TK2.5.2 PATH=%PATH%;%J2ME_HOME%in set CLASSPATH=%CLASSPATH%;%J2ME_HOME%ib;.

8. Compilación El tercer paso es la compilación del código fuente. javac -bootclasspath %J2ME_HOME% ibldcapi11.jar; %J2ME_HOME% ibidpapi20.jar -d tmpclasses -classpath tmpclasses;classes -g:none -source 1.4 -target 1.4 srcolaMundoMidlet.java Tenga en cuenta que el comando anterior se debe escribir en una única línea y sólo hay un espacio antes del nombre del archivo donde se encuentra el código fuente del midlet .

9. Compilación La compilación toma los archivos de código fuente ( src/HolaMundoMidlet.java ) y los convierte en su correspondiente versión de bytecodes binarios ( tmpclasses/HolaMundoMidlet.class ) Nótese como se especifica utilizar las clases pertenecientes a la plataforma J2ME: CLDC y MIDP, antes de las existentes en la J2SE.

10. Preverificación El cuarto paso es la preverificación de las clases recién compiladas. Recuérdese que esta verificación inicial se realiza en el entorno de desarrollo. preverify -classpath %J2ME_HOME% ibldcapi11.jar; %J2ME_HOME% ibidpapi20.jar; tmpclasses -d classes HolaMundoMidlet Nótese como la fase de compilación deja la clase compilada en el directorio tmpclasses y la fase de preverificación deja la clase compilada y preverificada en el directorio classes .

12. Creación del archivo de manifiesto El archivo de manifiesto especifica el contenido del archivo JAR. MIDlet-1: HolaMundo, , HolaMundoMidlet MIDlet-Name: HolaMundo MIDlet-Version: 1.0.0 MIDlet-Vendor: Jorge I. Meza MicroEdition-Configuration: CLDC-1.1 MicroEdition-Profile: MIDP-2.0 (salto de línea)

13. Creación del archivo de manifiesto El manifiesto deberá guardarse en el directorio in con el nombre de archivo Manifest.mf . Después de la última línea: atributo MicroEdition-Profile para este caso, deberá haber un salto de línea, de lo contrario no será tenido en cuenta. Para más información acerca del archivo de manifiesto consultar el documento Understanding the Manifiest .

14. Creación del archivo JAR El archivo JAR empaqueta las clases y recursos del midlet en una única ubicación con formato ZIP. Su descripción es realizada por el documento de manifiesto recién creado. jar cvfm binolaMundo.jar binanifest.mf -C classes . El comando anterior solicita la creación del archivo JAR ( HolaMundo.jar ) a ubicarse en el directorio bin , con el contenido del directorio classes y el documento de manifiesto binanifest.mf .

15. Creación del archivo JAD El contenido del archivo JAD ya fue tratado en una sesión anterior, por este motivo sólo se hará referencia al específico para el caso práctico. MIDlet-1: HolaMundo, , HolaMundoMidlet MIDlet-Name: HolaMundo MIDlet-Version: 1.0.0 MIDlet-Vendor: Jorge I. Meza MIDlet-Jar-URL: HolaMundo.jar MIDlet-Jar-Size: 1216 MicroEdition-Configuration: CLDC-1.1 MicroEdition-Profile: MIDP-2.0 (salto de línea)

16. Creación del archivo JAD El valor del atributo MIDlet-Jar-Size deberá coincidir con el tamaño exacto del archivo JAR ubicado ya en el directorio in . El documento descriptor deberá almacenarse bajo la carpeta in con el mismo nombre del archivo JAR y con la extensión JAD: HolaMundo.jad . Para mas información acerca de los atributos disponibles para el archivo JAD consulte el documento Retrieving MIDlet Attributes .

17. Ejecución (emulación) El sexto paso consiste en la prueba final del midlet empaquetado y listo para ser distribuído. Esta ejecución se realiza utilizando el emulador de dispositivos móviles incluído por el JWTK. %J2ME_HOME% inemulator.exe -Xdescriptor binolaMundo.jad

18. Enlaces de interés Understanding the Process of MIDlet Creation--Without the Toolkit http://today.java.net/pub/a/today/2005/02/09/j2me1.html?page=2 Packaging Programs in JAR Files http://java.sun.com/docs/books/tutorial/deployment/jar/ Understanding the Manifest http://java.sun.com/developer/Books/javaprogramming/JAR/basics/manifest.html Emuladores MIDP http://developers.sun.com/mobility/midp/articles/emulators/ Sun Java Wireless Toolkit for CLDC User's Guide (versión 2.5.2) http://java.sun.com/products/sjwtoolkit/wtk2.5.2/docs/UserGuide-html/index.html

19. Fin de la presentación. Creative Commons (CC)