Los atributos del elemento raíz de un archivo descriptor de la aplicación, application, especifican la versión necesaria del motor de ejecución de AIR:

<application xmlns="http://ns.adobe.com/air/application/1.5">

xmlns El espacio de nombre de AIR, el cual debe definirse como espacio de nombre XML predeterminado. El espacio de nombre cambia con cada edición principal de AIR (pero no con las revisiones menores). El último segmento del espacio de nombre, por ejemplo “1.5”, indica la versión del motor de ejecución que requiere la aplicación. Asegúrese de establecer el espacio de nombres en AIR 1.5 ("http://ns.adobe.com/air/application/1.5") si su aplicación utiliza alguna nueva función de AIR 1.5.

Para las aplicaciones basadas en SWF, la versión del motor de ejecución de AIR especificada en el descriptor de la aplicación determina la versión de SWF máxima que se puede cargar como contenido inicial de la aplicación. Las aplicaciones que especifican AIR 1.0 ó 1.1 sólo pueden utilizar archivos SWF9 (Flash Player 9) como contenido inicial, aunque se ejecuten utilizando el motor de ejecución de AIR 1.5. Las aplicaciones que especifican AIR 1.5 pueden usar archivos SWF9 o SWF10 (Flash Player 10) como contenido inicial. La versión de SWF determina qué versión de las API de AIR y Flash Player están disponibles. Si un archivo SWF9 se utiliza como contenido inicial de una aplicación de AIR 1.5, esa aplicación sólo tendrá acceso a las API de AIR 1.1 y Flash Player 9. Asimismo, no se aplicarán los cambios de comportamiento realizados en las API existentes en AIR 1.5 o Flash Player 10. (Los cambios importantes relacionados con la seguridad en las API constituyen una excepción en este principio y se pueden aplicar de forma retroactiva en revisiones actuales o posteriores del motor de ejecución.)

Para las aplicaciones basadas en HTML, la versión del motor de ejecución especificada en el descriptor de la aplicación determina qué versión de las API de AIR y Flash Player están disponibles en la aplicación. Los comportamientos de HTML, CSS y JavaScript siempre están determinados por la versión del Webkit utilizado en el motor de ejecución de AIR instalado, y no por el descriptor de la aplicación.

Si una aplicación de AIR carga contenido SWF, la versión de las API de AIR y Flash Player disponible para dicho contenido depende del modo en que se cargue el contenido. La siguiente tabla muestra cómo la versión de la API está determinada según el método de carga:

Al cargar un archivo SWF de una versión distinta al contenido de carga, puede encontrarse con los siguientes problemas:

• Carga de contenido SWF10 mediante SWF9 (o anterior): las referencias a las API de AIR 1.5 y Flash Player 10 en el contenido cargado no se resolverán.

• Carga de contenido SWF9 (o anterior) mediante SWF10: las API modificadas en AIR 1.5 y Flash Player 10 pueden comportarse de un modo inesperado para el contenido cargado.

minimumPatchLevel Opcional. Utilice el atributo minimumPatchLevel para especificar el nivel de revisión mínimo de Adobe AIR que requiere la aplicación. Las aplicaciones de AIR suelen especificar qué versión de AIR necesitan mediante la definición del espacio de nombre en el archivo descriptor de la aplicación. El espacio de nombre cambia para cada edición principal de AIR (por ejemplo, 1.0 ó 1.5). El nombre de espacio no cambia para las revisiones.

Las revisiones sólo contienen una serie limitada de soluciones y ninguna modificación de las API. En general las aplicaciones no indican qué revisión requieren. No obstante, una solución incluida en una revisión puede resolver un problema con una aplicación. En esta situación, una aplicación puede especificar un valor para el atributo minimumPatchLevel para asegurar que la revisión se aplique antes de instalar la aplicación. En caso necesario, el instalador de la aplicación de AIR indica al usuario que descargue e instale la versión o revisión que se requiera. El ejemplo siguiente muestra un elemento de la aplicación que especifica un valor para el atributo minimumPatchLevel:

<application     xmlns="http://ns.adobe.com/air/application/1.1" 
    minimumPatchLevel="5331">

Los elementos siguientes definen el ID, la versión, el nombre, el nombre de archivo, la descripción y el aviso de copyright de la aplicación:

<id>com.example.samples.TestApp</id> 
<version>2.0</version> 
<filename>TestApp</filename> 
<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 
<description>An MP3 player.</description> 
<copyright>Copyright (c) 2008 YourCompany, Inc.</copyright>

id Una cadena de identificación exclusiva de la aplicación, conocida como ID de la aplicación. El valor del atributo se limita a los siguientes caracteres:

• 0–9

• a–z

• A–Z

• . (punto)

• - (guión)

El valor debe contener entre 1 y 212 caracteres. Este elemento es obligatorio.

La cadena id normalmente utiliza una jerarquía separada por puntos, en consonancia con una dirección de dominio DNS inversa, un nombre de clase o paquete de Java™ o un identificador de tipo universal de Mac OS® X. La forma tipo DNS no es obligatoria y AIR no crea ninguna asociación entre el nombre y los dominios DNS reales.

version Especifica la información sobre la versión para la aplicación. (No tiene nada que ver con la versión del motor de ejecución). La cadena de la versión es un designador definido por la aplicación. AIR no realiza ninguna interpretación de la cadena de la versión. Por ejemplo, no supone que la versión “3.0” es más actualizada que la versión “2.0”. Ejemplos: "1.0", ".4", "0.5", "4.9", "1.3.4a". Este elemento es obligatorio.

filename La cadena que se deberá utilizar como nombre de archivo de la aplicación (sin la extensión) al instalar ésta. El archivo de la aplicación inicia la aplicación de AIR en el motor de ejecución. Si no se facilita ningún valor para name, el nombre de archivo (valor de filename) se utilizará también como nombre de la carpeta de instalación. Este elemento es obligatorio.

La propiedad filename puede contener cualquier carácter Unicode (UTF-8) salvo los siguientes, cuyo uso en nombres de archivo está prohibido en diversos sistemas de archivos:

El valor de filename no puede terminar con un punto.

name (opcional, pero recomendado) El título que aparece en el instalador de aplicaciones de AIR.

Si especifica un solo nodo de texto (en lugar de varios elementos text), el instalador de aplicaciones de AIR utiliza este nombre, cualquiera que sea el idioma seleccionado para el sistema:

<name>Test Application</name> 

El esquema del descriptor de aplicaciones de AIR 1.0 sólo permite definir un nodo de texto para el nombre (y no varios elementos de text).

En AIR 1.1 (o posterior) se pueden especificar varios idiomas en el elemento name. En el ejemplo siguiente se especifica el nombre en tres idiomas (inglés, francés y español):

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

El atributo xml:lang para cada elemento de texto especifica un código de idioma, de conformidad con lo definido en RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

El instalador de aplicaciones de AIR utiliza el nombre que mejor se corresponde con el idioma de la interfaz de usuario del sistema operativo del usuario. Por ejemplo, tomemos una instalación en la que el elemento name del archivo descriptor de la aplicación incluye un valor para la configuración regional "es" (español). El instalador de aplicaciones de AIR utiliza el nombre "es" si el sistema operativo identifica "es" (español) como el idioma de la interfaz de usuario. También utiliza el nombre "es" si el idioma de la interfaz de usuario del sistema es es-ES (español de España). Sin embargo, si el idioma de la interfaz de usuario es es-ES y el archivo descriptor de la aplicación define tanto el nombre es-ES como el nombre es-UY, el instalador de aplicaciones de AIR utiliza el valor es-ES. Si la aplicación no define ningún nombre que coincide con el idioma de la interfaz de usuario del sistema, el instalador de aplicaciones de AIR utiliza el primer valor de name que se define en el archivo descriptor de la aplicación.

Si no se especifica ningún elemento name, el instalador de aplicaciones de AIR muestra el nombre de archivo definido para filename como el nombre de la aplicación.

El elemento name sólo define el título de la aplicación que se utiliza en el instalador de aplicaciones de AIR. El instalador de aplicaciones de AIR admite varios idiomas: chino tradicional, chino simplificado, checo, neerlandés, inglés, francés, alemán, italiano, japonés, coreano, polaco, portugués brasileño, ruso, español, sueco y turco. El instalador de aplicaciones de AIR selecciona el idioma visualizado (para texto que no sea el título y la descripción de la aplicación) con base en el idioma de la interfaz de usuario del sistema. Esta selección de idioma es independiente de la configuración del archivo descriptor de la aplicación.

El elemento nameno define las configuraciones regionales disponibles para la aplicación instalada y en funcionamiento. Para obtener más información sobre el desarrollo de aplicaciones multilingües, consulte Localización de aplicaciones de AIR.

description (opcional) La descripción de la aplicación. Se muestra en el instalador de aplicaciones de AIR.

Si especifica un solo nodo de texto (en lugar de varios elementos para text), el instalador de aplicaciones de AIR utiliza este nombre, cualquiera que sea el idioma seleccionado para el sistema:

<description>This is a sample AIR application.</description> 

El esquema del descriptor de aplicaciones de AIR 1.0 sólo permite definir un nodo de texto para el nombre (y no varios elementos de text).

En AIR 1.1 (o superior) se pueden especificar varios idiomas en el elemento description. En el ejemplo siguiente se especifica una descripción en tres idiomas (inglés, francés y español):

<description> 
    <text xml:lang="en">This is a example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

El atributo xml:lang para cada elemento de texto especifica un código de idioma, de conformidad con lo definido en RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

El instalador de aplicaciones de AIR utiliza la descripción que es más similar al idioma de la interfaz de usuario del sistema operativo del usuario. Por ejemplo, tomemos una instalación en la que el elemento description del archivo descriptor de la aplicación incluye un valor para la configuración regional "es" (española). El instalador de aplicaciones de AIR utiliza el nombre "es" si el sistema del usuario identifica "es" (español) como el idioma de la interfaz de usuario. También utiliza el nombre "es" si el idioma de la interfaz de usuario del sistema es es-ES (español de España). Sin embargo, si el idioma de la interfaz de usuario del sistema es es-ES y el archivo descriptor de la aplicación define tanto el nombre es-ES como el nombre es-UY, el instalador de aplicaciones de AIR utiliza el valor es-ES. Si la aplicación no define ningún nombre que coincide con el idioma de la interfaz de usuario del sistema, el instalador de aplicaciones de AIR utiliza el primer valor de description que se define en el archivo descriptor de la aplicación.

Para obtener más información sobre el desarrollo de aplicaciones multilingües, consulte Localización de aplicaciones de AIR.

copyright (opcional) La información de copyright para la aplicación de AIR. En Mac OS el aviso de copyright aparece en el cuadro de diálogo Acerca de para la aplicación instalada. En Mac OS, la información de copyright también se utiliza en el campo NSHumanReadableCopyright del archivo Info.plist para la aplicación.

Las carpetas de instalación y de menús de programa se definen con la siguiente configuración de propiedades:

<installFolder>Acme</installFolder> 
<programMenuFolder>Acme/Applications</programMenuFolder>

installFolder (opcional) Identifica el subdirectorio del directorio de instalación predeterminado.

En Windows el subdirectorio de instalación predeterminado es el directorio Archivos de programa. En Mac OS es el directorio /Aplicaciones. En Linux, es /opt/. Por ejemplo, si la propiedad installFolder está definida en "Acme" y una aplicación lleva el nombre "EjemploApl", la aplicación se instala en C:\Archivos de programa\Acme\ExampleApp en Windows, en /Aplicaciones/Acme/Example.app en MacOS y /opt/Acme/ExampleApp en Linux.

Utilice la barra diagonal (/) como carácter separador entre directorios si desea especificar un subdirectorio anidado, como en el ejemplo siguiente:

<installFolder>Acme/Power Tools</installFolder>

La propiedad installFolder puede contener cualquier carácter Unicode (UTF-8) excepto aquellos cuyo uso en nombres de archivo está prohibido en diversos sistemas de archivos (para ver la lista de excepciones, consulte la anterior propiedad filename).

La propiedad installFolder es opcional. Si no se especifica ninguna propiedad para installFolder, la aplicación se instala en un subdirectorio del directorio de instalación predeterminado basado en la propiedad name.

programMenuFolder (Opcional) Identifica dónde deben guardarse los accesos directos a la aplicación en el menú Todos los programas del sistema operativo Windows o en el menú de aplicaciones de Linux. (En otros sistemas operativos, en la actualidad se hace caso omiso a esta opción). Las restricciones sobre el número de caracteres que se admiten en el valor de la propiedad son las mismas que para la propiedad installFolder. No utilice una barra diagonal (/) como último carácter de este valor.

Cuando se carga una aplicación de AIR, el motor de ejecución utiliza los valores del elemento initialWindow para crear la ventana inicial de la aplicación. Luego el motor de ejecución carga en la ventana el archivo SWF o HTML especificado en el elemento content.

El siguiente es un ejemplo del elemento initialWindow:

<initialWindow> 
    <content>AIRTunes.swf</content> 
    <title>AIR Tunes</title> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <minimizable>true</minimizable> 
    <maximizable>true</maximizable> 
    <resizable>true</resizable> 
    <width>400</width> 
    <height>600</height> 
    <x>150</x> 
    <y>150</y> 
    <minSize>300 300</minSize> 
    <maxSize>800 800</maxSize> 
</initialWindow>

Los elementos secundarios del elemento initialWindow definen las propiedades de la ventana en la que se carga el archivo de contenido raíz.

content El valor especificado para el elemento content es la URL para el archivo principal de contenido de la aplicación. Éste será un archivo SWF o un archivo HTML. La URL se especifica relativa a la raíz de la carpeta de instalación de la aplicación. (Al ejecutar una aplicación de AIR con ADL, la URL se indica relativa a la carpeta que contiene el archivo descriptor de la aplicación. Se puede utilizar el parámetro root-dir de ADL para especificar otro directorio raíz).

title (Opcional) El título de la ventana.

systemChrome (Opcional) Si este atributo se define en standard, se mostrará el fondo cromático estándar proporcionado por el sistema operativo. Si lo define en none, no se mostrará ningún fondo cromático del sistema. La opción de fondo cromático no puede modificarse durante el tiempo de ejecución.

transparent (opcional) Defínalo en "true" si desea que la ventana de la aplicación admita la mezcla alfa. Una ventana con transparencia puede dibujarse más lentamente y necesitar más memoria. La opción de transparencia no puede modificarse durante el tiempo de ejecución.

visible (opcional) Defínalo en true si desea que la ventana principal quede visible en cuanto se haya creado. El valor predeterminado es false.

Puede convenir dejar la ventana principal oculta al principio para que no se muestren los ajustes de la posición y el tamaño de la ventana y la disposición del contenido. Se podrá mostrar después la ventana llamando al método activate() de la ventana o cambiando la propiedad visible a true. Para obtener más información, consulte Trabajo con ventanas nativas.

x, y, width, height (opcionales) Límites iniciales de la ventana principal de la aplicación. Si no se definen estos valores, el tamaño de la ventana quedará definido por las opciones del archivo SWF raíz o, en el caso de HTML, por el sistema operativo.

minSize, maxSize (opcionales) Tamaños mínimo y máximo de la ventana. Si no se definen estos valores, los determinará el sistema operativo.

minimizable, maximizable, resizable (opcionales) Especifican si se puede minimizar, maximizar y redimensionar la ventana. Estas opciones tienen el valor predeterminado true.

La propiedad icon especifica un archivo de icono (o varios) a utilizar para la aplicación. Los iconos son opcionales. Si no se define la propiedad icon, el sistema operativo muestra un icono predeterminado.

La ruta se indica relativa al directorio raíz de la aplicación. Los archivos de iconos deben tener el formato PNG. Se pueden especificar todos los tamaños de icono siguientes:

<icon> 
    <image16x16>icons/smallIcon.png</image16x16> 
    <image32x32>icons/mediumIcon.png</image32x32> 
    <image48x48>icons/bigIcon.png</image48x48> 
    <image128x128>icons/biggestIcon.png</image128x128>  
</icon>

Si hay un elemento para un tamaño determinado, la imagen que contiene el archivo debe ser exactamente del tamaño especificado. Si no se proporcionan todos los tamaños, el sistema operativo ajusta el tamaño más parecido para un uso determinado del icono.

Para obtener el mejor resultado posible, proporcione una imagen para cada uno de los tamaños disponibles. Asegúrese también de que los iconos sean de buen aspecto tanto en el modo de color de 16 bits como en el de 32 bits.

AIR instala y actualiza las aplicaciones utilizando los cuadros de diálogo de instalación predeterminados. No obstante, puede proporcionar su propia interfaz para actualizar una aplicación. Para indicar que la aplicación debe encargarse del proceso de actualización, defina el elemento customUpdateUI en true:

<customUpdateUI>true</customUpdateUI>

Cuando la versión instalada de la aplicación tiene el elemento customUpdateUI definido en true y el usuario hace doble clic en el archivo de AIR para una nueva versión o instala una actualización de la aplicación utilizando la función de instalación integrada, el motor de ejecución abre la versión instalada de la aplicación en lugar del instalador de aplicaciones de AIR predeterminado. La lógica de la aplicación determina entonces cómo continuar con la operación de actualización. (Para que se lleve a cabo una actualización, el ID de la aplicación y el ID del editor que figuran en el archivo de AIR deben coincidir con los de la aplicación instalada).

Para obtener más información, consulte Actualización de aplicaciones de AIR.

Si se especifica la siguiente opción, se podrá iniciar la aplicación de AIR instalada utilizando la función de invocación desde el navegador (el usuario selecciona un vínculo en una página en el navegador Web):

<allowBrowserInvocation>true</allowBrowserInvocation>

El valor predeterminado es false.

Si este valor se define en true, asegúrese de tener en cuenta las posibles consecuencias para la seguridad, descritas en Invocación desde el navegador.

Para obtener más información, consulte Instalación y ejecución de aplicaciones de AIR desde una página Web.

El elemento fileTypes permite declarar los tipos de archivos con que se puede asociar una aplicación de AIR. Cuando se instala una aplicación de AIR, los tipos de archivos declarados se registran en el sistema operativo y, si estos tipos de archivos aún no se encuentran asociados con ninguna otra aplicación, se asocian con la aplicación de AIR. Para suprimir una asociación existente entre un tipo de archivo y otra aplicación, utilice el método en tiempo de ejecución NativeApplication.setAsDefaultApplication() (preferentemente con el permiso del usuario).

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

El elemento fileTypes es opcional. Puede contener varios elementos fileType.

Los elementos name y extension son obligatorios para cada declaración de fileType que se incluya. Se puede utilizar el mismo nombre con varias extensiones. La extensión identifica el tipo de archivo. (Cabe observar que la extensión se especifica sin el punto que la precede). El elemento description es opcional; lo presenta al usuario la interfaz de usuario del sistema operativo. contentType es necesario en AIR 1.5 (era opcional en AIR 1.0 y 1.1). La propiedad ayuda al sistema operativo a localizar la mejor aplicación para abrir un archivo en determinadas circunstancias. El valor debe ser el tipo MIME del contenido del archivo. Se debe tener en cuenta que el valor se omite en Linux si el tipo de archivo ya se ha registrado y dispone de un tipo MIME asignado.

Se pueden especificar iconos para la extensión de archivo utilizando el mismo formato que el elemento "icon" de la aplicación. Los archivos de iconos también deben incluirse en el archivo de instalación de AIR (no se colocan automáticamente en el paquete).

Si hay un tipo de archivo asociado con una aplicación de AIR, cada vez que un usuario abra un archivo de ese tipo se invocará la aplicación. Si la aplicación ya está funcionando, AIR distribuye el objeto InvokeEvent a la instancia que se esté ejecutando. En caso contrario, AIR iniciará primero la aplicación. En ambos casos la ruta al archivo puede recuperarse del objeto InvokeEvent distribuido por el objeto NativeApplication. Puede utilizarse esta ruta para abrir el archivo.

Para obtener más información, consulte Gestión de asociaciones con archivos y Captura de argumentos de la línea de comandos.