App Descriptor File
El Archivo App-Descriptor es un archivo de aplicacion .xml, el cual puede ser generado manualmente o desde algún plugin, según el entorno de trabajo que estemos utilizando, tendremos la posibilidad de ir completando los datos necesarios de la aplicación mediante un formulario, el resultado final sera un archivos con el nombre de la aplicacion y de extension xml, este archivo se puede generar mediante cualquier editor de texto, es por esto que voy a dejar un tipico Descriptor el cual con pequeñas modificaciones puede ser utilizado para cualquier proyecto que estemos empezando.
<?xml version="1.0" encoding="UTF-8"?> <application xmlns="http://ns.adobe.com/air/application/1.5"> <id>com.aircmr.HelloWorld</id> <version>0.1</version> <filename>HelloWorld</filename> <name>Hello World</name> <description>An AIR app to say Hello</description> <initialWindow> <content>HelloWorld.swf</content> <title>Hello World</title> <systemChrome>standard</systemChrome> <transparent>false</transparent> <visible>true</visible> </initialWindow> <installFolder>AIRCMR/HelloWorld</installFolder> <programMenuFolder>AIRCMR</programMenuFolder> </application>
Cada uno de estos paramentros tiene un significado y una razón de ser que tratare de explicar.
Atributos hijos del nodo raíz:
- Id: identificador único de la aplicación en modalidad string (reversed url rocomendado)
- Versión: string identificando nombre número o nombre de la versión actual
- Filename: nombre del archivo .air (sin extension) luego de realizar la compilación con el SDK
- Name (opcional): nombre de la aplicación utilizado por el instalador
- Description (opcional): texto descriptivo utilizado por el instalador
- Copyright (opcional): texto descriptivo utilizado por el instalador
- installFolder (opcional): subcarpeta dentro de Archivos de Programa donde queremos que la aplicación se instale (usar “/” como separador)
- programaMenuFolder (opcional): ubicación en el menú inicio del sistema operativo donde ubicar el acceso directo a la aplicación
Nodo hijo initialWindow, representando la ventana inicial
- Content: URL (dentro del paquete) del archivo inicial a cargar en la aplicación AIR, Puede ser un HTML o un SWF
- Title: Titulo de la ventana en el sistema operativo
- systemChrome: Standard define el borde clásico del SO. None no genera ningún borde.
- Transparent: Define un fondo transparente sobre el sistema operative. Solo puede ser true si systemChrome es none
- Visible: Se puede poner en false para que no se vea nada hasta que hayamos dibujado toda la página.
- X, y width, height
- Minimizable
- Maximizable
- Resizable
Iconos de la aplicación, nodo “icon” tiene subnodos
- Image16x16
- Image32x32
- Image64x64
- Image128x128
Los iconos deben ser en formato PNG, es recomendable probar que se vean bien en 16 bits
Si queremos que se pueda abrir desde el browser:
- allowBrowserInvocation en tue
Si queremos abrir archivos de un tipo determinado, en el nodo fileTypes creamos por cada tipo con:
- Name: nombre interno del formato
- extensión: extension que queremos capturar (sin .)
- descrition: texto descritivo que aparece en el SO
- contentType: tipo Mime
- icon: tiene hijos por cada tamaño
Si el usuario abre un contenido registrado por nuestro AIR, se generará un evento InvokeEvent.
Tags: Air, Descriptor
Posted in Air | No Comments »
