Adobe Air - 2013 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 18/11/2013

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Depuración de una aplicación de AIR móvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Última modificación 18/11/2013

CREACIÓN DE APLICACIONES DE ADOBE AIR

Contenidos

Instalación de AIR y aplicaciones de AIR en dispositivos móviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Actualización de aplicaciones móviles de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Uso de notificaciones push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Capítulo 8: Desarrollo de aplicaciones de AIR para dispositivos de televisión

Funciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Consideraciones de diseño de las aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Flujo de trabajo para desarrollar una aplicación de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Propiedades del descriptor de la aplicación de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

Empaquetado de una aplicación de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Depuración de aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Capítulo 9: Uso de extensiones nativas para Adobe AIR

Archivos de extensión nativa de AIR (ANE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Extensiones nativas y la clase NativeProcess de ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Extensiones nativas y clases de biblioteca de ActionScript (archivos SWC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Dispositivos admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Perfiles de dispositivos admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Lista de tareas para utilizar una extensión nativa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Declaración de la extensión en el archivo descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Inclusión del archivo ANE en la ruta de la biblioteca de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Empaquetado de una aplicación con extensiones nativas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Capítulo 10: Compiladores de ActionScript

Información sobre las herramientas de la línea de comandos de AIR en el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Configuración del compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Compilación de archivos de origen MXML y ActionScript para AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

Compilación de una biblioteca de código o componente de AIR (Flex) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Capítulo 11: AIR Debug Launcher (ADL)

Uso de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

Ejemplos con ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

Códigos de error y de salida de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Capítulo 12: AIR Developer Tool (ADT)

Comandos de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Conjuntos de opciones de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Mensajes de error de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Variables del entorno de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Capítulo 13: Firma de aplicaciones de AIR

Firma digital de archivos de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Creación de archivos intermedios sin firmar de AIR con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Firma de un archivo intermedio de AIR con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Firma de una versión actualizada de una aplicación de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Creación de certificados con firma automática con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Última modificación 18/11/2013

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Estructura del archivo descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Elementos del descriptor de la aplicación de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

Capítulo 15: Perfiles de dispositivo

Restricción de perfiles de destino en el archivo descriptor de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Capacidades en diferentes perfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Capítulo 16: API en navegador AIR.SWF

Personalización del archivo badge.swf de instalación integrada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Utilización del archivo badge.swf para instalar una aplicación de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Carga del archivo air.swf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Cómo comprobar si está instalado el motor de ejecución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Cómo comprobar desde una página web si una aplicación de AIR está instalada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Instalación de una aplicación de AIR desde el navegador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Inicio desde el navegador de una aplicación de AIR instalada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Capítulo 17: Actualización de aplicaciones de AIR

Actualización de aplicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Presentación de una interfaz de usuario personalizada para las actualizaciones de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . 270

Descarga de un archivo de AIR en el equipo del usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Comprobar si una aplicación se está ejecutando por primera vez . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Utilización del marco de actualización . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Capítulo 18: Visualización de código fuente

Carga, configuración y apertura del visor de código fuente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

Interfaz de usuario del visor de código fuente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

Capítulo 19: Depuración con el introspector HTML de AIR

Introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Carga del código del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Inspección de un objeto en la ficha Console (Consola) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

Configuración del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Interfaz del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Utilización del introspector de AIR con contenido en un entorno limitado ajeno a la aplicación . . . . . . . . . . . . . . . . . . . . . . . . 302

Capítulo 20: Localización de aplicaciones de AIR

Localización del nombre y la descripción en el instalador de aplicaciones de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Localización de contenido HTML con la arquitectura de localización de HTML de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Capítulo 21: Variables del entorno de ruta

Configuración de la ruta en Linux y Mac OS utilizando el shell Bash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

Configuración de la ruta en Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

Última modificación 18/11/2013

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

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 18/11/2013

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).

Última modificación 18/11/2013

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.

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 18/11/2013

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.

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 184 para obtener más información.

Última modificación 18/11/2013

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.

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 185 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 18/11/2013

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/).

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 18/11/2013

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.

Última modificación 18/11/2013

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

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 18/11/2013

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

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

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 18/11/2013

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

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 18/11/2013

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

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 18/11/2013

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

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 18/11/2013

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:

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 18/11/2013

CREACIÓN DE APLICACIONES DE ADOBE AIR

Trabajo con las API de AIR

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 18/11/2013

CREACIÓN DE APLICACIONES DE ADOBE AIR

Trabajo con las API de AIR

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 18/11/2013

CREACIÓN DE APLICACIONES DE ADOBE AIR

Trabajo con las API de AIR

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 18/11/2013

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).

Última modificación 18/11/2013

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 172)

• 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 172)

• Adobe Dreamweaver CS3, CS4, CS5 (consulte Extensión de AIR para Dreamweaver)

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 166.

AIR Development Tool (ADT) Empaqueta aplicaciones de AIR en paquetes de instalación distribuibles. Consulte “AIR

Developer Tool (ADT)” en la página 172.

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 18/11/2013

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.

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 166.

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 172.

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 18/11/2013

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.)

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 212.

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 18/11/2013

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.

Última modificación 18/11/2013

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.

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 18/11/2013

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>

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 18/11/2013

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:

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 AIRHelloWorldapp.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 "".)

4 Establezca el valor de texto de la propiedad systemChrome en none, tal y como se muestra a continuación:

5 Establezca el valor de texto de la propiedad transparent en true, tal y como se indica a continuación:

6 Guarde el archivo.

Última modificación 18/11/2013

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:

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 18/11/2013

+ 293 hidden pages