El siguiente diccionario de elementos describe cada uno de los elementos válidos de un archivo descriptor de la aplicación de AIR.
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:
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:
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.
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.
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:
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:
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:
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
name
no
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 elemento
filename
).
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 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
systemChrome
tiene 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
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
|
|
|