Cmo realizar mi primera aplicacin para telfono mvil

Creacin de un nuevo proyecto JavaME Mobile Application en NetBeans

Abriremos NetBeans IDE haciendo doble clic sobre el acceso directo del escritorio "NetBeans IDE 6.7.1" de nuestro equipo conWindows 7. Una vez abierto pulsaremos en el men "Achivo" - "Proyecto Nuevo...":

En "Categoras" elegiremos "Java ME", en "Proyectos" seleccionaremos "Mobile Application":

Introduciremos los siguientes datos:

Project name: nombre que tendr el proyecto, en nuestro caso "AjpdSoft Hola mundo J2ME". Project Location: carpeta donde se guardarn los proyectos. Project Folder: carpeta donde se guardarn los ficheros del proyecto. Set as main Project: si marcamos esta opcin el MIDlet que creemos ser el proyecto principal en el entorno NetBeans. Create hello MIDlet: si marcamos esta opcin se crear un MIDlet de ejemplo con el tpico mensaje "Hola mundo".

En la siguiente ventana podremos elegir los siguientes parmetros:

Emulator Platform: seleccionaremos Sun Java(TM) Wireless Toolkit 2.5.2_01 for CLDC. Device: tipo de dispositivo para el emulador, en nuestro caso "DefaultColorPhone". Device configuration: tipo de configuracin, en nuestro caso CLDC-1.1. Device Profile: tipo de pefil, en nuestro caso MIDP-2.1.

Introduciremos los datos anteriores y pulsaremos "Siguiente":

Si necesitamos ms perfiles de configuracin podremos marcarlos en la siguiente ventana. Pulsaremos "Terminar" para iniciar el desarrollo del proyecto:

Puesto que hemos marcado "Create hello MIDlet" NetBeans crear un formulario con las acciones necesarias para mostrar un mesaje en la pantalla de nuestro mvil "Hello world":

Vistas del IDE NetBeans: Source, Screen y Flow

Vista Flow Design
Esta vista es la primera que aparece cuando inicialmente creamos un MIDlet. Esta vista resulta muy interesante ya que nos indica cul es el flujo de ventanas de nuestra aplicacin, es decir, qu ventana lleva a qu otra ventana y a travs de qu botn o comando. Tambin nos permite editar fcilmente dicho flujo simplemente arrastrando y soltando elementos sobre el panel principal. De esta forma un desarrollador puede ir tomando cada uno de los tipos de ventana que se muestran en la Paleta de la derecha, dentro del grupo Screens (es decir, Alert, List, Splash-Screen, Form, TextBox o bien WaitScreen), ir colocndolos en el panel principal e ir definiendo cmo llegar de una ventana a otra simplemente conectndolas entre s. Adems, a cada ventana se le puede aadir cualquiera de los dems elementos que se muestran en la Paleta (Commands, Form Items, Elements, etc.) simplemente arrastrando dicho elemento sobre la ventana en la que queramos aadirlo. Por ltimo, decir que cuando se selecciona cualquier elemento en el panel principal, tambin es posible modificar sus propiedades o atributos mediante el panel de Propiedades que se encuentra debajo de la Paleta, abajo a la derecha, lo cual resulta extremadamente til al programador:

Vista Screen Design

Esta vista tambin resulta extremadamente til al programador ya que a travs de la misma es posible realizar el diseo de cada una de las ventanas de las que consta nuestro MIDlet. De esta forma el desarrollador podr ver el aspecto

final que aproximadamente tendr su aplicacin. Para cambiar la ventana que queremos disear basta con seleccionarla en la lista desplegable llamada Edited Screen que se encuentra encima del panel principal a la derecha. En nuestro ejemplo de "Hola mundo" slo podemos disear inicialmente una ventana llamada helloForm. En esta vista tambin disponemos de la Paleta de componentes, y el diseo de las ventanas es tan sencillo como arrastrar los elementos desde sta hasta el panel principal, igual que ocurra en la vista Flow Design. Y del mismo modo que en la vista Flow Design era posible editar las propiedades o atributos de los elementos seleccionados desde el panel de Propiedades, aqu eso tambin es posible de la misma forma. En la seccin anterior no se coment el panel Inspector mediante el cual podemos ver todos los elementos (ventanas, comandos, Items, etc.) que conforman nuestro MIDlet en forma de rbol jerrquico. A travs de l tambin se pueden realizar todas las acciones comentadas anteriormente para esta vista. Merece la pena resaltar la gran utilidad que esta vista ofrece al desarrollador de aplicaciones J2ME. Hasta tal punto es interesante que ser posible desarrollar aplicaciones sencillas sin necesidad de ver ni escribir ni una sola lnea de cdigo:

Vista Source
La vista Source permite ver y modificar el cdigo fuente Java de nuestra aplicacin:

Compilar y ejecutar la aplicacin (MIDlet) en el emulador de NetBeans

Para compilar el MIDlet pulsaremos en el men "Ejecutar" - "Limpiar y generar Main Project" o la pulsacin de las teclas Maysculas + F12. Nos mostrar el resultado de la operacin en la parte inferior del IDE de desarrollo:

Si todo es correcto mostrar, al final, algo as: "GENERACIN CORRECTA (total time: 2 seconds)". Una vez compilado correctamente NetBeans habr generado los ficheros .jar y .jad correspondientes. Con estos dos ficheros la aplicacin ya se podra ejecutar en un telfono mvil. Estos ficheros se encuentran en la carpeta "dist", dentro de la carpeta del proyecto:

En nuestro caso: AjpdSoft_Hola_mundo_J2ME.jad y AjpdSoft_Hola_mundo_J2ME.jar. Como decimos, si transferimos estos dos ficheros a un telfono mvil y ejecutamos el AjpdSoft_Hola_mundo_J2ME.jar, el mvil nos pedir si deseamos instalarlo, lo instalaremos y ya funcionar nuestra primera aplicacin para mvil.

Para ejecutarlo y probarlo en el equipo (en el emulador de NetBeans) pulsaremos en el men "Ejecutar" - "Ejecutar Main Project":

Si todo es correcto se ejecutar el emulador de telfomo mvil, como si de un mvil se tratase, aparecer seleccionado nuestro MIDlet, pulsaremos en el botn central del telfono para ejecutarlo:

Y podremos ver en nuestro equipo cmo funcionara la aplicacin (MIDlet) en el mvil:

Ficheros JAR y JAD

Un

fichero JAR (Java Archive) es el encargado de encapsular todas las clases y recursos (imgenes, sonidos, datos, etc.) que conformen uno o ms MIDlets.Un archivo JAR es un tipo de archivo que permite ejecutar aplicaciones escritas en lenguaje Java. Los archivos JAR estn comprimidos con el formato de archivo ZIP. Adems de las clases y los recursos, un

fichero JAR incluye otro archivo conocido como manifiesto (con nombre manifest.mf). Dicho archivo contiene informacin sobre el contenido del fichero JAR, los atributos de este archivo son: Atributo MIDlet-Name MIDlet-Version MIDlet-Vendor MIDlet-n Microedition-Configuration Microedition-Profile MIDlet-Description MIDlet-Icon MIDlet-Info-URL MIDlet-Data-Size Descripcin Nombre de la MIDlet suite Versin de la MIDlet suite Desarrollador del MIDlet Requerido S S S

Contiene una lista con el nombre de la MIDlet suite, icono y nombre S del MIDlet en la suite Configuracin necesitada para ejecutar el MIDlet Perfil necesitado para ejecutar el MIDlet Descripcin de la MIDlet suite Nombre del archivo png incluido en el JAR URL con informacin sobre el MIDlet Nmero de bytes requeridos por el MIDlet S S No No No No

El

fichero JAD (Java Application Descriptor) es opcional y sirve para proporcionar informacin adicional acerca del juego de MIDlets contenido en un

fichero JAR. Los atributos del archivo JAD son los siguientes: Atributo MIDlet-Name MIDlet-Vendor MIDlet-Version MIDlet-Configuration MIDlet-Profile Perfil MIDlet-Jar-URL MIDlet-Jar-Size MIDlet-Data-Size MIDlet-Delete-Confirm MIDlet-Description MIDlet-Icon MIDlet-Info-URL MIDlet-Install-Notify Descripcin Nombre de la MIDlet suite Nombre del desarrollador Versin del MIDlet Configuracin necesitada para ejecutar el MIDlet Perfil necesitado para ejecutar el MIDlet URL del archivo JAR de la MIDlet suite Tamao en bytes del archivo JAR Mnimo nmero de bytes de almacenamiento persistente usado por el MIDlet Confirmacin a la hora de eliminar el MIDlet Descripcin de la MIDlet suite Archivo .png incluido en el JAR URL con informacin de la MIDlet suite Indica que el AMS notifique al usuario de la instalacin del nuevo MIDlet Requerido S S S S S S S No No No No No No

Cdigo fuente (source code) en Java de la aplicacin para mvil

El cdigo Java de la aplicacin para telfonos mviles AjpdSoft Hola mundo J2ME es el siguiente (todo generado automticamente por el asistente de nuevo proyecto):

/* * To change this template, choose Tools | Templates * and open the template in the editor. */ package hello; import javax.microedition.midlet.*; import javax.microedition.lcdui.*; /** * @author ajpdsoft */ public class HelloMIDlet extends MIDlet implements CommandListener { private boolean midletPaused = false; //

private Command exitCommand;

private Form form; private StringItem stringItem; //

/** * The HelloMIDlet constructor. */ public HelloMIDlet() { } //

//

//

/** * Initilizes the application. * It is called only once when the MIDlet is * started. The method is called before the */ private void initialize() { // write pre-initialize user code here

startMIDlet method.

// write post-initialize user code here } //

//

/**

* Performs an action assigned to the * Mobile Device - MIDlet Started point. */ public void startMIDlet() { // write pre-action user code here switchDisplayable(null, getForm()); // write post-action user code here } //

//

/** * Performs an action assigned to the * Mobile Device - MIDlet Resumed point. */ public void resumeMIDlet() { // write pre-action user code here

// write post-action user code here } //

//

/** * * * * Switches a current displayable in a display. The display instance is taken from getDisplay method. This method is used by all actions in the design for switching displayable.

* @param alert the Alert which is temporarily * set to the display; if null, * then nextDisplayable is set immediately * @param nextDisplayable the Displayable to be set */ public void switchDisplayable(Alert alert, Displayable nextDisplayable) { // write pre-switch user code here Display display = getDisplay(); if (alert == null) { display.setCurrent(nextDisplayable); } else { display.setCurrent(alert, nextDisplayable); } // write post-switch user code here } //

//

/** * Called by a system to indicated that a command * has been invoked on a particular displayable. * @param command the Command that was invoked * @param displayable the Displayable where the command was invoked */ public void commandAction(Command command, Displayable displayable) { // write pre-action user code here if (displayable == form) { if (command == exitCommand) { // write pre-action user code here

exitMIDlet(); // write post-action user code here } } // write post-action user code here } //

//

/** * Returns an initiliazed instance of exitCommand component. * @return the initialized component instance */ public Command getExitCommand() { if (exitCommand == null) { // write pre-init user code here exitCommand = new Command("Exit", Command.EXIT, 0); // write post-init user code here } return exitCommand; } //

//

/** * Returns an initiliazed instance of form component.

* @return the initialized component instance */ public Form getForm() { if (form == null) { // write pre-init user code here form = new Form("Welcome", new Item[] { getStringItem() }); form.addCommand(getExitCommand()); form.setCommandListener(this); // write post-init user code here } return form; } //

//

/** * Returns an initiliazed instance of stringItem component. * @return the initialized component instance */ public StringItem getStringItem() { if (stringItem == null) { // write pre-init user code here stringItem = new StringItem("AjpdSoft - Primer programa m\u00F3vil", "AjpdSoft Hola mundo"); // write post-init user code here } return stringItem; }

//

/** * Returns a display instance. * @return the display instance. */ public Display getDisplay () { return Display.getDisplay(this); } /** * Exits MIDlet. */ public void exitMIDlet() { switchDisplayable (null, null); destroyApp(true); notifyDestroyed(); } /** * Called when MIDlet is started. * Checks whether the MIDlet have been already * started and initialize/starts or resumes the MIDlet. */ public void startApp() { if (midletPaused) { resumeMIDlet (); } else { initialize (); startMIDlet (); } midletPaused = false; } /** * Called when MIDlet is paused. */ public void pauseApp() { midletPaused = true; } /** * Called to signal the MIDlet to terminate. * @param unconditional if true, then the MIDlet has * to be unconditionally terminated and all * resources has to be released. */ public void destroyApp(boolean unconditional) { } }

Artculos relacionados