Air Building Apps

download Air Building Apps

of 297

Transcript of Air Building Apps

Creacin de aplicaciones de ADOBE AIR

Avisos legales

Avisos legalesPara ver los avisos legales, consulte http://help.adobe.com/es_ES/legalnotices/index.html.

ltima modificacin 3/2/2012

iii

ContenidoCaptulo 1: Acerca de Adobe AIR Captulo 2: Instalacin de Adobe AIR Instalacin de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Desinstalacin de Adobe AIR Actualizaciones de Adobe AIR .......................................................................................... 5 ........................................................... 6 ......................................................................................... 6 Instalacin y ejecucin de las aplicaciones de AIR de muestra

Captulo 3: Trabajo con las API de AIR Clases de ActionScript 3.0 especficas de AIR Componentes de Flex especficos de AIR

........................................................................... 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Clases de Flash Player con funcionalidad especfica de AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Captulo 4: Herramientas de la plataforma de Adobe Flash para el desarrollo de AIR Instalacin del SDK de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Configuracin del SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Configuracin de los SDK externos

Captulo 5: Creacin de su primera aplicacin de AIR Creacin de su primera aplicacin de AIR de Flex de escritorio en Flash Builder Creacin de la primera aplicacin de AIR de escritorio con Flash Professional Creacin de su primera aplicacin de AIR para Android en Flash Professional Creacin de su primera aplicacin de AIR para iOS Creacin de la primera aplicacin de AIR basada en HTML con Dreamweaver Creacin de la primera aplicacin de AIR basada en HTML con el SDK de AIR Creacin de la primera aplicacin de AIR de escritorio con el SDK de Flex Creacin de la primera aplicacin de AIR para Android con el SDK de Flex Captulo 6: Desarrollo de aplicaciones de AIR para el escritorio Flujo de trabajo para el desarrollo de una aplicacin de escritorio de AIR Configuracin de las propiedades de una aplicacin de escritorio Depuracin de una aplicacin de AIR de escritorio Empaquetado de un instalador nativo de escritorio Empaquetado de un archivo de instalacin de AIR de escritorio

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Empaquetado de un paquete de motor de ejecucin captador para equipos de escritorio Distribucin de paquetes de AIR para equipos de escritorio

Captulo 7: Desarrollo de aplicaciones de AIR para dispositivos mviles Configuracin del entorno de desarrollo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Consideraciones sobre el diseo de aplicaciones mviles Configuracin de las propiedades de una aplicacin mvil Empaquetado de una aplicacin de AIR mvil Depuracin de una aplicacin de AIR mvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Flujo de trabajo para crear aplicaciones de AIR para dispositivos mviles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRContenido

iv

Instalacin de AIR y aplicaciones de AIR en dispositivos mviles Actualizacin de aplicaciones mviles de AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Captulo 8: Desarrollo de aplicaciones de AIR para dispositivos de televisin Funciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Consideraciones de diseo de las aplicaciones de AIR para TV Flujo de trabajo para desarrollar una aplicacin de AIR para TV Propiedades del descriptor de la aplicacin de AIR para TV Empaquetado de una aplicacin de AIR para TV Depuracin de aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Captulo 9: Uso de extensiones nativas para Adobe AIR Archivos de extensin nativa de AIR (ANE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Extensiones nativas y la clase NativeProcess de ActionScript Dispositivos admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Extensiones nativas y clases de biblioteca de ActionScript (archivos SWC) Perfiles de dispositivos admitidos

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Lista de tareas para utilizar una extensin nativa

Declaracin de la extensin en el archivo descriptor de la aplicacin Inclusin del archivo ANE en la ruta de la biblioteca de la aplicacin Empaquetado de una aplicacin con extensiones nativas

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Captulo 10: Compiladores de ActionScript Informacin sobre las herramientas de la lnea de comandos de AIR en el SDK de Flex Configuracin del compilador Compilacin de archivos de origen MXML y ActionScript para AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Compilacin de una biblioteca de cdigo o componente de AIR (Flex)

Captulo 11: AIR Debug Launcher (ADL) Uso de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 Ejemplos con ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Cdigos de error y de salida de ADL

Captulo 12: AIR Developer Tool (ADT) Comandos de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Conjuntos de opciones de ADT Mensajes de error de ADT Variables del entorno de ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Captulo 13: Firma de aplicaciones de AIR Firma digital de archivos de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Creacin de archivos intermedios sin firmar de AIR con ADT Firma de un archivo intermedio de AIR con ADT Firma de una versin actualizada de una aplicacin de AIR Creacin de certificados con firma automtica con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRContenido

v

Captulo 14: Archivos descriptores de las aplicaciones de AIR Cambios en el descriptor de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Estructura del archivo descriptor de la aplicacin Elementos del descriptor de la aplicacin de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Captulo 15: Perfiles de dispositivo Restriccin de perfiles de destino en el archivo descriptor de la aplicacin Capacidades en diferentes perfiles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Captulo 16: API en navegador AIR.SWF Personalizacin del archivo badge.swf de instalacin integrada Carga del archivo air.swf

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Utilizacin del archivo badge.swf para instalar una aplicacin de AIR Cmo comprobar si est instalado el motor de ejecucin Instalacin de una aplicacin de AIR desde el navegador

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Cmo comprobar desde una pgina Web si una aplicacin de AIR est instalada Inicio desde el navegador de una aplicacin de AIR instalada

Captulo 17: Actualizacin de aplicaciones de AIR Actualizacin de aplicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 Presentacin de una interfaz de usuario personalizada para las actualizaciones de la aplicacin Descarga de un archivo de AIR en el equipo del usuario Utilizacin del marco de actualizacin Comprobar si una aplicacin se est ejecutando por primera vez . . . . . . . . . . . . . . . . . . . . . . . . 244 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Captulo 18: Visualizacin de cdigo fuente Carga, configuracin y apertura del visor de cdigo fuente Interfaz de usuario del visor de cdigo fuente

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Captulo 19: Depuracin con el introspector HTML de AIR Introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266 Carga del cdigo del introspector de AIR Configuracin del introspector de AIR Interfaz del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 Inspeccin de un objeto en la ficha Console (Consola)

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 . . . . . . . . . . . . . . . . . . . . . . . . 276

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Utilizacin del introspector de AIR con contenido en un entorno limitado ajeno a la aplicacin Captulo 20: Localizacin de aplicaciones de AIR Localizacin del nombre y la descripcin en el instalador de aplicaciones de AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Localizacin de contenido HTML con la arquitectura de localizacin de HTML de AIR Captulo 21: Variables del entorno de ruta Configuracin de la ruta en Linux y Mac OS utilizando el shell Bash Configuracin de la ruta en Windows

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

ltima modificacin 3/2/2012

1

Captulo 1: Acerca de Adobe AIRAdobe AIR es un motor de ejecucin multipantalla vlido 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 mviles. Las aplicaciones de AIR mviles, de televisin y escritorio se pueden crear con ActionScript 3.0 utilizando Adobe Flex y Adobe Flash (basado en SWF). Las aplicaciones de AIR de escritorio tambin se pueden crear con HTML, JavaScript y Ajax (basado en HTML). Para obtener ms informacin sobre el uso y una introduccin a Adobe AIR, consulte Adobe AIR Developer Connection http://www.adobe.com/devnet/air/ (Centro de desarrollo de Adobe AIR) (en ingls). AIR permite el trabajo en entornos conocidos para aprovechar las herramientas y los procesos con los que se encuentra ms cmodo. 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 tecnologas siguientes o combinando varias de ellas:

Flash/Flex/ActionScript HTML/JavaScript/CSS/AjaxLos usuarios interactan con las aplicaciones de AIR del mismo modo que con las aplicaciones nativas. El motor de ejecucin se instala una vez en el ordenador del usuario o dispositivo y despus se instalan y ejecutan las aplicaciones de AIR como cualquier otra aplicacin de escritorio. (En iOS, no se instala un motor de ejecucin de AIR independiente; todas las aplicaciones de AIR de iOS son independientes.) El motor de ejecucin ofrece una arquitectura y plataforma compatibles con distintos sistemas operativos para la implementacin 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 ejecucin, lo cual ofrece las siguientes ventajas:

Las aplicaciones desarrolladas para AIR se ejecutan en varios sistemas operativos distintos sin suponer trabajoadicional para el desarrollador. El motor de ejecucin asegura una presentacin e interacciones constantes y predecibles en todos los sistemas operativos compatibles con AIR.

Las aplicaciones se pueden crear de forma ms rpida permitiendo el aprovechamiento de tecnologas web ypatrones de diseo existentes. Las aplicaciones basadas en web se pueden ampliar al escritorio sin tener que aprender las tecnologas de desarrollo en escritorio tradicionales o la complejidad del cdigo nativo.

El desarrollo de aplicaciones resulta ms fcil que cuando se utilizan lenguajes de nivel inferior como C y C++. Nohace falta gestionar las complejas API de nivel inferior que son especficas para cada sistema operativo. Al desarrollar aplicaciones para AIR se puede aprovechar un juego enriquecido de arquitecturas e interfaces API:

API especficas para AIR proporcionadas por el motor de ejecucin y la arquitectura de AIR API de ActionScript utilizadas en archivos SWF y la arquitectura de Flex (adems de otras bibliotecas yarquitecturas basadas en ActionScript)

HTML, CSS y JavaScript La mayora de las arquitecturas de Ajax

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRAcerca de Adobe AIR

2

Las extensiones nativas para Adobe AIR proporcionan API de ActionScript que permiten acceder a funcionesespecficas de la plataforma programadas con cdigo nativo. Las extensiones nativas tambin proporcionan acceso al cdigo nativo heredado y el cdigo nativo siempre aporta mayor rendimiento. AIR es toda una novedad en la forma de crear, implementar y experimentar las aplicaciones. Puede obtener ms control creativo y ampliar las aplicaciones basadas en Flash, Flex, HTML y Ajax en su escritorio, dispositivos mviles y televisiones. Para obtener informacin sobre los elementos incluidos en cada nueva actualizacin de AIR , consulte las notas de la versin de Adobe AIR (http://www.adobe.com/go/learn_air_relnotes_es).

ltima modificacin 3/2/2012

3

Captulo 2: Instalacin de Adobe AIREl motor de ejecucin de Adobe AIR permite ejecutar aplicaciones de AIR. El motor de ejecucin se puede instalar de cualquiera de las formas siguientes:

Mediante la instalacin independiente del motor de ejecucin (sin instalar adems una aplicacin de AIR). Con la instalacin de una aplicacin de AIR por primera vez mediante una instalacin de pgina web (instalacindesde navegador) (se le indicar que tambin instale el motor de ejecucin).

Mediante la creacin de un archivo de instalacin que instale tanto la aplicacin como el motor de ejecucin. Debeobtener la aprobacin de Adobe para poder distribuir el motor de ejecucin de AIR de esta manera. Puede solicitar la aprobacin en la pgina Licencias del motor de ejecucin de Adobe (en ingls). Tenga en cuenta que Adobe no proporciona herramientas para crear este archivo de instalacin. No obstante, hay disponibles muchos kits de herramientas de archivos de instalacin de otros fabricantes.

Mediante la instalacin de una aplicacin de AIR que contenga AIR como motor de ejecucin captador. El motorde ejecucin captador lo utiliza solamente la aplicacin creadora del paquete. No se utiliza para ejecutar otras aplicaciones de AIR. Crear un motor de ejecucin es una opcin en Android, Mac y Windows. En iOS, todas las aplicaciones incluyen un paquete de motor de ejecucin.

Mediante la instalacin de un entorno de desarrollo de AIR como el kit de desarrollo de software de AIR, AdobeFlash Builder o el kit de desarrollo de software (SDK) de Adobe Flex (que incluye las herramientas de desarrollo de la lnea de comandos de AIR). El motor de ejecucin incluido en el SDK slo 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 ejecucin como el instalador de la aplicacin de AIR, crean archivos de registro cuando instalan, actualizan o eliminan aplicaciones de AIR o el propio motor de ejecucin de AIR. Puede consultar estos registros para ayudar a determinar la causa de cualquier problema de instalacin. Consulte Installation logs (Registros de instalacin; en ingls).

Instalacin de Adobe AIRPara instalar o actualizar el motor de ejecucin, el usuario debe tener privilegios administrativos para el equipo. Instalacin del motor de ejecucin en un ordenador con Windows 1 Descargue el archivo de instalacin del motor de ejecucin en http://get.adobe.com/es/air.2 Haga doble clic en el archivo de instalacin del motor de ejecucin. 3 Siga las indicaciones que aparecen en la ventana de instalacin para llevar a cabo la instalacin.

Instalacin del motor de ejecucin en un ordenador con Mac 1 Descargue el archivo de instalacin del motor de ejecucin en http://get.adobe.com/es/air.2 Haga doble clic en el archivo de instalacin del motor de ejecucin. 3 Siga las indicaciones que aparecen en la ventana de instalacin para llevar a cabo la instalacin.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

4

4 Si el instalador presenta una ventana de autenticacin, escriba el nombre de usuario y la contrasea que utiliza para

Mac OS. Instalacin del motor de ejecucin 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 instalacin en http://kb2.adobe.com/cps/853/cpsid_85304.html y realice la descarga. 2 Establezca los permisos de archivo para que se pueda ejecutar la aplicacin de instalacin: Desde una lnea 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 dilogo de propiedades que se abre mediante un men contextual.3 Ejecute el instalador desde la lnea de comandos o haciendo doble clic en el archivo de instalacin. 4 Siga las indicaciones que aparecen en la ventana de instalacin para llevar a cabo la instalacin.

Adobe AIR est instalado como paquete nativo. Es decir, como rpm en una distribucin basada en rpm y deb en una distribucin Debian. Actualmente AIR no admite ningn otro formato de paquete. Uso de los instaladores de paquete:1 Localice el paquete de AIR en http://kb2.adobe.com/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.

Tambin puede realizar la instalacin desde la lnea de comandos:a En un sistema Debian:sudo dpkg -i /adobeair-2.0.0.xxxxx.deb

b En un sistema basado en rpm:sudo rpm -i /adobeair-2.0.0-xxxxx.i386.rpm

O bien, si est actualizando una versin existente (AIR 1.5.3 o posterior):sudo rpm -U /adobeair-2.0.0-xxxxx.i386.rpm

La instalacin 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 ubicacin: /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 ejecucin de AIR. Instalacin del motor de ejecucin en un dispositivo de Android Se puede instalar la versin ms reciente del motor de ejecucin de AIR desde Android Market. Es posible instalar las versiones de desarrollo del motor de ejecucin de AIR desde un vnculo en una pgina web utilizando el comando -installRuntime de ADT. Slo una versin del motor de ejecucin 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 pgina 164 para obtener ms informacin.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

5

Instalacin del motor de ejecucin en un dispositivo de iOS El cdigo del motor de AIR necesario se integra con cada aplicacin creada para los dispositivos iPhone, iTouch y iPad. No instale un componente del motor de ejecucin independiente.

Ms temas de ayudaAIR para iOS en la pgina 74

Desinstalacin de Adobe AIRUna vez instalado el motor de ejecucin, se puede desinstalar siguiendo los procedimientos que se explican a continuacin. Desinstalacin del motor de ejecucin en un ordenador con Windows 1 En el men Inicio de Windows, seleccione Configuracin > Panel de control.2 Abra los programas, programas y funciones o el panel de control para agregar o quitar programas (dependiendo de

la versin de Windows que ejecute).3 Seleccione Adobe AIR para desinstalar el motor de ejecucin. 4 Haga clic en el botn Cambiar o quitar.

Desinstalacin del motor de ejecucin en un ordenador con Mac Haga doble clic en el archivo de desinstalacin de Adobe AIR, que se encuentra en la carpeta /Aplicaciones/Utilidades. Desinstalacin del motor de ejecucin en un ordenador con Linux Realice uno de los siguientes pasos:

Seleccione el comandoDesinstalador de Adobe AIR en el men Aplicaciones. Ejecute el instalador de AIR con la opcin -uninstall. Elimine los paquetes de AIR (adobeair y adobecerts) con el administrador de paquetes.Elimine el motor de ejecucin del dispositivo de Android 1 Abra la aplicacin de configuracin en el dispositivo.2 Puntee en la entrada de Adobe AIR en Aplicaciones > Administrar aplicaciones. 3 Puntee el botn Desinstalar.

Tambin puede utilizar el comando -uninstallRuntime de ADT. Consulte el Comando uninstallRuntime de ADT en la pgina 165 para obtener ms informacin. Eliminacin de un paquete de motor de ejecucin Para eliminar un motor de ejecucin captador, debe eliminar la aplicacin con la que se haya instalado. Recuerde que los motores de ejecucin captadores slo se utilizan para ejecutar la aplicacin de instalacin.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

6

Instalacin y ejecucin de las aplicaciones de AIR de muestraPara instalar o actualizar una aplicacin de AIR, un usuario debe disponer de privilegios administrativos para el equipo. Hay algunas aplicaciones de muestra a disposicin 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. Estn a disposicin tanto las aplicaciones compiladas como

el cdigo fuente.2 Para descargar y ejecutar una aplicacin de muestra, haga clic en el botn Instalar ahora de la aplicacin. Un

mensaje indica instalar y ejecutar la aplicacin.3 Si opta por descargar aplicaciones de muestra y ejecutarlas ms adelante, seleccione los vnculos 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 aplicacin que se encuentra en el escritorio o seleccione laaplicacin en el men Inicio.

En Mac OS, haga doble clic en el icono de la aplicacin, que se instala por omisin en la carpeta Aplicaciones desu directorio de usuario (por ejemplo, en Macintosh HD/Usuarios/UsuarioFicticio/Aplicaciones/). Nota: revise las notas de versin de AIR por si hubiera alguna actualizacin de estas instrucciones. Puede encontrarlas en: http://www.adobe.com/go/learn_air_relnotes_es.

Actualizaciones de Adobe AIRDe forma peridica, Adobe actualiza Adobe AIR con nuevas funciones o soluciones para problemas menores. La funcin de actualizacin y notificacin automtica permite que Adobe avise automticamente a los usuarios del momento en que est disponible una versin actualizada de Adobe AIR. Las actualizaciones a Adobe AIR garantizan que la aplicacin funcione adecuadamente y a menudo contienen cambios importantes para la seguridad. Adobe recomienda que los usuarios actualicen a la versin ms reciente de Adobe AIR si existe una nueva versin disponible, especialmente cuando se implica la actualizacin de seguridad. De forma predeterminada, cuando se inicia una aplicacin de AIR, el motor de ejecucin comprueba si una actualizacin est disponible. Esta comprobacin se lleva a cabo si han pasado ms de dos semanas desde la ltima bsqueda de actualizaciones. Si alguna actualizacin est disponible, AIR la descarga en segundo plano. Los usuarios pueden desactivar la capacidad de actualizacin automtica, utilizando la aplicacin SettingsManager de AIR. La aplicacin SettingsManager de AIR est disponible para descarga en http://airdownload.adobe.com/air/applications/SettingsManager/SettingsManager.air. El proceso de instalacin normal de Adobe AIR incluye la conexin a http://airinstall.adobe.com para enviar la informacin bsica sobre el entorno de instalacin como, por ejemplo, idioma y versin del sistema operativo. Esta informacin slo se transmite una vez por instalacin y permite que Adobe pueda confirmar que la instalacin se ha realizado correctamente. No se transmitir ni se recopilar informacin de identificacin personal.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

7

Actualizacin de motores de ejecucin captadores Si distribuye la aplicacin con un paquete de motor de ejecucin captador, ste no se actualizar automticamente. Por seguridad de sus propios usuarios, debe supervisar las actualizaciones publicadas por Adobe y actualizar su aplicacin con la nueva versin del motor de ejecucin cuando se publiquen cambios de seguridad importantes.

ltima modificacin 3/2/2012

8

Captulo 3: Trabajo con las API de AIRAdobe 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:

Gua del desarrollador de ActionScript 3.0 Referencia de ActionScript 3.0 para la plataforma de Adobe FlashDesarrolladores de HTML Si est creando aplicaciones de AIR basadas en HTML, las API que estn 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 ingls) Adobe AIR API Reference for HTML Developers

Clases de ActionScript 3.0 especficas de AIRLas siguiente tabla contiene clases del motor de ejecucin son especficas de Adobe AIR. No estn disponibles para el contenido SWF que se ejecuta en Adobe Flash Player en el navegador. Desarrolladores de HTML Las clases que estn disponibles en JavaScript mediante el archivo AIRAliases.js se incluyen en Adobe AIR API Reference for HTML Developers.

Clase ARecord AAAARecord ApplicationUpdater ApplicationUpdaterUI AudioPlaybackMode AutoCapitalize BrowserInvokeEvent CameraPosition CameraRoll CameraRollBrowseOptions

Paquete de ActionScript 3.0 flash.net.dns flash.net.dns air.update air.update flash.media flash.text flash.events flash.media flash.media flash.media

Aadido en versin de AIR 2.0 2.0 1.5 1.5 3.0 3.0 1.0 3.0 2.0 3.0

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

9

Clase CameraUI CertificateStatus CompressionAlgorithm DatagramSocket DatagramSocketDataEvent DNSResolver DNSResolverEvent DockIcon DownloadErrorEvent DRMAuthenticateEvent DRMDeviceGroup DRMDeviceGroupErrorEvent DRMDeviceGroupEvent DRMManagerError EncryptedLocalStore ExtensionContext File FileListEvent FileMode FileStream FocusDirection GameInput GameInputControl GameInputControlType GameInputDevice GameInputEvent GameInputFinger GameInputHand Geolocation GeolocationEvent HTMLHistoryItem HTMLHost HTMLLoader HTMLPDFCapability

Paquete de ActionScript 3.0 flash.media flash.security flash.utils flash.net flash.events flash.net.dns flash.events flash.desktop air.update.events flash.events flash.net.drm flash.net.drm flash.net.drm flash.errors flash.data flash.external flash.filesystem flash.events flash.filesystem flash.filesystem flash.display flash.ui flash.ui flash.ui flash.ui flash.ui flash.ui flash.ui flash.sensors flash.events flash.html flash.html flash.html flash.html

Aadido en versin de AIR 2.5 2.0 1.0 2.0 2.0 2.0 2.0 1.0 1.5 1.0 3.0 3.0 3.0 1.5 1.0 2.5 1.0 1.0 1.0 1.0 1.0 3.0 3.0 3.0 3.0 3.0 3.0 3.0 2.0 2.0 1.0 1.0 1.0 1.0

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

10

Clase HTMLSWFCapabiltiy HTMLUncaughtScriptExceptionEvent HTMLWindowCreateOptions Icon IFilePromise ImageDecodingPolicy InteractiveIcon InterfaceAddress InvokeEvent InvokeEventReason IPVersion IURIDereferencer LocationChangeEvent MediaEvent MediaPromise MediaType MXRecord NativeApplication NativeDragActions NativeDragEvent NativeDragManager NativeDragOptions NativeMenu NativeMenuItem NativeProcess NativeProcessExitEvent NativeProcessStartupInfo NativeWindow NativeWindowBoundsEvent NativeWindowDisplayState NativeWindowDisplayStateEvent NativeWindowInitOptions NativeWindowRenderMode NativeWindowResize

Paquete de ActionScript 3.0 flash.html flash.events flash.html flash.desktop flash.desktop flash.system flash.desktop flash.net flash.events flash.desktop flash.net flash.security flash.events flash.events flash.media flash.media flash.net.dns flash.desktop flash.desktop flash.events flash.desktop flash.desktop flash.display flash.display flash.desktop flash.events flash.desktop flash.display flash.events flash.display flash.events flash.display flash.display flash.display

Aadido en versin de AIR 2.0 1.0 1.0 1.0 2.0 2.6 1.0 2.0 1.0 1.5.1 2.0 1.0 2.5 2.5 2.5 2.5 2.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 1.0 3.0 1.0

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

11

Clase NativeWindowSystemChrome NativeWindowType NetworkInfo NetworkInterface NotificationType OutputProgressEvent PaperSize PrintMethod PrintUIOptions PTRRecord ReferencesValidationSetting ResourceRecord RevocationCheckSettings Screen ScreenMouseEvent SecureSocket SecureSocketMonitor ServerSocket ServerSocketConnectEvent ServiceMonitor SignatureStatus SignerTrustSettings SocketMonitor SoftKeyboardType SQLCollationType SQLColumnNameStyle SQLColumnSchema SQLConnection SQLError SQLErrorEvent SQLErrorOperation SQLEvent SQLIndexSchema SQLMode

Paquete de ActionScript 3.0 flash.display flash.display flash.net flash.net flash.desktop flash.events flash.printing flash.printing flash.printing flash.net.dns flash.security flash.net.dns flash.security flash.display flash.events flash.net air.net flash.net flash.events air.net flash.security flash.security air.net flash.text flash.data flash.data flash.data flash.data flash.errors flash.events flash.errors flash.events flash.data flash.data

Aadido en versin de AIR 1.0 1.0 2.0 2.0 1.0 1.0 2.0 2.0 2.0 2.0 1.0 2.0 1.0 1.0 1.0 2.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 3.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

12

Clase SQLResult SQLSchema SQLSchemaResult SQLStatement SQLTableSchema SQLTransactionLockType SQLTriggerSchema SQLUpdateEvent SQLViewSchema SRVRecord StageAspectRatio StageOrientation StageOrientationEvent StageText StageTextInitOptions StageWebView StatusFileUpdateErrorEvent StatusFileUpdateEvent StatusUpdateErrorEvent StatusUpdateEvent StorageVolume StorageVolumeChangeEvent StorageVolumeInfo SystemIdleMode SystemTrayIcon TouchEventIntent UpdateEvent Updater URLFilePromise URLMonitor URLRequestDefaults XMLSignatureValidator

Paquete de ActionScript 3.0 flash.data flash.data flash.data flash.data flash.data flash.data flash.data flash.events flash.data flash.net.dns flash.display flash.display flash.events flash.text flash.text flash.media air.update.events air.update.events air.update.events air.update.events flash.filesystem flash.events flash.filesystem flash.desktop flash.desktop flash.events air.update.events flash.desktop air.desktop air.net flash.net flash.security

Aadido en versin de AIR 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 2.0 3.0 3.0 2.5 1.5 1.5 1.5 1.5 2.0 2.0 2.0 2.0 1.0 3.0 1.5 1.0 2.0 1.0 1.0 1.0

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

13

Clases de Flash Player con funcionalidad especfica de AIRLas siguientes clases estn disponibles para el contenido SWF que se ejecuta en el navegador, pero AIR ofrece propiedades o mtodos adicionales:Paquete Clase Propiedad, mtodo o evento Aadido en versin de AIR 2.0 1.0 1.0 2.0 1.0 1.0 1.0 1.0 2.0 2.0 1.0 2.0 2.0 2.0 2.0 2.0 2.6 2.6 2.0 2.6 2.6 2.6

flash.desktop

Clipboard ClipboardFormats

supportsFilePromise

BITMAP_FORMAT FILE_LIST_FORMATFILE_PROMISE_LIST_FORMAT URL_FORMAT

flash.display

LoaderInfo

childSandboxBridge parentSandboxBridge

Stage

assignFocus() autoOrients deviceOrientationnativeWindow

orientation Evento orientationChange Evento orientationChanging setAspectRatiosetOrientation

softKeyboardRect supportedOrientations supportsOrientationChange NativeWindow owner listOwnedWindows NativeWindowInitOptions owner

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

14

Paquete

Clase

Propiedad, mtodo o evento

Aadido en versin de AIR 1.0 1.0 2.6 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0

flash.events

Event

CLOSING DISPLAYING PREPARING EXITING HTML_BOUNDS_CHANGE HTML_DOM_INITIALIZE HTML_RENDER LOCATION_CHANGE NETWORK_CHANGE STANDARD_ERROR_CLOSE STANDARD_INPUT_CLOSE STANDARD_OUTPUT_CLOSE USER_IDLE USER_PRESENT

HTTPStatusEvent

HTTP_RESPONSE_STATUS responseHeaders responseURL

KeyboardEvent

commandKey controlKey

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

15

Paquete

Clase

Propiedad, mtodo o evento

Aadido en versin de AIR 1.0 1.0 1.0 1.0 1.5 1.5 1.0 1.0

flash.net

FileReference

extension httpResponseStatus event uploadUnencoded()

NetStream

Evento drmAuthenticate Evento onDRMContentDatapreloadEmbeddedData() resetDRMVouchers() setDRMAuthenticationCredent ials()

URLRequest

authenticate cacheResponse followRedirects idleTimeout manageCookies useCache userAgent

1.0 1.0 1.0 2.0 1.0 1.0 1.0 1.0

URLStream

Evento httpResponseStatus

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

16

Paquete

Clase

Propiedad, mtodo o evento

Aadido en versin de AIR 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 1.1 1.0 1.0 2.5

flash.printing

PrintJob

active copies firstPage isColor jobName lastPage maxPixelsPerInch paperArea printableArea printer printers selectPaperSize() showPageSetupDialog() start2() supportsPageSetupDialog terminate()

PrintJobOptions

pixelsPerInch printMethod

flash.system

Capabilities LoaderContext Security

languages allowLoadBytesCodeExecution APPLICATION

flash.ui

KeyLocation

D_PAD

La mayora de estos nuevos mtodos y propiedades slo estn disponibles para contenido que se encuentra en el entorno limitado de seguridad de la aplicacin de AIR. No obstante, los nuevos integrantes de las clases URLRequest tambin estn disponibles para el contenido que se ejecuta en otros entornos limitados. Los mtodos ByteArray.compress() y ByteArray.uncompress() incluyen cada uno un nuevo parmetro, algorithm, que permite seleccionar entre la compresin deflate y zlib. Este parmetro est disponible nicamente en el contenido que se ejecuta en AIR.

Componentes de Flex especficos de AIRLos siguientes componentes MX de Adobe Flex estn a disposicin cuando se desarrolla contenido para Adobe AIR:

FileEvent FileSystemComboBox FileSystemDataGrid ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

17

FileSystemEnumerationMode FileSystemHistoryButton FileSystemList FileSystemSizeDisplayMode FileSystemTree FlexNativeMenu HTML Window WindowedApplication WindowedSystemManagerAsimismo, Flex 4 incluye los siguientes componentes spark de AIR:

Window WindowedApplicationPara obtener ms informacin sobre los componentes de Flex para AIR, consulte Using the Flex AIR components (Uso de componentes de Flex para AIR).

ltima modificacin 3/2/2012

18

Captulo 4: Herramientas de la plataforma de Adobe Flash para el desarrollo de AIREs 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 Publicacin para AIR) SDK de Adobe Flex 3.x y 4.x (consulte Configuracin del SDK de Flex en la pgina 20 y AIR Developer Tool(ADT) en la pgina 154)

Adobe Flash Builder (consulte Desarrollo de aplicaciones de AIR con Flash Builder)Para desarrolladores de HTML y Ajax:

SDK de Adobe AIR (consulte Instalacin del SDK de AIR en la pgina 18 y AIR Developer Tool (ADT) en lapgina 154)

Adobe Dreamweaver CS3, CS4, CS5 (consulte Extensin de AIR para Dreamweaver)

Instalacin del SDK de AIREl SDK de Adobe AIR contiene las siguientes herramientas de la lnea 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 pgina 149.AIR Development Tool (ADT) Empaqueta aplicaciones de AIR en paquetes de instalacin distribuibles. Consulte AIR

Developer Tool (ADT) en la pgina 154. Las herramientas de la lnea de comandos de AIR requieren Java para su instalacin en el equipo. La mquina virtual Java se puede utilizar desde JRE o JDK (versin 1.5 o posterior). Java JRE y Java JDK se encuentran disponibles en http://java.sun.com/. Se requieren 2 GB de memoria como mnimo para ejecutar la herramienta ADT. Nota: Java no se requiere para los usuarios finales que ejecuten aplicaciones de AIR. Para obtener una breve descripcin general sobre la creacin de una aplicacin de AIR con el SDK de AIR, consulte Creacin de la primera aplicacin de AIR basada en HTML con el SDK de AIR en la pgina 36.

Descarga e instalacin del SDK de AIREl SDK de AIR se puede descargar e instalar utilizando las siguientes instrucciones: Instalacin del SDK de AIR en Windows Descargue el archivo de instalacin del SDK de AIR.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRHerramientas de la plataforma de Adobe Flash para el desarrollo de AIR

19

El SDK de AIR se distribuye como archivo estndar. Para instalar AIR, extraiga el contenido del SDK en una carpetadel 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; aada la ruta a esta carpeta a la variablede entorno PATH. Instalacin del SDK de AIR en Mac OS X Descargue el archivo de instalacin del SDK de AIR.

El SDK de AIR se distribuye como archivo estndar. Para instalar AIR, extraiga el contenido del SDK en una carpetadel equipo (por ejemplo: /Users//Applications/AIRSDK).

Las herramientas ADL y ADT se incluyen en la carpeta bin del SDK de AIR; aada la ruta a esta carpeta a la variablede entorno PATH. Instalacin 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 continuacin, utilice el siguientecomando: tar -jxvf Para obtener informacin sobre instrucciones para comenzar a utilizar las herramientas del SDK de AIR, consulte Creacin de aplicaciones de AIR con las herramientas de la lnea de comandos.

Componentes del SDK de AIREn la siguiente tabla se describen las funciones de los archivos incluidos en el SDK de AIR:Carpeta del SDK bin Descripcin de las herramientas/archivos AIR Debug Launcher (ADL) permite ejecutar una aplicacin de AIR sin empaquetarla e instalarla primero. Para obtener ms informacin sobre el uso de esta herramienta, consulte AIR Debug Launcher (ADL) en la pgina 149. AIR Developer Tool (ADT) empaqueta la aplicacin como archivo de AIR para distribucin. Para obtener informacin sobre el uso de esta herramienta, consulte AIR Developer Tool (ADT) en la pgina 154. frameworks El directorio libs contiene bibliotecas de cdigo para su uso en aplicaciones de AIR. El directorio projects contiene el cdigo para las bibliotecas SWF y SWC compiladas. include El directorio include contiene el archivo de encabezado del lenguaje C para escribir extensiones nativas. El directorio install contiene los controladores USB de Windows para dispositivos de Android. (Estos son los controladores proporcionados por Google en el SDK de Android.) Contiene el cdigo de compatibilidad para las herramientas del SDK de AIR.

install

lib

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRHerramientas de la plataforma de Adobe Flash para el desarrollo de AIR

20

Carpeta del SDK runtimes

Descripcin de las herramientas/archivos Los motores de ejecucin de AIR para los dispositivos mviles y de escritorio. ADL utiliza el motor de ejecucin para iniciar las aplicaciones de AIR antes de que se empaqueten o se instalen. Los motores de ejecucin 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 ejecucin pblico de AIR para Android est disponible en Android Market.)

samples

Esta carpeta contiene un archivo descriptor de la aplicacin de ejemplo, un ejemplo de la funcin de instalacin integrada (badge.swf) y los iconos de la aplicacin de AIR predeterminados. descriptor-template.xml: una plantilla del archivo descriptor de la aplicacin que es necesaria para todas las aplicaciones de AIR. Para obtener una descripcin detallada del archivo descriptor de la aplicacin, consulte Archivos descriptores de las aplicaciones de AIR en la pgina 191. Los archivos de esquema de la estructura XML del descriptor de la aplicacin para cada versin oficial de AIR tambin se encuentran en esta carpeta.

templates

Configuracin del SDK de FlexPara 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 proyectosde Adobe AIR y comprobar, depurar y empaquetar aplicaciones de AIR. Consulte Creacin de su primera aplicacin de AIR de Flex de escritorio en Flash Builder en la pgina 22

Puede descargar el SDK de Adobe Flex y desarrollar aplicaciones de AIR de Flex utilizando su editor de textofavorito y las herramientas de la lnea de comandos. Para obtener una breve descripcin general de la creacin de una aplicacin de AIR con el SDK de Flex, consulte Creacin de la primera aplicacin de AIR de escritorio con el SDK de Flex en la pgina 40.

Instalacin del SDK de FlexLa creacin de aplicaciones de AIR con las herramientas de la lnea de comandos requiere que Java est instalado en el equipo. La mquina virtual Java se puede utilizar desde JRE o JDK (versin 1.5 o posterior). El JRE y JDK de Java estn 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 lnea de comandos que se utilizan para empaquetar, compilar y depurar las aplicaciones de AIR.1 Si an 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, asegrese 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 ditto en la ventana de terminal para combinar el SDK de AIR con el SDK de Flex:dittoair_sdk_folder flex_sdk_folder

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRHerramientas de la plataforma de Adobe Flash para el desarrollo de AIR

21

4 Las utilidades de AIR de la lnea de comandos se encuentran en la carpeta bin.

Configuracin de los SDK externosEl 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 ms informacin sobre la descarga e instalacin 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 bsicos 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 creacin o ejecucin 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 ms informacin, consulte Obtencin de archivos de desarrollo de Apple.

ltima modificacin 3/2/2012

22

Captulo 5: Creacin de su primera aplicacin de AIRCreacin de su primera aplicacin de AIR de Flex de escritorio en Flash BuilderPara obtener unas indicaciones rpidas y prcticas sobre el funcionamiento de Adobe AIR, utilice estas instrucciones para crear y empaquetar una sencilla aplicacin Hello World de AIR basada en archivos SWF utilizando Adobe Flash Builder. Si an no lo ha hecho, descargue e instale Flash Builder. Asimismo, descargue e instale la versin ms reciente de Adobe AIR, que se encuentra en: www.adobe.com/go/air_es.

Creacin de un proyecto de AIRFlash Builder incluye las herramientas necesarias para desarrollar y empaquetar aplicaciones de AIR. La creacin 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 definicin 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 aplicacin. Se dispone de dos opciones:

Una aplicacin web que se ejecuta en Adobe Flash Player. Una aplicacin de escritorio que se ejecuta en Adobe AIR.Seleccione Escritorio como tipo de aplicacin.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 aplicacin (al que se hace referencia como archivo descriptor de la aplicacin). El ltimo archivo especifica las propiedades de la aplicacin. Para obtener ms informacin, consulte Developing AIR applications with Flash Builder (Desarrollo de aplicaciones de AIR con Flash Builder; en ingls).

Escritura del cdigo de aplicaciones de AIRPara escribir el cdigo de la aplicacin Hello World, se edita el archivo MXML de la aplicacin (AIRHelloWorld.mxml), que se abre en el editor. (Si el archivo no se abre, utilice el navegador de proyectos para abrir el archivo.)

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

23

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 bsicos como, por ejemplo, una barra de ttulo y un botn de cierre.1 Aada un atributo title al componente WindowedApplication y asgnele el valor "Hello World":

2 Aada un componente Label a la aplicacin (sitelo dentro de la etiqueta WindowedApplication), establezca la

propiedad text del componente Label en "Hello AIR" y defina restricciones de diseo para mantenerlo centrado, tal y como se muestra a continuacin:

3 Aada el siguiente bloque de estilo inmediatamente despus de la etiqueta inicial WindowedApplication y antes de

la etiqueta del componente label introduzca: @namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication { skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin"); background-color:#999999; background-alpha:"0.7"; }

Esta configuracin de estilo se aplica a toda la aplicacin y se procesa el fondo de la ventana con un gris ligeramente transparente. El cdigo de la aplicacin presenta en este momento el siguiente aspecto:

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

24

@namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication { skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin"); background-color:#999999; background-alpha:"0.7"; }

A continuacin, se modificar parte de la configuracin del descriptor de la aplicacin para permitir que la aplicacin sea transparente:1 En el panel Flex Navigator (Navegador de Flex), site el archivo descriptor de la aplicacin 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 aplicacin para editarlo en Flash Builder. 3 En el cdigo XML, site las lneas 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 continuacin:none

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

6 Guarde el archivo.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

25

Prueba de la aplicacin de AIRPara probar el cdigo de la aplicacin que se ha escrito, ejectelo en modo de depuracin.1 Haga clic en el botn Debug (Depurar)

de la barra de herramientas principal.

Tambin puede seleccionar el comando Run (Ejecutar) > Debug (Depurar) > AIRHelloWorld. La aplicacin 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 sita en el

centro de la ventana. Mueva o cambie el tamao de la ventana tal y como lo hara en cualquier otra aplicacin de escritorio. Nota: si la aplicacin no se compila, corrija la sintaxis o los errores ortogrficos que se hayan podido introducir accidentalmente en el cdigo. Los errores y advertencias se muestran en la vista Problems (Problemas) de Flash Builder.

Empaquetado, firma y ejecucin de una aplicacin de AIRAhora ya se puede empaquetar la aplicacin "Hello World" en un archivo de AIR para su distribucin. Un archivo de AIR es un archivo de almacenamiento que contiene los archivos de la aplicacin, 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 aplicacin. El paquete de AIR se distribuye a los usuarios, que posteriormente lo utilizan para instalar la aplicacin. Un paso necesario en este proceso consiste en firmarlo digitalmente.1 Compruebe que la aplicacin no presenta errores de compilacin y que se ejecuta correctamente. 2 Seleccione Project (Proyecto) > Export Release Version (Exportar versin oficial). 3 Compruebe que el proyecto AIRHelloWorld y la aplicacin AIRHelloWorld.mxml se incluyan para el proyecto y

la aplicacin.4 Seleccione Exportar como opcin de paquete de AIR firmado. A continuacin, haga clic en Siguiente. 5 Si ya dispone de un certificado digital existente, haga clic en Examinar y seleccinelo. 6 Si debe crear un nuevo certificado digital con firma automtica, seleccione Crear. 7 Introduzca la informacin necesaria y haga clic en Aceptar. 8 Haga clic en Finalizar para generar el paquete de AIR denominado AIRHelloWorld.air.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

26

Ahora puede instalar y ejecutar la aplicacin desde Project Navigator (Navegador de proyectos) en Flash Builder o desde el sistema de archivos haciendo doble clic en el archivo de AIR.

Creacin de la primera aplicacin de AIR de escritorio con Flash ProfessionalA continuacin se resume la demostracin del funcionamiento de Adobe AIR. Siga las instrucciones de este tema para crear y empaquetar una sencilla aplicacin Hello World de AIR con Adobe Flash Professional. Si an no lo ha hecho, descargue e instale Adobe AIR, que se encuentra aqu: http://www.adobe.com/es/products/air/.

Creacin de la aplicacin Hello World en FlashCrear una aplicacin de Adobe AIR en Flash es muy similar a crear cualquier otro archivo FLA. El siguiente procedimiento le guiar en el proceso de creacin de una sencilla aplicacin Hello World con Flash Professional. Para crear la aplicacin Hello World 1 Inicie Flash.2 En la pantalla de bienvenida, haga clic en AIR para crear un archivo FLA vaco con configuracin de publicacin

de Adobe AIR.3 Seleccione la herramienta Texto en el panel Herramientas y cree un campo de texto esttico (valor predeterminado)

en el centro del escenario. Dele una anchura suficiente para que pueda contener entre 15 y 20 caracteres.4 Escriba el texto Hello World en el campo de texto. 5 Guarde el archivo y asgnele un nombre (por ejemplo, HelloAIR).

Prueba de la aplicacin1 Presione Ctrl + Intro o seleccione Control -> Probar pelcula ->Probar para probar la aplicacin en Adobe AIR. 2 Para utilizar la funcin Depurar pelcula, aada primero cdigo ActionScript a la aplicacin. Puede intentarlo

rpidamente aadiendo una sentencia trace como sta:trace("Running AIR application using Debug Movie");

3 Presione Ctrl + Mays + Intro o seleccione Depurar -> Depurar pelcula para ejecutar la aplicacin con Depurar

pelcula.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

27

La aplicacin Hello World se asemeja a la de la ilustracin:

Empaquetado de la aplicacin1 Seleccione Archivo > Publicar. 2 Firme el paquete de Adobe AIR con un certificado digital existente o cree un certificado con firma automtica

utilizando los siguientes pasos:a Haga clic en el botn Nuevo situado junto al campo Certificado. b Rellene los campos Nombre del editor, Unidad de organizacin, Nombre de organizacin, Correo electrnico,

Pas, Contrasea y Confirmar contrasea.c Especifique el tipo de certificado. La opcin Tipo de certificado hace referencia al nivel de seguridad: 1024-RSA

utiliza una clave de 1.024 bits (menos segunda) y 2048-RSA utiliza una clave de 2048 bits (ms segura).d Guarde la informacin en un archivo de certificado en la opcin Guardar como o haciendo clic en el botn

Examinar... para acceder a la ubicacin de la carpeta. (Por ejemplo, C:/Temp/mycert.pfx). Cuando haya terminado, haga clic en Aceptar.e Flash regresa al cuadro de dilogo Firma digital. La ruta y el nombre de archivo del certificado con firma

automtica creado aparece ahora en el cuadro de texto Certificado. Si no es as, introduzca la ruta y el nombre de archivo o haga clic en el botn Examinar para encontrarlo y seleccionarlo.f

Indique la misma contrasea en el campo de texto Contrasea del cuadro de dilogo Firma digital que la que se asign en el paso b. Para obtener ms informacin sobre la firma de las aplicaciones de Adobe AIR, consulte Firma digital de archivos de AIR en la pgina 177.

3 Para crear el archivo aplicacin y el instalador, haga clic en el botn Publicar. (En Flash CS4 y CS5, haga clic en el

botn Aceptar.) Debe ejecutar los comandos Probar pelcula o Depurar pelcula para crear los archivos SWF y application.xml antes de crear el archivo de AIR.4 Para instalar la aplicacin, haga doble clic en el archivo de AIR (application.air) en la misma carpeta en la que

guard la aplicacin.5 Haga clic en el botn Instalar del cuadro de dilogo Instalacin de la aplicacin.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

28

6 Revise los parmetros de Preferencias de instalacin y Ubicacin y asegrese de que la casilla de verificacin Iniciar

aplicacin tras la instalacin est seleccionada. A continuacin, haga clic en Continuar.7 Haga clic en Finalizar cuando aparezca el mensaje Instalacin completada.

Creacin de su primera aplicacin de AIR para Android en Flash ProfessionalPara desarrollar aplicaciones de AIR para Android, se debe descargar la extensin de Flash Professional CS5 para Android de Adobe Labs. Tambin se debe descargar e instalar el SDK de Android en el sitio web de Android, tal y como se describe en: Android Developers: Installing the SDK (Desarrolladores de Android: Instalacin del SDK; en ingls). Creacin de un proyecto 1 Abra Flash Professional CS52 Cree un nuevo proyecto de AIR para Android.

La pantalla de inicio de Flash Professional incluye un vnculo que crea una aplicacin de AIR para Android. Tambin puede seleccionar Archivo > Nuevo > y despus seleccionar la plantilla de AIR para Android.3 Guarde el documento como HelloWorld.fla.

Escritura del cdigo Debido a que el tutorial trata realmente sobre la escritura de cdigo, utilice nicamente la herramienta Texto para escribir "Hello, World!" en el escenario. Definicin de las propiedades de la aplicacin 1 Seleccione Archivo > Configuracin de Android de AIR.2 En la ficha General, establezca los siguientes ajustes:

Archivo de salida: HelloWorld.apk Nombre de la aplicacin: HelloWorld ID de la aplicacin: HelloWorld Nmero de versin: 0.0.1 Proporcin de aspecto: vertical3 En la ficha Implementacin, establezca los siguientes ajustes:

Certificado: hace referencia a un certificado de firma de cdigo de AIR vlido. Puede hacer clic en el botn Crearpara crear un nuevo certificado. (Las aplicaciones de Android implementadas a travs de Android Marketplace deben contar con certificados que sean vlidos hasta el 2033 como mnimo.) Indique la contrasea del certificado en el campo Contrasea.

Tipo de implementacin de Android: Depuracin Tras la publicacin: Seleccin de ambas opciones Introduzca la ruta a la herramienta ADB en el subdirectorio de herramientas del SDK de Android.4 Cierre del cuadro de dilogo de ajustes de Android haciendo clic en Aceptar.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

29

La aplicacin no necesita iconos ni permisos en esta etapa de su desarrollo. La mayora de las aplicaciones de AIR para Android requieren algunos permisos para poder acceder a funciones protegidas. Slo se deben establecer aquellos permisos que la aplicacin requiera realmente debido a que los usuarios pueden rechazar la aplicacin si sta solicita demasiados permisos.5 Guarde el archivo.

Empaquetado e instalacin de la aplicacin en el dispositivo de Android 1 Asegrese de que la depuracin de USB est activada en el dispositivo. La depuracin USB se puede activar en Aplicaciones > Desarrollo.2 Conecte el dispositivo al equipo mediante un cable USB. 3 Instale el motor de ejecucin de AIR, si an no lo ha hecho, dirigindose a Android Market y descargando Adobe

AIR. (Tambin puede instalar AIR localmente utilizando el comando Comando installRuntime de ADT en la pgina 164 de ADT. Los paquetes de Android para su uso en dispositivos de Android y los emuladores se incluyen en el SDK de AIR.)4 Seleccione Archivo > Publicar.

Flash Professional crea el archivo APK, instala la aplicacin en el dispositivo de Android conectado y lo inicia.

Creacin de su primera aplicacin de AIR para iOSAIR 2.6 o posterior, iOS 4.2 o posterior Puede codificar, crear y probar las funciones bsicas de una aplicacin de iOS utilizando slo herramientas de Adobe. Sin embargo, para instalar una aplicacin de iOS en un dispositivo y distribuirla, debe unirse al programa Apple iOS Developer (servicio de pago). Una vez que se una al programa iOS Developer, puede acceder a iOS Provisioning Portal donde podr obtener los siguientes elementos y archivos de Apple que son necesarios para instalar una aplicacin en un dispositivo para prueba y para la distribucin posterior. Entre estos elementos y archivos se incluyen:

Certificados de distribucin y desarrollo ID de la aplicacin Archivos de suministro de distribucin y desarrollo

Creacin del contenido de la aplicacin.Cree un archivo SWF que muestre el texto Hello world! Esta tarea se puede realizar utilizando Flash Professional, Flash Builder u otro IDE. En este ejemplo simplemente se utiliza un editor de texto y el compilador SWF de la lnea de comandos incluido en el SDK de Flex.1 Cree un directorio en una ubicacin adecuada para almacenar los archivos de la aplicacin. Cree un archivo

denominado HelloWorld.as y edtelo en su editor de cdigo favorito.2 Aada el siguiente cdigo:

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

30

package{ import import import import flash.display.Sprite; flash.text.TextField; flash.text.TextFormat; flash.text.TextFieldAutoSize;

public class HelloWorld extends Sprite { public function HelloWorld():void { var textField:TextField = new TextField(); textField.text = "Hello World!"; textField.autoSize = TextFieldAutoSize.LEFT; var format:TextFormat = new TextFormat(); format.size = 48; textField.setTextFormat ( format ); this.addChild( textField ); } } }

3 Compile la clase utilizando el compilador amxmlc:amxmlc HelloWorld.as

Un archivo SWF, HelloWorld.swf, se crea en la misma carpeta. Nota: en este ejemplo se da por sentado que ha configurado la variable de ruta de su entorno para que incluya el directorio que contiene amxmlc. Para obtener informacin sobre la configuracin de la ruta, consulte Variables del entorno de ruta en la pgina 290. Como alternativa, es posible indicar la ruta completa en amxmlc y las otras herramientas de la lnea de comandos utilizadas en este ejemplo.

Creacin de grficos de iconos y de la pantalla inicial de la aplicacinTodas las aplicaciones para iOS tienen iconos que aparecen en la interfaz de la aplicacin iTunes y en la pantalla del dispositivo.1 Cree un directorio en el directorio del proyecto y llmelo icons. 2 Cree tres archivos PNG en el directorio de iconos. Llmelos Icon_29.png, Icon_57.png e Icon_512.png. 3 Edite los archivos PNG para crear los grficos que desee para la aplicacin. Los archivos deben tener 29x29, 57x57

y 512x512 pxeles. Para esta prueba, basta con usar cuadrados de color slido como grficos. Nota: cuando se enva una aplicacin al App Store de Apple, se utiliza una versin JPG (no PNG) del archivo de 512 pxeles. Utilizar la versin PNG durante las versiones de desarrollo de pruebas de la aplicacin. Todas las aplicaciones para iPhone muestran una pgina inicial mientras se carga en el iPhone. Puede definir la imagen inicial en un archivo PNG:1 En el directorio de desarrollo principal, cree un archivo PNG llamado Default.png. (No coloque este archivo en un

subdirectorio de iconos.) Es importante que el nombre sea Default.png, con D mayscula.)2 Edite el archivo para que tenga 320 pxeles de ancho por 480 pxeles de alto. De momento, el contenido puede ser

un rectngulo blanco sencillo. (Lo cambiaremos ms adelante.) Para obtener informacin detallada sobre estos grficos, consulte Iconos de la aplicacin en la pgina 89.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

31

Creacin del archivo descriptor de la aplicacinCree un archivo descriptor de la aplicacin que especifique las propiedades bsicas de la aplicacin. Esta tarea se puede completar utilizando un IDE como, por ejemplo, Flash Builder o un editor de texto.1 En la carpeta del proyecto que contiene HelloWorld.as, cree un archivo XML denominado, HelloWorld-app.xml.

Edite este archivo en el editor de XML favorito.2 Aada el siguiente cdigo XML: change_to_your_id Hello World iOS 0.0.1 HelloWorld mobileDevice HelloWorld.swf Hello World! icons/AIRApp_29.png icons/AIRApp_57.png icons/AIRApp_512.png

Por motivos de simplicidad, en este ejemplo slo se establecen algunas de las propiedades disponibles. Nota: si est utilizando AIR 2 o anterior, debe usar el elemento en lugar de .3 Cambie el ID de la aplicacin para que coincida con el ID especificado en iOS Provisioning Portal. (No incluya la

parte raz del paquete aleatoria al principio del ID.4 Pruebe la aplicacin utilizando ADL:adl HelloWorld-app.xml -screensize iPhone

ADL debe abrir una ventana en el escritorio que muestre el texto: Hello World! Si no es as, compruebe el descriptor de la aplicacin y el cdigo fuente para localizar errores.

Compilacin del archivo IPAAhora puede compilar el archivo de instalacin IPA utilizando ADT. Debe contar con el certificado de desarrollador de Apple y la clave privada en formato de archivo P12 y el archivo de suministro de desarrollo de Apple. Ejecute la utilidad ADT con las siguientes opciones, sustituyendo el almacn de claves, la contrasea para acceder al almacn y los valores del perfil de suministro con los suyos propios:adt -package -target ipa-debug -keystore iosPrivateKey.p12 -storetype pkcs12 -storepass qwerty12 -provisioning-profile ios.mobileprovision HelloWorld.ipa HelloWorld-app.xml HelloWorld.swf icons Default.png

(Utilice una sola lnea de comandos; los saltos de lnea de este ejemplo slo se aaden para facilitar la lectura.)

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

32

ADT genera el archivo instalador de la aplicacin de iOS, HelloWorld.ipa, en el directorio del proyecto. La compilacin del archivo IPA puede tardar varios minutos.

Instalacin de la aplicacin en un dispositivoPara instalar la aplicacin de iOS para prueba:1 Abra la aplicacin iTunes. 2 Si an no lo ha hecho, aada el archivo de suministro de esta aplicacin a iTunes. En iTunes, seleccione Archivo >

Aadir a la biblioteca. Posteriormente, seleccione el archivo de suministro (que tendr mobileprovision como tipo de archivo provisional). Por ahora, para probar la aplicacin en su dispositivo de desarrollador, utilice el perfil de suministro de desarrollo. Ms adelante, cuando distribuya aplicaciones a iTunes Store, utilizar el perfil de distribucin. Para distribuir la aplicacin ad hoc (a varios dispositivos sin tener que pasar por iTunes Store), utilice el archivo de suministro ad hoc. Para obtener ms informacin sobre el suministro de perfiles, consulte Configuracin de iOS en la pgina 70.3 Algunas versiones de iTunes no sustituyen la aplicacin si ya est instalada la misma versin. En ese caso, elimine

la aplicacin del dispositivo y de la lista de aplicaciones de iTunes.4 Haga doble clic en el archivo IPA de su aplicacin. Debe aparecer en la lista de aplicaciones en iTunes. 5 Conecte el dispositivo al puerto USB del equipo. 6 En iTunes, compruebe la ficha Aplicaciones del dispositivo y verifique que la aplicacin aparece seleccionada en la

lista de aplicaciones para instalar.7 Seleccione el dispositivo en la lista de la izquierda de la aplicacin iTunes. Haga clic en el botn Sincronizar.

Cuando finalice la sincronizacin, la aplicacin Hello World aparecer en el iPhone. Si no tiene instalada la versin ms reciente, elimnela del dispositivo y de la lista de aplicaciones de iTunes y vuelva a realizar este procedimiento. Puede darse el caso si la versin instalada utiliza el mismo ID y versin que la aplicacin existente.

Edicin de los grficos de la pantalla inicialRecuerde que antes de compilar la aplicacin, cre un archivo Default.png (consulte la seccin Creacin de grficos de iconos y de la pantalla inicial de la aplicacin en la pgina 30). Este archivo PNG sirve de imagen inicial cuando se carga la aplicacin. Al probar la aplicacin en el iPhone, probablemente se haya dado cuenta de que la pantalla inicial aparece en blanco. Debe cambiar esta imagen para que coincida con la pantalla de inicio de la aplicacin (Hello World!):1 Abra la aplicacin en el dispositivo. Cuando aparezca el primer texto Hello World, pulse el botn Inicio (debajo

de la pantalla) y no lo suelte. Con el botn Inicio presionado, pulse el botn de encendido/reposo (en la parte superior del iPhone). De este modo har una captura de pantalla y enviar la imagen al Carrete.2 Transfiera la imagen al equipo de desarrollo desde iPhoto u otra aplicacin de transferencia de fotografas. (En Mac

OS, tambin puede utilizar la aplicacin Instantnea.) Tambin puede enviar la fotografa al equipo de desarrollo por correo electrnico:

Abra la aplicacin Fotos. Abra el Carrete. Abra la captura de pantalla que realiz anteriormente.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

33

Toque la imagen y luego toque el botn reenviar (flecha) situado en la esquina inferior izquierda.Seguidamente, toque el botn Enviar foto y envese la fotografa a usted mismo.3 Reemplace el archivo Default.png (en su directorio de desarrollo) por una versin PNG de la imagen de la captura

de pantalla.4 Vuelva a compilar la aplicacin (consulte la seccin Compilacin del archivo IPA en la pgina 31) y reinstlela

en el dispositivo. La aplicacin utilizar la nueva pantalla de inicio cuando se cargue. Nota: puede crear cualquier grfico que quiera para el archivo Default.png, siempre y cuando tenga las dimensiones correctas (320 x 480 pxeles). No obstante, suele ser mejor que la imagen del archivo Default.png coincida con el estado inicial de la aplicacin.

Creacin de la primera aplicacin de AIR basada en HTML con DreamweaverPara obtener unas indicaciones rpidas y prcticas sobre el funcionamiento de Adobe AIR, utilice estas instrucciones para crear y empaquetar una sencilla aplicacin Hello World de AIR basada en HTML utilizando la extensin de Adobe AIR para Dreamweaver. Si an no lo ha hecho, descargue e instale Adobe AIR, que se encuentra aqu: http://www.adobe.com/es/products/air/. Para obtener instrucciones sobre la instalacin de la extensin de Adobe AIR para Dreamweaver, consulte Instalacin de la extensin de AIR para Dreamweaver. Para obtener informacin general sobre la extensin, incluyendo los requisitos del sistema, consulte Extensin de AIR para Dreamweaver. Nota: las aplicaciones de AIR basadas en HTML slo se pueden desarrollar para los perfiles extendedDesktop y de escritorio. Los perfiles mviles y de tv no se admiten.

Preparacin de los archivos de la aplicacinLa aplicacin de Adobe AIR debe contar con una pgina de inicio y todas sus pginas relacionadas definidas en un sitio de Dreamweaver.1 Inicie Dreamweaver y asegrese de disponer de un sitio definido. 2 Abra una nueva pgina HTML seleccionando Archivo > Nuevo, elija HTML en la columna Tipo de pgina,

seleccione Ninguno en la columna Diseo y haga clic en Crear.3 En la nueva pgina, escriba Hello World!

Este ejemplo es muy sencillo, pero, si lo desea, puede aplicar el estilo que desee al texto, aadir ms contenido a la pgina, vincular otras pginas a esta pgina de inicio, etc.4 Guarde la pgina (Archivo > Guardar) como hello_world.html. Compruebe que el archivo se guarda en un sitio de

Dreamweaver. (Para obtener ms informacin sobre los sitios de Dreamweaver, consulte la ayuda de Dreamweaver.)

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

34

Creacin de una aplicacin de Adobe AIR1 Compruebe que la pgina hello_world.html est abierta en la ventana de documento de Dreamweaver. (Consulte

la seccin anterior para obtener instrucciones sobre cmo crearla.)2 Seleccione Sitio > Configuracin de la aplicacin de Air.

La mayor parte de las opciones de configuracin necesarias del cuadro de dilogo AIR - Configuracin de aplicacin e instalador se encuentran seleccionadas automticamente. Sin embargo, se debe seleccionar el contenido inicial (o pgina de inicio) de la aplicacin.3 Haga clic en el botn Examinar situado junto a la opcin Contenido inicial, desplcese a la pgina hello_world.html

y seleccinela.4 Junto a la opcin Firma digital, haga clic en el botn Definir.

Con la firma digital se garantiza que el cdigo de una aplicacin no se ha alterado ni daado desde su creacin por parte del autor del software y es necesaria en todas las aplicaciones de Adobe AIR.5 En el cuadro de dilogo Firma digital, seleccione Firmar el paquete de AIR con un certificado digital y haga clic en

el botn Crear. (Si ya tiene acceso a un certificado digital, puede hacer clic en el botn Examinar para seleccionarlo.)6 Complete los campos necesarios del cuadro de dilogo Certificado digital con firma automtica. Debe indicar su

nombre, una contrasea y su confirmacin, as como un nombre para el archivo de certificado digital. Dreamweaver guarda el certificado digital en la raz del sitio.7 Haga clic en Aceptar para volver al cuadro de dilogo Firma digital. 8 En el cuadro de dilogo Firma digital, indique la contrasea especificada para el certificado digital y haga clic en

Aceptar.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

35

El cuadro de dilogo completo AIR - Configuracin de aplicacin e instalador puede presentar el siguiente aspecto:

Para obtener ms informacin sobre todas las opciones del cuadro de dilogo y cmo modificarlas, consulte Creacin de una aplicacin de AIR en Dreamweaver.9 Haga clic en el botn Crear archivo de AIR.

Dreamweaver crea el archivo de la aplicacin de Adobe AIR y lo guarda en la carpeta raz del sitio. Dreamweaver tambin crea un archivo application.xml y lo guarda en el mismo lugar. Este archivo sirve como manifiesto y define distintas propiedades de la aplicacin.

Instalacin de la aplicacin en el escritorioUna vez creado el archivo de aplicacin, puede instalarlo en cualquier escritorio.1 Desplace el archivo de aplicacin de Adobe AIR fuera del sitio de Dreamweaver y llvelo al escritorio deseado.

Este paso es opcional. Si lo prefiere, puede instalar la nueva aplicacin en el equipo directamente desde el directorio del sitio de Dreamweaver.2 Haga doble clic en el archivo ejecutable de la aplicacin (archivo .air) para instalarla.

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

36

Vista previa de una aplicacin de Adobe AIRSe puede obtener una vista previa de las pginas que formarn parte de las aplicaciones de AIR en cualquier momento. Es decir, no necesariamente se debe empaquetar la aplicacin antes de ver su aspecto cuando se instale.1 Compruebe que la pgina hello_world.html est abierta en la ventana de documento de Dreamweaver. 2 En la barra de herramientas Documento, haga clic en el botn de previsualizacin/depuracin en el navegador y, a

continuacin, seleccione Vista previa en AIR. Tambin puede presionar Ctrl+Mays+F12 (Windows) o Cmd+Mays+F12 (Macintosh). Al obtener una vista previa de esta pgina, fundamentalmente se est viendo lo que vera un usuario como pgina de inicio de la aplicacin una vez instalada en un escritorio.

Creacin de la primera aplicacin de AIR basada en HTML con el SDK de AIRPara obtener unas indicaciones rpidas y prcticas sobre el funcionamiento de Adobe AIR, utilice estas instrucciones para crear y empaquetar una sencilla aplicacin Hello World de AIR basada en HTML. Para comenzar, debe tener instalado el motor de ejecucin y configurar el SDK de AIR. En este tutorial utilizar AIR Debug Launcher (ADL) y AIR Developer Tool (ADT). ADL y ADT son programas de utilidades de lnea de comandos y se pueden encontrar en el directorio bin del SDK de AIR (consulte Instalacin del SDK de AIR en la pgina 18). En este tutorial se asume que est familiarizado con la ejecucin de programas desde la lnea de comandos y que conoce cmo configurar las variables del entorno de ruta necesarias para el sistema operativo. Nota: si es usuario de Dreamweaver, consulte Creacin de la primera aplicacin de AIR basada en HTML con Dreamweaver en la pgina 33. Nota: Las aplicaciones de AIR basadas en HTML slo se pueden desarrollar para los perfiles extendedDesktop y de escritorio. Los perfiles mviles y de tv no se admiten.

Creacin de archivos del proyectoTodos los proyectos de AIR basados en HTML deben incluir los siguientes archivos: un archivo descriptor de la aplicacin, que especifica los metadatos de la aplicacin y una pgina HTML de nivel superior. Adems de estos archivos necesarios, este proyecto incluye un archivo de cdigo JavaScript, AIRAliases.js, que define las variables de alias adecuadas para las clases de API de AIR.1 Cree un directorio denominado HelloWorld para que incluya los archivos del proyecto. 2 Cree un archivo XML, denominado HelloWorld-app.xml. 3 Cree un archivo HTML denominado HelloWorld.html. 4 Copie AIRAliases.js de la carpeta frameworks del SDK de AIR al directorio project.

Creacin del archivo descriptor de la aplicacin de AIRPara comenzar a crear la aplicacin de AIR, cree un archivo descriptor de la aplicacin XML con la siguiente estructura:

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

37

1 Abra HelloWorld-app.xml para la edicin. 2 Aada el elemento raz , incluyendo el atributo de espacio de nombres de AIR:

El ltimo segmento del espacio de nombres, 2.7, especifica la versin del motor de ejecucin que requiere la aplicacin.3 Aada el elemento :

examples.html.HelloWorld El ID de la aplicacin la identifica de forma exclusiva junto con el ID de editor (que AIR obtiene del certificado utilizado para firmar el paquete de la aplicacin). El ID de la aplicacin se utiliza para la instalacin, el acceso al directorio privado de almacenamiento del sistema de archivos de la aplicacin, el acceso al almacenamiento cifrado privado y la comunicacin entre aplicaciones.4 Agregue el elemento :

0.1Ayuda a los usuarios a determinar qu versin de la aplicacin se est instalando. Nota: si est utilizando AIR 2 o anterior, debe usar el elemento en lugar de .5 Agregue el elemento :

HelloWorld Nombre utilizado para el ejecutable de la aplicacin, el directorio de instalacin y otras referencias a la aplicacin en el sistema operativo.6 Aada el elemento que contiene los siguientes elementos secundarios para especificar las

propiedades de la ventana de la aplicacin inicial: HelloWorld.html Identifica el archivo HTML raz para que se cargue AIR. true Hace visible a la ventana de forma inmediata. 400 Establece la anchura de la ventana (en pxeles). 200 Establece la altura de la ventana.7 Guarde el archivo. El archivo descriptor de la aplicacin completo debe presentar el siguiente aspecto:

ltima modificacin 3/2/2012

CREACIN DE APLICACIONES DE ADOBE AIRCreacin de su primera aplicacin de AIR

38

examples.html.HelloWorld 0.1 HelloWorld HelloWorld.html true 400 200

En este ejemplo slo se establecen unas cuantas de las posibles propiedades de la aplicacin. Para obtener el conjunto completo de las propiedades de la aplicacin, que permiten especificar determinados aspectos, como el tamao y el fondo cromtico de la ventana, la transparencia, el directorio de instalacin predeterminado, los tipos de archivo asociados y los iconos de la aplicacin, consulte Archivos descriptores de las aplicaciones de AIR en la pgina 191.

Creacin de la