Crea un Launcher de tu Pagina Web para BlackBerry.

Primero vamos a explicar que es un “Web Launcher”.

Un Web Launcher es un icono de acceso directo, que se instala en tu teléfono BlackBerry y que nos permite con un solo click abrir el wap site de tu pagina.

Por defecto en este ejemplo usare el Link de mi pagina personal http://marcossit.wordpress.com

Que necesitamos para crear el Launcher?

  • BlackBerry JDE 7.1.0
  • Java JDK 7u3
  • Simulador. (por lo general el JDE trae uno por defecto, pero pueden usar otro si lo desean).

Primeros Pasos.

  • Lo primero es obviamente instalar los paquetes que se mencionan en la parte superior. Yo recomiendo hacerlo en el siguiente orden:
  1. Java JDK 7u3
  2. JDE 7.1.0
  3. Opcional el Simulador
  • Pasamos al siguiente paso configurar las variables del entorno de nuestra PC (Probado en Win Vista/7 solamente)
  • Damos Clic Derecho a Mi PC y nos vamos a Propiedades. Y nos aparecerá una ventana donde aparece la información de nuestro sistema, Damos clic en Configuración Avanzada del Sistema, que se encuentra a la izquierda. Y nos debe de aparecer una ventana como esta:

  • Nos vamos a la pestaña de Opciones Avanzadas y damos clic en Variables de Entorno

  • Buscamos en las Variables del sistema, la variable llamada Path y le damos clic en Editar

  • Se abrirá una nueva ventana y le agregamos esto: ;C:Program FilesJavajdk1.7.0_03bin si es que dejamos la ruta por default del instalador, si lo metiste en otra carpeta, deberás poner la dirección donde se encuentra instalado el JDK. Y damos Clic en Aceptar.
  • Si no existe la Variable PATH, la creamos y copiamos el link tal cual la explicación anterior.

  • Después ahi mismo en Variables del Sistema, crearemos una nueva variable llamada Classpath y tendrá la dirección de nuestro src.zip en este caso sería esta: ;C:Program FilesJavajdk1.7.0_03src.zip y le damos clic en Aceptar.
  1. Les recuerdo que el ; que anteceder a la variable solo se pone siempre y cuando exista ya un PATH y un CLASSPATH creado con una ruta. Si no existe se copian las rutas sin el ;
  • Le damos Clic en Aceptar en Variables de Entorno y en la Ventana de Opciones Avanzadas.
  • Ahora nos iremos a la Consola de Comandos de Windows 7, o al famoso CMD, una vez abierto escribimos javac y deberá mostrar este contenido.

  • Y si se muestra esto, quedó instalado el Java JDK en nuestro sistema de Windows 7/Vista.
  • Ahora procedemos a ejecutar el JDE su ruta se encuentra en Inicio /Todos Los Programas / Research In Motion / BlackBerry JDE 7.1.0 / JDE
  • Al abrir saldrá un entorno muy parecido a este:

  • Bueno crearemos un nuevo proyecto para eso le vamos a dar File/New Workspace
  • Se abrirá una ventana como la siguiente.

  • Esta una ruta predeterminada donde estará toda la información del documento. Yo recomiendo previamente crear una carpeta para cada app por ejemplo C:misAppsLauncher
  • Para ubicar la nueva ruta le damos Browse… donde se abrirá una ventana y alli la ubicamos, en Name File o Nombre del Archivo le ponemos el nombre que queramos por defecto yo pondré Marcossit Launcher, le damos aceptar.
  • Se creara el entorno de trabajo o Workspace con el nombre Marcossit Launcher.jdw como muestra la siguiente imagen.

  • Ahora crearemos el nombre del Archivo en este caso no se vera la extensión pero es por defecto .jdp en mi caso le pondré Marcossit Launcher.
  • Para crearlo le damos botón secundario del mause sobre el Workspace creado Marcossit Launcher.jdw se abrira una ventana y le daremos donde dice Create new Project in Marcossit Launcher.jdw al darle se abrirá una venta donde le daremos el nombre explicado arriba. Se vera algo así:

  • Luego vamos ahora si a crear nuestro .java para hacerlo de la misma manera que el paso anterior pero esta vez le damos click en el Nombre del Proyecto, es decir el segundo que creamos que sale sin la extensión. Al abrir la ventana saldrá Create new File in Project… y como muestra la imagen se creara la extensión .java y al otro lado se abre una venta ya con el entorno listo para trabajar.

  • Borramos todo el contenido. Y procedemos a crear un nuevo código. Vamos a copiar tal cual el siguiente.

/*
* MarcossitLauncher.java
*
* © company here>,
* Confidential and proprietary.
*/

package MarcossitLauncher;

import net.rim.blackberry.api.browser.Browser;
import net.rim.blackberry.api.browser.BrowserSession;
import net.rim.device.api.ui.UiApplication;

class WebLink extends UiApplication{
public static void main(String[] args){
WebLink instance = new WebLink();
instance.enterEventDispatcher();
}
public WebLink() {
BrowserSession site = Browser.getDefaultSession();
site.displayPage(“http://Marcossit.wordpress.com”);
site.showBrowser();
System.exit(0);
}
}

  • Recuerden donde se sustituirá el nombre del .java y el link de la pagina web. Se vera de la siguiente manera.

  • Ahora vamos a proceder a agregar el icono/os y el nombre del archivo
  • Vamos a Marcossit Launcherel que esta sin la extensión y le damos botón Derecho/Propieties
  • Se abrirá una ventana con las propiedades de la app, bueno en este paso podemos llenarlo como lo muestro en la siguiente imagen:

  • Ahora nos movemos a la pestaña Resources que sera donde vamos a agregar los iconos de la app, por lo general yo uso 70×70 pero se puede usar 75×75 o 80×80 la idea es que no pese mas de 12kb y que sea en formato .png
  • Por lo general yo ubico los iconos en la misma carpeta donde se crea el archivo para mayor comodidad
  • Ubicamos donde dice Icon Files y le damos en add. Si observamos salen dos cuadros uno que dice
  1. Icon files
  2. focus icon files
  • Icon Files yo agrego el icono que mostrara la app cuando esta OFF es decir cuando no estamos posicionados encima de ella por eso yo la nombro previamente OFF.png
  • Focus icon Files seria lo inverso, cuando nos paramos encima de la app esta seria la imagen que nos muestra por eso la nombro ON.png ahora cabe resaltar que esto ocurre cuando estamos desde el BlackBerry o desde el Simulador.
  • Quedaría como muestra la siguiente imagen.

  • Le damos OK y ya tendremos casi todo listo.
  • Ahora vamos a la venta donde dice Build y seleccionamos donde dice Build esto se crea con el propósito de construir la app, si lo hicimos bien nos mostrara algo como esto:

  • Vamos ahora a probar la aplicación en el Simulador para esto nos vam0s de nuevo a Build y luego donde dice Build and Run, esperamos que cargue el Simulador esto puede tardar un poco. Al Ejecutar el simulador debería salir el icono con el y darle click debería abrir. Como se muestra en la siguiente imagen.

  • Ahora al verificar la perfección del Launcher en cuanto a su funcionamiento, cerramos el simulador y vamos ahora a firmar la app para poder usarla en nuestros equipos.

Como Firmar una aplicación.

  • Primero debemos solicitar los keys a rim registrando en el siguiente enlace https://www.blackberry.com/SignedKeys/
  • Registramos y esperamos que nos llegue esto puede tardar de 5 minutos a 1 dias (Debemos tener paciencia).
  • Ahora cuando nos llegue el correo serán tres archivos.
  • Descargamos los 3 y los instalamos en el orden que llegaron a nuestro correo. Serian unos archivos muy parecidos a estos

  • Luego de seguir los pasos que nos van llevando cada archivo al ejecutar (Cuando piden PIN/Key tratar de usar la misma para no confundirnos luego, en los 3 nos pedirán estos y deberá ser las mismas para los 3 Keys).
  • Vamos al JDE de nuevo y le vamos a dar click de nuevo en Buidl/Build luego de que se cargue y vuelva a construir le damos en Build/Request Signatures… se nos abrirá el siguiente cuadro. Donde marca la flecha azul decía Request allí le vamos a dar para que se nos abra la ventana donde vamos a meter el código que metimos anteriormente al instalar los keys que nos llegaron

  • Al meter los códigos nos saldrá los siguiente, si sale en verde quiere decir que se firmaron correctamente y podremos usar el cod y el jad si sale en rojo es que tenemos un error en el key.

  • Con estos pasos tendremos la aplicación lista para ser usada. Nos vamos C:misAppsLauncher o donde este el archivo creado y copiamos el .jad y el .cod y lo subimos a dropbox o a algun otro servidor. O instalar desde la SD directamente.

Aqui dejare mi Proyecto por si desean verlo y usarlo

Proyecto Marcossit Launcher LINK

No se olviden de descargar el Launcher de mi Blog con integración al BBM 6.0 o superior, desde el siguiente enlace LINK

Mayor información Vistar la pagina de BlackBerry Developers para Java Link