El archivo descriptor de la aplicación es un archivo XML que contiene propiedades para toda la aplicación, como su nombre, versión, copyright y otros ajustes.
Flash Professional CS5 genera un archivo descriptor de la aplicación a partir de la configuración del cuadro de diálogo Configuración de iPhone. Sin embargo, también es posible editar el archivo descriptor de la aplicación en un editor de texto. Flash Professional denomina el archivo descriptor de la aplicación añadiéndole “-app.xml” al nombre del proyecto. Por ejemplo, el archivo descriptor de la aplicación de un proyecto HelloWorld sería HelloWorld-app.xml. Edite el archivo descriptor de la aplicación si desea definir ajustes no admitidos en el cuadro de diálogo Configuración de iPhone de Flash Professional CS5. Por ejemplo, puede definir el elemento
InfoAdditions
para que establezca los parámetros info.Plist de la aplicación.
El siguiente es un ejemplo de archivo descriptor de una aplicación:
Tiene los detalles de los parámetros de este archivo descriptor de la aplicación:
-
En el elemento
<application>
, el espacio de nombres AIR 2.0 es necesario para poder crear aplicaciones para iPhone:
<application xmlns="http://ns.adobe.com/air/application/2.0">
-
El elemento
<id>
:
<id>com.example.as3.HelloWorld</id>
El ID de la aplicación la identifica de forma exclusiva. La forma recomendada es una cadena de estilo DNS inversa delimitada por puntos como, por ejemplo,
"com.company.AppName"
. El compilador utiliza este valor como ID de paquete de la aplicación para iPhone.
Si el archivo de suministro está vinculado a un ID de aplicación concreto, debe usar dicho ID de aplicación en este elemento. Descarte los caracteres que Apple asigna al inicio del ID de aplicación de Apple (denominados ID de raíz del paquete). Por ejemplo, si el ID de aplicación del perfil de suministro es 96LPVWEASL.com.example.bob.myApp, utilice com.example.bob.myApp como ID de aplicación en el archivo descriptor de la aplicación.
Si el perfil de suministro admite varios ID de aplicación (comodín), su ID de aplicación terminará con un asterisco (por ejemplo, 5RM86Z4DJM.*). Proporcione un ID de aplicación que coincida con el patrón de comodines de ID de aplicación que suministró a Apple:
-
Si su ID de aplicación de Apple es com.miDominio.*, el ID de aplicación del archivo descriptor de la aplicación debe comenzar con com.miDominio. Puede especificar un ID de aplicación como com.miDominio.miAplicacion o com.miDominio.aplicacion22.
-
Si su ID de aplicación de Apple es *, el ID de aplicación del archivo descriptor de la aplicación puede ser cualquier cadena de caracteres válidos.
Encontrará el ID de aplicación de Apple (o el patrón de ID de aplicación comodín) asociado a su perfil de suministro en el centro de desarrollo de iPhone (
http://developer.apple.com/iphone
). Vaya a Program Portal del centro de desarrollo de iPhone y acceda a la sección Provisioning (Suministro).
Importante:
no tenga en cuenta los caracteres que preceden al ID de aplicación de Apple. Apple se refiere a esta cadena como ID de raíz del paquete. Por ejemplo, si Apple muestra su ID de aplicación como 5RM86Z4DJM.*, omita 5RM86Z4DJM: es un ID de aplicación comodín. Si Apple muestra su ID de aplicación como 96LPVWEASL.com.example.bob.myApp, omita 96LPVWEASL: utilice com.example.bob.myApp como ID de aplicación.
-
El elemento
<filename>
:
<filename>HelloWorld</filename>
El nombre utilizado para el archivo de instalación del iPhone. No incluya un carácter de signo (+) en el nombre de archivo.
-
El elemento
<name>
:
<name>Hello World</name>
El nombre de la aplicación que se visualiza en iTunes y en el iPhone. No incluya un carácter de signo (+) en el nombre.
-
El elemento
<version>
:
<version>1.0</version>
Ayuda a los usuarios a determinar qué versión de la aplicación se está instalando. Esta versión se utiliza como elemento CFBundleVersion de la aplicación para iPhone. Debe estar en formato similar a nnnnn[.nn[.nn]] donde n es un dígito entre 0 y 9 y los corchetes indican componentes opcionales, como 1, 1.0 o 1.0.1. de iPhone deben contener sólo dígitos y puntos decimales. Las versiones de iPhone pueden contener hasta dos puntos decimales.
-
El elemento
<initialWindow>
contiene los siguientes elementos secundarios para especificar las propiedades del aspecto inicial de la aplicación:
<content>HelloWorld.swf</content>
Identifica el archivo SWF raíz para compilarlo en la aplicación para iPhone.
<visible>true</visible>
Parámetro necesario.
<fullScreen>true</fullScreen>
Especifica que la aplicación utiliza toda la pantalla en el iPhone.
<aspectRatio>portrait</aspectRatio>
Especifica que la proporción de aspecto inicial de la aplicación es vertical (no horizontal). Tenga en cuenta que el archivo Default.png utilizado para definir la ventana inicial de la aplicación debe tener 320 píxeles de ancho por 480 píxeles de alto, independientemente de este ajuste. (Consulte la sección
Icono de iPhone e imágenes de pantalla inicial
.)
<autoOrients>true</autoOrients>
(Opcional) Especifica si la orientación del contenido se ajusta automáticamente al cambiar la orientación física del dispositivo. El valor predeterminado es
true
. Puede cancelar la orientación automática llamando al método
preventDefault()
de un evento
orientationChanging
. distribuido por el objeto Stage. Para obtener más información, consulte
Definición y detección de la orientación de pantalla
.
Si utiliza la orientación automática, para obtener los mejores resultados, establezca la propiedad
align
de Stage en lo siguiente:
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
<renderMode>gpu</renderMode>
(Opcional) El modo de procesamiento utilizado por la aplicación. Existen tres parámetros posibles:
-
cpu
: la aplicación utiliza la CPU para procesar todos los objetos de visualización. No se utiliza aceleración de hardware.
-
gpu
: la aplicación utiliza la GPU del iPhone para componer mapas de bits.
-
automático
: esta función no se ha implementado.
Para obtener más información, consulte la sección
Aceleración de hardware
.
-
El elemento
<profiles>
:
<profiles>mobileDevice</profiles>
Limita la compilación de la aplicación únicamente al perfil del dispositivo móvil. De momento, este perfil solamente admite aplicaciones para iPhone. Hay tres perfiles admitidos:
-
desktop
: una aplicación de AIR de escritorio.
-
extendedDesktop
: una aplicación de AIR de escritorio compatible con API de procesos nativos.
-
mobileDevice
: una aplicación de AIR para dispositivo móvil. Actualmente, el iPhone es el único dispositivo móvil admitido.
Limitar la aplicación a perfiles determinados impedirá que se pueda compilar en otros. Si no especifica ningún perfil, podrá compilar la aplicación para cualquiera de los tres. Puede especificar varios perfiles incluyéndolos (separados por espacios) en el elemento
<profiles>
.
No olvide incluir
mobileDevice
como perfil admitido (o deje el elemento
<profiles>
vacío).
-
El elemento
<icon>
contiene los siguientes elementos secundarios para especificar los iconos utilizados en la aplicación:
<image29x29>icons/icon29.png</image29x29>
Imagen que se utiliza en los resultados de búsqueda de Spotlight.
<image48x48>icons/icon48.png</image48x48>
Imagen que se utiliza en los resultados de búsqueda de Spotlight en el iPad.
<image57x57>icons/icon57.png</image57x57>
Imagen que se utiliza en la pantalla de inicio del iPhone y del iPod Touch.
<image72x72>icons/icon72.png</image72x72>
Imagen que se utiliza en la pantalla de inicio del iPad.
<image512x512>icons/icon512.png</image512x512>
Imagen que se utiliza en la aplicación iTunes.
La herramienta Packager for iPhone utiliza iconos de 29, 57, y 512 píxeles incluidos como referencia en el archivo descriptor de la aplicación. La herramienta los copia en archivos llamados Icon-Small.png, Icon.png y iTunesArtwork respectivamente. Para evitar que se haga esta copia, puede empaquetar los archivos directamente. Para ello, colóquelos en el directorio que contiene el archivo descriptor de la aplicación y elija los nombres y rutas adecuados.
La imagen de 512 píxeles es sólo para uso interno. Cuando envíe una aplicación a Apple, enviará la imagen de 512 píxeles por separado. No está incluida en el IPA. Especifíquelo para asegurarse de que la imagen de 512 píxeles se ve bien en iTunes antes de enviarla.
-
El elemento
<iPhone>
contiene los siguientes elementos secundarios para especificar ajustes específicos del iPhone:
<InfoAdditions></InfoAdditions>
Contiene los elementos secundarios que especifican pares de clave-valor para usarlos como parámetros de Info.plist en la aplicación:
<![CDATA[
<key>UIStatusBarStyle</key>
<string>UIStatusBarStyleBlackOpaque</string>
<key>UIRequiresPersistentWiFi</key>
<string>NO</string>
]]>
En este ejemplo, los valores definen la barra de estado de la aplicación y establecen que la aplicación no requiere acceso permanente a redes Wi-Fi.
Los parámetros de InfoAdditions se encierran entre etiquetas
CDATA
.
Para compatibilidad con el iPad, incluya la configuración de clave-valor de
UIDeviceFamily
. La configuración de
UIDeviceFamily
se expresa en un conjunto de cadenas. Cada cadena define los dispositivos admitidos. La configuración
<string>1</string>
define la compatibilidad con el iPhone y el iPod touch. La configuración
<string>2</string>
define la compatibilidad con el iPad. La configuración
<string>3</string>
define la compatibilidad con tvOS. Si especifica solo una de estas cadenas, solo se admitirá dicha familia de dispositivos. Por ejemplo, la siguiente configuración limita la compatibilidad al iPad:
<key>UIDeviceFamily</key>
<array>
<string>2</string>
</array>>
La siguiente configuración define la compatibilidad con ambas familias de dispositivos (iPhone/iPod touch e iPad):
<key>UIDeviceFamily</key>
<array>
<string>1</string>
<string>2</string>
</array>
Para obtener información sobre otros parámetros de Info.plist, consulte la documentación para desarrolladores de Apple.
