BlackBerry Messenger SDK

BlackBerry Messenger SDK Versión: 1.2 Guía de introducción

Publicado: 2011-10-11 SWD-1391821-1011103456-005

Contenido 1 Requisitos del sistema... 2 2 Dependencias de versión de BlackBerry Messenger... 3 3 El entorno de preproducción de BlackBerry Messenger... 4 4 Instalación y configuración de los simuladores para ofrecer compatibilidad con BlackBerry Messenger SDK 5 Configurar las variables de entorno Java... 5 Instalar y ejecutar BlackBerry MDS Simulator... 5 Configurar BlackBerry MDS Simulator para utilizar cifrado de intensidad ilimitada... 6 Instalar el paquete de BlackBerry Smartphone Simulator... 6 Configuración de BlackBerry Smartphone Simulator... 6 5 Configurar el entorno de desarrollo... 8 Crear un proyecto para la aplicación conectada a BlackBerry Messenger mediante BlackBerry Java Plug-in para Eclipse... 8 Crear un espacio de trabajo para su aplicación conectada a BlackBerry Messenger mediante BlackBerry Java Development Environment... 8 6 Ejecutar la aplicación conectada a BlackBerry Messenger... 10 Ejecutar la aplicación con los simuladores... 10 Ejecutar la aplicación de BlackBerry Java Plug-in para Eclipse... 10 Ejecutar una aplicación desde BlackBerry Java Development Environment... 11 7 Comentarios... 13

Requisitos del sistema Requisitos del sistema 1 Java SE Development Kit (JDK) de 32 bits, versión 6, actualización 20 o superior (http://www.oracle.com/ technetwork/java/javase/downloads/index.html) Nota: La plataforma BlackBerry Messenger no admite Java de 64 bits ni Java 7. Uno de los entornos de desarrollo siguientes: BlackBerry Java Plug-in para Eclipse (na.blackberry.com/developers/javaappdev/javaplugin.jsp), que incluye BlackBerry Java SDK BlackBerry Java Development Environment 6.0 (na.blackberry.com/eng/developers/javaappdev/ javadevenv.jsp) 2

Dependencias de versión de BlackBerry Messenger Dependencias de versión de BlackBerry Messenger 2 La tabla siguiente muestra las dependencias entre versiones del BlackBerry Messenger SDK, de BlackBerry Messenger y de BlackBerry Device Software. Puede utilizar este gráfico para determinar las versiones mínimas de BBM y de BlackBerry Device Software necesarias para ejecutar su aplicación. Versión BBMSDK Versión BBM Versión de BlackBerry Device Software 1.0 6.0.0 5.0 y posterior 1.2 6.0.1 5.0 y posterior 3

El entorno de preproducción de BlackBerry Messenger El entorno de preproducción de BlackBerry Messenger El entorno de preproducción de BBM es un entorno de desarrollo que puede utilizar para crear y probar su aplicación conectada a BBM con una pequeña comunidad beta antes lanzarla a través del escaparate BlackBerry App World. Si su aplicación todavía no se encuentra en BlackBerry App World, se incluye automáticamente en el entorno de preproducción. El entorno de preproducción ofrece todas las funciones del entorno de producción, con las limitaciones siguientes: Las licencias de prueba están limitadas a 100 por cada aplicación Las aplicaciones caducan después de 180 días Una aplicación en preproducción no se puede comunicar con la misma aplicación registrada en BlackBerry App World 3 4

Instalación y configuración de los simuladores para ofrecer compatibilidad con BlackBerry Messenger SDK Instalación y configuración de los simuladores para ofrecer compatibilidad con BlackBerry Messenger SDK 4 Para probar la aplicación conectada a BBM, debe instalar y configurar BlackBerry MDS Simulator y BlackBerry Smartphone Simulator con unas opciones que permitan la comunicación entre BlackBerry MDS Simulator y dos instancias de BlackBerry Smartphone Simulator. Configurar las variables de entorno Java Antes de comenzar: Compruebe que ejecuta la versión de 32 bits de Java SE Development Kit (JDK). 1. En Windows, abra el cuadro de diálogo Environment Variables. 2. Configure la variable de entorno JAVA_HOME en el directorio donde instaló el JDK, por ejemplo: C:\Program Files\Java\jdk1.6.0_24. En Windows de 64 bits, la ruta predeterminada es C:\Program Files(x86)\Java\jdk1.6.0_24. 3. En la variable de entorno PATH, agregue %JAVA_HOME%\bin; al principio de la cadena. 4. Haga clic en OK para guardar y cerrar el cuadro de diálogo Environment Variables. 5. Compruebe que las variables de entorno estén configuradas correctamente. a. Abra una ventana del símbolo del sistema. b. Escriba java -version y asegúrese de que la versión de Java sea la misma que la versión que ha configurado en la variable de entorno: java version "1.6.0_24" Java(TM) SE Runtime Environment (build 1.6.0_24-b07) Java HotSpot(TM) Client VM (build 19.1-b02, mixed mode, sharing) Instalar y ejecutar BlackBerry MDS Simulator Antes de comenzar: Complete la tarea Configurar BlackBerry MDS Simulator para utilizar cifrado de intensidad ilimitada. 1. En la carpeta en la que ha extraído BlackBerry Messenger SDK, abra la carpeta MDS simulator. 2. Extraiga los contenidos del archivo MDSv3.5.3.zip. 3. Abra la carpeta sdk > mds. 4. Haga doble clic en run.bat para iniciar BlackBerry MDS Simulator. Después de terminar: 5

Instalar el paquete de BlackBerry Smartphone Simulator Si ejecuta BlackBerry MDS Simulator y BlackBerry Smartphone Simulator en ordenadores independientes, cambie el valor UDP.send.host del archivo rimpublic.property (ubicado de forma predeterminada en C:\Program Files \Research In Motion\BlackBerry JDE 6.0.0\MDS\config), por la dirección IP del ordenador que esté ejecutando BlackBerry MDS Simulator. Configurar BlackBerry MDS Simulator para utilizar cifrado de intensidad ilimitada Nota: Debe vivir en un país cuya tecnología sea compatible con esta funcionalidad para poder activarla. Antes de comenzar: Compruebe que ejecuta la versión de 32 bits de Java SE Development Kit (JDK). 1. Descargue el archivo jce_policy-6.zip del sitio web de Oracle en http://www.oracle.com/technetwork/java/ javase/downloads/jce-6-download-429243.html. 2. Extraiga los contenidos del archivo jce_policy-6.zip en el ordenador. 3. En el directorio del sistema JDK (por ejemplo, C:\Program Files\Java\jre1.6.0_24\jre\lib\security), sustituya los archivos local_policy.jar y US_export_policy.jar en la carpeta de seguridad. Para obtener más información, consulte Configurar las variables de entorno Java. Instalar el paquete de BlackBerry Smartphone Simulator 1. En la carpeta donde extrajo el archivo BlackBerry Messenger SDK, abra la carpeta BlackBerry smartphone simulator. 2. Haga doble clic en el archivo BlackBerry_Simulators_<version>_<model>.exe. 3. Siga las instrucciones que aparecen en pantalla. Una vez finalizada la instalación del paquete de BlackBerry Smartphone Simulator, dos archivos.bat (sim1.bat y sim2.bat) estarán disponibles en la carpeta en la que ha instalado el paquete de BlackBerry Smartphone Simulator. Estos archivos.bat inician dos instancias de BlackBerry Smartphone Simulator. Estas instancias se comunican entre sí a través de la plataforma de BlackBerry Messenger mediante el simulador BlackBerry MDS Simulator que se ejecuta en el mismo ordenador. Para obtener más información sobre cómo ejecutar las instancias de BlackBerry Smartphone Simulator y BlackBerry MDS Simulator en ordenadores independientes, consulte Configuración de BlackBerry Smartphone Simulator. Configuración de BlackBerry Smartphone Simulator Si desea ejecutar BlackBerry Smartphone Simulator sin iniciar los dos archivos.bat del archivo.zip BlackBerry Messenger SDK, puede crear sus propios archivos.bat que especifiquen los siguientes parámetros para ofrecer compatibilidad con BlackBerry Messenger SDK. 6

Instalar el paquete de BlackBerry Smartphone Simulator Parámetro app-param=regdestip app-param=regdestport appparam=disablesyncservicerecord session app-param=regsrcport pin Descripción Este parámetro especifica la dirección IP del ordenador que ejecuta BlackBerry MDS Simulator. Si BlackBerry MDS Simulator se ejecuta en el mismo ordenador que ejecuta BlackBerry Smartphone Simulator, debe especificar 127.0.0.1. Este parámetro debe especificar el puerto predeterminado, 19781. Si utiliza un valor diferente, asegúrese de que es el mismo para cada instancia de BlackBerry Smartphone Simulator. Se debe especificar este parámetro para llevar a cabo una comunicación punto a punto entre dispositivos. Si ha ejecutado BlackBerry Smartphone Simulator sin especificar este parámetro anteriormente, en BlackBerry JDE, haga clic en File > Erase Simulator File > Erase Filesystem para eliminar el sistema de archivos y suprimir el registro del servicio SYNC de la instancia anterior. El número de sesión debe ser único para cada instancia del simulador. El número de puerto debe ser único para cada instancia del simulador. Este parámetro debe ser 0x2100000 o mayor, y único para cada una de las instancias del simulador. Ejemplo El siguiente ejemplo muestra cómo ejecutar dos instancias de BlackBerry Smartphone Simulator a través de la misma instancia de BlackBerry MDS Simulator. Cree un archivo.bat para iniciar cada instancia BlackBerry Smartphone Simulator personalizada con los siguientes contenidos: Ejemplo de contenido del archivo Simulator 1.bat: @echo off fledge.exe /app=jvm.dll /handheld=9800 /session=sim1 /app-param=jvmalxconfigfile: 9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000a /app-param=regversion=3 / app-param=regdestip=127.0.0.1 /app-param=regdestport=19781 /appparam=regsrcport=19780 /app-param=disablesyncservicerecord Ejemplo de contenido del archivo Simulator 2.bat: @echo off fledge.exe /app=jvm.dll /handheld=9800 /session=sim2 /app-param=jvmalxconfigfile: 9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000b /app-param=regversion=3 / app-param=regdestip=127.0.0.1 /app-param=regdestport=19781 /appparam=regsrcport=19782 /app-param=disablesyncservicerecord 7

Configurar el entorno de desarrollo Configurar el entorno de desarrollo 5 Tanto BlackBerry Java Development Environment como BlackBerry Java Plug-in para Eclipse son compatibles con el desarrollo de aplicaciones compatibles con la plataforma BlackBerry Messenger. Crear un proyecto para la aplicación conectada a BlackBerry Messenger mediante BlackBerry Java Plug-in para Eclipse 1. En Eclipse, abra el BlackBerry Application Development perspective. 2. Haga clic en File > New > BlackBerry Project. 3. En el cuadro de dialogo New BlackBerry Project, en el campo Project Name, escriba un nombre para su proyecto. 4. En la sección JRE, asegúrese de seleccionar una versión de BlackBerry JRE 5.0 o posterior y haga clic en Finish. 5. En la vista de Package Explorer, haga clic con el botón derecho en el proyecto y haga clic en Properties. 6. En el cuadro de diálogo Properties, en el panel izquierdo, haga clic en Java Build Path. 7. Haga clic en la pestaña Libraries. 8. Haga clic en el botón Add External JARs. 9. Vaya a la carpeta donde extrajo el archivo BlackBerry Messenger SDK. En la carpeta BBM SDK, haga doble clic en net_rim_bb_qm_platform.jar. 10. Haga clic en Next. 11. En la ventana de propiedades, haga clic en OK. 12. Cuando esté listo para crear su proyecto, en el menú Project, haga clic en BlackBerry > Package All. Después de terminar: Para probar su aplicación, consulte Ejecutar la aplicación conectada a BlackBerry Messenger. Crear un espacio de trabajo para su aplicación conectada a BlackBerry Messenger mediante BlackBerry Java Development Environment Antes de comenzar: En la carpeta donde extrajo BlackBerry Messenger SDK, copie net_rim_bb_qm_platform.jar de la carpeta BBM SDK a la carpeta lib de BlackBerry Java Development Environment (la ubicación predeterminada de la carpeta lib es C:\Program Files\Research In Motion\BlackBerry JDE 6.0.0\lib). 1. En BlackBerry JDE, haga clic en File > New Workspace. 2. En el campo Workspace Name, escriba un nombre para el espacio de trabajo y haga clic en OK. 3. Haga clic con el botón derecho en el espacio de trabajo y haga clic en Properties. 8

Crear un espacio de trabajo para su aplicación conectada a BlackBerry Messenger mediante BlackBerry Java Development Environment 4. En el cuadro de diálogo Workspace Properties, en la pestaña General, junto a la lista Imported Jar Files, haga clic en Add. 5. En el cuadro de dialogo Add file, navegue hasta C:\Program Files\Research In Motion\BlackBerry JDE 6.0.0\lib y haga doble clic en el archivo net_rim_bb_qm_platform.jar. El archivo aparece en la lista de archivos jar importados en las propiedades del espacio de trabajo. Ahora puede importar las clases BlackBerry Messenger y compilar su aplicación. 6. Haga clic con el botón derecho en el espacio de trabajo y lleva a cabo una de las siguientes acciones: Para importar un proyecto existente, haga clic en Add Project to <workspace name>. Para crear un proyecto nuevo, haga clic en Create new Project in <workspace name>. 7. Una vez esté listo para crear su proyecto, haga clic en la lista desplegable del perfil de BlackBerry Smartphone Simulator ubicada en la esquina superior derecha de BlackBerry JDE. De forma predeterminada, el perfil seleccionado es Default Simulator. 8. En la lista desplegable, haga clic en 9800-6.0.0.313. 9. En el menú Build, haga clic en Build. Los archivos.cod de su aplicación se crean y colocan en el directorio de simuladores de BlackBerry JDE. Después de terminar: Para probar su aplicación, consulte Ejecutar la aplicación conectada a BlackBerry Messenger. 9

Ejecutar la aplicación conectada a BlackBerry Messenger Ejecutar la aplicación conectada a BlackBerry Messenger 6 Ejecutar la aplicación con los simuladores 1. En la carpeta en la que ha extraído el archivo.zip que contiene BlackBerry Messenger SDK, abra la carpeta MDS Simulator -> sdk -> mds. 2. Haga doble clic en run.bat para iniciar BlackBerry MDS Simulator. 3. En Windows Explorer, desplácese a la carpeta en la que ha instalado BlackBerry Smartphone Simulator. De forma predeterminada, la ubicación de esta carpeta es C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0\6.0.0.313 (9800). 4. Haga doble clic en el archivo sim1.bat (o su archivo.bat personalizado) para iniciar un BlackBerry Smartphone Simulator con la configuración adecuada para ejecutar su aplicación y comunicarse con BlackBerry MDS Simulator. 5. En Windows Explorer, en la carpeta BlackBerry Smartphone Simulator, haga doble clic en el archivo sim2.bat (o su segundo archivo.bat personalizado) para iniciar una segunda instancia de BlackBerry Smartphone Simulator con la configuración adecuada para comunicarse con el primer BlackBerry Smartphone Simulator. 6. Para que cada una de las instancias de BlackBerry Messenger se tengan mutuamente como contactos, en la primera instancia BlackBerry Smartphone Simulator, abra BlackBerry Messenger. 7. Haga clic en la tecla Menu y haga clic en el elemento de menú Invite Contact. 8. Haga clic en Invite by sending a PIN or email message. 9. En el campo To, escriba 2100000B. Éste es el PIN predeterminado de la segunda instancia BlackBerry Smartphone Simulator. 10. En la segunda instancia BlackBerry Smartphone Simulator, abra BlackBerry Messenger y acepte la invitación. 11. Haga clic en la tecla Send. 12. En la primera instancia BlackBerry Smartphone Simulator, cierre BlackBerry Messenger. 13. En la pantalla de inicio, haga clic en el icono de la aplicación de la plataforma BlackBerry Messenger. Ahora podrá comunicarse entre dos instancias BlackBerry Smartphone Simulator. Ejecutar la aplicación de BlackBerry Java Plug-in para Eclipse 1. Haga clic en Run > Debug Configurations. 2. Cree una nueva configuración de inicio de BlackBerry Simulator y escriba un nombre. 3. En la pestaña Projects, seleccione los proyectos que quiera iniciar. 4. En la pestaña Simulator, haga clic en General. 5. En la lista desplegable Device, seleccione un simulador (por ejemplo: SimPackage-6.0.0.313_9800-9800). 10

Ejecutar una aplicación desde BlackBerry Java Development Environment Para aprender cómo instalar el paquete del simulador, consulte Instalar el paquete de BlackBerry Smartphone Simulator. 6. Haga clic en la pestaña Advanced: a. Seleccione la casilla de verificación Use Customized command options. b. En el cuadro Customized command line, escriba los argumentos del archivo sim1.bat. Por ejemplo: "C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\fledge.exe" /handheld=9800 /app-param=jvmalxconfigfile: 9800.xml /pin=0x2100000a /data-port=0x4d44 /data-port=0x4d4e /session=9800 / app="c:\program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\Jvm.dll" /app=jvm.dll /handheld=9800 /session=sim1 /appparam=jvmalxconfigfile:9800.xml /data-port=0x4d44 /data-port=0x4d4e / pin=0x2100000a /app-param=regversion=3 /app-param=regdestip=127.0.0.1 /appparam=regdestport=19781 /app-param=regsrcport=19780 /appparam=disablesyncservicerecord /title="blackberry 9800-1 Simulator" c. En el cuadro Customized working directory, escriba la ruta de acceso del directorio donde instaló el paquete del simulador. d. En el cuadro Customized MDS directory, escriba la ruta de acceso del directorio donde instaló el paquete del simulador de MDS. Para aprender cómo instalar el paquete del simulador de MDS, consulte Instalar y ejecutar BlackBerry MDS Simulator. 7. Para guardar la configuración, haga clic en Apply. 8. Haga clic en Debug. Ejecutar una aplicación desde BlackBerry Java Development Environment 1. En BlackBerry JDE, haga clic en Edit > Preferences. 2. Cree un nuevo perfil del simulador y escriba un nombre. 3. En la pestaña Simulator, haga clic en General. 4. En la lista desplegable Device, seleccione un simulador (por ejemplo: SimPackage-6.0.0.313_9800-9800). 5. Haga clic en la pestaña Advanced: a. Seleccione la casilla de verificación Use Customized command options. b. En el cuadro Customized command line, escriba los argumentos del archivo sim1.bat. Por ejemplo: "C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\fledge.exe" /handheld=9800 /app-param=jvmalxconfigfile: 9800.xml /pin=0x2100000a /data-port=0x4d44 /data-port=0x4d4e /session=9800 / app="c:\program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\Jvm.dll" /app=jvm.dll /handheld=9800 /session=sim1 /appparam=jvmalxconfigfile:9800.xml /data-port=0x4d44 /data-port=0x4d4e / 11

Ejecutar una aplicación desde BlackBerry Java Development Environment pin=0x2100000a /app-param=regversion=3 /app-param=regdestip=127.0.0.1 /appparam=regdestport=19781 /app-param=regsrcport=19780 /appparam=disablesyncservicerecord /title="blackberry 9800-1 Simulator" c. En el cuadro Customized working directory, escriba la ruta de acceso del directorio donde instaló el paquete del simulador. d. En el cuadro Customized MDS directory, escriba la ruta de acceso del directorio donde instaló el paquete de MDS. 6. Haga clic en OK. 7. Haga clic en Run. 12

Comentarios Comentarios 7 Para ofrecer comentarios acerca de esta entrega, visite www.blackberry.com/docsfeedback. 13