Adobe Air - 2017 Creación de Aplicaciones [es]

Creación de aplicaciones de
ADOBE®
AIR®
Avisos legales
Para ver los avisos legales, consulte http://help.adobe.com/es_ES/legalnotices/index.html.
Última modificación 26/3/2017

Contenidos

Capítulo 1: Acerca de Adobe AIR
Capítulo 2: Instalación de Adobe AIR
Instalación de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Desinstalación de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Instalación y ejecución de las aplicaciones de AIR de muestra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Actualizaciones de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Capítulo 3: Trabajo con las API de AIR
Clases de ActionScript 3.0 específicas de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Clases de Flash Player con funcionalidad específica de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Componentes de Flex específicos de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Capítulo 4: Herramientas de la plataforma de Adobe Flash para el desarrollo de AIR
Instalación del SDK de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Configuración del SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Configuración de los SDK externos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
iii
Capítulo 5: Creación de su primera aplicación de AIR
Creación de su primera aplicación de AIR de Flex de escritorio en Flash Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Creación de la primera aplicación de AIR de escritorio con Flash Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Creación de su primera aplicación de AIR para Android en Flash Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Creación de su primera aplicación de AIR para iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Creación de la primera aplicación de AIR basada en HTML con Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Creación de la primera aplicación de AIR basada en HTML con el SDK de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Creación de la primera aplicación de AIR de escritorio con el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Creación de la primera aplicación de AIR para Android con el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Capítulo 6: Desarrollo de aplicaciones de AIR para el escritorio
Flujo de trabajo para el desarrollo de una aplicación de escritorio de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Configuración de las propiedades de una aplicación de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Depuración de una aplicación de AIR de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Empaquetado de un archivo de instalación de AIR de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Empaquetado de un instalador nativo de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Empaquetado de un paquete de motor de ejecución captador para equipos de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Distribución de paquetes de AIR para equipos de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Capítulo 7: Desarrollo de aplicaciones de AIR para dispositivos móviles
Configuración del entorno de desarrollo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Consideraciones sobre el diseño de aplicaciones móviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Flujo de trabajo para crear aplicaciones de AIR para dispositivos móviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Configuración de las propiedades de una aplicación móvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Empaquetado de una aplicación de AIR móvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Depuración de una aplicación de AIR móvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Contenidos
Instalación de AIR y aplicaciones de AIR en dispositivos móviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Actualización de aplicaciones móviles de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Uso de notificaciones push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Capítulo 8: Desarrollo de aplicaciones de AIR para dispositivos de televisión
Funciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Consideraciones de diseño de las aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Flujo de trabajo para desarrollar una aplicación de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Propiedades del descriptor de la aplicación de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Empaquetado de una aplicación de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Depuración de aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Capítulo 9: Uso de extensiones nativas para Adobe AIR
Archivos de extensión nativa de AIR (ANE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Extensiones nativas y la clase NativeProcess de ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Extensiones nativas y clases de biblioteca de ActionScript (archivos SWC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Dispositivos admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Perfiles de dispositivos admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Lista de tareas para utilizar una extensión nativa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Declaración de la extensión en el archivo descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Inclusión del archivo ANE en la ruta de la biblioteca de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Empaquetado de una aplicación con extensiones nativas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
iv
Capítulo 10: Compiladores de ActionScript
Información sobre las herramientas de la línea de comandos de AIR en el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Configuración del compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Compilación de archivos de origen MXML y ActionScript para AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Compilación de una biblioteca de código o componente de AIR (Flex) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Capítulo 11: AIR Debug Launcher (ADL)
Uso de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Ejemplos con ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Códigos de error y de salida de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Capítulo 12: AIR Developer Tool (ADT)
Comandos de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Conjuntos de opciones de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Mensajes de error de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Variables del entorno de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Capítulo 13: Firma de aplicaciones de AIR
Firma digital de archivos de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Creación de archivos intermedios sin firmar de AIR con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Firma de un archivo intermedio de AIR con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Firma de una versión actualizada de una aplicación de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Creación de certificados con firma automática con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Contenidos
Capítulo 14: Archivos descriptores de las aplicaciones de AIR
Cambios en el descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Estructura del archivo descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Elementos del descriptor de la aplicación de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Capítulo 15: Perfiles de dispositivo
Restricción de perfiles de destino en el archivo descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Capacidades en diferentes perfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Capítulo 16: API en navegador AIR.SWF
Personalización del archivo badge.swf de instalación integrada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Utilización del archivo badge.swf para instalar una aplicación de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Carga del archivo air.swf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Cómo comprobar si está instalado el motor de ejecución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Cómo comprobar desde una página web si una aplicación de AIR está instalada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Instalación de una aplicación de AIR desde el navegador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Inicio desde el navegador de una aplicación de AIR instalada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Capítulo 17: Actualización de aplicaciones de AIR
Actualización de aplicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Presentación de una interfaz de usuario personalizada para las actualizaciones de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . 273
Descarga de un archivo de AIR en el equipo del usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Comprobar si una aplicación se está ejecutando por primera vez . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Utilización del marco de actualización . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
v
Capítulo 18: Visualización de código fuente
Carga, configuración y apertura del visor de código fuente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Interfaz de usuario del visor de código fuente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Capítulo 19: Depuración con el introspector HTML de AIR
Introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Carga del código del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Inspección de un objeto en la ficha Console (Consola) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Configuración del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Interfaz del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Utilización del introspector de AIR con contenido en un entorno limitado ajeno a la aplicación . . . . . . . . . . . . . . . . . . . . . . . . 305
Capítulo 20: Localización de aplicaciones de AIR
Localización del nombre y la descripción en el instalador de aplicaciones de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Localización de contenido HTML con la arquitectura de localización de HTML de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Capítulo 21: Variables del entorno de ruta
Configuración de la ruta en Linux y Mac OS utilizando el shell Bash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Configuración de la ruta en Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Última modificación 26/3/2017

Capítulo 1: Acerca de Adobe AIR

Adobe® AIR® es un motor de ejecución multipantalla válido para todos los sistemas operativos que le permite aprovechar sus habilidades de desarrollo web para crear e implementar aplicaciones enriquecidas de Internet (RIA) en el escritorio y dispositivos móviles. Las aplicaciones de AIR móviles, de televisión y escritorio se pueden crear con ActionScript 3.0 utilizando Adobe® Flex y Adobe® Flash® (basado en SWF). Las aplicaciones de AIR de escritorio también se pueden crear con HTML, JavaScript® y Ajax (basado en HTML).
Para obtener más información sobre el uso y una introducción a Adobe AIR, consulte Adobe AIR Developer Connection http://www.adobe.com/devnet/air/ (Centro de desarrollo de Adobe AIR) (en inglés).
AIR permite el trabajo en entornos conocidos para aprovechar las herramientas y los procesos con los que se encuentra más cómodo. Al admitir Flash, Flex, HTML, JavaScript y Ajax, es posible obtener la mejor experiencia posible que se adapte a sus necesidades.
Por ejemplo, se pueden desarrollar aplicaciones utilizando una de las tecnologías siguientes o combinando varias de ellas:
Flash/Flex/ActionScript
HTML/JavaScript/CSS/Ajax
1
Los usuarios interactúan con las aplicaciones de AIR del mismo modo que con las aplicaciones nativas. El motor de ejecución se instala una vez en el ordenador del usuario o dispositivo y después se instalan y ejecutan las aplicaciones de AIR como cualquier otra aplicación de escritorio. (En iOS, no se instala un motor de ejecución de AIR independiente; todas las aplicaciones de AIR de iOS son independientes.)
El motor de ejecución ofrece una arquitectura y plataforma compatibles con distintos sistemas operativos para la implementación de aplicaciones. La compatibilidad y constancia del funcionamiento y las interacciones en distintos escritorios obvia la necesidad de realizar pruebas en distintos navegadores. En lugar de desarrollar programas para un sistema operativo determinado, el desarrollador centra sus esfuerzos en el motor de ejecución, lo cual ofrece las siguientes ventajas:
Las aplicaciones desarrolladas para AIR se ejecutan en varios sistemas operativos distintos sin suponer trabajo
adicional para el desarrollador. El motor de ejecución asegura una presentación e interacciones constantes y predecibles en todos los sistemas operativos compatibles con AIR.
Las aplicaciones se pueden crear de forma más rápida permitiendo el aprovechamiento de tecnologías web y
patrones de diseño existentes. Las aplicaciones basadas en web se pueden ampliar al escritorio sin tener que aprender las tecnologías de desarrollo en escritorio tradicionales o la complejidad del código nativo.
El desarrollo de aplicaciones resulta más fácil que cuando se utilizan lenguajes de nivel inferior como C y C++. No
hace falta gestionar las complejas API de nivel inferior que son específicas para cada sistema operativo.
Al desarrollar aplicaciones para AIR se puede aprovechar un juego enriquecido de arquitecturas e interfaces API:
API específicas para AIR proporcionadas por el motor de ejecución y la arquitectura de AIR
API de ActionScript utilizadas en archivos SWF y la arquitectura de Flex (además de otras bibliotecas y
arquitecturas basadas en ActionScript)
HTML, CSS y JavaScript
La mayoría de las arquitecturas de Ajax
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Acerca de Adobe AIR
Las extensiones nativas para Adobe AIR proporcionan API de ActionScript que permiten acceder a funciones
específicas de la plataforma programadas con código nativo. Las extensiones nativas también proporcionan acceso al código nativo heredado y el código nativo siempre aporta mayor rendimiento.
AIR es toda una novedad en la forma de crear, implementar y experimentar las aplicaciones. Puede obtener más control creativo y ampliar las aplicaciones basadas en Flash, Flex, HTML y Ajax en su escritorio, dispositivos móviles y televisiones.
Para obtener información sobre los elementos incluidos en cada nueva actualización de AIR, consulte las notas de la versión de Adobe AIR (http://www.adobe.com/go/learn_air_relnotes_es).
2
Última modificación 26/3/2017

Capítulo 2: Instalación de Adobe AIR

El motor de ejecución de Adobe® AIR® permite ejecutar aplicaciones de AIR. El motor de ejecución se puede instalar de cualquiera de las formas siguientes:
Mediante la instalación independiente del motor de ejecución (sin instalar además una aplicación de AIR).
Con la instalación de una aplicación de AIR por primera vez mediante una instalación de página web (“instalación
desde navegador”) (se le indicará que también instale el motor de ejecución).
Mediante la creación de un archivo de instalación que instale tanto la aplicación como el motor de ejecución. Debe
obtener la aprobación de Adobe para poder distribuir el motor de ejecución de AIR de esta manera. Puede solicitar la aprobación en la página Licencias del motor de ejecución de Adobe (en inglés). Tenga en cuenta que Adobe no proporciona herramientas para crear este archivo de instalación. No obstante, hay disponibles muchos kits de herramientas de archivos de instalación de otros fabricantes.
Mediante la instalación de una aplicación de AIR que contenga AIR como motor de ejecución captador. El motor
de ejecución captador lo utiliza solamente la aplicación creadora del paquete. No se utiliza para ejecutar otras aplicaciones de AIR. Crear un motor de ejecución es una opción en Mac y Windows. En iOS, todas las aplicaciones incluyen un paquete de motor de ejecución. A partir de AIR 3.7, todas las aplicaciones de Android incluyen un paquete de motor de ejecución por defecto (aunque tiene la opción de usar un motor por separado).
Mediante la instalación de un entorno de desarrollo de AIR como el kit de desarrollo de software de AIR, Adobe®
Flash® Builder™ o el kit de desarrollo de software (SDK) de Adobe Flex® (que incluye las herramientas de desarrollo de la línea de comandos de AIR). El motor de ejecución incluido en el SDK solo se utiliza al depurar las aplicaciones; no se emplea para ejecutar aplicaciones de AIR instaladas.
3
Los requisitos del sistema para instalar AIR y ejecutar aplicaciones de AIR se describen en: Adobe AIR: Requisitos del
sistema (http://www.adobe.com/es/products/air/systemreqs/).
Tanto el instalador del motor de ejecución como el instalador de la aplicación de AIR, crean archivos de registro cuando instalan, actualizan o eliminan aplicaciones de AIR o el propio motor de ejecución de AIR. Puede consultar estos registros para ayudar a determinar la causa de cualquier problema de instalación. Consulte Installation logs (Registros de instalación; en inglés).

Instalación de Adobe AIR

Para instalar o actualizar el motor de ejecución, el usuario debe tener privilegios administrativos para el equipo.
Instalación del motor de ejecución en un ordenador con Windows
1 Descargue el archivo de instalación del motor de ejecución en http://get.adobe.com/es/air.
2 Haga doble clic en el archivo de instalación del motor de ejecución.
3 Siga las indicaciones que aparecen en la ventana de instalación para llevar a cabo la instalación.
Instalación del motor de ejecución en un ordenador con Mac
1 Descargue el archivo de instalación del motor de ejecución en http://get.adobe.com/es/air.
2 Haga doble clic en el archivo de instalación del motor de ejecución.
3 Siga las indicaciones que aparecen en la ventana de instalación para llevar a cabo la instalación.
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Instalación de Adobe AIR
4 Si el instalador presenta una ventana de autenticación, escriba el nombre de usuario y la contraseña que utiliza para
Mac OS.
Instalación del motor de ejecución en un ordenador con Linux
Nota: de momento, AIR 2.7 y posterior no se admite en Linux. Las aplicaciones de AIR desarrolladas para Linux deben seguir utilizando el SDK de AIR 2.6.
Uso del instalador binario:
1 Localice el archivo binario de instalación en http://kb2.adobe.com/es/cps/853/cpsid_85304.html y realice la
descarga.
2 Establezca los permisos de archivo para que se pueda ejecutar la aplicación de instalación: Desde una línea de
comandos, se pueden establecer los permisos de archivo con:
chmod +x AdobeAIRInstaller.bin
Algunas versiones de Linux permiten establecer permisos de archivo en el cuadro de diálogo de propiedades que se abre mediante un menú contextual.
3 Ejecute el instalador desde la línea de comandos o haciendo doble clic en el archivo de instalación.
4 Siga las indicaciones que aparecen en la ventana de instalación para llevar a cabo la instalación.
4
Adobe AIR está instalado como paquete nativo. Es decir, como rpm en una distribución basada en rpm y deb en una distribución Debian. Actualmente AIR no admite ningún otro formato de paquete.
Uso de los instaladores de paquete:
1 Localice el paquete de AIR en http://kb2.adobe.com/es/cps/853/cpsid_85304.html. Descargue el paquete rpm o
Debian, dependiendo de qué formato de paquete admita el sistema.
2 Si es necesario, haga doble clic en el archivo del paquete de AIR para instalar el paquete.
También puede realizar la instalación desde la línea de comandos:
a En un sistema Debian:
sudo dpkg -i <path to the package>/adobeair-2.0.0.xxxxx.deb
b En un sistema basado en rpm:
sudo rpm -i <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
O bien, si está actualizando una versión existente (AIR 1.5.3 o posterior):
sudo rpm -U <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
La instalación de aplicaciones de AIR 2 y AIR requiere que disponga de privilegios de administrador en su equipo.
Adobe AIR se encuentra instalada en la siguiente ubicación: /opt/Adobe AIR/Versions/1.0
AIR registra el tipo mime "application/vnd.adobe.air-application-installer-package+zip", lo que significa que los archivos .air son de este tipo mime y, por lo tanto, se registran con el motor de ejecución de AIR.
Instalación del motor de ejecución en un dispositivo de Android
Se puede instalar la versión más reciente del motor de ejecución de AIR desde Android Market.
Es posible instalar las versiones de desarrollo del motor de ejecución de AIR desde un vínculo en una página web utilizando el comando
-installRuntime de ADT. Solo una versión del motor de ejecución de AIR se puede instalar
a la vez; no se pueden tener las versiones de desarrollo y lanzamiento instaladas al mismo tiempo.
Consulte “Comando installRuntime de ADT” en la página 186 para obtener más información.
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Instalación de Adobe AIR
Instalación del motor de ejecución en un dispositivo de iOS
El código del motor de AIR necesario se integra con cada aplicación creada para los dispositivos iPhone, iTouch y iPad. No instale un componente del motor de ejecución independiente.
Más temas de ayuda
AIR para iOS” en la página 75

Desinstalación de Adobe AIR

Una vez instalado el motor de ejecución, se puede desinstalar siguiendo los procedimientos que se explican a continuación.
Desinstalación del motor de ejecución en un ordenador con Windows
1 En el menú Inicio de Windows, seleccione Configuración > Panel de control.
2 Abra los programas, programas y funciones o el panel de control para agregar o quitar programas (dependiendo de
la versión de Windows que ejecute).
3 Seleccione “Adobe AIR” para desinstalar el motor de ejecución.
4 Haga clic en el botón Cambiar o quitar.
5
Desinstalación del motor de ejecución en un ordenador con Mac
Haga doble clic en el archivo de desinstalación de Adobe AIR, que se encuentra en la carpeta
/Aplicaciones/Utilidades.
Desinstalación del motor de ejecución en un ordenador con Linux
Realice uno de los siguientes pasos:
Seleccione el comando“Desinstalador de Adobe AIR” en el menú Aplicaciones.
Ejecute el instalador de AIR con la opción -uninstall.
Elimine los paquetes de AIR (adobeair y adobecerts) con el administrador de paquetes.
Elimine el motor de ejecución del dispositivo de Android
1 Abra la aplicación de configuración en el dispositivo.
2 Puntee en la entrada de Adobe AIR en Aplicaciones > Administrar aplicaciones.
3 Puntee el botón Desinstalar.
También puede utilizar el comando en la página 187 para obtener más información.
Eliminación de un paquete de motor de ejecución
Para eliminar un motor de ejecución captador, debe eliminar la aplicación con la que se haya instalado. Recuerde que los motores de ejecución captadores solo se utilizan para ejecutar la aplicación de instalación.
-uninstallRuntime de ADT. Consulte el “Comando uninstallRuntime de ADT
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Instalación de Adobe AIR

Instalación y ejecución de las aplicaciones de AIR de muestra

Para instalar o actualizar una aplicación de AIR, un usuario debe disponer de privilegios administrativos para el equipo.
Hay algunas aplicaciones de muestra a disposición para demostrar las funciones de AIR. Para tener acceso a las mismas e instalarlas, siga estas instrucciones:
1 Descargue y ejecute las aplicaciones de AIR de muestra. Están a disposición tanto las aplicaciones compiladas como
el código fuente.
2 Para descargar y ejecutar una aplicación de muestra, haga clic en el botón Instalar ahora de la aplicación. Un
mensaje indica instalar y ejecutar la aplicación.
3 Si opta por descargar aplicaciones de muestra y ejecutarlas más adelante, seleccione los vínculos de descarga. Las
aplicaciones de AIR pueden ejecutarse en cualquier momento de la siguiente manera:
En Windows, haga doble clic en el icono de la aplicación que se encuentra en el escritorio o seleccione la
aplicación en el menú Inicio.
En Mac OS, haga doble clic en el icono de la aplicación, que se instala por omisión en la carpeta Aplicaciones de
su directorio de usuario (por ejemplo, en Macintosh HD/Usuarios/UsuarioFicticio/Aplicaciones/).
6
Nota: revise las notas de versión de AIR por si hubiera alguna actualización de estas instrucciones. Puede encontrarlas en: http://www.adobe.com/go/learn_air_relnotes_es.

Actualizaciones de Adobe AIR

De forma periódica, Adobe actualiza Adobe AIR con nuevas funciones o soluciones para problemas menores. La función de actualización y notificación automática permite que Adobe avise automáticamente a los usuarios del momento en que está disponible una versión actualizada de Adobe AIR.
Las actualizaciones a Adobe AIR garantizan que la aplicación funcione adecuadamente y a menudo contienen cambios importantes para la seguridad. Adobe recomienda que los usuarios actualicen a la versión más reciente de Adobe AIR si existe una nueva versión disponible, especialmente cuando se implica la actualización de seguridad.
De forma predeterminada, cuando se inicia una aplicación de AIR, el motor de ejecución comprueba si una actualización está disponible. Esta comprobación se lleva a cabo si han pasado más de dos semanas desde la última búsqueda de actualizaciones. Si alguna actualización está disponible, AIR la descarga en segundo plano.
Los usuarios pueden desactivar la capacidad de actualización automática, utilizando la aplicación SettingsManager de AIR. La aplicación SettingsManager de AIR está disponible para descarga en
http://airdownload.adobe.com/air/applications/SettingsManager/SettingsManager.air.
El proceso de instalación normal de Adobe AIR incluye la conexión a http://airinstall.adobe.com para enviar la información básica sobre el entorno de instalación como, por ejemplo, idioma y versión del sistema operativo. Esta información solo se transmite una vez por instalación y permite que Adobe pueda confirmar que la instalación se ha realizado correctamente. No se transmitirá ni se recopilará información de identificación personal.
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Instalación de Adobe AIR
Actualización de motores de ejecución captadores
Si distribuye la aplicación con un paquete de motor de ejecución captador, este no se actualizará automáticamente. Por seguridad de sus propios usuarios, debe supervisar las actualizaciones publicadas por Adobe y actualizar su aplicación con la nueva versión del motor de ejecución cuando se publiquen cambios de seguridad importantes.
7
Última modificación 26/3/2017

Capítulo 3: Trabajo con las API de AIR

Adobe® AIR® incluye funcionalidad que no está disponible para el contenido SWF que se ejecuta en Adobe® Flash® Player.
Desarrolladores de ActionScript 3.0
Las API de Adobe AIR se encuentran documentadas en las siguientes referencias:
Guía del desarrollador de ActionScript 3.0
Referencia de ActionScript 3.0 para la plataforma de Adobe Flash
Desarrolladores de HTML
Si está creando aplicaciones de AIR basadas en HTML, las API que están disponibles en JavaScript mediante el archivo AIRAliases.js (consulte Acceso a las clases de API de AIR desde JavaScript) se documentan en las siguientes referencias:
HTML Developer's Guide for Adobe AIR (en inglés)
Adobe AIR API Reference for HTML Developers
8

Clases de ActionScript 3.0 específicas de AIR

Las siguiente tabla contiene clases del motor de ejecución son específicas de Adobe AIR. No están disponibles para el contenido SWF que se ejecuta en Adobe® Flash® Player en el navegador.
Desarrolladores de HTML
Las clases que están disponibles en JavaScript mediante el archivo AIRAliases.js se incluyen en Adobe AIR API
Reference for HTML Developers.
Clase Paquete de ActionScript 3.0 Añadido en versión de AIR
ARecord flash.net.dns 2.0
AAAARecord flash.net.dns 2.0
ApplicationUpdater air.update 1.5
ApplicationUpdaterUI air.update 1.5
AudioPlaybackMode flash.media 3.0
AutoCapitalize flash.text 3.0
BrowserInvokeEvent flash.events 1.0
CameraPosition flash.media 3.0
CameraRoll flash.media 2.0
CameraRollBrowseOptions flash.media 3.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
Clase Paquete de ActionScript 3.0 Añadido en versión de AIR
CameraUI flash.media 2.5
CertificateStatus flash.security 2.0
CompressionAlgorithm flash.utils 1.0
DatagramSocket flash.net 2.0
DatagramSocketDataEvent flash.events 2.0
DNSResolver flash.net.dns 2.0
DNSResolverEvent flash.events 2.0
DockIcon flash.desktop 1.0
DownloadErrorEvent air.update.events 1.5
DRMAuthenticateEvent flash.events 1.0
DRMDeviceGroup flash.net.drm 3.0
DRMDeviceGroupErrorEvent flash.net.drm 3.0
DRMDeviceGroupEvent flash.net.drm 3.0
9
DRMManagerError flash.errors 1.5
EncryptedLocalStore flash.data 1.0
ExtensionContext flash.external 2.5
File flash.filesystem 1.0
FileListEvent flash.events 1.0
FileMode flash.filesystem 1.0
FileStream flash.filesystem 1.0
FocusDirection flash.display 1.0
GameInput flash.ui 3.0
GameInputControl flash.ui 3.0
GameInputControlType flash.ui 3.6 y versiones anteriores;
GameInputDevice flash.ui 3.0
GameInputEvent flash.ui 3.0
GameInputFinger flash.ui 3.6 y versiones anteriores;
GameInputHand flash.ui 3.6 y versiones anteriores;
eliminados, desde 3.7
eliminados, desde 3.7
eliminados, desde 3.7
Geolocation flash.sensors 2.0
GeolocationEvent flash.events 2.0
HTMLHistoryItem flash.html 1.0
HTMLHost flash.html 1.0
HTMLLoader flash.html 1.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
Clase Paquete de ActionScript 3.0 Añadido en versión de AIR
HTMLPDFCapability flash.html 1.0
HTMLSWFCapabiltiy flash.html 2.0
HTMLUncaughtScriptExceptionEvent flash.events 1.0
HTMLWindowCreateOptions flash.html 1.0
Icon flash.desktop 1.0
IFilePromise flash.desktop 2.0
ImageDecodingPolicy flash.system 2.6
InteractiveIcon flash.desktop 1.0
InterfaceAddress flash.net 2.0
InvokeEvent flash.events 1.0
InvokeEventReason flash.desktop 1.5.1
IPVersion flash.net 2.0
IURIDereferencer flash.security 1.0
10
LocationChangeEvent flash.events 2.5
MediaEvent flash.events 2.5
MediaPromise flash.media 2.5
MediaType flash.media 2.5
MXRecord flash.net.dns 2.0
NativeApplication flash.desktop 1.0
NativeDragActions flash.desktop 1.0
NativeDragEvent flash.events 1.0
NativeDragManager flash.desktop 1.0
NativeDragOptions flash.desktop 1.0
NativeMenu flash.display 1.0
NativeMenuItem flash.display 1.0
NativeProcess flash.desktop 2.0
NativeProcessExitEvent flash.events 2.0
NativeProcessStartupInfo flash.desktop 2.0
NativeWindow flash.display 1.0
NativeWindowBoundsEvent flash.events 1.0
NativeWindowDisplayState flash.display 1.0
NativeWindowDisplayStateEvent flash.events 1.0
NativeWindowInitOptions flash.display 1.0
NativeWindowRenderMode flash.display 3.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
Clase Paquete de ActionScript 3.0 Añadido en versión de AIR
NativeWindowResize flash.display 1.0
NativeWindowSystemChrome flash.display 1.0
NativeWindowType flash.display 1.0
NetworkInfo flash.net 2.0
NetworkInterface flash.net 2.0
NotificationType flash.desktop 1.0
OutputProgressEvent flash.events 1.0
PaperSize flash.printing 2.0
PrintMethod flash.printing 2.0
PrintUIOptions flash.printing 2.0
PTRRecord flash.net.dns 2.0
ReferencesValidationSetting flash.security 1.0
ResourceRecord flash.net.dns 2.0
11
RevocationCheckSettings flash.security 1.0
Screen flash.display 1.0
ScreenMouseEvent flash.events 1.0
SecureSocket flash.net 2.0
SecureSocketMonitor air.net 2.0
ServerSocket flash.net 2.0
ServerSocketConnectEvent flash.events 2.0
ServiceMonitor air.net 1.0
SignatureStatus flash.security 1.0
SignerTrustSettings flash.security 1.0
SocketMonitor air.net 1.0
SoftKeyboardType flash.text 3.0
SQLCollationType flash.data 1.0
SQLColumnNameStyle flash.data 1.0
SQLColumnSchema flash.data 1.0
SQLConnection flash.data 1.0
SQLError flash.errors 1.0
SQLErrorEvent flash.events 1.0
SQLErrorOperation flash.errors 1.0
SQLEvent flash.events 1.0
SQLIndexSchema flash.data 1.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
Clase Paquete de ActionScript 3.0 Añadido en versión de AIR
SQLMode flash.data 1.0
SQLResult flash.data 1.0
SQLSchema flash.data 1.0
SQLSchemaResult flash.data 1.0
SQLStatement flash.data 1.0
SQLTableSchema flash.data 1.0
SQLTransactionLockType flash.data 1.0
SQLTriggerSchema flash.data 1.0
SQLUpdateEvent flash.events 1.0
SQLViewSchema flash.data 1.0
SRVRecord flash.net.dns 2.0
StageAspectRatio flash.display 2.0
StageOrientation flash.display 2.0
12
StageOrientationEvent flash.events 2.0
StageText flash.text 3.0
StageTextInitOptions flash.text 3.0
StageWebView flash.media 2.5
StatusFileUpdateErrorEvent air.update.events 1.5
StatusFileUpdateEvent air.update.events 1.5
StatusUpdateErrorEvent air.update.events 1.5
StatusUpdateEvent air.update.events 1.5
StorageVolume flash.filesystem 2.0
StorageVolumeChangeEvent flash.events 2.0
StorageVolumeInfo flash.filesystem 2.0
SystemIdleMode flash.desktop 2.0
SystemTrayIcon flash.desktop 1.0
TouchEventIntent flash.events 3.0
UpdateEvent air.update.events 1.5
Updater flash.desktop 1.0
URLFilePromise air.desktop 2.0
URLMonitor air.net 1.0
URLRequestDefaults flash.net 1.0
XMLSignatureValidator flash.security 1.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR

Clases de Flash Player con funcionalidad específica de AIR

Las siguientes clases están disponibles para el contenido SWF que se ejecuta en el navegador, pero AIR ofrece propiedades o métodos adicionales:
13
Paquete Clase Propiedad, método o evento Añadido en versión de
flash.desktop Clipboard supportsFilePromise 2.0
ClipboardFormats BITMAP_FORMAT 1.0
FILE_LIST_FORMAT 1.0
FILE_PROMISE_LIST_FORMAT 2.0
URL_FORMAT 1.0
flash.display LoaderInfo
Stage assignFocus() 1.0
childSandboxBridge 1.0
parentSandboxBridge 1.0
autoOrients 2.0
deviceOrientation 2.0
nativeWindow 1.0
orientation 2.0
Evento orientationChange 2.0
Evento orientationChanging 2.0
setAspectRatio 2.0
setOrientation 2.0
AIR
softKeyboardRect 2.6
supportedOrientations 2.6
supportsOrientationChange 2.0
NativeWindow owner 2.6
listOwnedWindows 2.6
NativeWindowInitOptions owner 2.6
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
14
Paquete Clase Propiedad, método o evento Añadido en versión de
AIR
flash.events Event CLOSING 1.0
DISPLAYING 1.0
PREPARING 2.6
EXITING 1.0
HTML_BOUNDS_CHANGE 1.0
HTML_DOM_INITIALIZE 1.0
HTML_RENDER 1.0
LOCATION_CHANGE 1.0
NETWORK_CHANGE 1.0
STANDARD_ERROR_CLOSE 2.0
STANDARD_INPUT_CLOSE 2.0
STANDARD_OUTPUT_CLOSE 2.0
USER_IDLE 1.0
USER_PRESENT 1.0
HTTPStatusEvent
HTTP_RESPONSE_STATUS 1.0
responseHeaders 1.0
KeyboardEvent
responseURL 1.0
commandKey 1.0
controlKey 1.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
15
Paquete Clase Propiedad, método o evento Añadido en versión de
AIR
flash.net FileReference extension 1.0
httpResponseStatus event 1.0
uploadUnencoded() 1.0
NetStream Evento
drmAuthenticate 1.0
Evento
onDRMContentData 1.5
preloadEmbeddedData() 1.5
resetDRMVouchers() 1.0
setDRMAuthenticationCredent ials()
1.0
URLRequest authenticate 1.0
cacheResponse 1.0
followRedirects 1.0
idleTimeout 2.0
manageCookies 1.0
useCache 1.0
userAgent 1.0
URLStream
Evento httpResponseStatus 1.0
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
16
Paquete Clase Propiedad, método o evento Añadido en versión de
flash.printing PrintJob active 2.0
copies 2.0
firstPage 2.0
isColor 2.0
jobName 2.0
lastPage 2.0
maxPixelsPerInch 2.0
paperArea 2.0
printableArea 2.0
printer 2.0
printers 2.0
selectPaperSize() 2.0
showPageSetupDialog() 2.0
start2() 2.0
supportsPageSetupDialog 2.0
terminate() 2.0
AIR
PrintJobOptions
flash.system Capabilities
LoaderContext
Security
flash.ui KeyLocation D_PAD 2.5
pixelsPerInch 2.0
printMethod 2.0
languages 1.1
allowLoadBytesCodeExecution 1.0
APPLICATION 1.0
La mayoría de estos nuevos métodos y propiedades solo están disponibles para contenido que se encuentra en el entorno limitado de seguridad de la aplicación de AIR. No obstante, los nuevos integrantes de las clases URLRequest también están disponibles para el contenido que se ejecuta en otros entornos limitados.
Los métodos
algorithm, que permite seleccionar entre la compresión deflate y zlib. Este parámetro está disponible únicamente en
ByteArray.compress() y ByteArray.uncompress() incluyen cada uno un nuevo parámetro,
el contenido que se ejecuta en AIR.

Componentes de Flex específicos de AIR

Los siguientes componentes MX de Adobe® Flex™ están a disposición cuando se desarrolla contenido para Adobe AIR:
FileEvent
FileSystemComboBox
FileSystemDataGrid
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Trabajo con las API de AIR
FileSystemEnumerationMode
FileSystemHistoryButton
FileSystemList
FileSystemSizeDisplayMode
FileSystemTree
FlexNativeMenu
HTML
Window
WindowedApplication
WindowedSystemManager
Asimismo, Flex 4 incluye los siguientes componentes spark de AIR:
Window
WindowedApplication
Para obtener más información sobre los componentes de Flex para AIR, consulte Using the Flex AIR components (Uso de componentes de Flex para AIR).
17
Última modificación 26/3/2017

Capítulo 4: Herramientas de la plataforma de Adobe Flash para el desarrollo de AIR

Es posible desarrollar aplicaciones de AIR con las siguientes herramientas de desarrollo de la plataforma de Adobe Flash:
Para los desarrolladores de ActionScript 3.0 (Flash y Flex):
Adobe Flash Professional (consulte Publicación para AIR)
SDK de Adobe Flex 3.x y 4.x (consulte “Configuración del SDK de Flex” en la página 20 y “AIR Developer Tool
(ADT)” en la página 174)
Adobe Flash Builder (consulte Desarrollo de aplicaciones de AIR con Flash Builder)
Para desarrolladores de HTML y Ajax:
SDK de Adobe AIR (consulte “Instalación del SDK de AIR” en la página 18 y “AIR Developer Tool (ADT)” en la
página 174)
Adobe Dreamweaver CS3, CS4, CS5 (consulte Extensión de AIR para Dreamweaver)
18

Instalación del SDK de AIR

El SDK de Adobe AIR contiene las siguientes herramientas de la línea de comandos que se utilizan para iniciar y empaquetar aplicaciones:
AIR Debug Launcher (ADL) Permite ejecutar aplicaciones de AIR sin tener que instalarlas primero. Consulte “AIR
Debug Launcher (ADL)” en la página 168.
AIR Development Tool (ADT) Empaqueta aplicaciones de AIR en paquetes de instalación distribuibles. Consulte “AIR
Developer Tool (ADT)” en la página 174.
Las herramientas de la línea de comandos de AIR requieren Java para su instalación en el equipo. La máquina virtual Java se puede utilizar desde JRE o JDK (versión 1.5 o posterior). Java JRE y Java JDK se encuentran disponibles en http://java.sun.com/.
Se requieren 2 GB de memoria como mínimo para ejecutar la herramienta ADT.
Nota: Java no se requiere para los usuarios finales que ejecuten aplicaciones de AIR.
Para obtener una breve descripción general sobre la creación de una aplicación de AIR con el SDK de AIR, consulte “Creación de la primera aplicación de AIR basada en HTML con el SDK de AIR” en la página 36.

Descarga e instalación del SDK de AIR

El SDK de AIR se puede descargar e instalar utilizando las siguientes instrucciones:
Instalación del SDK de AIR en Windows
Descargue el archivo de instalación del SDK de AIR.
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Herramientas de la plataforma de Adobe Flash para el desarrollo de AIR
El SDK de AIR se distribuye como archivo estándar. Para instalar AIR, extraiga el contenido del SDK en una carpeta
del equipo (por ejemplo: C:\Archivos de programa\Adobe\AIRSDK o C:\AIRSDK).
Las herramientas ADL y ADT se incluyen en la carpeta bin del SDK de AIR; añada la ruta a esta carpeta a la variable
de entorno PATH.
Instalación del SDK de AIR en Mac OS X
Descargue el archivo de instalación del SDK de AIR.
El SDK de AIR se distribuye como archivo estándar. Para instalar AIR, extraiga el contenido del SDK en una carpeta
del equipo (por ejemplo: /Users/<userName>/Applications/AIRSDK).
Las herramientas ADL y ADT se incluyen en la carpeta bin del SDK de AIR; añada la ruta a esta carpeta a la variable
de entorno PATH.
Instalación del SDK de AIR en Linux
El SDK está disponible en el formato tbz2.
Para instalar el SDK, cree una carpeta en la que desee descomprimirlo y, a continuación, utilice el siguiente
comando: tar -jxvf <path to AIR-SDK.tbz2>
Para obtener información sobre instrucciones para comenzar a utilizar las herramientas del SDK de AIR, consulte Creación de aplicaciones de AIR con las herramientas de la línea de comandos.
19

Componentes del SDK de AIR

En la siguiente tabla se describen las funciones de los archivos incluidos en el SDK de AIR:
Carpeta del SDK Descripción de las herramientas/archivos
bin AIR Debug Launcher (ADL) permite ejecutar una aplicación de AIR sin empaquetarla
frameworks El directorio libs contiene bibliotecas de código para su uso en aplicaciones de AIR.
include El directorio include contiene el archivo de encabezado del lenguaje C para escribir
install El directorio install contiene los controladores USB de Windows para dispositivos de
lib Contiene el código de compatibilidad para las herramientas del SDK de AIR.
e instalarla primero. Para obtener más información sobre el uso de esta herramienta, consulte “AIR Debug Launcher (ADL)” en la página 168.
AIR Developer Tool (ADT) empaqueta la aplicación como archivo de AIR para distribución. Para obtener información sobre el uso de esta herramienta, consulte “AIR Developer Tool (ADT)” en la página 174.
El directorio projects contiene el código para las bibliotecas SWF y SWC compiladas.
extensiones nativas.
Android. (Estos son los controladores proporcionados por Google en el SDK de Android.)
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Herramientas de la plataforma de Adobe Flash para el desarrollo de AIR
Carpeta del SDK Descripción de las herramientas/archivos
runtimes Los motores de ejecución de AIR para los dispositivos móviles y de escritorio.
ADL utiliza el motor de ejecución para iniciar las aplicaciones de AIR antes de que se empaqueten o se instalen.
Los motores de ejecución de AIR para Android (paquetes APK) se pueden instalar en emuladores o dispositivos de Android para desarrollo y prueba. Los paquetes APK independientes se utilizan para los dispositivos y emuladores. (El motor de ejecución público de AIR para Android está disponible en Android Market.)
20
samples Esta carpeta contiene un archivo descriptor de la aplicación de ejemplo, un ejemplo
templates descriptor-template.xml: una plantilla del archivo descriptor de la aplicación que es
de la función de instalación integrada (badge.swf) y los iconos de la aplicación de AIR predeterminados.
necesaria para todas las aplicaciones de AIR. Para ver una descripción detallada del archivo descriptor de la aplicación, consulte “Archivos descriptores de las
aplicaciones de AIR” en la página 214.
Los archivos de esquema de la estructura XML del descriptor de la aplicación para cada versión oficial de AIR también se encuentran en esta carpeta.

Configuración del SDK de Flex

Para desarrollar aplicaciones de Adobe® AIR® con Adobe® Flex™, dispone de las siguientes opciones:
Puede descargar e instalar Adobe® Flash® Builder™, que proporciona herramientas integradas para crear proyectos
de Adobe AIR y comprobar, depurar y empaquetar aplicaciones de AIR. Consulte “Creación de su primera
aplicación de AIR de Flex de escritorio en Flash Builder” en la página 22.
Puede descargar el SDK de Adobe® Flex™ y desarrollar aplicaciones de AIR de Flex utilizando su editor de texto
favorito y las herramientas de la línea de comandos.
Para obtener una breve descripción general de la creación de una aplicación de AIR con el SDK de Flex, consulte “Creación de la primera aplicación de AIR de escritorio con el SDK de Flex” en la página 40.

Instalación del SDK de Flex

La creación de aplicaciones de AIR con las herramientas de la línea de comandos requiere que Java esté instalado en el equipo. La máquina virtual Java se puede utilizar desde JRE o JDK (versión 1.5 o posterior). El JRE y JDK de Java están disponibles en http://java.sun.com/.
Nota: Java no se requiere para los usuarios finales que ejecuten aplicaciones de AIR.
El SDK de Flex proporciona la API de AIR y las herramientas de la línea de comandos que se utilizan para empaquetar, compilar y depurar las aplicaciones de AIR.
1 Si aún no lo ha hecho, descargue el SDK de Flex en http://opensource.adobe.com/wiki/display/flexsdk/Downloads.
2 Ubique el contenido del SDK en una carpeta (por ejemplo, Flex SDK).
3 Copie el contenido del SDK de AIR en los archivos del SDK de Flex.
Nota: en los equipos Mac, asegúrese de que copia o reemplaza los archivos independientes en las carpetas del SDK, no los directorios completos. De forma predeterminada, con la copia de un directorio en Mac en un directorio del mismo nombre se eliminan los archivos existentes en el directorio de destino; no se combina el contenido de los dos directorios. Puede utilizar el comando
air_sdk_folder flex_sdk_folder
ditto en la ventana de terminal para combinar el SDK de AIR con el SDK de Flex:ditto
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Herramientas de la plataforma de Adobe Flash para el desarrollo de AIR
4 Las utilidades de AIR de la línea de comandos se encuentran en la carpeta bin.

Configuración de los SDK externos

El desarrollo de aplicaciones para Android y iOS requiere que descargue los archivos de suministro, los SDK u otras herramientas de desarrollo de los creadores de plataformas.
Para obtener más información sobre la descarga e instalación del SDK de Android, consulte Android Developers:
Installing the SDK. Desde AIR 2.6, no es necesario descargar el SDK de Android. El SDK de AIR ahora incluye los
componentes básicos necesarios para instalar e iniciar paquetes de APK. Aun así, el SDK de Android puede resultar útil para una serie de tareas de desarrollo, entre las que se incluyen la creación o ejecución de emuladores de software y capturas de pantalla del dispositivo.
Un SDK externo no es necesario para el desarrollo de iOS. Sin embargo, se requieren certificados especiales y perfiles de suministro. Para obtener más información, consulte Obtención de archivos de desarrollo de Apple.
21
Última modificación 26/3/2017

Capítulo 5: Creación de su primera aplicación de AIR

Creación de su primera aplicación de AIR de Flex de escritorio en Flash Builder

Para obtener unas indicaciones rápidas y prácticas sobre el funcionamiento de Adobe® AIR®, utilice estas instrucciones para crear y empaquetar una sencilla aplicación “Hello World” de AIR basada en archivos SWF utilizando Adobe® Flash® Builder.
Si aún no lo ha hecho, descargue e instale Flash Builder. Asimismo, descargue e instale la versión más reciente de Adobe AIR, que se encuentra en: www.adobe.com/go/air_es.

Creación de un proyecto de AIR

Flash Builder incluye las herramientas necesarias para desarrollar y empaquetar aplicaciones de AIR.
22
La creación de aplicaciones de AIR en Flash Builder o Flex Builder comienza del mismo modo en que se crean otros proyectos de aplicaciones basadas en Flex: mediante la definición de un nuevo proyecto.
1 Abra Flash Builder.
2 Seleccione File (Archivo) > New (Nuevo)> Flex Project (Proyecto de Flex).
3 Indique el nombre del proyecto como AIRHelloWorld.
4 En Flex, las aplicaciones de AIR se consideran un tipo de aplicación. Se dispone de dos opciones:
Una aplicación web que se ejecuta en Adobe® Flash® Player.
Una aplicación de escritorio que se ejecuta en Adobe AIR.
Seleccione Escritorio como tipo de aplicación.
5 Haga clic en Finish (Finalizar) para crear el proyecto.
Los proyectos de AIR constan inicialmente de dos archivos: el archivo principal MXML y el archivo XML de la aplicación (al que se hace referencia como archivo descriptor de la aplicación). El último archivo especifica las propiedades de la aplicación.
Para obtener más información, consulte Developing AIR applications with Flash Builder (Desarrollo de aplicaciones de AIR con Flash Builder; en inglés).

Escritura del código de aplicaciones de AIR

Para escribir el código de la aplicación “Hello World”, se edita el archivo MXML de la aplicación (AIRHelloWorld.mxml), que se abre en el editor. (Si el archivo no se abre, utilice el navegador de proyectos para abrir el archivo.)
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Creación de su primera aplicación de AIR
Las aplicaciones de AIR de Flex en el escritorio se incluyen en la etiqueta MXML WindowedApplication. La etiqueta MXML WindowedApplication crea una sencilla ventana que incluye controles básicos como, por ejemplo, una barra de título y un botón de cierre.
1 Añada un atributo title al componente WindowedApplication y asígnele el valor "Hello World":
<?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" title="Hello World">
</s:WindowedApplication>
2 Añada un componente Label a la aplicación (sitúelo dentro de la etiqueta WindowedApplication), establezca la
propiedad
text del componente Label en "Hello AIR" y defina restricciones de diseño para mantenerlo centrado,
tal y como se muestra a continuación:
<?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" title="Hello World">
<s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/>
</s:WindowedApplication>
23
3 Añada el siguiente bloque de estilo inmediatamente después de la etiqueta inicial WindowedApplication y antes de
la etiqueta del componente label introduzca:
<fx:Style>
@namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication {
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin");
background-color:#999999; background-alpha:"0.7";
}
</fx:Style>
Esta configuración de estilo se aplica a toda la aplicación y se procesa el fondo de la ventana con un gris ligeramente transparente.
El código de la aplicación presenta en este momento el siguiente aspecto:
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Creación de su primera aplicación de AIR
<?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" title="Hello World">
<fx:Style>
@namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication {
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin");
background-color:#999999; background-alpha:"0.7";
}
</fx:Style>
<s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/>
</s:WindowedApplication>
A continuación, se modificará parte de la configuración del descriptor de la aplicación para permitir que la aplicación sea transparente:
24
1 En el panel Flex Navigator (Navegador de Flex), sitúe el archivo descriptor de la aplicación en el directorio de origen
del proyecto. Si se ha asignado el nombre AIRHelloWorld al proyecto, este archivo se denomina AIRHelloWorld­app.xml.
2 Haga doble clic en el archivo descriptor de la aplicación para editarlo en Flash Builder.
3 En el código XML, sitúe las líneas de comentarios para las propiedades systemChrome y transparent (de la
propiedad
initialWindow). Elimine los comentarios. (Elimine los delimitadores de comentarios "<!--" y "-->".)
4 Establezca el valor de texto de la propiedad systemChrome en none, tal y como se muestra a continuación:
<systemChrome>none</systemChrome>
5 Establezca el valor de texto de la propiedad transparent en true, tal y como se indica a continuación:
<transparent>true</transparent>
6 Guarde el archivo.
Última modificación 26/3/2017
CREACIÓN DE APLICACIONES DE ADOBE AIR
Creación de su primera aplicación de AIR

Prueba de la aplicación de AIR

Para probar el código de la aplicación que se ha escrito, ejecútelo en modo de depuración.
1 Haga clic en el botón Debug (Depurar) de la barra de herramientas principal.
También puede seleccionar el comando Run (Ejecutar) > Debug (Depurar) > AIRHelloWorld.
La aplicación de AIR resultante debe ser similar al siguiente ejemplo:
25
2 Con el uso de las propiedades horizontalCenter y verticalCenter del control Label, el texto se sitúa en el
centro de la ventana. Mueva o cambie el tamaño de la ventana tal y como lo haría en cualquier otra aplicación de escritorio.
Nota: si la aplicación no se compila, corrija la sintaxis o los errores ortográficos que se hayan podido introducir accidentalmente en el código. Los errores y advertencias se muestran en la vista Problems (Problemas) de Flash Builder.

Empaquetado, firma y ejecución de una aplicación de AIR

Ahora ya se puede empaquetar la aplicación "Hello World" en un archivo de AIR para su distribución. Un archivo de AIR es un archivo de almacenamiento que contiene los archivos de la aplicación, que son todos los archivos incluidos en la carpeta bin del proyecto. En este sencillo ejemplo, estos archivos son los archivos SWF y XML de la aplicación. El paquete de AIR se distribuye a los usuarios, que posteriormente lo utilizan para instalar la aplicación. Un paso necesario en este proceso consiste en firmarlo digitalmente.
1 Compruebe que la aplicación no presenta errores de compilación y que se ejecuta correctamente.
2 Seleccione Project (Proyecto) > Export Release Version (Exportar versión oficial).
3 Compruebe que el proyecto AIRHelloWorld y la aplicación AIRHelloWorld.mxml se incluyan para el proyecto y
la aplicación.
4 Seleccione Exportar como opción de paquete de AIR firmado. A continuación, haga clic en Siguiente.
5 Si ya dispone de un certificado digital existente, haga clic en Examinar y selecciónelo.
6 Si debe crear un nuevo certificado digital con firma automática, seleccione Crear.
7 Introduzca la información necesaria y haga clic en Aceptar.
8 Haga clic en Finalizar para generar el paquete de AIR denominado AIRHelloWorld.air.
Última modificación 26/3/2017
Loading...
+ 296 hidden pages