Aplicaciones WebWorks HTML5 de BlackBerry para la tableta ... · Aplicaciones WebWorks HTML5 de...

Aplicaciones WebWorks HTML5 de BlackBerry para la tableta BlackBerry® PlayBook™ Módulo 5 - Escribir extensiones API de WebWorks HTML5

Aplicaciones WebWorks HTML5 de BlackBerry

2 © 2012 Research In Motion Limited Módulo 5 – Escribir extensiones API v0.01


Módulo 5 – Escribir extensiones API © 2012 Research In Motion Limited 3 v0.01

© 2012 Research In Motion Limited. Todos los derechos reservados. BlackBerry®, RIM®, Research In Motion®, SurePress™, SureType® y las marcas comerciales, nombres y logotipos relacionados son propiedad de Research In Motion Limited y se encuentran registrados o se utilizan en los Estados Unidos y otros países.

Ripple es marca comercial de tinyHippos, Inc.; Dropbox es marca comercial de Dropbox, Inc. Corporation; Adobe y Dreamweaver son marcas comerciales de Adobe Systems Incorporated; Windows es marca comercial de Microsoft Corporation; Mac es marca comercial de Apple Inc. Las demás marcas comerciales pertenecen a sus respectivos dueños.

Esta documentación, incluida cualquier documentación que se incorpore como referencia como la proporcionada o disponible como hipervínculo, se proporciona o se pone a disposición "TAL CUAL" y "SEGÚN SU DISPONIBILIDAD" sin ninguna condición, responsabilidad o garantía de ningún tipo por Research In Motion Limited y sus empresas afiliadas ("RIM") y RIM no asume ninguna responsabilidad por los errores tipográficos, técnicos o cualquier otra imprecisión, error u omisión contenidos en esta documentación. Con el objeto de proteger la información confidencial de RIM y sus secretos comerciales, la presente documentación describe algunos aspectos de la tecnología de RIM en términos generales. RIM se reserva el derecho de modificar de forma periódica la información contenida en este documento, sin que exista el compromiso de realizar tales modificaciones, actualizaciones, mejoras ni agregados, o de que se produzcan de forma oportuna.

Esta documentación puede contener referencias a fuentes de información, hardware, software, productos, servicios, componentes y contenido de terceros como, por ejemplo, el contenido protegido por derechos de propiedad intelectual y sitios web de terceros (que en adelante se denominarán conjuntamente los “productos y servicios de terceros”). RIM no controla ni es responsable por los productos y servicios de terceros, incluido de forma no taxativa, el contenido, la exactitud, el cumplimiento de los derechos de propiedad intelectual, la compatibilidad, el desempeño, la confiabilidad, la legalidad, la decencia, los vínculos y todo otro aspecto que corresponda a los productos y servicios de terceros. La inclusión de una referencia a los productos y servicios de terceros en este documento no implica responsabilidad alguna de RIM por tales productos y servicios de terceros ni por tales terceros.

SIN PERJUICIO DE LAS PROHIBICIONES ESPECÍFICAS DE LA LEGISLACIÓN VIGENTE DE SU JURISDICCIÓN, QUEDAN EXCLUIDAS POR EL PRESENTE TODAS LAS CONDICIONES, APROBACIONES Y GARANTÍAS DE CUALQUIER TIPO, EXPLÍCITAS E IMPLÍCITAS, INCLUSO, AUNQUE DE FORMA NO TAXATIVA, TODA CONDICIÓN, APROBACIÓN, GARANTÍA, DECLARACIÓN O GARANTÍA DE DURABILIDAD, IDONEIDAD PARA UN FIN O USO ESPECÍFICO, COMERCIABILIDAD, CALIDAD COMERCIAL, AUSENCIA DE INCUMPLIMIENTOS, CALIDAD SATISFACTORIA O TITULARIDAD, O QUE DERIVE DE UNA LEY O COSTUMBRE O DEL CURSO DE LAS NEGOCIACIONES O USO COMERCIAL, O VINCULADO CON LA DOCUMENTACIÓN O SU USO, O EL DESEMPEÑO O MAL RENDIMIENTO DE TODO SOFTWARE, HARDWARE, SERVICIO O CUALQUIER PRODUCTO O SERVICIO DE TERCEROS MENCIONADOS AQUÍ. ASIMISMO, ES POSIBLE QUE EXISTAN OTROS DERECHOS QUE VARÍAN DE UN ESTADO O PROVINCIA A OTRO. ES POSIBLE QUE ALGUNAS JURISDICCIONES NO PERMITAN LA EXCLUSIÓN O LIMITACIÓN DE GARANTÍAS IMPLÍCITAS Y CONDICIONES. SIN PERJUICIO DE LAS DISPOSICIONES LEGALES VIGENTES, TODA GARANTÍA IMPLÍCITA O CONDICIÓN RELACIONADA CON LA DOCUMENTACIÓN QUE NO PUEDA EXCLUIRSE TAL Y COMO SE HA EXPUESTO ANTERIORMENTE, PERO QUE PUEDA SER LIMITADA, POR LA PRESENTE QUEDARÁ LIMITADA A NOVENTA (90) DÍAS DESDE DE LA FECHA DE ADQUISICIÓN DE LA DOCUMENTACIÓN O EL ELEMENTO QUE ES SUJETO DEL RECLAMO.

SIN PERJUICIO DE LAS DISPOSICIONES LEGALES VIGENTES EN SU JURISDICCIÓN, RIM NO ASUMIRÁ RESPONSABILIDAD ALGUNA POR NINGÚN TIPO DE DAÑO RELACIONADO CON ESTA DOCUMENTACIÓN O SU USO, EL DESEMPEÑO O MAL DESEMPEÑO DE TODO SOFTWARE, HARDWARE, SERVICIO O PRODUCTOS Y SERVICIOS DE TERCEROS QUE AQUÍ SE MENCIONAN, INCLUIDOS, AUNQUE DE FORMA NO TAXATIVA, LOS DAÑOS DIRECTOS, CONSECUENTES, EJEMPLIFICADORES, INCIDENTALES, INDIRECTOS, ESPECIALES, PUNITIVOS Y AGRAVADOS, DAÑOS POR LUCRO CESANTE, IMPOSIBILIDAD DE OBTENER LOS AHORROS ESPERADOS, INTERRUPCIÓN DE LA ACTIVIDAD COMERCIAL, PÉRDIDA DE INFORMACIÓN COMERCIAL, PÉRDIDA DE OPORTUNIDADES DE NEGOCIO O DAÑO O PÉRDIDA DE DATOS, IMPOSIBILIDAD DE TRANSMITIR O RECIBIR DATOS DE CUALQUIER ÍNDOLE, PROBLEMAS VINCULADOS CON TODA APLICACIÓN QUE SE UTILICE JUNTO CON PRODUCTOS Y SERVICIOS DE RIM, COSTOS PRODUCIDOS POR EL TIEMPO DE INACTIVIDAD, PÉRDIDA DE USO DE LOS PRODUCTOS Y SERVICIOS DE RIM EN TODO O EN PARTE O DE CUALQUIER SERVICIO DE TIEMPO DE AIRE, COSTO DE BIENES SUSTITUTOS, COSTOS DE COBERTURA, INSTALACIONES O SERVICIOS, COSTO DE CAPITAL O TODA PÉRDIDA MONETARIA SIMILAR, TANTO SI LOS DAÑOS FUERON PREVISTOS O NO, Y AUN SI HUBIERE EXISTIDO AVISO A RIM DE LA POSIBILIDAD DE QUE SE PRODUJERAN TALES DAÑOS.

SIN PERJUICIO DE LAS DISPOSICIONES LEGALES VIGENTES EN SU JURISDICCIÓN, RIM NO TENDRÁ NINGÚN OTRO TIPO DE OBLIGACIÓN O RESPONSABILIDAD CONTRACTUAL, EXTRACONTRACTUAL NI DE OTRAS ÍNDOLES, INCLUIDA LA RESPONSABILIDAD POR NEGLIGENCIA Y LA RESPONSABILIDAD ESTRICTA.

LAS LIMITACIONES, EXCLUSIONES Y RENUNCIAS DE RESPONSABILIDAD SE APLICARÁN: (A) INDEPENDIENTEMENTE DE LA NATURALEZA DE LA CAUSA DE LA ACCIÓN, DEMANDA O ACCIÓN SUYA, INCLUIDA PERO NO LIMITADA AL INCUMPLIMIENTO DEL CONTRATO, NEGLIGENCIA, AGRAVIO, EXTRACONTRACTUAL, RESPONSABILIDAD ESTRICTA O CUALQUIER OTRA TEORÍA DEL DERECHO Y DEBERÁN SOBREVIVIR A UNO O MÁS INCUMPLIMIENTOS ESENCIALES O AL INCUMPLIMIENTO DEL PROPÓSITO ESENCIAL DE ESTE CONTRATO O CUALQUIER SOLUCIÓN 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 TAMBIÉN LOS PROVEEDORES DE SERVICIOS DE USO) Y SUS RESPECTIVOS DIRECTORES, EMPLEADOS Y CONTRATISTAS INDEPENDIENTES.

ADEMÁS DE LAS LIMITACIONES Y EXCLUSIONES MENCIONADAS ANTERIORMENTE, LOS DIRECTORES, EMPLEADOS, AGENTES, DISTRIBUIDORES, PROVEEDORES, CONTRATISTAS INDEPENDIENTES DE RIM Y TODA PERSONA O ENTIDAD RELACIONADA CON RIM DESLINDAN TODA RESPONSABILIDAD DERIVADA O RELACIONADA CON LA DOCUMENTACIÓN.

Antes de instalar, utilizar o suscribirse a cualquiera de los productos y servicios de terceros, es responsabilidad del usuario asegurarse de que su proveedor de servicios de tiempo de aire ofrezca compatibilidad con todas sus funciones. Es posible que algunos proveedores de servicios de tiempo de aire no ofrezcan las funciones de exploración de Internet con una suscripción a BlackBerry® Internet Service. Consulte con su proveedor de servicios acerca de la disponibilidad, arreglos de itinerancia, planes de servicio y funciones. La instalación o el uso de productos y servicios de terceros con productos y servicios de RIM puede requerir la obtención de una o más licencias de patentes, marcas comerciales, derechos de propiedad intelectual o de otro tipo para prevenir la violación de los derechos de terceros. Es responsabilidad exclusiva del usuario determinar si corresponde utilizar dichos Productos y servicios de terceros y averiguar si tales licencias de terceros son necesarias, en cuyo caso será responsable también de su adquisición. Los productos y servicios de terceros no deberán instalarse ni utilizarse hasta que el usuario haya adquirido todas las licencias necesarias. Todo producto o servicio de terceros ofrecido junto con los productos y servicios de RIM se proporciona para comodidad del usuario y en el estado en que se encuentra, y RIM no ofrece ningún tipo de condición, aval ni garantía explícita ni implícita, ni asume responsabilidad alguna en este sentido. El uso de productos y servicios de terceros se rige por las cláusulas de las posibles licencias y acuerdos correspondientes celebrados con terceros y dependerá de su aceptación por parte del usuario, sin perjuicio de toda disposición expresamente estipulada al respecto en virtud de una licencia u otro tipo de acuerdo celebrado con RIM.

Algunas características mencionadas en esta documentación necesitan una versión mínima del software de BlackBerry® Enterprise Server, BlackBerry® Desktop Software y/o BlackBerry® Device Software, y puede que se requiera desarrollo adicional o Productos o servicios de terceros para acceder a las aplicaciones de la empresa.

Este producto incluye el software desarrollado por Apache Software Foundation (http://www.apache.org/) y/o tiene licencia de conformidad con la versión 2.0 de Apache License (http://www.apache.org/licenses/). Para obtener más información, consulte el archivo NOTICE.txt incluido con el software. A menos que se exija por la ley aplicable o se acuerde por escrito, el software distribuido bajo la licencia se distribuye “TAL CUAL”, SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ni expresa ni implícita. Consulte la licencia para el idioma específico que rige los permisos y limitaciones en la licencia.

Los términos 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 DOCUMENTACIÓN TIENE POR OBJETO PREVALECER SOBRE CUALQUIER ACUERDO EXPRESO ESCRITO NI GARANTÍA PROPORCIONADA POR RIM EN RELACIÓN CON PARTES DE PRODUCTOS O SERVICIOS DE RIM AL MARGEN DE ESTE DOCUMENTO.



Acerca de este manual de laboratorio Este material se ha diseñado con el supuesto de que los participantes cumplen todos los requisitos previos necesarios antes de completar los ejercicios.

Para que no se generen impactos negativos en la calidad de la experiencia de aprendizaje, RIM recomienda que los participantes cumplan todos los requisitos previos.



Contenidos Acerca de este manual de laboratorio ....................................... 5 Descripción general..................................................... 8

Objetivos .......................................................... 8 Requisitos previos.................................................... 8 Requisitos de software ................................................ 8

¿Qué es una API? ...................................................... 9 ¿Qué es una interfaz API de WebWorks HTML5 de BlackBerry? .................. 9

Cómo incluir una API de WebWorks HTML5 de BlackBerry en la aplicación "Hello World".................................................................... 10 Cómo escribir una extensión API personalizada .............................. 13 Cómo utilizar la extensión “blackberry.custom.file” ........................... 20 Resumen y material adicional ............................................ 22

Resumen ......................................................... 22 Recursos adicionales ................................................ 22





Descripción general Objetivos En este módulo, el participante accederá a los siguientes conceptos:

• ¿Qué es una interfaz API de WebWorks HTML5?

• ¿Por qué utilizar interfaces API de WebWorks HTML5?

• Cómo incluir una API de WebWorks HTML5 de BlackBerry en la aplicación "Hello World"

• Cómo incluir una extensión API personalizada para la aplicación para una tableta BlackBerry PlayBook por medio de interfaces API de WebWorks HTML5

Requisitos previos Para este módulo, los requisitos previos relacionados con las aptitudes y áreas de conocimiento son:

Haber diseñado la aplicación “Hello World” del módulo “Módulo 3 - Diseñar la primera aplicación para la tableta BlackBerry PlayBook” (creación de los archivos “index.html” y “config.xml”)

• Estar familiarizado con los conceptos de programación orientados a objetos, como interfaces API • Haber finalizado la instalación de la herramienta de emulación Ripple™ del módulo "Módulo 2 –

Instalación de herramientas” • Acceder a archivos desde un servidor web remoto para realizar pruebas en el emulador Ripple

(del módulo “Módulo 3 - Diseñar la primera aplicación para la tableta BlackBerry PlayBook”) • Haber finalizado la instalación del SDK de BlackBerry® WebWorks™ para SO de tabletas del

módulo "Módulo 2 – Instalación de herramientas” • Los conceptos de este módulo deberán exponerse a participantes que hayan completado el

Módulo 3 y el proceso de creación de la aplicación "Hello World". Los desarrolladores de aplicaciones novatos deberán integrar interfaces API de WebWorks HTML5 de BlackBerry en sus aplicaciones antes de continuar con la creación de extensiones personalizadas

Requisitos de software Para completar este módulo, se requiere:

- Un editor de HTML (como el Bloc de notas)

- Los archivos “index.html” y “config.xml” de la aplicación “Hello World” del Módulo 3

- Instalación del SDK de WebWorks de BlackBerry para el SO de tabletas

- Instalación del software del emulador Ripple

- Acceso a un servidor web remoto (como Dropbox®) para realizar pruebas

Para completar este módulo, se requiere (de ser posible)

- Acceso a un software de autor y de edición como Adobe® Dreamweaver® CS5.5



¿Qué es una API? API quiere decir Application Programming Interface (Interfaz de programación de aplicaciones). Una interfaz API es un formato de lenguaje y mensajes que utiliza un programa de aplicación para comunicarse con un sistema operativo. Las API se implementan escribiendo llamadas de función dentro de una aplicación, que proporcionará el vínculo al protocolo requerido para su ejecución.

¿Qué es una interfaz API de WebWorks HTML5 de BlackBerry? Una extensión API de WebWorks HTML5 de BlackBerry es una función adicional que permite que el usuario interactúe con las funcionalidades del sistema de la tableta BlackBerry PlayBook. Si bien las API están diseñadas para programadores, resultan útiles para los usuarios, ya que garantizan que todos los programas que utilizan una API común cuenten con interfaces similares. Esto hace que sea más sencillo para los usuarios aprender a utilizar nuevos programas.

Ejemplo:

La API de Interfaz de usuario (UI) consiste de una función de Diálogo La función que se encuentra en este objeto permite que el desarrollador integre cuadros de diálogo de sistemas estándar en una aplicación WebWorks HTML5 de BlackBerry y que controle el flujo de la aplicación basándose en las respuestas del usuario. Se puede acceder a esta API por medio del elemento <feature id="blackberry.ui.dialog"/> en el documento config.xml.



Cómo incluir una API de WebWorks HTML5 de BlackBerry en la aplicación "Hello World" Primero cree el archivo HTML principal para su aplicación “Hello World” creando un directorio que incluya un archivo “index.html”.

Ejemplo: C:\HelloWorld\index.html\

Luego agregue una API simple específica de WebWorks HTML5 de BlackBerry al código fuente de la aplicación por medio de la siguiente sintaxis de ejemplo:

Los pasos detallados más arriba son los mismos para Windows® y Mac OS X. Sin embargo, los ejemplos de rutas provistos son rutas de ejemplo de Windows. Los archivos “index.html” y “config.xml” para esta aplicación se pueden encontrar en el módulo “Módulo 3 - Diseñar la primera aplicación para la tableta BlackBerry PlayBook”.

Luego, cree un archivo “config.xml” para la aplicación en el mismo directorio que el archivo Hello World “index.html” (ejemplo: C:\HelloWorld\config.xml).

Edite el archivo “config.xml" para incluir un parámetro <feature> para la API deseada utilizando la siguiente sintaxis de ejemplo:

-

-

-

-

<!DOCTYPE html> <html> <head> <meta name="viewport" id="viewport" content=“target-densitydpi=devicedpi,width=device-width,user-scalable=no"/> <script type="text/javascript"> function doAlert() { alert('El nombre de mi aplicación es: ' + blackberry.app.name); } </script> </head> <body onload="doAlert()"> <h1>Hello World</h1> </body> </html>

<?xml version="1.0" encoding="utf-8"?> <widget xmlns="http://www.w3.org/ns/widgets" xmlns:rim="http://www.blackberry.com/ns/widgets" version="1.0.0"> <name>Hello World</name> <author>Me</author> <content src="index.html"/> <feature id="blackberry.app"/> </widget>



En este ejemplo, la API System (Application) se utilizó para indicar el nombre de la aplicación. En las etiquetas <name></name>, ingrese el nombre de la aplicación “Hello World”.

Para ver el archivo “index.html” en el emulador Ripple, guarde el archivo para acceder a un servidor web externo (como Dropbox). Una vez guardado en la carpeta "Pública" de Dropbox, seleccione la opción "Copiar vínculo público".

La información relacionada con el acceso a archivos desde un servidor web remoto como Dropbox para realizar pruebas en el emulador Ripple se puede encontrar en el módulo "Módulo 3 - Diseñar la primera aplicación para la tableta BlackBerry PlayBook".

Asegúrese de que el archivo “index.html” esté guardado en la carpeta "Pública" de la cuenta Ripple. En la barra de direcciones de Ripple, pegue el vínculo público para el archivo "index.html".

Debería aparecer el siguiente cuadro de diálogo:

Ilustración 1: API System (Application) utilizada para crear un diálogo simple

Tras realizar la prueba en el emulador Ripple, la aplicación puede integrarse y presentarse para su implementación. La aplicación también puede firmarse si el propósito es distribuirla. La información sobre cómo integrar y presentar la aplicación puede encontrarse en el módulo “Módulo 3 - Diseñar la primera aplicación para la tableta BlackBerry PlayBook”.

La información sobre cómo firmar la aplicación para su distribución puede encontrarse en el módulo “Módulo 4 - Prueba, firma e implementación de aplicaciones”.





Cómo escribir una extensión API personalizada En el siguiente ejemplo se demostrará cómo crear una extensión API personalizada. La API detallada a continuación demostrará cómo guardar datos de una aplicación a una tableta PlayBook. Esta API permitirá que un desarrollador escriba y guarde cualquier cadena de datos en un archivo.

Para encontrar extensiones API de WebWorks HTML5 de BlackBerry existentes para el SO�de tabletas, vaya a:

C:\Archivos de programa\Research In Motion\SDK de BlackBerry WebWorks para SO de tabletas 2.2.0.5\bbwp\ext

Ilustración 2: interfaces API disponibles dentro del SDK de WebWorks de BlackBerry para el SO�de tabletas



Luego, cree los archivos y directorios siguiendo la estructura de directorios que se muestra a continuación:

La estructura básica del archivo dentro de la carpeta bbwp/ext puede copiarse para crear el directorio "blackberry.custom.file".

El archivo “library.xml” especifica la estructura básica y el elemento feature que se utilizará en la aplicación para activar las funcionalidades de esta extensión personalizada. Ver a continuación:



Luego, cree el archivo “custom_file_dispatcher.js”. Este archivo implementa las funciones básicas que se utilizarán para leer y escribir datos en la tableta BlackBerry PlayBook.

Utilice la siguiente sintaxis para crear el archivo “custom_file_dispatcher.js”:



Luego cree el archivo “custom_file_ns.js” por medio de la siguiente sintaxis:



Luego cree el archivo “ActionScript”, que interactuará con la tableta BlackBerry PlayBook. Para crear un “ActionScript” use la siguiente sintaxis:







Cómo utilizar la extensión “blackberry.custom.file” Para leer datos en un archivo, incluya el elemento feature <feature id="blackberry.custom.file"/> en el archivo “config.xml” como se muestra a continuación:

Para escribir datos en un archivo, incluya el elemento feature <feature id="blackberry.custom.file"/> en el archivo “config.xml” como se muestra a continuación:





Resumen y material adicional Resumen En este módulo, se cubren los siguientes temas:

• ¿Qué es una interfaz API de WebWorks HTML5?

• ¿Por qué utilizar interfaces API de WebWorks HTML5?

• Cómo incluir una API de WebWorks HTML5 de BlackBerry en la aplicación "Hello World"

• Cómo incluir una extensión API personalizada para la aplicación para una tableta BlackBerry PlayBook por medio de interfaces API de WebWorks HTML5

Recursos adicionales La guía de referencia de API de WebWorks HTML5 de BlackBerry, junto con información adicional relacionada con las API utilizadas con más frecuencia, se encuentra disponible aquí.

Para integrar más interfaces API de WebWorks HTML5 de BlackBerry en las aplicaciones, consulte la Guía de referencia de API.

Más códigos y aplicaciones de muestra que utilizan interfaces API para aplicaciones WebWorks HTML5 también se encuentran disponibles en el portal de WebWorks HTML5 de BlackBerry.

Date post:	29-Apr-2019
Category:	Documents
Upload:	ledang
View:	218 times
Download:	0 times

Aplicaciones WebWorks HTML5 de BlackBerry para la tableta ... · Aplicaciones WebWorks HTML5 de...

Documents