Cómo realizar mi primera aplicación para teléfono móvil

Creación 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 con Windows 7. Una vez abierto pulsaremos en el menú “Achivo” – “Proyecto Nuevo…”:

AjpdSoft Cómo realizar mi primera aplicación para teléfono móvil

En “Categorías” elegiremos “Java ME”, en “Proyectos” seleccionaremos “Mobile Application”:

AjpdSoft Cómo realizar mi primera aplicación para teléfono móvil

Introduciremos los siguientes datos:

  • Project name: nombre que tendrá el proyecto, en nuestro caso “AjpdSoft Hola mundo J2ME”.
  • Project Location: carpeta donde se guardarán los proyectos.
  • Project Folder: carpeta donde se guardarán los ficheros del proyecto.
  • Set as main Project: si marcamos esta opción el MIDlet que creemos será el proyecto principal en el entorno NetBeans.
  • Create hello MIDlet: si marcamos esta opción se creará un MIDlet de ejemplo con el típico mensaje “Hola mundo”.

AjpdSoft Cómo realizar mi primera aplicación para teléfono móvil

En la siguiente ventana podremos elegir los siguientes parámetros:

  • 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 configuración, en nuestro caso CLDC-1.1.
  • Device Profile: tipo de pefil, en nuestro caso MIDP-2.1.

Introduciremos los datos anteriores y pulsaremos “Siguiente”:

AjpdSoft Cómo realizar mi primera aplicación para teléfono móvil

Si necesitamos más perfiles de configuración podremos marcarlos en la siguiente ventana. Pulsaremos “Terminar” para iniciar el desarrollo del proyecto:

AjpdSoft Cómo realizar mi primera aplicación para teléfono móvil

Puesto que hemos marcado “Create hello MIDlet” NetBeans creará un formulario con las acciones necesarias para mostrar un mesaje en la pantalla de nuestro móvil “Hello world”:

AjpdSoft Cómo realizar mi primera aplicación para teléfono móvil

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 cuál es el flujo de ventanas de nuestra aplicación, es decir, qué ventana lleva a qué otra ventana y a través de qué botón o comando. También nos permite editar fácilmente 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 colocándolos en el panel principal e ir definiendo cómo llegar de una ventana a otra simplemente conectándolas entre sí. Además, a cada ventana se le puede añadir cualquiera de los demás elementos que se muestran en la Paleta (Commands, Form Items, Elements, etc.) simplemente arrastrando dicho elemento sobre la ventana en la que queramos añadirlo. Por último, decir que cuando se selecciona cualquier elemento en el panel principal, también 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:

AjpdSoft Vistas del IDE NetBeans: Source, Screen y Flow

Vista Screen Design

Esta vista también resulta extremadamente útil al programador ya que a través de la misma es posible realizar el diseño 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 aplicación. Para cambiar la ventana que queremos diseñar 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” sólo podemos diseñar inicialmente una ventana llamada helloForm.

En esta vista también disponemos de la Paleta de componentes, y el diseño 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 también es posible de la misma forma. En la sección 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 jerárquico. A través de él también 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 línea de código:

AjpdSoft Vistas del IDE NetBeans: Source, Screen y Flow

Vista Source

La vista Source permite ver y modificar el código fuente Java de nuestra aplicación:

AjpdSoft Vistas del IDE NetBeans: Source, Screen y Flow

Compilar y ejecutar la aplicación (MIDlet) en el emulador de NetBeans

Para compilar el MIDlet pulsaremos en el menú “Ejecutar” – “Limpiar y generar Main Project” o la pulsación de las teclas Mayúsculas + F12. Nos mostrará el resultado de la operación en la parte inferior del IDE de desarrollo:

AjpdSoft Compilar y ejecutar la aplicación (MIDlet) en el emulador de NetBeans

Si todo es correcto mostrará, al final, algo así: “GENERACIÓN CORRECTA (total time: 2 seconds)”. Una vez compilado correctamente NetBeans habrá generado los ficheros .jar y .jad correspondientes. Con estos dos ficheros la aplicación ya se podría ejecutar en un teléfono móvil. Estos ficheros se encuentran en la carpeta “dist”, dentro de la carpeta del proyecto:

AjpdSoft Compilar y ejecutar la aplicación (MIDlet) en el emulador de NetBeans

En nuestro caso: AjpdSoft_Hola_mundo_J2ME.jad AjpdSoft_Hola_mundo_J2ME.jar.

Como decimos, si transferimos estos dos ficheros a un teléfono móvil y ejecutamos el AjpdSoft_Hola_mundo_J2ME.jar, el móvil nos pedirá si deseamos instalarlo, lo instalaremos y ya funcionará nuestra primera aplicación para móvil.

Para ejecutarlo y probarlo en el equipo (en el emulador de NetBeans) pulsaremos en el menú “Ejecutar” – “Ejecutar Main Project”:

AjpdSoft Compilar y ejecutar la aplicación (MIDlet) en el emulador de NetBeans

Si todo es correcto se ejecutará el emulador de teléfomo móvil, como si de un móvil se tratase, aparecerá seleccionado nuestro MIDlet, pulsaremos en el botón central del teléfono para ejecutarlo:

AjpdSoft Compilar y ejecutar la aplicación (MIDlet) en el emulador de NetBeans

Y podremos ver en nuestro equipo cómo funcionaría la aplicación (MIDlet) en el móvil:

AjpdSoft Compilar y ejecutar la aplicación (MIDlet) en el emulador de NetBeans

Ficheros JAR y JAD

Un fichero JAR (Java Archive) es el encargado de encapsular todas las clases y recursos (imágenes, sonidos, datos, etc.) que conformen uno o más MIDlets.Un archivo JAR es un tipo de archivo que permite ejecutar aplicaciones escritas en lenguaje Java. Los archivos JAR están comprimidos con el formato de archivo ZIP. Además de las clases y los recursos, un fichero JAR incluye otro archivo conocido como manifiesto (con nombre manifest.mf). Dicho archivo contiene información sobre el contenido del fichero JAR, los atributos de este archivo son:

Atributo Descripción Requerido
MIDlet-Name Nombre de la MIDlet suite
MIDlet-Version Versión de la MIDlet suite
MIDlet-Vendor Desarrollador del MIDlet
MIDlet-n Contiene una lista con el nombre de la MIDlet suite, icono y nombre del MIDlet en la suite
Microedition-Configuration Configuración necesitada para ejecutar el MIDlet
Microedition-Profile Perfil necesitado para ejecutar el MIDlet
MIDlet-Description Descripción de la MIDlet suite No
MIDlet-Icon Nombre del archivo png incluido en el JAR No
MIDlet-Info-URL URL con información sobre el MIDlet No
MIDlet-Data-Size Número de bytes requeridos por el MIDlet No

El fichero JAD (Java Application Descriptor) es opcional y sirve para proporcionar información adicional acerca del juego de MIDlets contenido en un fichero JAR. Los atributos del archivo JAD son los siguientes:

Atributo Descripción Requerido
MIDlet-Name Nombre de la MIDlet suite
MIDlet-Vendor Nombre del desarrollador
MIDlet-Version Versión del MIDlet
MIDlet-Configuration Configuración necesitada para ejecutar el MIDlet
MIDlet-Profile Perfil Perfil necesitado para ejecutar el MIDlet
MIDlet-Jar-URL URL del archivo JAR de la MIDlet suite
MIDlet-Jar-Size Tamaño en bytes del archivo JAR
MIDlet-Data-Size Mínimo número de bytes de almacenamiento
persistente usado por el MIDlet
No
MIDlet-Delete-Confirm Confirmación a la hora de eliminar el MIDlet No
MIDlet-Description Descripción de la MIDlet suite No
MIDlet-Icon Archivo .png incluido en el JAR No
MIDlet-Info-URL URL con información de la MIDlet suite No
MIDlet-Install-Notify Indica que el AMS notifique al usuario de la
instalación del nuevo MIDlet
No

 

 

Código fuente (source code) en Java de la aplicación para móvil

El código Java de la aplicación para teléfonos móviles AjpdSoft Hola mundo J2ME es el siguiente (todo generado automáticamente 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 startMIDlet method. */ private void initialize() { // write pre-initialize user code here // 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) {
    }

}