air buildingapps

323
Creación de aplicaciones de ADOBE ® AIR ®

Upload: dandczdcz

Post on 01-Dec-2015

77 views

Category:

Documents


5 download

TRANSCRIPT

  • Creacin deaplicaciones de ADOBE AIR

  • ltima modificacin 24/6/2013

    Avisos legales

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

  • iii

    ltima modificacin 24/6/2013

    Contenidos

    Captulo 1: Acerca de Adobe AIR

    Captulo 2: Instalacin de Adobe AIRInstalacin de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

    Desinstalacin de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    Instalacin y ejecucin de las aplicaciones de AIR de muestra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

    Actualizaciones de Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

    Captulo 3: Trabajo con las API de AIRClases de ActionScript 3.0 especficas de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

    Clases de Flash Player con funcionalidad especfica de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

    Componentes de Flex especficos de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

    Captulo 4: Herramientas de la plataforma de Adobe Flash para el desarrollo de AIRInstalacin del SDK de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

    Configuracin del SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    Configuracin de los SDK externos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

    Captulo 5: Creacin de su primera aplicacin de AIRCreacin de su primera aplicacin de AIR de Flex de escritorio en Flash Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

    Creacin de la primera aplicacin de AIR de escritorio con Flash Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

    Creacin de su primera aplicacin de AIR para Android en Flash Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

    Creacin de su primera aplicacin de AIR para iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    Creacin de la primera aplicacin de AIR basada en HTML con Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

    Creacin de la primera aplicacin de AIR basada en HTML con el SDK de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

    Creacin de la primera aplicacin de AIR de escritorio con el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

    Creacin de la primera aplicacin de AIR para Android con el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

    Captulo 6: Desarrollo de aplicaciones de AIR para el escritorioFlujo de trabajo para el desarrollo de una aplicacin de escritorio de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

    Configuracin de las propiedades de una aplicacin de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

    Depuracin de una aplicacin de AIR de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

    Empaquetado de un archivo de instalacin de AIR de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

    Empaquetado de un instalador nativo de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    Empaquetado de un paquete de motor de ejecucin captador para equipos de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    Distribucin de paquetes de AIR para equipos de escritorio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

    Captulo 7: Desarrollo de aplicaciones de AIR para dispositivos mvilesConfiguracin del entorno de desarrollo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

    Consideraciones sobre el diseo de aplicaciones mviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

    Flujo de trabajo para crear aplicaciones de AIR para dispositivos mviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

    Configuracin de las propiedades de una aplicacin mvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

    Empaquetado de una aplicacin de AIR mvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

    Depuracin de una aplicacin de AIR mvil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

  • ivCREACIN DE APLICACIONES DE ADOBE AIRContenidos

    ltima modificacin 24/6/2013

    Instalacin de AIR y aplicaciones de AIR en dispositivos mviles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

    Actualizacin de aplicaciones mviles de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

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

    Captulo 8: Desarrollo de aplicaciones de AIR para dispositivos de televisinFunciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

    Consideraciones de diseo de las aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

    Flujo de trabajo para desarrollar una aplicacin de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

    Propiedades del descriptor de la aplicacin de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

    Empaquetado de una aplicacin de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

    Depuracin de aplicaciones de AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

    Captulo 9: Uso de extensiones nativas para Adobe AIRArchivos de extensin 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 extensin nativa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

    Declaracin de la extensin en el archivo descriptor de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

    Inclusin del archivo ANE en la ruta de la biblioteca de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

    Empaquetado de una aplicacin con extensiones nativas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

    Captulo 10: Compiladores de ActionScriptInformacin sobre las herramientas de la lnea de comandos de AIR en el SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

    Configuracin del compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

    Compilacin de archivos de origen MXML y ActionScript para AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

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

    Captulo 11: AIR Debug Launcher (ADL)Uso de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

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

    Cdigos de error y de salida de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

    Captulo 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

    Captulo 13: Firma de aplicaciones de AIRFirma digital de archivos de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

    Creacin de archivos intermedios sin firmar de AIR con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

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

    Firma de una versin actualizada de una aplicacin de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

    Creacin de certificados con firma automtica con ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

  • vCREACIN DE APLICACIONES DE ADOBE AIRContenidos

    ltima modificacin 24/6/2013

    Captulo 14: Archivos descriptores de las aplicaciones de AIRCambios en el descriptor de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

    Estructura del archivo descriptor de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

    Elementos del descriptor de la aplicacin de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

    Captulo 15: Perfiles de dispositivoRestriccin de perfiles de destino en el archivo descriptor de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

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

    Captulo 16: API en navegador AIR.SWFPersonalizacin del archivo badge.swf de instalacin integrada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

    Utilizacin del archivo badge.swf para instalar una aplicacin de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

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

    Cmo comprobar si est instalado el motor de ejecucin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

    Cmo comprobar desde una pgina web si una aplicacin de AIR est instalada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

    Instalacin de una aplicacin de AIR desde el navegador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

    Inicio desde el navegador de una aplicacin de AIR instalada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

    Captulo 17: Actualizacin de aplicaciones de AIRActualizacin de aplicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

    Presentacin de una interfaz de usuario personalizada para las actualizaciones de la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . 270

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

    Comprobar si una aplicacin se est ejecutando por primera vez . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

    Utilizacin del marco de actualizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

    Captulo 18: Visualizacin de cdigo fuenteCarga, configuracin y apertura del visor de cdigo fuente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

    Interfaz de usuario del visor de cdigo fuente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

    Captulo 19: Depuracin con el introspector HTML de AIRIntrospector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

    Carga del cdigo del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

    Inspeccin de un objeto en la ficha Console (Consola) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

    Configuracin del introspector de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

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

    Utilizacin del introspector de AIR con contenido en un entorno limitado ajeno a la aplicacin . . . . . . . . . . . . . . . . . . . . . . . . 302

    Captulo 20: Localizacin de aplicaciones de AIRLocalizacin del nombre y la descripcin en el instalador de aplicaciones de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

    Localizacin de contenido HTML con la arquitectura de localizacin de HTML de AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

    Captulo 21: Variables del entorno de rutaConfiguracin de la ruta en Linux y Mac OS utilizando el shell Bash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

    Configuracin de la ruta en Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

  • 1ltima modificacin 24/6/2013

    Captulo 1: Acerca de Adobe AIR

    Adobe 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/Ajax

    Los 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 trabajo adicional 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 y patrones 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++. No hace 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 y arquitecturas basadas en ActionScript)

    HTML, CSS y JavaScript

    La mayora de las arquitecturas de Ajax

  • 2CREACIN DE APLICACIONES DE ADOBE AIRAcerca de Adobe AIR

    ltima modificacin 24/6/2013

    Las extensiones nativas para Adobe AIR proporcionan API de ActionScript que permiten acceder a funciones especficas 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).

  • 3ltima modificacin 24/6/2013

    Captulo 2: Instalacin de Adobe AIR

    El 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 (instalacin desde 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. Debe obtener 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 motor de 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 Mac y Windows. En iOS, todas las aplicaciones incluyen un paquete de motor de ejecucin. A partir de AIR 3.7, todas las aplicaciones de Android incluyen un paquete de motor de ejecucin por defecto (aunque tiene la opcin de usar un motor por separado).

    Mediante la instalacin 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 lnea de comandos de AIR). El motor de ejecucin 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 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 Mac1 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.

  • 4CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

    ltima modificacin 24/6/2013

    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 LinuxNota: 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/es/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/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.

    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 AndroidSe 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. Solo 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 184 para obtener ms informacin.

  • 5CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

    ltima modificacin 24/6/2013

    Instalacin del motor de ejecucin en un dispositivo de iOSEl 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 ayuda AIR para iOS en la pgina 75

    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 Windows1 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 LinuxRealice 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 Android1 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 185 para obtener ms informacin.

    Eliminacin de un paquete de motor de ejecucinPara eliminar un motor de ejecucin captador, debe eliminar la aplicacin con la que se haya instalado. Recuerde que los motores de ejecucin captadores solo se utilizan para ejecutar la aplicacin de instalacin.

  • 6CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

    ltima modificacin 24/6/2013

    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 la aplicacin 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 de su 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 solo 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.

  • 7CREACIN DE APLICACIONES DE ADOBE AIRInstalacin de Adobe AIR

    ltima modificacin 24/6/2013

    Actualizacin de motores de ejecucin captadoresSi distribuye la aplicacin con un paquete de motor de ejecucin captador, este 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.

  • 8ltima modificacin 24/6/2013

    Captulo 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.0Las 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 Flash

    Desarrolladores de HTMLSi 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 HTMLLas clases que estn disponibles en JavaScript mediante el archivo AIRAliases.js se incluyen en Adobe AIR API Reference for HTML Developers.

    Clase Paquete de ActionScript 3.0 Aadido en versin 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

  • 9CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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; eliminados, desde 3.7

    GameInputDevice flash.ui 3.0

    GameInputEvent flash.ui 3.0

    GameInputFinger flash.ui 3.6 y versiones anteriores; eliminados, desde 3.7

    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

    Clase Paquete de ActionScript 3.0 Aadido en versin de AIR

  • 10CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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

    Clase Paquete de ActionScript 3.0 Aadido en versin de AIR

  • 11CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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

    Clase Paquete de ActionScript 3.0 Aadido en versin de AIR

  • 12CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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

    Clase Paquete de ActionScript 3.0 Aadido en versin de AIR

  • 13CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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

    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 childSandboxBridge 1.0

    parentSandboxBridge 1.0

    Stage assignFocus() 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

    softKeyboardRect 2.6

    supportedOrientations 2.6

    supportsOrientationChange 2.0

    NativeWindow owner 2.6

    listOwnedWindows 2.6

    NativeWindowInitOptions owner 2.6

  • 14CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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

    responseURL 1.0

    KeyboardEvent commandKey 1.0

    controlKey 1.0

    Paquete Clase Propiedad, mtodo o evento Aadido en versin de AIR

  • 15CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    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

    setDRMAuthenticationCredentials()

    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

    Paquete Clase Propiedad, mtodo o evento Aadido en versin de AIR

  • 16CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    La mayora de estos nuevos mtodos y propiedades solo 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

    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

    PrintJobOptions pixelsPerInch 2.0

    printMethod 2.0

    flash.system Capabilities languages 1.1

    LoaderContext allowLoadBytesCodeExecution 1.0

    Security APPLICATION 1.0

    flash.ui KeyLocation D_PAD 2.5

    Paquete Clase Propiedad, mtodo o evento Aadido en versin de AIR

  • 17CREACIN DE APLICACIONES DE ADOBE AIRTrabajo con las API de AIR

    ltima modificacin 24/6/2013

    FileSystemEnumerationMode

    FileSystemHistoryButton

    FileSystemList

    FileSystemSizeDisplayMode

    FileSystemTree

    FlexNativeMenu

    HTML

    Window

    WindowedApplication

    WindowedSystemManager

    Asimismo, Flex 4 incluye los siguientes componentes spark de AIR:

    Window

    WindowedApplication

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

  • 18

    ltima modificacin 24/6/2013

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

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

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

    Instalacin del SDK de AIR El 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 166.

    AIR Development Tool (ADT) Empaqueta aplicaciones de AIR en paquetes de instalacin distribuibles. Consulte AIR Developer Tool (ADT) en la pgina 172.

    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.

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

    ltima modificacin 24/6/2013

    El SDK de AIR se distribuye como archivo estndar. 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; aada la ruta a esta carpeta a la variable de 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 carpeta del 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 variable de 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 siguiente comando: 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 Descripcin de las herramientas/archivos

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

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

    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.

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

    lib Contiene el cdigo de compatibilidad para las herramientas del SDK de AIR.

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

    ltima modificacin 24/6/2013

    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 proyectos de 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 texto favorito 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:ditto air_sdk_folder flex_sdk_folder

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

    templates descriptor-template.xml: una plantilla del archivo descriptor de la aplicacin que es necesaria para todas las aplicaciones de AIR. Para ver una descripcin detallada del archivo descriptor de la aplicacin, consulte Archivos descriptores de las aplicaciones de AIR en la pgina 212.

    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.

    Carpeta del SDK Descripcin de las herramientas/archivos

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

    ltima modificacin 24/6/2013

    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.

  • 22

    ltima modificacin 24/6/2013

    Captulo 5: Creacin de su primera aplicacin de AIR

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

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

    ltima modificacin 24/6/2013

    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:

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

    ltima modificacin 24/6/2013

    @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 AIRHelloWorld-app.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.

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

    ltima modificacin 24/6/2013

    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.

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

    ltima modificacin 24/6/2013

    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 World1 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 esta:trace("Running AIR application using Debug Movie");

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

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

    ltima modificacin 24/6/2013

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

    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.

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

    ltima modificacin 24/6/2013

    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 proyecto1 Abra Flash Professional CS5

    2 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 aplicacin1 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: vertical

    3 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 Crear para 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.

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

    ltima modificacin 24/6/2013

    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. Solo se deben establecer aquellos permisos que la aplicacin requiera realmente debido a que los usuarios pueden rechazar la aplicacin si esta solicita demasiados permisos.

    5 Guarde el archivo.

    Empaquetado e instalacin de la aplicacin en el dispositivo de Android1 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 184 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 solo 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:

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

    ltima modificacin 24/6/2013

    package{ import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import 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 316. 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 93.

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

    ltima modificacin 24/6/2013

    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 solo 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 solo se aaden para facilitar la lectura.)

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

    ltima modificacin 24/6/2013

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

    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.

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

    ltima modificacin 24/6/2013

    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 solo se pueden desarrollar para los perfiles extendedDesktop y de escritorio. El perfil mvil no es compatible.

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

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

    ltima modificacin 24/6/2013

    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.

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

    ltima modificacin 24/6/2013

    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.

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

    ltima modificacin 24/6/2013

    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