[javiergv]

GUIA PARA DESARROLLO DE APLICACIONES BLACKBERRY

En vista de que he leido algunos comentarios de usuarios interesados en el desarrollo de Aplicaciones, desarrolle esta guia con informacion util acerca de las cosas basicas necesarias para el desarrollo y puesta en marcha de una Aplicación

¿Que son las APIs? y ¿Porque se deben firmar?
Lo primero que debemos saber es que Research In Motion (RIM) debe realizar un seguimiento del uso de algunos Interfaces de Programas de Aplicación (API´s, por sus siglas en Ingles) de BlackBerry ® en el entorno de desarrollo Java (JDE) para un control en materia de seguridad, esto quiere decir, que ellos velan hasta cierto punto de que la Aplicacion no se use para tomar informacion del usuario por ejemplo.

En la documentación de referencia de las API, se indican las APIs que requieren de firma mediante un candado o simplemente donde se indique su requerimiento.
Si utilizas estas APIs en las clases (Archivos .Java) o codigos de tus aplicaciones, estas deberán estar firmadas con una clave, o la firma, proporcionada por RIM antes de que puedas cargar la aplicación con el archivo .cod en el dispositivo. Cuando cargas una aplicacion sin firma al dispositivo este dara un error de ""
Aca les dejo algunos ejemplos de APIs que necesitan firma:

BlackBerry JDE 4.6.0 API Reference

Nota: El registro y firma de las aplicaciones solo sera requerido cuando se necesita correr la aplicacion en el dispositivo. La firma no es necesaria para correr la aplicacion en el simulador.
Para poder firmar las aplicaciones necesitamos 20$ que pagaremos por Tarjeta de Crédito y rellenar el siguiente formulario que por cierto no lo pude abrir con el Firefox ya que me da un error (Se les pedirá un PIN que no deben olvidar ya que se usara para instalar las Keys, y ojo este no es el PIN de su Blackberry):

https://www.blackberry.com/SignedKeys/

Luego 4 días aproximadamente recibiremos la respuesta de RIM en tres correos, cada uno tendrá un adjunto (client-RCR-1560404037.csi; client-RRT-1560404037.csi y client-RBB-1560404037.csi) estos tenemos que descargarlos y ejecutarlos en la Computadora donde desarrollaremos la aplicación. Es importante saber que estas firmas son para uso de un (01) solo computador. En este proceso se les pedirá un Password (no olviden colocar el mismo password a los 3 Keys), este Password no es el mismo PIN que también tendrán que introducir en este proceso y para cada vez que firmemos una aplicación, así que tampoco lo pierdan.

Acá les copio textualmente la guía que está en los tres correos que envía RIM:

The following attachment will allow the BlackBerry SignatureTool to register with the Signing Authority. Please ensure that the BlackBerry Java Development Environment or BlackBerry Java Development Environment Component Package has been installed onto the workstation that will be used to sign your BlackBerry Java applications.

To register the attachment, please follow the instructions below:

1)Double-click on the attachment.
2)If a dialog box appears that states that a private key cannot be found, complete steps 3 through 6 before you continue. Otherwise, proceed to step 7.
3)Click "Yes" to create a new key pair file.
4)Type a password for your private key, and type it again to confirm.
5)Click "Ok"
6)Move your mouse to generate date for a new private key.
7)In the "Registration PIN" field, type the PIN number that you supplied on the signature key request form.
8)In the Private Key password field, type a password of at least 8 characters. This is your private key password, which protects your private key. Please remember this password as you will be prompted for it each time signing is attempted.
9)Click "Register".
10)Click "Exit".

Note: All 3 keys (RBB, RCR, RRT) received should be installed on the same PC. The same password must be specified for all keys on the same PC.

¿Que programas se requieren para el desarrollo?
Por supuesto necesitamos principalmente el JDE, aunque tambien se pueden desarrollar con el IDE de su preferencia, por ejemplo existe un Plugin para JDE de Eclipse. Netbean, Visual C y otros.
Desde Aca pueden descargar el JDE en sus distintas versiones y otras herramientas para el Desarrollo en Java

Desde aca:BlackBerry - Java Development Environment

El BlackBerry Java Development Environment incluye las siguientes herramientas para el desarrollo:
•BlackBerry® Integrated Development Environment (IDE)
•BlackBerry Smartphone Simulador
•Java ME APIs and BlackBerry APIs
•Aplicaciones de Ejemplo

El JDE a su vez exige tener algunas otra herramientas para su correcta Instalacion y uso. Entre ellas tenemos:

•Java® SE Development Kit version 1.6 o superior. Lo pueden descargar desde acá: Java SE Downloads - Sun Developer Network (SDN)

•Microsoft® DirectX® version 8.0 or posterior
•Microsoft® Windows Vista o Microsoft® Windows® XP Professional
•Intel®Pentium® procesador o compatible (800 MHz o superior)
•Minimo 400 MB de Ram disponible o mas
•Minimo 500 MB de espacio en el disco duro disponible

Esta es la pagina principal de Blackberry para los desarrolladores:
BlackBerry - BlackBerry Developer Zone

Aca los Manuales de JDE y otros (BlackBerry Java Development Environment). Estes es el IDE para el desarrollo de los codigos Java.

Desde aca: ]http://na.blackberry.com/eng/deliverables/3802/development.pdf

Ejemplo de Desarrollo de una Aplicación

Estes es un ejemplo sencillo de un codigo en Java para el Desarrollo de un Web Launcher sin Rollover Icon:
Primero que nada debemos conocer como se esctructura y organiza una aplicacion. Cada aplicacion o proyecto en JDE debería ubicarse en una carpeta distinta.
En anexo observaran la estructura de la cual hablamos, en la parte superior se encuentra el Workspace o espacio de trabajo que en nuestro ejemplo es ZonaBB.jdw luego debajo o dentro encontraremos el nombre del Proyecto “ZonaBlackberry” (acá no le vemos la extensión al archivo pero este será .jdp y se encuentra dentro de la carpeta “com”. (No es necesario tener el recurso dentro de esta carpeta solo es la forma en que cada quien se organice, esta no es la única manera de desarrollar una aplicación, dentro de la programación existen muchos caminos o códigos que pueden conducir a un mismo destino, lo que sí es importante tomar en cuenta es que mientras más sencillo y logre su cometido este será mucho más eficiente y eficaz. En este caso es solo que se me pego de la forma donde están guardados los ejemplos: C:\Archivos de programa\Research In Motion\BlackBerry JDE 4.6.0\samples\com\rim\samples (:D)
Acá también podemos observar que dentro de la carpeta “com” se hayan dos carpetas una “img” donde guardare la imagen del icono (ZonaBB2.png) y otra de nombre “ZonaBlackberry” donde estará la Clase o archivo .Java que en nuestro ejemplo es ZonaBlackberry.java

Las propiedades del proyecto las podemos ver haciendo click derecho sobre el Proyecto de esta manera:

Las pestañas de izquierda a derecha son:

General: desde acá colocaremos el titulo a la aplicación, la versión, el propietario, y la descripción de la aplicación:

Application: desde acá podemos especificar qué tipo de proyecto será (CLDC Application, MIDlet o Library)

Resources: desde acá podemos agregar todas las imágenes o recursos que tendrá la aplicación, en nuestro ejemplo solo tendremos el icono de la Aplicación, que como verán se encuentra dentro de la carpeta imagen.

Una vez definidas las propiedades de nuestro proyecto procedemos con el desarrollo del código fuente o source code
Aquí les mostraremos un ejemplo de un código fuente a seguir para el desarrollo de un Web Launcher:

Como verán es bastante corto y sencillo.

Antes de firmar la aplicación, la probaremos con el Simulador para descartar algún bug o fallo en el mismo, para ello nos vamos por Build>Build All and Run. (Dependiendo del JDE que hayan instalado este traerá un Simulador de un Dispositivo Blackberry, la versión 4.6.0 trae consigo el simulador del Bold, la 4.7 el simulador del Storm y así sucesivamente)

Luego de probar que no haya errores procedemos a construir el proyecto para que se generen los archivos .cod, .jar y .jad. Para ello seleccionamos el proyecto ZonaBB.jdw y luego nos vamos por Build>Build All

En la parte inferior vamos a ver el log del proceso de construcción, en donde observaremos algo como lo que se anexaesto es lo que nos indica que las APIs que usamos en la clase requieren firma. “requires signing with keys”

Entonces procedemos a firmar la aplicación por Build>Request Signatures…

Presionamos el botón inferior izquierdo que dice Request (Esto requiere de una conexión a internet)

Introducimos la clave que configuramos y aceptamos (Esto requiere de una conexión a internet)

Luego veremos que ya los archivos .cod están firmados y aparecerán en verde

Ahora podemos generar el archivo .alx para la instalación vía Desktop Manager por Project>Generate ALX file.
Por último tenemos todos los archivos juntos en la carpeta “com” los podemos copiar para luego subirlos a un servidor para la descarga OTA o para la distribución de la forma que mejor les parezca. Sin olvidar que es necesario que para la instalación OTA o vía SD se requieren los Archivos .jad y .cod, para la Instalacion vía Desktop Manager se requieren de los archivos .alx y .cod

[grojas]

Esta arrechi...... esta guia!!!. Te felicito!!!, no habia tenido tiempo de leerla hasta hoy y la verdad es que te botaste!!.

20 puntos!!!

Saludos!!

[BBnewuser]

Tremenda guia... Excelente...!!!

[chubejam]

viejo gracias por la info, tremendo aporte. Esta info esta muy completa y clara.

[javiergv]

Gracias, siempre a la orden. Vamos a ver si asi los usuarios se animan a desarrollar aplicaciones hechas en casa.

[chubejam]

es verdad, aqui en el foro deben haber programadores que no sepan que pueden desarrollar app para los blackberry y con esta info se animen a desarrollarlas.

Vamos a ver quienes son los primeros que se animan y aceptan el reto.

saludos.....

[wilchesjorge]

tremenda info pana..quiero saber si esta aplicacion con el simple echo de instalarla mejora la ubicacion del telefono con java en lo mapas. gracias

[javiergv]

Iniciado por wilchesjorge

tremenda info pana..quiero saber si esta aplicacion con el simple echo de instalarla mejora la ubicacion del telefono con java en lo mapas. gracias

Con cual aplicacion instalada? Aca se explico como desarrollar una aplicacion. Si tienes los conocimientos suficientes podrias desarrollar una aplicacion que te de la ubicacion en un mapa. Pero mejorarla no creo. El gps te ubicara con el margen de error para el que fue fabricado mejorar eso ya no seria cuestion de una aplicacion si no de un hardware nuevo y mejorado.
Posted via Mobile Device

[RamGia]

Esta info está muy interesante, tengo experiencia en programación aunque hace ya bastante tiempo que no le dedico tiempo a desarrollar, mi último lenguaje de programación usado fue Visual Studio 6, pero nunca he intentado hacer algo en JAVA, veré si le dedico algo de tiempo y quien quita que pueda de repente entrar en el hilo del desarrollo de aplicaciones para BB.

Saludos y gracias por tan excelente info.-

[javiergv]

Iniciado por RamGia

Esta info está muy interesante, tengo experiencia en programación aunque hace ya bastante tiempo que no le dedico tiempo a desarrollar, mi último lenguaje de programación usado fue Visual Studio 6, pero nunca he intentado hacer algo en JAVA, veré si le dedico algo de tiempo y quien quita que pueda de repente entrar en el hilo del desarrollo de aplicaciones para BB.

Saludos y gracias por tan excelente info.-

De nada, creo que te iria mejor que a mi, yo solo tenia experiencia con Programacion en TurboPascal y en HP :s y poco a poco y leyendo bastante he logrado hacer par de cosas. El web launcher de ZonaBlackberry y la App de ZonaBlackberry Mobile que la puedes encontrar como stick en el foro de Aplicaciones. Cualquier duda creo que deberiamos postearla aqui, para que vayamos creciendo en esto. Ahorita estoy en desarrollo de una App que implementa el screenshot y estoy presentando para de problemillas, pero cuando este 100% la dispongo aca.
Posted via Mobile Device

[RamGia]

De nada, creo que te iria mejor que a mi, yo solo tenia experiencia con Programacion en TurboPascal y en HP

Pues como que venimos de la misma escuela porque mis inicios fueron en BASIC =)
También programé en dBase, Pascal, COBOL (lo que más he odiado), hasta que llegué a conocer Visual Basic con el cual desarrollé buenas aplicaciones pero lo único es que tengo como 5 años desconectado y voy a tener que refrescar bastante la memoria jejeje.

De verdad que me interesa bastante la idea de desarrollar aplicaciones para los BB, trataré de estar en contacto con este tema tan interesante.

Gracias nuevamente Javier.-

[TriFulCa2K]

yo fui bien hasta que me da un error al correrlo me dice "I/O Error: Cannot run program "javac": CreateProcess error=2, El sistema no puede hallar el archivo especificado
Error while building projec"

ya noc que hacer

[javiergv]

Debe haber algun error en parate del codigo, de que se trata la aplicacion que intentas hacer? Estas usando algun archivo dentro del programa? Alguna imagen para el icono tal vez? Si es asi, recuerda que debe estar incluido dentro de los recursos de la app, para que cuando lo llames no te de error. Si colocas el codigo seguro te ayudo.
Posted via Mobile Device

[javiergv]

Prueba esto, abre en command, en Inicio>Ejecutar, y colocas dentro cmd y presionas Enter, con esto se abrira el prompt, dentro tipea y ejecuta el comando: "javac" si obtienes algun error eso significa que a) necesitas instalar el apropiado Sun JDK, b) lo otro que puede ser es que tengas que agregar el directorio java/bin al inicio de tu ruta de windows en las variables de entorno, eso lo haces, entrando en propiedades de mi pc, te vas al escritorio, click derecho sobre Mi pc, te pones en la pestaña de opciones avanzadas, luego haces click en variables de entorno. Alli dentro Verifica que en el directorio C:\j2sdk<version\bin aparezca primero en la variable del sistema PATH algo como esto: C:\j2sdk1.4.1_07\bin;C:\Perl\bin\;C:\Oracle\Ora81\bin;C:\Archivos de Programa\Oracle\jre\1.1.7\bin;%SystemRoot%\system3 2; %SystemRoot%



Si tienes multiples versiones de JAVA intaladas, mueve el PATH o ruta al comienzo de la lista como esta en el ejemplo.


Si el directorio C:\j2sdk<version>\bin no existe, es posible que no tengas instalado el Java SDK en tu computadora, como te explique al comienzo. Exitos

[TriFulCa2K]

Gracias amigo ... Si ese era el problema las variables del ambiente.... Coloque path y la ruta de la variable ...eso lo hice anoche ... Pero muchas gracias por la ayuda ... Ya me corrio ... Solo me falta las firmas digitales pero no tengo cupo cadivi jajajaja
Posted via Mobile Device