Versin: 7.0
Gua de introduccin
Contenido
1 Introduccin...................................................................................................................................................... Cmo obtener ayuda para el desarrollo de Java.............................................................................................. 2 Crear una aplicacin ptima............................................................................................................................. Disear su aplicacin........................................................................................................................................ 3 Herramientas de desarrollo de Java................................................................................................................. Acerca de BlackBerry Java Plug-in para Eclipse................................................................................................ Simuladores...................................................................................................................................................... Claves de firma de cdigo................................................................................................................................. 4 Crear su primera aplicacin.............................................................................................................................. Crear la aplicacin Hola BlackBerry.................................................................................................................. Ejecutar su aplicacin....................................................................................................................................... Ejecutar su aplicacin en un simulador..................................................................................................... Ejecutar su aplicacin en un smartphone.................................................................................................. Ms tutoriales................................................................................................................................................... 5 Presentacin de Java SDK................................................................................................................................. API de ciclo de vida de la aplicacin................................................................................................................. API de la interfaz de usuario (IU)...................................................................................................................... API de integracin de aplicaciones................................................................................................................... API de la gestin PIM........................................................................................................................................ API de mensajera............................................................................................................................................. API de conexin de red..................................................................................................................................... API de utilidades y de la plataforma CLDC........................................................................................................ Caractersticas del dispositivo y BlackBerry Infrastructure............................................................................... API de almacenamiento de datos..................................................................................................................... API multimedia................................................................................................................................................. API de servicios basados en ubicacin.............................................................................................................. API de seguridad............................................................................................................................................... Compatibilidad con las API estndar de Java.................................................................................................... 6 Comentarios..................................................................................................................................................... 7 Glosario............................................................................................................................................................. 8 Historial de revisin del documento................................................................................................................. 3 3 4 5 7 7 8 8 9 9 10 10 11 12 13 13 15 17 21 21 23 25 26 29 31 31 33 36 37 38 40
9 Aviso legal.........................................................................................................................................................
41
Gua de introduccin
Introduccin
Introduccin
Sugerencias para crear una aplicacin ptima Una introduccin a las herramientas de desarrollo de aplicaciones BlackBerry Java Un tutorial para aprender a crear una aplicacin sencilla Una introduccin a los componentes de las API en BlackBerry Java SDK
Bienvenido al desarrollo de aplicaciones Java de BlackBerry. Esta gua le ayudar a empezar a crear aplicaciones de mvil para smartphones BlackBerry. En esta gua encontrar:
Esta gua est diseada como introduccin a los recursos de desarrollo de BlackBerry Java, y por tanto ofrece enlaces a informacin adicional en las guas de desarrollo de BlackBerry Java SDK y BlackBerry Developer Zone.
Plataformas de pago para la consulta de dudas: Asistencia tcnica basada en incidentes para desarrolladores Programa BlackBerry Alliance
Puede que su pregunta ya est respondida. Breve descripcin general de los recursos de desarrollo de Java: Guas de desarrollo de Java Aplicaciones Java de muestra Referencia API de Java Recursos para desarrolladores Pgina de introduccin a Java de la zona para desarrolladores de BlackBerry Blog para desarrolladores de BlackBerry Base de conocimientos para el desarrollo de Java
Gua de introduccin
Research In Motion proporciona las siguientes soluciones para ayudarle a alcanzar el xito con sus aplicaciones. Todos estos servicios se proporcionan de forma gratuita.
Gua de introduccin
Disear su aplicacin
Analytics Service es un SDK y portal Web que puede ayudarle a comprender el uso de sus aplicaciones. Por ejemplo, puede reunir datos acerca de sus usuarios como su modelo de smartphone BlackBerry, versin, pas de origen e idioma; el nmero de usuarios nicos, el nmero total de sesiones y la longitud media de una sesin; y datos como vistas de pantalla, clics y errores de aplicacin. Analytics Service recopila los datos, los compila y genera informes y mtricas en un portal Web. Para obtener ms informacin, consulte: Servicio de anlisis Guas para desarrolladores y referencia API de Analytics Service
Disear su aplicacin
Esta seccin proporciona los pasos bsicos de planificacin de una aplicacin ptima, con vnculos a informacin ms detallada.
Investigar el mercado
El primer paso debe ser investigar el mercado para determinar lo que desean los potenciales usuarios. Para las aplicaciones cuya venta est prevista a travs del escaparate BlackBerry App World, deber realizar un estudio del potencial de mercado y observar su actual comportamiento en el mismo. Para las aplicaciones de empresa, deber determinar los niveles de necesidad y capacidad de los usuarios de destino.
Para obtener ms informacin acerca de las caractersticas del modelo y del uso por parte de los clientes de los modelos, consulte: Escoger el SO de un dispositivo de destino Modelos de smartphone BlackBerry Referencia API para BlackBerry Java SDK y Gua de desarrollo de componentes de la interfaz de usuario de BlackBerry Java SDK (para la versin en la que se introdujeron cada uno de los componentes API)
Gua de introduccin
Disear su aplicacin
En BlackBerry Java Plug-in para Eclipse, puede empaquetar su proyecto de aplicacin BlackBerry (y sus proyectos dependientes) para varias versiones de BlackBerry Device Software. Cuando distribuye su aplicacin, el complemento crea un archivo master .alx en la carpeta Standard de su proyecto de aplicacin de BlackBerry. Al distribuir su aplicacin por Internet, el complemento crea los archivos .jad y .cod para cada versin de BlackBerry Device Software en la carpeta Web de su proyecto de aplicacin BlackBerry. Para obtener ms informacin acerca del empaquetado de proyectos de aplicaciones para varias versiones, consulte las guas para desarrolladores de BlackBerry Java Plug-in para Eclipse.
Para obtener ms informacin acerca de los acelermetros y magnetmetros, consulte la Gua de desarrollo de la interfaz de usuario y navegacin de BlackBerry Java SDK. Para obtener ms informacin acerca de NFC, consulte la Gua de desarrollo de red y conectividad de BlackBerry Java SDK. Para obtener informacin sobre nuevas caractersticas de BlackBerry Java SDK 7, consulte: Migrar su aplicacin a BlackBerry 7 BlackBerry Java SDK 7: Novedades de esta versin
Gua de introduccin
Esta seccin describe las herramientas del desarrollo que puede utilizar para el desarrollo de aplicaciones para el smartphone BlackBerry.
Haya versiones de BlackBerry Java Plug-in para Eclipse para sistemas operativos Windows y Macintosh. Si anteriormente ha desarrollado aplicaciones Java de BlackBerry con BlackBerry JDE, podr importar su proyecto a Eclipse con BlackBerry Java Plug-in para Eclipse. Tras la versin 1.1, BlackBerry Java Plug-in para Eclipse no es ya compatible con los archivos de proyecto (.jdp) ni con los archivos de espacio de trabajo (.jdw), adems ha dejado de ser compatible con las versiones anteriores de BlackBerry JDE.
Gua de introduccin
Simuladores
Puede descargar Eclipse IDE y el complemento juntos. Si ya tiene Eclipse instalado, puede elegir instalar Eclipse IDE con BlackBerry Java Plug-in en un directorio diferente, o sobrescribir su instalacin existente. Estos son los sitios de descarga para Eclipse con el complemento: BlackBerry Java Plug-in para Eclipse v1.3 (Windows) BlackBerry Java Plug-in para Eclipse v1.3 (Mac)
Si ya tiene Eclipse Classic 3.6.x instalado, puede instalar el complemento y SDK sin volver a instalar Eclipse. Puede hacer esto en Eclipse, o a travs de Help > Install New Software (debe especificar un sitio de actualizacin de BlackBerry para esto) o Window > Preferences (ample el elemento Java y seleccione Installed JREs). Una vez que tiene el complemento instalado, puede actualizar la versin de JavaSDK o eliminar Java SDK. Puede encontrar las instrucciones completas de la instalacin aqu: guas de desarrollo de BlackBerry Java Plug-in para Eclipse (para Windows y Mac).
Simuladores
Cuando instala el BlackBerry Java Plug-in para Eclipse, se incluye un simulador en la descarga. Sin embargo, es una buena prctica probar su aplicacin en simuladores para varios modelos de smartphone. Puede descargar otros simuladores de BlackBerry gratuitos. Para obtener ms informacin acerca de los simuladores y cmo descargarlos, consulte: Simuladores de smartphones BlackBerry Guas de desarrollo de simuladores de smartphones BlackBerry
Gua de introduccin
BlackBerry Java Plug-in para Eclipse 1.3 y posterior proporciona plantillas que puede utilizar para crear un proyecto de aplicacin bsico de BlackBerry. Puede personalizar el cdigo en la plantilla segn convenga a sus necesidades, o puede crear una aplicacin desde cero con una plantilla vaca. Para empezar, crearemos una versin de la aplicacin "Hola mundo" mediante la plantilla Hola BlackBerry. Esta versin de "Hola mundo" es una aplicacin bsica de interfaz de usuario que proporciona algunos componentes sencillos de la interfaz de usuario. La aplicacin incluye un campo de texto editable que permite al usuario del dispositivo BlackBerry escribir texto en un campo; en este ejemplo, puede escribir su nombre. La aplicacin tambin incluye un campo de botn. Cuando el usuario del dispositivo BlackBerry escriba su nombre y haga clic en el botn Say Hello to, la aplicacin mostrar un cuadro de dilogo con el texto Hello <username> tal como se muestra en la siguiente captura de pantalla.
Gua de introduccin
Ejecutar su aplicacin
8.
En la lista de proyectos del panel del Navegador de paquetes, aparece el proyecto de HolaBlackBerry. Puede ampliar el proyecto para comprobar que la carpeta de src/mypackage contenga dos archivos de origen de Java: HelloBlackBerry.java: este archivo contiene el cdigo fuente para la seccin principal de la aplicacin. HelloBlackBerryScreen.java: este archivo contiene el cdigo fuente para generar la pantalla.
Ejecutar su aplicacin
Puede ejecutar y probar su aplicacin en un BlackBerry Smartphone Simulator o un smartphone BlackBerry. BlackBerry Java Plug-in para Eclipse incluye simuladores para varios modelos de smartphones BlackBerry. Los simuladores ejecutan el mismo cdigo Java que los smartphones, as que un simulador ofrece un entorno preciso para probar cmo funcionar su aplicacin en un dispositivo BlackBerry.
3.
10
Gua de introduccin
Ejecutar su aplicacin
4.
5. 6.
La aplicacin HolaBlackBerry se abre y muestra una pantalla con un campo de texto editable y un botn. Para probar la aplicacin HolaBlackBerry, escriba su nombre en el campo Enter Name y, a continuacin, haga clic en el botn Say Hello to. Se mostrar un cuadro de dilogo con el texto Hello <your name> y un botn OK. Haga clic en OK. Para cerrar la aplicacin, en el simulador, pulse la tecla Menu y, a continuacin, seleccione Close. Para cerrar el simulador, seleccione File > Exit.
4.
11
Gua de introduccin
Ms tutoriales
Ms tutoriales
Aqu tiene algunos tutoriales avanzados: Tutorial: Crear un botn personalizado Tutoriales en los foros de asistencia de desarrolladores de Java
12
Gua de introduccin
El smartphone BlackBerry se crea en su totalidad desde el principio como un dispositivo basado en Java, con todas las aplicaciones y API integradas escritas en Java. BlackBerry Java SDK incluye API de Java ME y API especficas de BlackBerry. Las API de BlackBerry le proporcionan acceso a funciones avanzadas de la interfaz de usuario, adems de una fantstica integracin con las aplicaciones existentes, la capacidad de crear bases de datos con SQLite y utilizar las funciones de cifrado para proteger el contenido, la funcionalidad de integracin de caractersticas basadas en ubicacin (por ejemplo, mapas y la funcin de geoubicacin), etc. BlackBerry Java SDK se divide en doce categoras. Cada categora consta de API que ofrecen un tipo independiente de funcionalidad, por ejemplo, la creacin de una interfaz de usuario, redes, almacenamiento de datos y seguridad. Muchas de las categoras incluyen tanto API de Java ME como especficas de BlackBerry. Las doce categoras que forman BlackBerry Java SDK se describen en las secciones siguientes.
Iniciando
Una aplicacin BlackBerry se puede iniciar de varias maneras: El usuario hace clic en un icono en la pantalla de inicio. El sistema inicia automticamente la aplicacin cuando el smartphone se enciende. Otra aplicacin la inicia. El sistema inicia la aplicacin a una hora programada.
En ejecucin
Independientemente de cmo se inicie una aplicacin, el Administrador de aplicaciones ser el responsable de iniciar el proceso en el cual se ejecutar la aplicacin. La clase ApplicationManager permite a las aplicaciones interactuar con el Administrador de aplicaciones para realizar tareas, incluidas: Ejecutar una aplicacin inmediatamente o a una hora especfica. Interactuar con procesos, por ejemplo, la recuperacin de los ID de las aplicaciones en primer plano. Publicar eventos globales en el sistema.
El Administrador de aplicaciones inicia una aplicacin obteniendo un nuevo proceso y generando un subproceso dentro del mismo para llamar a uno de los puntos de entrada de la aplicacin. Para muchas aplicaciones, el mtodo main() de la clase de la aplicacin es el nico punto de entrada al que se llama. Sin embargo, puede
13
Gua de introduccin
configurar ms de un punto de entrada para una aplicacin. Si hay varios puntos de entrada, los usuarios podrn iniciar la aplicacin de diversas maneras. Por ejemplo, si su aplicacin permite a los usuarios crear un documento nuevo, es posible que desee proporcionar a los usuarios dos iconos en los que hacer clic para iniciar la aplicacin. Los usuarios podrn hacer clic en uno de los iconos para abrir la aplicacin en su pantalla de inicio y en el otro icono para abrir la aplicacin en la pantalla necesaria para crear un documento nuevo. Los descriptores de la aplicacin son conjuntos de datos acerca de una aplicacin. Una sola aplicacin puede tener ms de un descriptor asociado a dicha aplicacin. Una aplicacin con varios puntos de entrada tiene un descriptor de aplicacin que se corresponde con cada uno de esos puntos de entrada. Puede utilizar la clase ApplicationDescriptor para trabajar con los descriptores de la aplicacin. El entorno operativo de BlackBerry consta de varios subprocesos. Le permite ejecutar varias aplicaciones de forma simultnea. Es compatible con la difusin de eventos a varias aplicaciones y con la ejecucin de subprocesos en segundo plano. El subproceso de eventos es el nico subproceso que puede procesar eventos y actualizar la interfaz de usuario de la aplicacin, as que no deber utilizarlo para ejecutar instrucciones que puedan generar errores o tardar mucho tiempo en completarse. Si, por ejemplo, necesita establecer una conexin de red, debe generar y utilizar otro subproceso. Es posible que se den situaciones en las que desee actualizar la interfaz de usuario a partir de un subproceso sin eventos. Existen dos posibilidades. Puede utilizar subprocesos en segundo plano para acceder a la interfaz de usuario adoptando el bloqueo de eventos durante un breve perodo de tiempo. Esta opcin es til si debe realizar una actualizacin rpida o urgente de la IU. En este caso, debe completar rpidamente la actualizacin de la IU que requiere y liberar el bloqueo. De lo contrario, la aplicacin perder su capacidad de respuesta y es posible que el sistema la interrumpa finalmente. Adquiere el bloqueo de eventos llamando a Application.getEventLock() en el subproceso en segundo plano, y a continuacin sincronizando este objeto para serializar el acceso a la IU. Podr agregar un objeto Runnable a la cola de eventos. Esta opcin es preferible si es admisible experimentar una demora antes de que su tarea se ejecute. Inserte un evento en la forma de un objeto que implementa Runnable. El evento ser administrado por el subproceso de eventos cuando sea recibido desde la cola de mensajes. El subproceso de eventos procesa el evento llamando a su mtodo run(). Para insertar eventos Runnable en la cola de mensajes de su aplicacin, utilice el mtodo invokeAndWait() o el mtodo invokeLater().
En cualquier caso, no deber ejecutar tareas que consuman una gran cantidad de tiempo o que puedan bloquearse. Si utiliza llamadas de biblioteca dentro de su tarea, asegrese de conocer su funcionamiento y utilcelas nicamente si se pueden implementar rpidamente y sin ningn tipo de bloqueo.
Interrupcin
Una de las formas de interrumpir una aplicacin consiste en invocar System.exit(), que hace que BlackBerry JVM ponga fin a todos los procesos del autor de la llamada y, como resultado, a todos los subprocesos asociados. De forma alternativa, puede interrumpir una aplicacin sacando la ltima pantalla de la pila de visualizacin, esto har que el mtodo close() realice una llamada a System.exit().
14
Gua de introduccin
Se recomienda eliminar manualmente el registro de cualquier servicio de escucha que haya registrado antes de interrumpir su aplicacin. Puesto que normalmente iniciar el subproceso del distribuidor de eventos llamando a Application.enterEventDispatcher(), que no finalizar, su aplicacin deber proporcionar una forma de interrupcin. Las aplicaciones que interactan con el usuario podran proporcionar un controlador para el elemento de men Close y las aplicaciones que no interactan con el usuario podran poner fin a la aplicacin tras la gestin de algn evento del sistema que represente la razn para su existencia.
Fields
Un Field representa una regin rectangular contenida por un gestor. Cada control, como un botn, corresponde a una instancia de un campo. No puede crear una instancia de Field directamente, pero puede utilizar campos preconstruidos y crear campos personalizados. Cada campo dibuja el control y gestiona las entradas de los usuarios. A continuacin tiene algunos de los campos preconstruidos ms usados: ButtonField proporciona un botn nico LabelField proporciona una etiqueta de texto TextField proporciona una etiqueta de texto DateField le permite almacenar una fecha y mostrarla en distintos formatos en un campo (por ejemplo, 2011/11/17) MapField le permite representar un mapa en un campo BrowserField le permite mostrar contenido Web en un campo
Gerentes
Un Manager, tambin llamado gestor de diseo, gestiona la disposicin y desplazamiento de los campos. Un objeto Manager contiene campos. Hay varias subclases de Manager que administran tipos especficos del diseo de campo.
15
Gua de introduccin
Varios gestores tiles se definen en el paquete net.rim.device.api.ui.container. Los siguientes gestores son los ms utilizados. VerticalFieldManager, que dispone los campos en una nica columna vertical HorizontalFieldManager, que dispone los campos en una nica fila horizontal FlowFieldManager, que dispone los campos horizontalmente en primer lugar y, a continuacin, verticalmente
Debe definir un gestor de diseo en el nivel superior de su pantalla y, a continuacin, agregar campos al mismo. Puesto que los gestores de diseo son subclases de Field, pueden incrustarse en otros gestores de diseo. Tambin puede definir su propio gestor de diseo.
Screens
Un objeto Screen es el contenedor de nivel superior de los elementos de la interfaz de usuario que representa lo que desea mostrar. Los objetos Screen pueden contener campos (por ejemplo, campos de texto), gestores de diseo, botones de opcin y listas desplegables. La API de la interfaz tiene dos tipos principales de objeto Screen: FullScreen se subdivide a su vez en las subclases MainScreen y PhoneScreen PopupScreen se subdivide a su vez en subclases: Dialog, Status, LocationPicker y AbstractLocationPicker
Puede mostrar informacin complementaria para su aplicacin en una pantalla desplegable sin interrumpir el flujo de la aplicacin. Como resultado, no tiene que abandonar la pantalla principal y, a continuacin, volver a la misma ms tarde. Adems, puede dar prioridad a los objetos PopupScreen que deben insertarse en la parte superior de la pila de visualizacin invocando pushGlobalScreen(Screen, int, int).
Mens
Los smartphones BlackBerry organizan comandos en un men al cual se puede acceder pulsando la tecla Men. Los elementos del men son instancias de MenuItem. Puede personalizar el men que se abre para su aplicacin. Puede: Agregar o eliminar elementos del men dependiendo del estado de la pantalla o la aplicacin cuando el men se abra Especificar el orden de los elementos del men Especificar el orden de los elementos del men y el elemento del men seleccionado de forma predeterminada
Listeners (Oyentes)
La API de la IU contiene un modelo de servicios de escucha de eventos genricos que le permite implementar servicios de escucha para numerosos tipos de eventos, como cuando se cambia un campo, o cuando el usuario pulsa una tecla, hace clic en el panel tctil o la bola de desplazamiento, o bien toca la pantalla tctil. Puede establecer un servicio de escucha para un objeto Field invocando setChangeListener() de la clase Field.
16
Gua de introduccin
Algunos componentes estndar en la API de la IU, incluidos los indicadores de actividad y de progreso en el paquete net.rim.device.api.ui.component.progressindicator y las listas y tablas del paquete net.rim.device.api.ui.component.table, utilizan el patrn de diseo Model-View-Controller (MVC). Antes de utilizar estos componentes, debe estar familiarizado con el patrn de diseo MVC. Hay numerosos recursos impresos y en lnea en los que obtener ms informacin acerca de MVC.
Grficos
Dispone de varias opciones para crear grficos en un smartphone BlackBerry: Puede agregar componentes predefinidos de la interfaz de usuario como texto, controles de entrada e imgenes a los objetos Screen. Puede hacer dibujos personalizados sencillos en una pantalla omitiendo el mtodo paint() de la clase que representa la pantalla y utilizando los mtodos suministrados por el objeto Graphics para dibujar en la pantalla. Puede dibujar grficos en 2D con las API de SVG: org.w3c.dom, org.w3c.dom.events y org.w3c.dom.svg. Puede crear imgenes ms sofisticadas en 2D mediante las API de la utilidad de grficos: API de OpenGL ES o API de OpenVG. Puede crear imgenes en 3D mediante la API de OpenGL ES. Crear un botn personalizado Gua de desarrollo de interfaz de usuario y navegacin de BlackBerry Java SDK Gua de desarrollo de grficos y animaciones de BlackBerry Java SDK Directrices de la interfaz de usuario de smartphones BlackBerry Gua de desarrollo de componentes de la interfaz de usuario de BlackBerry Java SDK
API Invoke
Puede utilizar la API Invoke para invocar aplicaciones principales y pasar opcionalmente los datos. Para utilizar esta API, llame a invokeApplication y pase el tipo de aplicacin y el argumento correspondiente. Puede utilizar la API Invoke para invocar las siguientes aplicaciones principales:
17
Gua de introduccin
contactos calculadora calendario cmara BlackBerry Maps notas mensajes telfono bsqueda tareas
Invoke contiene campos APP_TYPE que enumeran las aplicaciones. Para cada aplicacin principal que pueda ser invocada con la API Invoke, hay una subclase correspondiente de la clase ApplicationArguments. Por ejemplo, para invocar la aplicacin Telfono, llame a invokeApplication y pase el tipo de aplicacin Telfono y un argumento PhoneArguments. Para invocar una aplicacin sin argumentos, pase null en lugar de un objeto ApplicationArguments.
BlackBerry Browser
Puede invocar BlackBerry Browser y abrir una pgina Web con los mtodos en la clase Browser y la clase BrowserSession. Para obtener ms informacin acerca de cmo invocar la clase Browser, adems de cmo invocar una clase Browser no especificada navegador predeterminado, consulte el artculo de la Base de conocimientos Invocar Browser. Tambin puede incrustar contenido Web en su aplicacin con la clase BrowserField.
Administrador de aplicaciones
Puede iniciar una aplicacin principal con la clase ApplicationManager, especificando el mdulo de cdigo de la aplicacin. Utilice esta tcnica slo si la aplicacin no se puede invocar con cualquiera de las tcnicas descritas anteriormente. No puede pasar los argumentos de la aplicacin a una aplicacin principal con esta tcnica. Puede utilizar ApplicationManager para invocar las siguientes aplicaciones principales:
18
Gua de introduccin
Nota: Los nombres de los mdulos de las aplicaciones principales estn sujetos a cambios. La invocacin directa de mdulos pueden tener efectos secundarios involuntarios.
19
Gua de introduccin
utilizan en el navegador de archivos (incluida la aplicacin Multimedia) y en el men Enviar como en la aplicacin Cmara.
Bsqueda unificada
El Servicio de bsqueda unificada es un motor de bsqueda que se incluye con BlackBerry Device Software 6 o posterior. Puede utilizar la API de bsqueda unificada (net.rim.device.unifiedsearch) para incluir sus datos de aplicaciones en el repositorio del servicio de bsqueda unificada y buscar en el ndice de contenidos desde su aplicacin.
20
Gua de introduccin
Extensiones de RIM
Las extensiones de RIM para el PIM de J2ME incluyen: Compatibilidad con varios calendarios, varias listas de calendario y listas de contactos Lectura y escritura en el bloc de notas Obtencin y configuracin de la frecuencia de los elementos ToDo Configuracin una interfaz de usuario estndar para seleccionar un contacto Bsquedas en la Lista global de direcciones (GAL) (para entornos de BlackBerry Enterprise Server)
Para obtener ms informacin acerca de las extensiones de RIM para PIM, consulte net.rim.blackberry.api.pdap.
API de mensajera
Las API de mensajera le permiten utilizar la funcionalidad de mensajera en sus aplicaciones, incluidos correos electrnicos, mensajes de aplicacin, SMS, MMS y BlackBerry Messenger.
21
Gua de introduccin
API de mensajera
Para crear y enviar mensajes de correo electrnico, debe configurar el valor Sesin predeterminado, recuperar una instancia de Store, crear el mensaje de correo electrnico y almacenar el correo electrnico en una carpeta de elementos enviados recuperados. Por ltimo, debe configurar y enviar el mensaje de correo electrnico. Cada dispositivo BlackBerry tiene un PIN nico y admite mensajera PIN a PIN enviada con la aplicacin Mensajes. Para configurar su aplicacin de forma que cree y enve mensajes PIN, establezca la Sesin predeterminada, recupere una instancia de Store, establezca la direccin de PIN de destino, cree el mensaje PIN y almacene el mensaje en una carpeta enviada recuperada. Por ltimo, debe configurar y enviar el mensaje de PIN. Para enviar un mensaje de correo electrnico con un archivo adjunto, cree el objeto Multiparte, cree y aada el archivo adjunto a este objeto, y estructure y enve el mensaje correo electrnico. Para descargar automticamente archivos adjuntos en mensajes de correo electrnico en segundo plan cuando los mensajes lleguen a la lista de mensajes, utilice la interfaz DownloadProgressListener y la clase AttachmentDownloadManager.
Mensajes de la aplicacin
Un ApplicationMessage es un mensaje personalizado que aparece en la aplicacin Mensajes y que invoca su aplicacin cuando el usuario la abre o elige un elemento del men proporcionado para el mensaje. Puede utilizar un paquete messagelist para crear mensajes de la aplicacin.
Puede enviar mensajes SMS con la API javax.wireless.messaging y la API Invoke de BlackBerry. No es posible enviar mensajes SMS directamente desde un smartphone BlackBerry que opera en una red CDMA. Para recibir mensajes SMS a travs de BlackBerry Java SDK 4.6.0 o posterior, utilice la interfaz MessageListener. Si utiliza una versin anterior del SDK, utilice la interfaz MessageConnection. Si desea que mensajes SMS especficos se guarden en una carpeta de mensajes SMS, debe especificar la ubicacin de la carpeta mediante MessageArguments cuando se reciba el mensaje SMS por parte del smartphone BlackBerry. Las aplicaciones no pueden acceder a los mensajes SMS almacenados en el smartphone BlackBerry. Para escuchar los mensajes SMS entrantes que aparecen en la lista de mensajes, debe configurar el argumento del nmero de puerto de Connector.open() en 0 - Connector.open("sms://:0"). Los mensajes MMS cuentan con un encabezado MMS y un cuerpo MMS. El encabezado MMS consta de direccin, prioridad, asunto e informacin de entrega. El cuerpo MMS es la parte de archivo adjunto multimedia. Para recibir mensajes MMS mediante BlackBerry Java SDK 4.6.0 o posterior, utilice la interfaz MessageListener. Si utiliza una versin anterior de BlackBerry JDE, debe utilizar la interfaz MessageConnection.
22
Gua de introduccin
El envo de mensajes MMS es similar al envo de mensajes SMS, a excepcin de que debe pasar la constante MULTIPART_MESSAGE al crear el objeto MessageConnection. Para escuchar los mensajes MMS entrantes que aparecen en la lista de mensajes, configure el ID de la aplicacin Connector.open() seleccionada en 0. Adems de proporcionar notificaciones a las aplicaciones cuando se reciben mensajes (mediante la interfaz MessageListener), tambin puede configurar las notificaciones de las aplicaciones para los mensajes SMS y MMS salientes y enviados. Para los mensajes SMS, puede configurar su aplicacin para efectuar un seguimiento de los mensajes SMS enviados pasando una instancia de una clase que implementa la interfaz OutboundMessageListener al invocar MessageConnection.setMessageListener(). La notificacin mediante esta interfaz ocurre slo una vez que el mensaje se ha enviado correctamente. Si la operacin de envo genera un error, no se notificar a la aplicacin.
BlackBerry Messenger
BBM es un programa de mensajera instantnea que permite a los usuarios de smartphones BlackBerry comunicarse sin iniciar sesin o salir de la aplicacin. Siempre que los smartphones estn conectados a una red mvil, BBM mantiene conectados a los usuarios con sus contactos y grupos de BBM. BlackBerry Messenger SDK es una descarga independiente de BlackBerry Java SDK. BBM SDK, utilizado en conjunto con BlackBerry Java SDK, le permite desarrollar aplicaciones que incorporan caractersticas sociales, por ejemplo, conexiones punto a punto entre smartphones BlackBerry y los chats integrados. Por ejemplo, en una aplicacin de un juego de ajedrez, el usuario del smartphone BlackBerry podra invitar a un contacto de BBM a jugar una partida de ajedrez y los movimientos podran enviarse y recibirse mediante la plataforma BBM. No es necesario que desarrolle estas caractersticas sociales por su cuenta, y tampoco es necesaria una herramienta de desarrollo de servidor para ofrecer compatibilidad con las mismas. Para obtener ms informacin acerca de BBM, consulte las guas para desarrolladores del SDK de la plataforma social BlackBerry Messenger.
API de red
La API de red se ha diseado para facilitar la creacin de conexiones HTTP, HTTPS, de socket, TLS, SSL, UDP y de datagrama. Incluye las clases para las dos principales tareas implicadas en la creacin de una conexin de red:
23
Gua de introduccin
Puede utilizar el mtodo TransportInfo.getAvailableTransportTypes() para determinar qu tipos de transporte son compatibles con el smartphone. A continuacin, puede utilizar el mtodo TransportInfo.isTransportAvailable() para determinar si el smartphone puede finalmente utilizar el tipo de transporte suministrado. Por ltimo, puede probar la cobertura del tipo de transporte mediante TransportInfo.hasSufficientCoverage(). Tras la secuencia de llamadas de sondeo, conocer los tipos de transporte que hay disponibles y si el smartphone se encuentra en cobertura para el transporte elegido. La API de red no crea conexiones seguras para subprocesos. Su aplicacin se bloquear si llama a ConnectionFactory.getConnection() en el subproceso de evento. Al llamar a este mtodo para crear una conexin, se crea un subproceso sin eventos. La manera ms sencilla de utilizar la clase ConnectionFactory para crear una conexin consiste en llamar al mtodo ConnectionFactory.getConnection(), especificando slo la URL a la que conectarse. El mtodo devolver un objeto ConnectionDescriptor desde el que llamar a ConnectionDescriptor.getConnection() para recuperar un objeto Connection que podr relacionar con un subobjeto adecuado. La solucin BlackBerry tambin activa aplicaciones de servidor para insertar datos de forma proactiva en smartphones BlackBerry de un modo sumamente seguro y fiable.
NFC
El paquete de API de NFC le permite leer y escribir datos en etiquetas inteligentes, emular una etiqueta inteligente y acceder a un elemento seguro incrustado en un smartphone BlackBerry o tarjeta SIM. La API de NFC admite la mayora de los tipos principales de etiquetas. NFC se ofrece en el paquete net.rim.device.api.io.nfc. Puede comprobar si un smartphone admite NFC con las clases de DeviceCapability en el paquete net.rim.device.api.system.capability. Para leer y escribir en etiquetas inteligentes, puede registrar su aplicacin para recibir las notificaciones cuando un smartphone BlackBerry detecte una etiqueta. Puede registrar servicios de escucha con la clase ReaderWriterManager en el paquete net.rim.device.api.io.readerwriter. Puede configurar un smartphone para
24
Gua de introduccin
que emule una etiqueta inteligente con el paquete net.rim.device.api.io.nfc.emulation. Para conectar accesorios inteligentes a su dispositivo, puede utilizar la clase net.rim.device.blackberry.api.accessory.AccessoryManager. Puede utilizar el paquete net.rim.device.api.io.nfc.se para acceder a un elemento seguro.
Gua de introduccin
javax.xml.parsers proporciona compatibilidad con el procesamiento de documentos XML mediante el uso del procesamiento XML basado en eventos SAX (Simple API for XML). javax.xml.rpc proporciona compatibilidad con JAX-RPC en el cliente de servicios Web org.xml.sax proporciona compatibilidad con eventos principales SAX org.xml.sax.helpers proporciona clases helper para la compatibilidad con SAX
Los paquetes proporcionados por RIM en la categora de utilidades y plataforma CLDC son: Paquetes relacionados con servicios Web y XML: net.rim.device.api.xml, net.rim.device.api.xml.jaxp y net.rim.device.api.xml.parsers Paquetes relacionados con recopilaciones: net.rim.device.api.collection, net.rim.device.api.collection.util y net.rim.device.api.util Matemticas y otras utilidades: net.rim.device.api.math y net.rim.device.api.util J2ME Web Services (documento tcnico de Sun)
26
Gua de introduccin
Hay algunos mecanismos generales que puede utilizar para consultar la informacin disponible acerca de un smartphone. Puede utilizar System.getProperty() para obtener informacin acerca de numerosas caractersticas del smartphone, por ejemplo, si admite las mezclas de audio y qu zona horaria se ha configurado actualmente. Puede utilizar la clase DeviceCapability para consultar si las capacidades cubiertas estn admitidas, permitidas o disponibles. Mediante la API del libro de servicios (net.rim.device.api.servicebook), su aplicacin puede interactuar con el libro de servicios en el smartphone. Por ejemplo, puede utilizar un registro de servicios para controlar varias conexiones de correo electrnico o para buscar mensajes de correo electrnico individuales dentro de una jerarqua de correo electrnico basada en el ID del contenido del elemento del correo electrnico. Las siguientes clases, principalmente en el paquete net.rim.device.api.system, proporcionan mtodos que le permiten obtener informacin acerca del smartphone: Clase AccelerometerSensor Audio Backlight BluetoothSerialPort Branding CDMAInfo DeviceInfo Los mtodos ofrecen datos tales como... Si el smartphone tiene un acelermetro Si el smartphone admite audio, cdecs, auriculares; si los auriculares estn conectados; el volumen Si la retroiluminacin est activada y si el brillo se puede configurar; el brillo, el brillo predeterminado y el tiempo de espera de la retroiluminacin Si se admite Bluetooth; informacin sobre Bluetooth ID de fabricante, versin de los datos de marca, si los datos de marca estn firmados El nmero de serie electrnico (ESN) e identificador de equipo mvil (MEID) del smartphone La versin de la plataforma, la versin de software, el nombre del fabricante, el PIN, el ID del dispositivo, el nombre del dispositivo, si es un simulador, el nivel de batera, el estado de la batera, la temperatura de batera, el voltaje de batera, si la batera se puede extraer, si hay una cmara, el tamao de la memoria flash Propiedades como subpxeles y requisitos para la retroiluminacin; la resolucin horizontal y vertical; la altura y el ancho del rea de dibujo; el nmero de colores que se muestran Identidad internacional de equipos mviles (IMEI) Si el smartphone admite GPS; modo de GPS predeterminado Si se admite LED, si el LED es multicolor Estadsticas de RAM, el tamao de la memoria flash, la cantidad de memoria flash libre Informacin del propietario, el nombre del propietario El nmero de telfono; si el correo de voz est activado Familias de acceso inalmbrico compatibles
Display
27
Gua de introduccin
Los mtodos ofrecen datos tales como... Si el smartphone tiene tapa y si est abierta; si tiene un sensor de funda y si est en su funda; si tiene un teclado deslizante y el estado del teclado El nmero de International Mobile Subscriber Identity (Identidad internacional de suscriptor mvil o IMSI) Si hay un puerto USB; el estado de la conexin USB
BlackBerry Infrastructure
Research In Motion ofrece dos tipos bsicos de infraestructura: BlackBerry Enterprise Server y BlackBerry Internet Service. BES: BlackBerry Enterprise Server es una solucin inalmbrica con caractersticas de seguridad avanzadas para empresas con departamentos de IT. BlackBerry Enterprise Server se ejecuta detrs del firewall de la empresa y se integra con una infraestructura existente en la empresa. Est diseado para ser un vnculo seguro y centralizado entre la red inalmbrica, el software de comunicacin, las aplicaciones y los smartphones BlackBerry de una empresa. Los administradores pueden aplicar reglas de polticas de TI y directivas de control de las aplicaciones para controlar los smartphones utilizados en la empresa. Para los desarrolladores Java, en un entorno BES, hay varias API de inters: BlackBerry Administration API: una descarga separada de BlackBerry Java SDK. Consulte las guas de desarrollo de BlackBerry Administration API. Servicios web de BlackBerry para administracin: una descarga independiente de Java SDK. Consulte las guas de desarrollo de los servicios web de BlackBerry para administracin. En Java SDK hay muchas API relevantes para desarrolladores de BES, incluida la API de poltica de TI (net.rim.device.api.itpolicy) y la de control de aplicaciones (net.rim.device.api.applicationcontrol).
BIS: BlackBerry Internet Service es un servicio de correo electrnico y de Internet para dispositivos diseado para proporcionar funciones a los suscriptores de mensajes como la entrega automtica de correo electrnico, acceso mvil a los mensajes adjuntos y cmodo acceso a contenidos de Internet. BlackBerry Internet Service utiliza la seguridad de la red inalmbrica a la que se conecta. Los mensajes de correo electrnico que se envan entre BlackBerry Internet Service y el smartphone BlackBerry no estn cifrados. Si estos mensajes de correo electrnico se envan a travs de la red inalmbrica, utilizan los modelos de seguridad de red inalmbrica existentes o disponibles. Sin embargo, los mensajes de correo electrnico que se envan entre BlackBerry Internet Service y el servidor de mensajera se pueden cifrar a travs del cifrado SSL. El explorador y otras aplicaciones del dispositivo BlackBerry pueden utilizar el cifrado SSL con el fin de proteger los datos cuando los suscriptores se conectan a Internet (por ejemplo, mientras realiza compras o consulta sus datos bancarios en lnea).
Servicio push
28
Gua de introduccin
El servicio push ofrece una manera eficaz y segura de enviar informacin a smartphones BlackBerry. Puede crear una aplicacin con push mediante la API de push, net.rim.blackberry.api.push. La API de push detecta la informacin de fondo y despierta su aplicacin cuando llega nueva informacin. La funcionalidad de servidor se ofrece en el Push SDK que se descarga por separado; consulte las guas de desarrollo de Push Service SDK.
Almacena los datos en archivos y carpetas mediante la API FileConnection. Almacena los datos en bases de datos relacionales mediante la API Database. Almacena objetos despus de varios reinicios del smartphone mediante la API PersistentStore. Guarda los objetos de forma no constante, lo cual es muy til para compartir datos entre aplicaciones y crear instancias nicas de sistema mediante la API RuntimeStore. Almacena los datos en el sistema de administracin de registros MIDP mediante la API RMS.
La siguiente tabla compara las caractersticas de cada enfoque: Caractersticas Sistema de archivos Cualquiera Base de datos Almacn SQLite constante Archivo de base de datos relacional Tarjeta de memoria externa, almacenami ento multimedia integrado Objeto de Java Almacn de tiempo de ejecucin Objeto de Java Almacn de registros Serializado
Data format
Storage locations
29
Gua de introduccin
Caractersticas
Sistema de archivos almacenamient o multimedia integrado Tamao de las particiones a las que el usuario tiene acceso
Almacn de registros
Tamao de las particiones a las que el usuario tiene acceso 5.0 o posterior S S
Todo
3.6 o posterior
Todo
S S
No S
S S
A continuacin se ofrecen algunas consideraciones que le ayudarn a elegir un enfoque de almacenamiento de datos: El sistema de archivos y las bases de datos SQLite constituyen, normalmente, la ubicacin de almacenamiento ms eficaz para archivos grandes de slo lectura como vdeos o grficos de gran tamao. La memoria de los smartphones inalmbricos puede ser muy limitada, por lo que debe considerar no almacenar todos los datos en el smartphone. Los smartphones BlackBerry estn con frecuencia conectados por lo que aplicacin puede acceder a los datos cuando sea necesario. En muchos casos, el mejor enfoque consiste en almacenar los datos despus de varios reinicios del smartphone slo para los datos a los que se accede con frecuencia. A la hora de considerar dnde almacenar los datos esenciales, tenga presente que las tarjetas microSD se pueden quitar. Hay ms latencia en el proceso de escritura en el almacenamiento de la aplicacin que en el proceso de lectura del mismo. Por ejemplo, el proceso de lectura del almacn constante es relativamente rpido mientras que los objetos commits son relativamente lentos. El sistema de archivos y el almacn de registros son enfoques basados en estndares, mientras que el almacn constante y el almacn de tiempo de ejecucin son especficos para el smartphone BlackBerry. Si desea que su aplicacin se ejecute en otros dispositivos compatibles con Java ME, debe considerar un enfoque basado en estndares. Gua de desarrollo de almacenamiento de datos de BlackBerry Java SDK
30
Gua de introduccin
API multimedia
API multimedia
La API multimedia le permite reproducir y registrar audio y vdeo. Esta API es la Mobile Media API establecida en JSR 135 y se ofrece en el paquete javax.microedition.media. Para registrar y reproducir archivos multimedia en su aplicacin, deber utilizar la clase Player. Para crear una instancia de la clase Player, invoque createPlayer() en la clase javax.microedition.media.Manager. Al crear por primera vez la clase Player mediante uno de los mtodos createPlayer(), se adopta un estado UNREALIZED. Antes de poder obtener acceso a los metadatos o controles asociados a la clase Player, debe invocar el mtodo realize() del objeto Player. Este mtodo efecta una transicin de la clase Player al estado REALIZED. En el estado REALIZED, la clase Player proporciona acceso a los recursos asociados que controlan la reproduccin y la grabacin. Puede utilizar los mtodos getControl() y getControls() del objeto Player (heredados de Controllable), pasando un String que especifica el objeto Control necesario. Los controles para el reproductor multimedia estn disponibles en el paquete javax.microedition.media.control. Antes de que su aplicacin se cierre, debe invocar el mtodo close() del objeto Player para poner fin a la asignacin de los recursos creados por Player. Esta accin se podr llevar a cabo en cualquier momento para liberar memoria o recursos. Tras invocar close(), ya no podr utilizar la clase Player.
31
Gua de introduccin
Geoubicacin: proporciona una ubicacin utilizando la posicin de la antena celular y los puntos de acceso de WLAN. No es necesario disponer de la tecnologa GPS en el smartphone para utilizar el servicio de geoubicacin. La geoubicacin es til para aplicaciones que requieran una ubicacin aproximada y que puedan utilizarse en interiores (por ejemplo, aplicaciones que realizan recomendaciones sobre lugares de inters locales). Puede recuperar la geoubicacin mediante el paquete net.rim.device.api.gps. Codificacin geogrfica y codificacin geogrfica inversa: proporciona las coordenadas geoespaciales de una calle (codificacin geogrfica), as como la calle de las coordenadas geoespaciales (codificacin geogrfica inversa).
Su aplicacin puede interactuar con BlackBerry Maps de las siguientes formas: Invoque BlackBerry Maps desde su aplicacin mediante el mtodo Invoke.invokeApplication() con parmetros MapsArguments. Puede mostrar lo siguiente: una ubicacin para una direccin de la aplicacin Contactos una ubicacin para un hito una ubicacin en coordenadas especficas una ubicacin o una ruta mediante un documento de ubicacin un ubicacin mediante informacin local de bsqueda una superposicin KML Abra BlackBerry Maps desde BlackBerry Browser
32
Gua de introduccin
API de seguridad
Puede crear un cuadro de dilogo de colector de ubicacin que permita al usuario elegir una ubicacin de una lista con posibles opciones definidas por usted. Puede definir el cuadro de dilogo de colector de ubicacin con la API Colector de ubicacin incluida en el paquete net.rim.device.api.lbs.picker. La ubicacin se pasar mediante un objeto javax.microedition.location.Landmark.
API de seguridad
Las API de seguridad incluyen la RIM Cryptographic API y la API de proteccin de contenido.
33
Gua de introduccin
API de seguridad
API de conexin segura: la API de conexin segura define la funcionalidad del protocolo que puede utilizar para establecer comunicaciones sumamente seguras. Puede utilizar los siguientes protocolos: SSL: el estndar SSL est diseado para proteger los datos enviados mediante conexiones de TCP/IP; se utiliza en la implementacin de HTTPS. SSL se proporciona en el paquete net.rim.device.api.crypto.tls.ssl30 . TLS: el estndar TLS pertenece a IETF y est basado en la versin 3 de SSL. TLS se dise para sustituir a SSL y su adopcin ha sido muy amplia. TLS se proporciona en los paquetes net.rim.device.api.crypto.tls y net.rim.device.api.crypto.tls.tls10. WTLS: el estndar WTLS es una capa sobre WAP, en lugar de sobre TCP/IP. La proteccin de las comunicaciones inalmbricas que utilizan WAP implica el uso de WTLS entre el smartphone cliente y el gateway WAP, y de SSL o TLS ms all del gateway WAP. WTSL se proporciona en el paquete net.rim.device.api.crypto.tls.wtls20 .
API del almacn de claves: un almacn de claves es una base de datos que almacena certificados y claves de cifrado. Cada smartphone BlackBerry tiene un almacn de claves precargado con certificados raz para todas las autoridades de certificacin. Esta prctica permite a los usuarios del smartphone BlackBerry confiar en los certificados raz, que forman la base para todas las cadenas de confianza subsiguientes. Las clases del almacn de claves se proporcionan en el paquete net.rim.device.api.crypto.keystore . API de certificados: los certificados son documentos electrnicos que almacenan claves, junto con informacin de identificacin. Hay varios paquetes que le ayudarn a administrar certificados de cifrado:
net.rim.device.api.crypto.certificate net.rim.device.api.crypto.certificate.status net.rim.device.api.crypto.certificate.x509 javax.microedition.pki net.rim.device.api.crypto.certificate.wtls
API de codificador: la codificacin es el proceso utilizado para convertir los datos de un formato a otro. Aunque a menudo forma parte del proceso de cifrado, la codificacin no es lo mismo que el cifrado y generalmente no es segura. Las claves se codifican para ofrecer una representacin estndar, no para proteger su identidad. Las clases para codificar claves y firmas se proporcionan en el paquete net.rim.device.api.crypto.encoder . API de ASN1: la mayora de las aplicaciones utilizan certificados producidos por una autoridad de certificacin. Si necesita analizar o leer certificados personalmente, debe utilizar el paquete net.rim.device.api.crypto.asn1 . API de OID: los identificadores de objeto se administran con el paquete net.rim.device.api.crypto.oid . API de valores bsicos: los valores bsicos de cifrado son las claves, MAC, las cifras, los algoritmos sin clave como los compendios y PRNG, y otras funcionalidades asociadas al cifrado simtrico y de clave pblica. Los valores bsicos de cifrado se proporcionan en el paquete net.rim.device.api.crypto .
Proteccin de contenido
34
Gua de introduccin
API de seguridad
La funcin de proteccin de contenido se encarga de evitar los problemas relacionados con el robo de un smartphone y la copia de los datos contenidos en l, algo que puede suceder incluso cuando los datos estn cifrados y el smartphone se encuentra bloqueado. La proteccin de contenido cifra los datos de tal forma que es imposible acceder a la clave de cifrado cuando el smartphone se encuentra bloqueado. Una implementacin de la proteccin de contenido consta de tres partes: Todos los modelos de smartphone BlackBerry incorporan la funcin de proteccin de contenido. Para hacer uso de ella, es imprescindible que el smartphone cuente con una contrasea de dispositivo. La proteccin de contenido deber activarla el propio usuario del smartphone o bien, deber activarse mediante una regla de poltica de TI. Para proteger los datos de una aplicacin, sta deber suscribirse al marco de proteccin de contenido mediante el registro de un servicio de escucha. La funcin de proteccin de contenido la activa el propio usuario al bloquear y desbloquear el smartphone.
La proteccin de contenido puede utilizarse para cifrar los datos de los objetos String o de matrices de bytes. La proteccin de contenido puede aplicarse a datos no constantes. No obstante, la API de proteccin de contenido contiene la funcionalidad especfica para el almacn constante. Las siguientes clases e interfaces se utilizan para implementar la proteccin de contenido: net.rim.device.api.system.PersistentContent: esta clase contiene mtodos de utilidad para codificar y decodificar datos, registrar servicios de escucha, as como para realizar otras tareas relacionadas con la proteccin de contenido. net.rim.device.api.system.PersistentContentListener: esta interfaz de servicio de escucha permite que su aplicacin reciba notificaciones cuando se produzcan cambios en el estado o la configuracin de la proteccin de contenido del smartphone. net.rim.device.api.system.PersistentContentException: esta excepcin surge cuando se produce un error relacionado con la proteccin de contenido.
BlackBerry Balance
Los administradores de BlackBerry Enterprise Server pueden establecer las reglas de poltica de TI que distinguen la informacin de trabajo y la personal en los smartphones BlackBerry de su empresa. Puede utilizar la API de plataforma multiservicio para implementar las caractersticas de BlackBerry Balance en sus aplicaciones. La clase net.rim.device.api.system.MultiServicePlatformManager y la interfaz de net.rim.device.api.system.MultiServicePlatformListener le permiten implementar controles de acceso a los datos y crear servicios de escucha que permitan a los administradores eliminar datos de forma remota. Los modos (como el de trabajo) se definen en la clase net.rim.device.api.system.ServiceMode. La clase net.rim.device.api.system.Application incluye mtodos para trabajar con los modos. La excepcin PL_INVALID_OPERATION se genera cuando una aplicacin no autorizada, personal o que no sea del trabajo intenta eliminar, crear, leer o cambiar un archivo de trabajo.
Gua de introduccin
36
Gua de introduccin
Comentarios
Comentarios
Para ofrecer comentarios acerca de esta entrega, visite www.blackberry.com/docsfeedback.
37
Gua de introduccin
Glosario
Glosario
AES Advanced Encryption Standard (Estndar de cifrado avanzado)
cifrado de capa de transporte de BlackBerry El cifrado de capa de transporte de BlackBerry (anteriormente conocido como cifrado BlackBerry estndar) utiliza un algoritmo simtrico de cifrado de claves para ayudar a proteger los datos que estn en trnsito entre un dispositivo BlackBerry y BlackBerry Enterprise Server cuando los datos se encuentran fuera de un firewall de la empresa. Entorno de BlackBerry Enterprise Server Un entorno de BlackBerry Enterprise Server consiste en una o ms instancias de BlackBerry Domain, un servidor de mensajera, as como cualquier software y hardware de terceros con los que interacten los componentes de BlackBerry Enterprise Server. certificado Un certificado es un documento digital que asocia la identidad y la clave pblica de un sujeto de certificado. Cada certificado tiene una clave privada correspondiente que se almacena por separado. Una autoridad de certificacin firma el certificado para indicar que es autntico y de confianza. CLDC Configuracin de dispositivos con conexin limitada (Connected Limited Device Configuration) claves de firma de cdigo Las claves de firma de cdigo son las claves almacenadas en tarjetas multimedia que firma los archivos para que un usuario pueda instalar y ejecutar los archivos en un dispositivo BlackBerry. proteccin de contenido La proteccin de contenido ayuda a proteger los datos de usuario en un dispositivo BlackBerry bloqueado cifrando los datos de usuario mediante la clave de proteccin de contenido y la clave privada ECC. HTTPS Hypertext Transfer Protocol over Secure Sockets Layer (Protocolo de transferencia de hipertexto a travs de un nivel de socket seguro) poltica de TI La poltica de TI consiste en varias reglas de poltica de TI que controlan las caractersticas de seguridad y el comportamiento de los smartphones BlackBerry, de las tabletas BlackBerry PlayBook, de BlackBerry Desktop Software y de BlackBerry Web Desktop Manager. Regla de poltica de TI
38
Gua de introduccin
Glosario
La regla de poltica de TI le permite personalizar y controlar las acciones que pueden realizar los smartphones BlackBerry, las tabletas PlayBook, BlackBerry Desktop Software y BlackBerry Web Desktop Manager. JDK Java Development Kit JVM Java Virtual Machine Java ME Plataforma Java, Micro Edition MIDP Perfil de dispositivo mvil de informacin (Mobile Information Device Profile) S/MIME Secure Multipurpose Internet Mail Extensions (Extensiones seguras multiuso del correo de Internet) TCP/IP El protocolo de control de transmisin/protocolo de Internet (TCP/IP) es un conjunto de protocolos de comunicacin usado para transmitir datos a travs de una red, como por ejemplo Internet. WAP Wireless Application Protocol (Protocolo de aplicaciones inalmbricas) WTLS Wireless Transport Layer Security (Capa inalmbrica de seguridad de transporte)
39
Gua de introduccin
40
Gua de introduccin
Aviso legal
Aviso legal
2011 Research In Motion Limited. Reservados todos los derechos. BlackBerry, RIM, Research In Motion y las marcas comerciales, nombres y logotipos relacionados son propiedad de Research In Motion Limited y estn registrados y/o se usan en EE. UU. y en diferentes pases del mundo. Bluetooth es una marca comercial de Bluetooth SIG. Eclipse es una marca comercial de Eclipse Foundation, Inc. Facebook es una marca comercial de Facebook, Inc. GSM es una marca comercial de GSM MOU Association. Intel y Pentium son marcas comerciales de Intel Corporation. Java, JavaScript y NetBeans son marcas comerciales de Oracle America, Inc. OpenGL es una marca comercial de Silicon Graphics, Inc. OpenVG es una marca comercial de Khronos Group Inc. SQLite es una marca comercial de Hipp, Wyrick & Company, Inc. SVG Tiny es una marca comercial de W3C. Twitter es una marca comercial de Twitter, Inc. Wi-Fi es una marca comercial de Wi-Fi Alliance. Todas las dems marcas comerciales son propiedad de sus respectivos propietarios. Esta documentacin, incluida cualquier documentacin que se incorpore mediante referencia como documento proporcionado o disponible en www.blackberry.com/go/docs, se proporciona o se pone a disposicin "TAL CUAL" y "SEGN SU DISPONIBILIDAD" sin ninguna condicin, responsabilidad o garanta de ningn tipo por Research In Motion Limited y sus empresas afiliadas ("RIM") y RIM no asume ninguna responsabilidad por los errores tipogrficos, tcnicos o cualquier otra imprecisin, error u omisin contenidos en esta documentacin. Con el fin de proteger la informacin confidencial y propia de RIM, as como los secretos comerciales, la presente documentacin describe algunos aspectos de la tecnologa de RIM en lneas generales. RIM se reserva el derecho a modificar peridicamente la informacin que contiene esta documentacin, si bien tampoco se compromete en modo alguno a proporcionar cambios, actualizaciones, ampliaciones o cualquier otro tipo de informacin que se pueda agregar a esta documentacin. Esta documentacin puede contener referencias a fuentes de informacin, hardware o software, productos o servicios, incluidos componentes y contenido como, por ejemplo, el contenido protegido por copyright y/o sitios Web de terceros (conjuntamente, los "Productos y servicios de terceros"). RIM no controla ni es responsable de ningn tipo de Productos y servicios de terceros, incluido, sin restricciones, el contenido, la exactitud, el cumplimiento de copyright, la compatibilidad, el rendimiento, la honradez, la legalidad, la decencia, los vnculos o cualquier otro aspecto de los Productos y servicios de terceros. La inclusin de una referencia a los Productos y servicios de terceros en esta documentacin no implica que RIM se haga responsable de dichos Productos y servicios de terceros o de dichos terceros en modo alguno. EXCEPTO EN LA MEDIDA EN QUE LO PROHBA ESPECFICAMENTE LA LEY DE SU JURISDICCIN, QUEDAN EXCLUIDAS POR LA PRESENTE TODAS LAS CONDICIONES, APROBACIONES O GARANTAS DE CUALQUIER TIPO, EXPLCITAS O IMPLCITAS, INCLUIDA, SIN NINGN TIPO DE LIMITACIN, CUALQUIER CONDICIN, APROBACIN, GARANTA, DECLARACIN DE GARANTA DE DURABILIDAD, IDONEIDAD PARA UN FIN O USO DETERMINADO, COMERCIABILIDAD, CALIDAD COMERCIAL, ESTADO DE NO INFRACCIN, CALIDAD SATISFACTORIA O TITULARIDAD, O QUE SE DERIVE DE UNA LEY O COSTUMBRE O UN CURSO DE LAS NEGOCIACIONES O USO DEL COMERCIO, O RELACIONADO CON LA DOCUMENTACIN O SU USO O RENDIMIENTO O NO RENDIMIENTO DE CUALQUIER SOFTWARE, HARDWARE, SERVICIO O CUALQUIER PRODUCTO O SERVICIO DE TERCEROS MENCIONADOS AQU. TAMBIN PODRA TENER OTROS DERECHOS QUE VARAN SEGN EL ESTADO O PROVINCIA. ES POSIBLE QUE ALGUNAS JURISDICCIONES NO PERMITAN LA EXCLUSIN O LA LIMITACIN DE GARANTAS IMPLCITAS Y CONDICIONES. EN LA MEDIDA EN QUE LO PERMITA LA LEY, CUALQUIER GARANTA IMPLCITA O CONDICIONES EN
41
Gua de introduccin
Aviso legal
RELACIN CON LA DOCUMENTACIN NO SE PUEDEN EXCLUIR TAL Y COMO SE HA EXPUESTO ANTERIORMENTE, PERO PUEDEN SER LIMITADAS, Y POR LA PRESENTE ESTN LIMITADAS A NOVENTA (90) DAS DESDE DE LA FECHA QUE ADQUIRI LA DOCUMENTACIN O EL ELEMENTO QUE ES SUJETO DE LA RECLAMACIN. EN LA MEDIDA MXIMA EN QUE LO PERMITA LA LEY DE SU JURISDICCIN, EN NINGN CASO RIM ASUMIR RESPONSABILIDAD ALGUNA POR CUALQUIER TIPO DE DAOS RELACIONADOS CON ESTA DOCUMENTACIN O SU USO, O RENDIMIENTO O NO RENDIMIENTO DE CUALQUIER SOFTWARE, HARDWARE, SERVICIO O PRODUCTOS Y SERVICIOS DE TERCEROS AQU MENCIONADOS INCLUIDOS SIN NINGN TIPO DE LIMITACIN CUALQUIERA DE LOS SIGUIENTES DAOS: DIRECTOS, RESULTANTES, EJEMPLARES, INCIDENTALES, INDIRECTOS, ESPECIALES, PUNITIVOS O AGRAVADOS, DAOS POR PRDIDA DE BENEFICIOS O INGRESOS, IMPOSIBILIDAD DE CONSEGUIR LOS AHORROS ESPERADOS, INTERRUPCIN DE LA ACTIVIDAD COMERCIAL, PRDIDA DE INFORMACIN COMERCIAL, PRDIDA DE LA OPORTUNIDAD DE NEGOCIO O CORRUPCIN O PRDIDA DE DATOS, IMPOSIBILIDAD DE TRANSMITIR O RECIBIR CUALQUIER DATO, PROBLEMAS ASOCIADOS CON CUALQUIER APLICACIN QUE SE UTILICE JUNTO CON PRODUCTOS Y SERVICIOS DE RIM, COSTES DEBIDOS AL TIEMPO DE INACTIVIDAD, PRDIDA DE USO DE LOS PRODUCTOS Y SERVICIOS DE RIM O PARTE DE L O DE CUALQUIER SERVICIO DE USO, COSTE DE SERVICIOS SUSTITUTIVOS, COSTES DE COBERTURA, INSTALACIONES O SERVICIOS, COSTE DEL CAPITAL O CUALQUIER OTRA PRDIDA MONETARIA SIMILAR, TANTO SI DICHOS DAOS SE HAN PREVISTO O NO, Y AUNQUE SE HAYA AVISADO A RIM DE LA POSIBILIDAD DE DICHOS DAOS. EN LA MEDIDA MXIMA EN QUE LO PERMITA LA LEY DE SU JURISDICCIN, RIM NO TENDR NINGN OTRO TIPO DE OBLIGACIN O RESPONSABILIDAD CONTRACTUAL, EXTRACONTRACTUAL O CUALQUIER OTRA, INCLUIDA CUALQUIER RESPONSABILIDAD POR NEGLIGENCIA O RESPONSABILIDAD ESTRICTA. LAS LIMITACIONES, EXCLUSIONES Y DESCARGOS DE RESPONSABILIDAD SE APLICARN: (A) INDEPENDIENTEMENTE DE LA NATURALEZA DE LA CAUSA DE LA ACCIN, DEMANDA O ACCIN SUYA, INCLUIDA PERO NO LIMITADA AL INCUMPLIMIENTO DEL CONTRATO, NEGLIGENCIA, AGRAVIO, EXTRACONTRACTUAL, RESPONSABILIDAD ESTRICTA O CUALQUIER OTRA TEORA DEL DERECHO Y DEBERN SOBREVIVIR A UNO O MS INCUMPLIMIENTOS ESENCIALES O AL INCUMPLIMIENTO DEL PROPSITO ESENCIAL DE ESTE CONTRATO O CUALQUIER SOLUCIN CONTENIDA AQU; Y (B) A RIM Y A SUS EMPRESAS AFILIADAS, SUS SUCESORES, CESIONARIOS, AGENTES, PROVEEDORES (INCLUIDOS LOS PROVEEDORES DE SERVICIOS DE USO), DISTRIBUIDORES AUTORIZADOS POR RIM (INCLUIDOS TAMBIN LOS PROVEEDORES DE SERVICIOS DE USO) Y SUS RESPECTIVOS DIRECTORES, EMPLEADOS Y CONTRATISTAS INDEPENDIENTES. ADEMS DE LAS LIMITACIONES Y EXCLUSIONES MENCIONADAS ANTERIORMENTE, EN NINGN CASO NINGN DIRECTOR, EMPLEADO, AGENTE, DISTRIBUIDOR, PROVEEDOR, CONTRATISTA INDEPENDIENTE DE RIM O CUALQUIER AFILIADO DE RIM ASUMIR NINGUNA RESPONSABILIDAD DERIVADA DE O RELACIONADA CON LA DOCUMENTACIN. Antes de instalar, usar o suscribirse a cualquiera de los Productos y servicios de terceros, es su responsabilidad asegurarse de que su proveedor de servicios de uso ofrezca compatibilidad con todas sus funciones. Puede que algunos proveedores de servicios de uso no ofrezcan las funciones de exploracin de Internet con una suscripcin al servicio BlackBerry Internet Service. Consulte con su proveedor de servicios acerca de la disponibilidad, arreglos de itinerancia, planes de servicio y funciones. La instalacin o el uso de los Productos y servicios de terceros con productos y servicios de RIM puede precisar la obtencin de una o ms patentes, marcas comerciales, derechos de autor u otras licencias para evitar que se vulneren o violen derechos de terceros. Usted
42
Gua de introduccin
Aviso legal
es el nico responsable de determinar si desea utilizar Productos y servicios de terceros y si se necesita para ello cualquier otra licencia de terceros. En caso de necesitarlas, usted es el nico responsable de su adquisicin. No instale o utilice Productos y servicios de terceros hasta que se hayan adquirido todas las licencias necesarias. Cualquier tipo de Productos y servicios de terceros que se proporcione con los productos y servicios de RIM se le facilita para su comodidad "TAL CUAL" sin ninguna condicin expresa e implcita, aprobacin, garanta de cualquier tipo por RIM y RIM no sume ninguna responsabilidad en relacin con ello. El uso de los Productos y servicios de terceros se regir y estar sujeto a la aceptacin de los trminos de licencias independientes aplicables en este caso con terceros, excepto en los casos cubiertos expresamente por una licencia u otro acuerdo con RIM. Algunas funciones mencionadas en esta documentacin requieren una versin mnima del software de BlackBerry Enterprise Server, BlackBerry Desktop Software y/o BlackBerry Device Software. Los trminos de uso de cualquier producto o servicio de RIM se presentan en una licencia independiente o en otro acuerdo con RIM que se aplica en este caso. NINGUNA PARTE DE LA PRESENTE DOCUMENTACIN EST PENSADA PARA PREVALECER SOBRE CUALQUIER ACUERDO EXPRESO POR ESCRITO O GARANTA PROPORCIONADA POR RIM PARA PARTES DE CUALQUIER PRODUCTO O SERVICIO DE RIM QUE NO SEA ESTA DOCUMENTACIN. Research In Motion Limited 295 Phillip Street Waterloo, ON N2L 3W8 Canad Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF Reino Unido Publicado en Canad
43