Elementos del descriptor de la aplicación de AIR

El siguiente diccionario de elementos describe cada uno de los elementos válidos de un archivo descriptor de la aplicación de AIR.

allowBrowserInvocation

Permite que la API en navegador de AIR detecte e inicie la aplicación.

Si este valor se define en true, asegúrese de tener en cuenta las posibles consecuencias para la seguridad. Estos aspectos se describen en Invocación de una aplicación de AIR desde el navegador (para desarrolladores de ActionScript) e Invocación de una aplicación de AIR desde el navegado (para desarrolladores de HTML).

Para obtener más información, consulte Inicio desde el navegador de una aplicación de AIR instalada.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<allowBrowserInvocation>true</allowBrowserInvocation>

android

Permite añadir elementos al archivo de manifiesto de Android. AIR crea el archivo AndroidManifest.xml para cada paquete APK. El elemento android en el descriptor de la aplicación de AIR se puede utilizar para añadir elementos adicionales al mismo. Se omite en todas las plataformas excepto en Android.

Elemento principal:application

Elementos secundarios:

Contenido

Elementos que define las propiedades específicas de Android para añadirse en el manifiesto de la aplicación de Android.

Ejemplo

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

application

Elemento raíz de un documento descriptor de la aplicación de AIR.

Elemento principal: ninguno

Elementos secundarios:

Atributos

minimumPatchLevel: nivel de revisión mínimo del motor de ejecución de AIR que requiere esta aplicación.

xmlns: el atributo del espacio de nombres XML determina la versión del motor de ejecución de AIR necesaria de la aplicación.

El espacio de nombres cambia con cada edición principal de AIR (pero no con las revisiones menores). El último segmento del espacio de nombres, por ejemplo “3.0”, indica la versión del motor de ejecución que requiere la aplicación.

Los valores xmlns para las versiones principales de AIR son:

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

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 o 1.1 solo pueden utilizar archivos SWF9 (Flash Player 9) como contenido inicial, aunque se ejecuten utilizando el motor de ejecución de AIR 2. Las aplicaciones que especifican AIR 1.5 (o posterior) 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 solo 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 2.0 o Flash Player 10.1. (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. En ocasiones la versión eficaz se determina mediante el espacio de nombres del descriptor de la aplicación, otras veces mediante la versión del contenido de carga y a veces mediante la versión del contenido cargado. La siguiente tabla muestra cómo la versión de la API está determinada según el método de carga:

Forma de carga del contenido

Forma en que la versión de la API se ve determinada

Contenido inicial, aplicación basada en SWF

Versión SWF del archivo cargado

Contenido inicial, aplicación basada en HTML

Espacio de nombres del descriptor de la aplicación

SWF cargado mediante contenido SWF

Versión del contenido de carga

Biblioteca SWF cargada mediante contenido HTML utilizando la etiqueta <script>

Espacio de nombres del descriptor de la aplicación

SWF cargado mediante contenido HTML utilizando las API de AIR o Flash Player (por ejemplo, flash.display.Loader)

Espacio de nombres del descriptor de la aplicación

SWF cargado mediante contenido HTML utilizando etiquetas <object> o <embed> (o las API equivalentes de JavaScript)

Versión SWF del archivo cargado

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

  • Carga de un SWF de versión reciente mediante un SWF de versión anterior. Las referencias a las API añadidas a las versiones más recientes de AIR y Flash Player en el contenido cargado quedarán si resolver

  • Carga de un SWF de versión anterior mediante un SWF de versión reciente. Las API modificadas en las versiones más recientes de AIR y Flash Player pueden tener un comportamiento no previsto por el contenido cargado.

Contenido

El elemento de la aplicación contiene los elementos secundarios que define las propiedades de una aplicación de AIR.

Ejemplo

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

aspectRatio

Especifica la relación de aspecto de la aplicación.

Si no se especifica, la aplicación se abre en la proporción de aspecto “natural” del dispositivo. La orientación natural varía de dispositivo a dispositivo. Generalmente, esta es la proporción de aspecto vertical en los dispositivos de pantalla pequeña como, por ejemplo, teléfonos. En algunos dispositivos como, por ejemplo, el tablet iPad, la aplicación se abre en la orientación actual. En AIR 3.3 y versiones posteriores, esto se aplica a toda la aplicación, no solo a la visualización inicial.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

portrait, landscape o any

Ejemplo

<aspectRatio>landscape</aspectRatio>

autoOrients

Especifica si la orientación del contenido se ajusta automáticamente al cambiar la orientación física del dispositivo. Para obtener más información, consulte Orientación del escenario.

Al utilizar la orientación automática, considere el establecimiento de las propiedades align y scaleMode del objeto Stage en los siguientes parámetros:

stage.align = StageAlign.TOP_LEFT; 
stage.scaleMode = StageScaleMode.NO_SCALE;

Esta configuración permite que la aplicación gire sobre la esquina superior izquierda y evita que el contenido de la aplicación se escale automáticamente. Mientras los demás modos de escala se ajustan al contenido para que se ajuste a las dimensiones del escenario girado, también recortan, distorsionan o reducen excesivamente el contenido. Los mejores resultados se pueden obtener casi siempre volviendo a dibujar o a diseñar por sí mismo el contenido.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<autoOrients>true</autoOrients>

colorDepth

Especifica si se utiliza color de 16 bits o 32 bits.

Con color de 16 bits se puede aumentar el rendimiento de procesamiento a costa de la fidelidad de los colores. Hasta AIR 3, el color de 16 bits siempre se ha utilizado en Android. En AIR 3, se utiliza color de 32 bits de forma predeterminada.

Nota: si la aplicación usa la clase StageVideo, debe utilizar color de 32 bits.

Elemento principal:android

Elementos secundarios: ninguno

Contenido

Uno de los valores siguientes:

  • 16 bits

  • 32 bits

Ejemplo

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

containsVideo

Especifica si la aplicación debe contener cualquier contenido de vídeo o no.

Elemento principal:android

Elementos secundarios: ninguno

Contenido

Uno de los valores siguientes:

  • true

  • false

Ejemplo

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

content

El valor especificado para el elemento content es la URL para el archivo principal de contenido de la aplicación. Este 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).

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Una URL relativa al directorio de la aplicación. al tratarse como una URL el valor del elemento content, los caracteres del nombre del archivo de contenido deben codificarse como URL de acuerdo con las reglas definidas en RFC 1738. Los caracteres de espacio, por ejemplo, deben codificarse como %20.

Ejemplo

<content>TravelPlanner.swf</content>

contentType

contentType es necesario desde AIR 1.5 (era opcional en AIR 1.0 y 1.1). La propiedad ayuda a algunos sistemas operativos a localizar la mejor aplicación para abrir un archivo. 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.

Elemento principal:fileType

Elementos secundarios: ninguno

Contenido

Subtipo y tipo MIME. Consulte RFC2045 para obtener más información sobre los tipos MIME.

Ejemplo

<contentType>text/plain</contentType>

copyright

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.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

Cadena que contiene la información de derechos de autor de la aplicación.

Ejemplo

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

customUpdateUI

Indica si una aplicación proporcionará sus propios cuadros de diálogo de actualización. Si el valor es false, AIR presenta cuadros diálogo de actualización estándar para el usuario. Solo las aplicaciones distribuidas como archivos de AIR pueden utilizar el sistema de actualización integrado de AIR.

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. El motor de ejecución no abre el 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).

Nota: el mecanismo customUpdateUI solo entra en juego si la aplicación ya está instalada y el usuario hace doble clic en el archivo de instalación de AIR que contiene una actualización, o si instala una actualización de la aplicación utilizando la función de instalación integrada. Puede descargar una actualización e iniciarla a través de la lógica de su propia aplicación, visualizando la interfaz de usuario personalizada según convenga, esté o no customUpdateUI definido en true.

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

Elemento principal:application

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<customUpdateUI>true</customUpdateUI>

depthAndStencil

Indica que la aplicación requiere el uso del búfer de esténcil o de profundidad. Normalmente estos búferes se utilizan al trabajar con contenido en 3D. De forma predeterminada, el valor de este elemento es false para desactivar los búferes de esténcil y de profundidad. Este elemento es necesario, ya que los búferes deben estar asignados en el inicio de la aplicación antes de que se cargue ningún otro contenido.

El ajuste de este elemento debe coincidir con el valor transferido por el argumento enableDepthAndStencil al método Context3D.configureBackBuffer(). Si los valores no coinciden, AIR emite un error.

Este elemento solo se puede aplicar si renderMode = direct. Si renderMode no es igual a direct, ADT emite el error 118:

<depthAndStencil> element unexpected for render mode cpu.  It requires "direct" render mode.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<depthAndStencil>true</depthAndStencil>

description

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: De lo contrario, 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 la descripción "es" si el sistema del usuario identifica "es" (español) como el idioma de la interfaz de usuario. También utiliza la descripción "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-UV, el instalador de aplicaciones de AIR utiliza el valor es-ES. Si la aplicación no define ninguna descripción 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.

Elemento principal:application

Elementos secundarios:text

Contenido

El esquema del descriptor de aplicaciones de AIR 1.0 solo 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. 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).

Ejemplo

Descripción el nodo de texto simple:

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

Descripción con elementos de texto localizados para inglés, francés y español (válidos en AIR 1.1 y posterior):

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

description

La descripción del tipo de archivo se muestra al usuario mediante el sistema operativo. La descripción del tipo de archivo no se localiza.

Consulte también: description como elemento secundario del elemento application

Elemento principal:fileType

Elementos secundarios: ninguno

Contenido

Cadena que describe el contenido del archivo.

Ejemplo

<description>PNG image</description>

embedFonts

Permite utilizar fuentes personalizadas en StageText en la aplicación AIR. Este elemento es opcional.

Elemento principal:application

Elementos secundarios:fuente

Contenido

El elemento embedFonts puede contener cualquier elemento de fuente.

Ejemplo

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

Entitlements

iOS utiliza propiedades denominadas derechos (entitlements) para proporcionar acceso a la aplicación a recursos y funcionalidades adicionales. Utilice el elemento Entitlements para especificar esta información en una aplicación de iOS móvil.

Elemento principal:iPhone

Elementos secundarios: elementos Entitlements.plist de iOS

Contenido

Contiene elementos secundarios que especifican pares de clave-valor para usarlos como parámetros de Entitlements.plist en la aplicación. El contenido del elemento Entitlements se debe incluir en un bloque CDATA. Para obtener más información, consulte la Referencia de claves de derechos en al biblioteca del desarrollador de iOS.

Ejemplo

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

extension

La cadena de extensión de un tipo de archivo.

Elemento principal:fileType

Elementos secundarios: ninguno

Contenido

Cadena que identifique los caracteres de la extensión de archivo (sin el punto, “.”).

Ejemplo

<extension>png</extension>

extensionID

Especifica el ID de una extensión utilizada por la aplicación. El ID se define en el documento descriptor de la extensión.

Elemento principal:extensions

Elementos secundarios: ninguno

Contenido

Cadena que identifica el ID de la extensión.

Ejemplo

<extensionID>com.example.extendedFeature</extensionID>

extensions

Identifica las extensiones utilizadas por una aplicación.

Elemento principal:application

Elementos secundarios:extensionID

Contenido

Elementos extensionID que contienen los ID de extensión de ActionScript desde el archivo descriptor de la extensión.

Ejemplo

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

externalSwfs

Especifica el nombre de un archivo de texto que contiene una lista de los archivos SWF que ADT debe configurar para alojamiento remoto. Puede minimizar el tamaño de descarga inicial de la aplicación mediante el empaquetamiento de un subconjunto de los archivos SWF usados por su aplicación y la carga del resto (solo activos) de archivos SWF externos en tiempo de ejecución con el método Loader.load(),. Para utilizar esta función, se debe empaquetar la aplicación de tal manera que ADT mueva todo el código de bytes ActionScript (ABC) de los archivos SWF cargados de forma externa al SWF de la aplicación principal, dejando un archivo SWF que contenga únicamente activos. Esto se hace para cumplir con la regla de la Apple Store que prohíbe descargar código después de que una aplicación esté instalada.

Para obtener más información, consulte Reducir tamaño de descarga mediante la carga externa, los archivos SWF solo de recurso.

Elemento principal:iPhone, initialWindow

Elementos secundarios: ninguno

Contenido

Nombre de un archivo de texto que contiene una lista delimitada por líneas de los archivos SWF que se deben alojar de forma remota.

Atributos:

Ninguno

Ejemplos

iOS:

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

filename

Cadena que se deberá utilizar como nombre de archivo de la aplicación (sin la extensión) al instalar esta. 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.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

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:

Carácter

Código hexadecimal

diversos

0x00 – x1F

*

x2A

"

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

El valor de filename no puede terminar con un punto.

Ejemplo

<filename>MyApplication</filename>

fileType

Describe un solo tipo de archivo que la aplicación puede registrar.

Elemento principal:fileTypes

Elementos secundarios:

Contenido

Elementos que describen un tipo de archivo.

Ejemplo

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

fileTypes

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

Nota: los métodos del motor de ejecución solo pueden manejar asociaciones para los tipos de archivos declarados en el descriptor de la aplicación.

El elemento fileTypes es opcional.

Elemento principal:application

Elementos secundarios:fileType

Contenido

El elemento fileTypes puede contener cualquier número de elementos fileType.

Ejemplo

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

fuente

Describe una única fuente personalizada que se puede utilizar en la aplicación AIR.

Elemento principal:embedFonts

Elementos secundarios:fontName,fontPath

Contenido

Elementos que especifican el nombre de fuente personalizada y su ruta.

Ejemplo

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

fontName

Especifica el nombre de la fuente personalizada.

Elemento principal:fuente

Elementos secundarios: ninguno

Contenido

El nombre de la fuente personalizada que se especificará en StageText.fontFamily

Ejemplo

<fontName>space age</fontName> 

fontPath

Proporciona la ubicación del archivo de la fuente personalizada.

Elemento principal:fuente

Elementos secundarios: ninguno

Contenido

Ruta del archivo de fuente personalizada (con respecto al origen).

Ejemplo

<fontPath>ttf/space age.ttf</fontPath> 

forceCPURenderModeForDevices

Forzar el modo de representación de CPU para un conjunto de dispositivos específicos. Esta función permite activar de forma selectiva el modo de representación de GPU para los restantes dispositivos con iOS.

Esta etiqueta se agrega como un elemento secundario de la etiqueta iPhone y se especifica una lista de nombres de modelos de dispositivos separados por espacios. Los nombres de modelos de dispositivos válidos incluyen los siguientes:

iPad1,1

iPhone1,1

iPod1,1

iPad2,1

iPhone1,2

iPod2,1

iPad2,2

iPhone2,1

iPod3,3

iPad2,3

iPhone3.1

iPod4,1

iPad2,4

iPhone3,2

iPod5,1

iPad2,5

iPhone4,1

 

iPad3,1

iPhone5,1

 

iPad3,2

   

iPad3,3

   

iPad3,4

   

Elemento principal:iPhone, initialWindow

Elementos secundarios: ninguno

Contenido

Lista separada por espacios de nombres de modelos de dispositivos.

Atributos:

Ninguno

Ejemplos

iOS:

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

fullScreen

Especifica si la aplicación se inicia en modo de pantalla completa.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<fullscreen>true</fullscreen>

height

Altura inicial de la ventana principal de la aplicación.

Si no se ve una altura, esta se determina mediante la configuración del archivo raíz SWF o, en el caso de una aplicación de AIR basada en HTML, mediante el sistema operativo.

Altura máxima de una ventana modificada de 2048 píxeles a 4096 píxeles en AIR 2.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Entero positivo con un valor máximo de 4095.

Ejemplo

<height>4095</height>

icon

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:

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.

Nota: los iconos especificados no se añaden automáticamente al paquete de AIR. Los archivos de iconos deben estar incluidos en sus lugares relativos correctos cuando se empaqueta de la aplicación.

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.

Elemento principal:application

Elementos secundarios:imageNxN

Contenido

Elemento imageNxN para cada tamaño de icono deseado.

Ejemplo

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

id

Cadena de identificación de la aplicación, denominada ID de la aplicación. En ocasiones se utiliza el Identificador de estilo DNS inverso, pero este estilo no es necesario.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

El valor de ID se limita a los siguientes caracteres:

  • 0–9

  • a–z

  • A–Z

  • . (punto)

  • - (guion)

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

Ejemplo

<id>org.example.application</id>

imageNxN

Define la ruta a un icono relativa al directorio de la aplicación.

Se pueden utilizar las siguientes imágenes de icono; cada una de ellas especifica un tamaño de icono diferente:

  • image16x16

  • image29x29 (AIR 2+)

  • image32x32

  • image36x36 (AIR 2.5+)

  • image48x48

  • image50x50 (AIR 3.4+)

  • image57x57 (AIR 2+)

  • image58x58 (AIR 3.4+)

  • image72x72 (AIR 2+)

  • image100x100 (AIR 3.4+)

  • image114x114 (AIR 2.6+)

  • image128x128

  • image144x144 (AIR 3.4+)

  • image512x512 (AIR 2+)

  • image1024x1024 (AIR 3.4+)

El icono debe ser un gráfico PNG que sea del mismo tamaño indicado por el elemento de imagen. Los archivos de icono se deben incluir en el paquete de la aplicación; los iconos a los que se hace referencia en el documento descriptor de la aplicación no se incluyen automáticamente.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

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

Carácter

Código hexadecimal

diversos

0x00 – x1F

*

x2A

"

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

Ejemplo

<image32x32>icons/icon32.png</image32x32>

InfoAdditions

Permite especificar las propiedades adicionales de una aplicación de iOS.

Elemento principal:iPhone

Elementos secundarios: elementos Info.plist iOS

Contenido

Contiene elementos secundarios que especifican pares de clave-valor para usarlos como parámetros de Info.plist en la aplicación. El contenido del elemento InfoAdditions se debe incluir en un bloque CDATA.

Consulte Information Property List Key Reference (Referencia clave de la lista de propiedades de información; en inglés) en Apple iPhone Reference Library para obtener información sobre las parejas de valores clave y cómo expresarlas en XML.

Ejemplo

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

initialWindow

Define el archivo de contenido principal y el aspecto de la aplicación inicial.

Elemento principal:application

Elementos secundarios: todos los elementos siguientes pueden aparecer como secundarios del elemento initialWindow. Sin embargo, algunos elementos se omiten dependiendo de si AIR admite las ventanas en una plataforma:

Elemento

Escritorio

Móvil

aspectRatio

se omitirá

utilizado

autoOrients

se omitirá

utilizado

content

utilizado

utilizado

depthAndStencil

utilizado

utilizado

fullScreen

se omitirá

utilizado

height

utilizado

se omitirá

maximizable

utilizado

se omitirá

maxSize

utilizado

se omitirá

minimizable

utilizado

se omitirá

minSize

utilizado

se omitirá

renderMode

utilizado (AIR 3.0 y posterior)

utilizado

requestedDisplayResolution

utilizado (AIR 3.6 y posterior)

se omitirá

resizable

utilizado

se omitirá

softKeyboardBehavior

se omitirá

utilizado

systemChrome

utilizado

se omitirá

title

utilizado

se omitirá

transparent

utilizado

se omitirá

visible

utilizado

se omitirá

width

utilizado

se omitirá

x

utilizado

se omitirá

y

utilizado

se omitirá

Contenido

Elementos secundarios que definen el comportamiento y la apariencia de la aplicación.

Ejemplo

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

installFolder

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.

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.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

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

Utilice la barra diagonal (/) como carácter separador entre directorios si desea especificar un subdirectorio anidado.

Ejemplo

<installFolder>utilities/toolA</installFolder>

iPhone

Define propiedades de la aplicación específica de iOS.

Elemento principal:application

manifest

Especifica información para añadir al archivo de manifiesto de Android para la aplicación.

Elemento principal:manifestAdditions

Elementos secundarios: Definidos por el SDK de Android.

Contenido

El elemento manifiesto no es, técnicamente hablando, parte del esquema del descriptor de la aplicación de AIR. Se trata de la raíz del documento XML de manifiesto de Android. Todo el contenido que se sitúe en el elemento manifest se debe ajustar al esquema de AndroidManifest.xml. Cuando se genera un archivo APK con las herramientas de AIR, la información del elemento manifest se copia en la parte correspondiente del archivo AndroidManifest.xml generado de la aplicación.

Si especifica valores de manifest en Android que solamente están disponibles en una versión del SDK más reciente que la admitida directamente en AIR, deberá establecer el indicador -platformsdk como ADT al empaquetar la aplicación. Establezca el indicador en la ruta del sistema de archivos en una versión del SDK de Android que admita los valores que está añadiendo.

El propio elemento manifest se debe incluir en un bloque CDATA en el descriptor de la aplicación de AIR.

Ejemplo

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

manifestAdditions

Especifica la información para añadir al archivo de manifiesto de Android.

Todas las aplicaciones de Android incluyen un archivo de manifiesto que define las propiedades básicas de la aplicación. El archivo de manifiesto de Android es similar en concepto al descriptor de la aplicación de AIR. Una aplicación de AIR para Android cuenta con un descriptor de la aplicación y archivo de manifiesto de Android generado automáticamente. Cuando se empaqueta una aplicación de AIR para Android, la información en este elemento manifestAdditions se añade a las partes correspondientes del documento de manifiesto de Android.

Elemento principal:android

Elementos secundarios:manifest

Contenido

La información del elemento manifestAdditions se añade al documento XML AndroidManifest.

AIR establece varias entrada de manifiesto en el documento de manifiesto de Android generado para garantizar que las funciones del motor de ejecución y la aplicación funcionan correctamente. La siguiente configuración no puede omitirse:

Los siguientes atributos del elemento de manifiesto no se pueden establecer:

  • package

  • android:versionCode

  • android:versionName

Los siguientes atributos del elemento de actividad principal no se pueden establecer:

  • android:label

  • android:icon

Los siguientes atributos del elemento de la aplicación no se pueden establecer:

  • android:theme

  • android:name

  • android:label

  • android:windowSoftInputMode

  • android:configChanges

  • android:screenOrientation

  • android:launchMode

Ejemplo

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

maximizable

Especifica si la ventana se puede maximizar.

Nota: en los sistemas operativos como Mac OS X en los cuales la maximización de las ventanas es una operación de redimensionamiento, para que la ventana no cambie de tamaño, tanto "maximizable" como "resizable" deben definirse en false.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true (predeterminado) o false

Ejemplo

<maximizable>false</maximizable>

maxSize

Tamaños máximos de la ventana. Si ni se establece un tamaño máximo, este se determina mediante el sistema operativo.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Dos enteros que representan la altura y la anchura máximas, separados por espacios en blanco.

Nota: el tamaño de ventana máximo admitido en AIR ha aumentado de 2048x2048 píxeles a 4096x4096 píxeles en AIR 2. (Debido a que las coordenadas de la pantalla se basan en cero, el valor máximo se puede utilizar para la anchura y la altura es de 4095.)

Ejemplo

<maxSize>1024 360</maxSize>

minimizable

Especifica si la ventana se puede minimizar.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true (predeterminado) o false

Ejemplo

<minimizable>false</minimizable>

minSize

Especifica el tamaño mínimo permitido para la ventana.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Dos enteros que representan la altura y la anchura mínimas, separados por espacios en blanco. Se debe tener en cuenta que el tamaño mínimo impuesto por el sistema operativo tiene precedencia sobre el valor establecido en el descriptor de la aplicación.

Ejemplo

<minSize>120 60</minSize>

name

El título de la aplicación mostrado por el instalador de la aplicación de AIR.

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.

Elemento principal:application

Elementos secundarios:text

Contenido

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.

El esquema del descriptor de aplicaciones de AIR 1.0 solo 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.

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-UV, 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.

El elemento name solo 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.

Ejemplo

El siguiente ejemplo define un nombre con un nodo de texto simple:

<name>Test Application</name> 

El siguiente ejemplo, válido para AIR 1.1 y posterior, especifica el nombre en tres idiomas (inglés, francés y español) utilizando los nodos del elemento <text>:

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

name

Identifica el nombre de un tipo de archivo.

Elemento principal:fileType

Elementos secundarios: ninguno

Contenido

Cadena que representa el nombre del tipo de archivo.

Ejemplo

<name>adobe.VideoFile</name>

programMenuFolder

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

Elemento principal:application

Elementos secundarios: ninguno

Contenido

La cadena utilizada para el valor programMenuFolder 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 el elementofilename). No utilice una barra diagonal (/) como último carácter de este valor.

Ejemplo

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

publisherID

Identifica el ID del editor para actualizar una aplicación de AIR creada en un principio con una versión de AIR 1.5.2 o posterior.

Especifique un ID de editor únicamente al crear una actualización de la aplicación. El valor dele elemento publisherID debe coincidir con el ID del editor generado por AIR en la versión anterior de la aplicación. Para una aplicación instalada, el ID del editor se puede encontrar en la carpeta en la que se instala en una aplicación, en el archivo META-INF/AIR/publisherid.

Las nuevas aplicaciones creadas con AIR 1.5.3 o posterior no deben especificar ningún ID de editor.

Para obtener más información, consulte Identificador del editor de AIR.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

Cadena del ID de editor.

Ejemplo

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

renderMode

Especifica si utilizar la aceleración con la unidad de procesamiento de gráficos (GPU), si se admite en el dispositivo informático actual.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Uno de los valores siguientes:

  • auto (predeterminado): actualmente se sitúa en modo CPU.

  • cpu: la aceleración de hardware no se utiliza.

  • direct: la composición del procesamiento se produce en la CPU; la fusión utiliza la GPU. Disponible en AIR 3+.

    Nota: para poder aprovechar la aceleración de GPU del contenido de Flash con plataformas de AIR para móviles, Adobe recomienda utilizar renderMode="direct" (es decir, Stage3D) en vez de renderMode="gpu". Adobe oficialmente admite y recomienda las siguientes arquitecturas basadas en Stage3D: Starling (2D) y Away3D (3D). Para obtener más información sobre Stage3D y Starling/Away3D, consulte http://gaming.adobe.com/getstarted/.
  • gpu: la aceleración de hardware se usa, si está disponible.

    Importante: no utilice el modo de procesamiento de GPU para las aplicaciones de Flex.

Ejemplo

<renderMode>direct</renderMode>

requestedDisplayResolution

Especifica si la aplicación desea utilizar la resolución estándar o alta en un dispositivo o un monitor de ordenador con una pantalla de alta resolución. Cuando se establece en estándar (valor predeterminado), la pantalla aparecerá en la aplicación como pantalla de resolución estándar. Cuando se establece en alta, la aplicación puede gestionar cada píxel de alta resolución.

Por ejemplo, en una pantalla de iPhone con alta resolución 640x960, si el valor es estándar, las dimensiones de escenario a pantalla completa serán 320x480 y cada píxel de aplicación se representa mediante cuatro píxeles de pantalla. Si el valor es alta, las dimensiones de escenario a pantalla completa serán 640x960.

En los dispositivos con pantallas de resolución estándar, las dimensiones del escenario coinciden con las dimensiones de la pantalla independientemente de la configuración empleada.

Si el elemento requestedDisplayResolution está anidado en el elemento iPhone, se aplica a dispositivos iOS. En ese caso, el atributo excludeDevices se puede usar para especificar dispositivos a los que no se aplica el valor.

Si el elemento requestedDisplayResolution está anidado en el elemento initialWindow, se aplica a aplicaciones de AIR de escritorio en ordenadores MacBook Pro que admitan presentaciones de alta resolución. El valor especificado se aplica a todas las ventanas nativas usadas en la aplicación. El anidado del elemento requestedDisplayResolution en el elemento initialWindow es posible a partir de AIR 3.6.

Elemento principal:iPhone, initialWindow

Elementos secundarios: ninguno

Contenido

standard (valor predeterminado) o high.

Atributo:

excludeDevices: lista de prefijos de nombres de modelo o nombres de modelo de iOS, separados por espacios. Permite al desarrollador especificar que ciertos dispositivos usen alta resolución y otros resolución estándar. Este atributo solo está disponible en iOS (el elemento requestedDisplayResolution está anidado en el elemento iPhone). El atributo excludeDevices está disponible a partir de AIR 3.6.

Para dispositivos cuyo nombre de modelo se especifique en este atributo, el valor de requestedDisplayResolution es el opuesto al especificado. Es decir, si el valor de requestedDisplayResolution es alta, los dispositivos excluidos usan resolución estándar. Si el valor de requestedDisplayResolution es estándar, los dispositivos excluidos usan resolución alta.

Los valores son prefijos de nombres de modelo o nombres de modelo de dispositivos iOS. Por ejemplo, el valor iPad3,1 hace referencia específica a un iPad con Wi-Fi de tercera generación (pero no a iPads GSM o CDMA de tercera generación). El valor iPad3 también se puede referir a cualquier iPad de tercera generación. Encontrará una lista no oficial de nombres de modelo de iOS en la página de modelos de iPhone wiki.

Ejemplos

Escritorio:

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

iOS:

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

resizable

Especifica si la ventana se puede cambiar de tamaño.

Nota: en los sistemas operativos como Mac OS X en los cuales la maximización de las ventanas es una operación de redimensionamiento, para que la ventana no cambie de tamaño, tanto "maximizable" como "resizable" deben definirse en false.

Elemento principal:initialWindow

Elementos secundarios:

Contenido

true (predeterminado) o false

Ejemplo

<resizable>false</resizable>

softKeyboardBehavior

Especifica el comportamiento predeterminado de la aplicación cuando se muestra un teclado virtual. El comportamiento predeterminado es desplazar la aplicación hacia arriba. El motor de ejecución mantiene el campo de texto u objeto interactivo seleccionados en pantalla. Utilice la opción pan si la aplicación no proporciona su propia lógica de administración de teclado.

También puede desactivar el comportamiento automático estableciendo el elemento softKeyboardBehavior en none. En este caso, los campos de texto y los objetos interactivos distribuyen un evento SoftKeyboardEvent cuando el teclado de software se activa, pero el motor de ejecución no desplaza ni cambia el tamaño de la aplicación. Es responsabilidad de la aplicación mantener el área de entrada de texto visible.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

none o pan. El valor predeterminado es pan.

Ejemplo

<softKeyboardBehavior>none</softKeyboardBehavior>

supportedLanguages

Identifica los idiomas admitidos en la aplicación. Este elemento solamente se utiliza en iOS, el motor de ejecución captador de Mac y en aplicaciones de Android. Este elemento se omite en todos los demás tipos de aplicaciones.

Si no especifica este elemento, el empaquetador lleva a cabo de forma predeterminada las siguientes acciones en función del tipo de aplicación:

  • iOS: todos los idiomas admitidos por el motor de ejecución de AIR se enumeran en el App Store de iOS como idiomas admitidos de la aplicación.

  • Motor de ejecución captador de Mac: la aplicación empaquetada con el paquete captador no contiene información de localización.

  • Android: el paquete de la aplicación tiene los recursos para todos los idiomas admitidos por el motor de ejecución de AIR.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

Una lista de los idiomas admitidos, delimitada con espacios. Los valores de idioma válidos son los valores ISO 639‑1 de los idiomas admitidos por el motor de ejecución de AIR: en, de, es, fr, it, ja, ko, pt, ru, cs, nl, pl, sv, tr, zh, da, nb, iw.

El empaquetador genera un error en caso de encontrar un valor vacío en el elemento <supportedLanguages>.

Nota: las etiquetas localizadas (por ejemplo, el nombre de etiqueta) omiten el valor del idioma i se utiliza la etiqueta <supportedLanguages> y no contiene el idioma. Si una extensión nativa tiene recursos para un idioma no especificado por la etiqueta <supportedLanguages>, se emite una advertencia y los recursos se omiten para dicho idioma.

Ejemplo

<supportedLanguages>en ja fr es</supportedLanguages>

supportedProfiles

Identifica los perfiles compatibles con la aplicación.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

Es posible incluir cualquiera de estos valores en el elemento supportedProfiles:

  • desktop: el perfil de escritorio define las aplicaciones de AIR que están instaladas en un equipo de escritorio utilizando un archivo de AIR. Estas aplicaciones no tienen acceso a la clase NativeProcess (que proporciona comunicación con las aplicaciones nativas).

  • extendedDesktop: el perfil de escritorio ampliado define las aplicaciones de AIR que se encuentran instaladas en un equipo de escritorio utilizando un instalador de aplicaciones nativas. Estas aplicaciones tienen acceso a la clase NativeProcess (que proporciona comunicación con las aplicaciones nativas).

  • mobileDevice: perfil del dispositivo móvil para las aplicaciones móviles.

  • extendedMobileDevice: el perfil de dispositivo móvil ampliado no está en uso actualmente.

La propiedad supportedProfiles es opcional. Si no se incluye este elemento en el archivo descriptor de la aplicación, esta se puede compilar e implementar para cualquier perfil.

Para especificar varios perfiles, separe cada uno de ellos con carácter de espacio. Por ejemplo, la siguiente configuración especifica que la aplicación solo está disponible en los perfiles de escritorio y ampliados:

<supportedProfiles>desktop extendedDesktop</supportedProfiles>
Nota: cuando se ejecuta una aplicación con ADL y no se especifica ningún valor para la opción -profile de ADL, se utiliza el primer perfil en el descriptor de la aplicación. (Si tampoco se especifican perfiles es el descriptor de la aplicación, se utilizará el perfil de escritorio.)

Ejemplo

<supportedProfiles>desktop mobileDevice</supportedProfiles>

systemChrome

Especifica si la ventana de la aplicación inicial se crea con la barra de título estándar, los bordes y los controles que proporciona el sistema operativo.

El fondo cromático de una ventana no se puede cambiar en tiempo de ejecución.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Uno de los valores siguientes:

  • none: no se proporciona ningún fondo cromático. La aplicación (o un marco de la aplicación como Flex) es responsable de mostrar el fondo cromático de la ventana.

  • standard (valor predeterminado): el fondo cromático del sistema lo proporciona el sistema operativo.

Ejemplo

<systemChrome>standard</systemChrome>

text

Especifica una cadena localizada.

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 la aplicación de AIR utiliza el elemento text con el valor de atributo xml:lang que más coincide con el idioma de la interfaz de usuario del sistema operativo del usuario.

Por ejemplo, considere una instalación en la que un elemento text incluye un valor para la configuración local de inglés en (inglés). 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-UV, el instalador de aplicaciones de AIR utiliza el valor es-ES.

Si la aplicación no define ningún elemento text que coincide con los idiomas de la interfaz de usuario del sistema, el instalador de aplicaciones de AIR utiliza el primer valor name definido en el archivo descriptor de la aplicación.

Elementos principales:

Elementos secundarios: ninguno

Contenido

Un atributo xml:lang que especifica una configuración regional y una cadena de texto localizado.

Ejemplo

<text xml:lang="fr">Bonjour AIR</text>

title

Especifica el título mostrado en la barra de título de la ventana de la aplicación.

Un título solo se muestra si el elemento systemChrome se define como standard.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Cadena que contiene el título de la ventana.

Ejemplo

<title>Example Window Title</title>

transparent

Especifica si la ventana de la aplicación inicial es de mezcla alfa con el escritorio.

Una ventana con transparencia activada puede dibujarse más lentamente y necesitar más memoria. La opción de transparencia no puede modificarse durante el tiempo de ejecución.

Importante: solo se puede definir transparent en true si systemChrometiene el valor.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<transparent>true</transparent>

version

Especifica la información sobre la versión para la aplicación.

La cadena de la versión es un designador definido por la aplicación. AIR no interpreta la cadena de versión de ningún modo. 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".

En AIR 2.5 y posterior, el elemento version se sustituye por los elementos versionNumber y versionLabel.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

Cadena que contiene la versión de la aplicación.

Ejemplo

<version>0.1 Alpha</version>

versionLabel

Especifica una cadena de versión legible para el usuario.

El valor de la etiqueta de la versión se muestra en los cuadros de diálogo de instalación en lugar del valor del elemento versionNumber. Si no se utiliza versionLabel, versionNumber se usa para ambos.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

Cadena que contiene el texto de la versión mostrada públicamente.

Ejemplo

<versionLabel>0.9 Beta</versionlabel>

versionNumber

Número de versión de la aplicación.

Elemento principal:application

Elementos secundarios: ninguno

Contenido

El número de versión puede contener una secuencia de hasta tres enteros separados por puntos. Cada entero debe ser un número entre 0 y 999 (incluido).

Ejemplos

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

visible

Especifica si la ventana de la aplicación inicial se puede ver tras su creación.

Las ventanas de AIR, incluyendo la ventana inicial, se crean en un estado visible de forma predeterminada. Se podrá mostrar una ventana llamando al método activate() del objeto NativeWindow o cambiando la propiedad visible a true. 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.

El componente mx:WindowedApplication de Flex muestra y activa la ventana de forma automática inmediatamente antes de distribuir el evento applicationComplete, a menos que el atributo visible esté definido en false en la definición MXML.

En los dispositivos en el perfil móvil, que no admite ventanas, la configuración visible se omite.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

true o false (predeterminado)

Ejemplo

<visible>true</visible>

width

Anchura inicial de la ventana principal de la aplicación.

Si no se establece una anchura, esta se determina mediante los ajustes en el archivo raíz SWF, o bien, en el caso de una aplicación de AIR basada en HTML, mediante el sistema operativo.

Anchura máxima de una ventana modificada de 2048 píxeles a 4096 píxeles en AIR 2.

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Entero positivo con un valor máximo de 4095.

Ejemplo

<width>1024</width>

x

Posición horizontal de la ventana de la aplicación inicial.

En la mayoría de los casos, es mejor permitir que el sistema operativo determine la posición inicial de la ventana en lugar de asignar un valor fijo.

El origen del sistema de coordenadas de pantalla (0,0) es la esquina superior izquierda de la pantalla del escritorio principal (tal y como se determina mediante el sistema operativo).

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Valor entero.

Ejemplo

<x>120</x>

y

Posición vertical de la ventana de la aplicación inicial.

En la mayoría de los casos, es mejor permitir que el sistema operativo determine la posición inicial de la ventana en lugar de asignar un valor fijo.

El origen del sistema de coordenadas de pantalla (0,0) es la esquina superior izquierda de la pantalla del escritorio principal (tal y como se determina mediante el sistema operativo).

Elemento principal:initialWindow

Elementos secundarios: ninguno

Contenido

Valor entero.

Ejemplo

<y>250</y>