19.11.2012 Views

Building Adobe AIR Applications

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

CREACIÓN DE APLICACIONES DE ADOBE <strong>AIR</strong><br />

Actualización de aplicaciones de <strong>AIR</strong><br />

Definición del archivo descriptor de actualización y adición del archivo de <strong>AIR</strong><br />

al servidor web<br />

Cuando se utiliza el marco de actualización de <strong>AIR</strong>, se define la información básica sobre la actualización disponible<br />

en un archivo descriptor de actualización, almacenado en el servidor web. Un archivo descriptor de actualización es<br />

un sencillo archivo XML. El marco de actualización incluido en la aplicación comprueba este archivo para ver si se ha<br />

cargado una nueva versión.<br />

Formato del archivo descriptor de actualización modificado para <strong>AIR</strong> 2.5. El nuevo formato utiliza un espacio de<br />

nombres distinto. El espacio de nombres original es “http://ns.adobe.com/air/framework/update/description/1.0”. El<br />

espacio de nombres de <strong>AIR</strong> 2.5 es “http://ns.adobe.com/air/framework/update/description/2.5”.<br />

Las aplicaciones de <strong>AIR</strong> creadas antes de <strong>AIR</strong> 2.5 sólo pueden leer el descriptor de actualización 1.0 de la versión. Las<br />

aplicaciones de <strong>AIR</strong> creadas utilizando el marco actualizador incluido en <strong>AIR</strong> 2.5 o posterior sólo pueden leer el<br />

descriptor de actualización de la versión 2.5. Debido a esta incompatibilidad de versiones, en ocasiones es necesario<br />

crear dos archivos del descriptor de actualización. La lógica de actualización en las versiones de <strong>AIR</strong> 2.5 de la aplicación<br />

debe descargar un descriptor de actualización que utilice el nuevo formato. Las versiones anteriores de la aplicación<br />

de <strong>AIR</strong> deben continuar utilizando el formato original. Ambos archivos deben modificarse para cada actualización que<br />

se publique (hasta que deje de admitir versiones creadas antes de <strong>AIR</strong> 2.5).<br />

El archivo descriptor de actualización contiene los siguientes datos:<br />

versionNumber: la nueva versión de la aplicación de <strong>AIR</strong>. Utilice el elementoversionNumber en los descriptores<br />

de actualización para actualizar las aplicaciones de <strong>AIR</strong> 2.5. El valor debe ser la misma cadena que se utiliza en el<br />

elemento versionNumber del nuevo archivo descriptor de la aplicación de <strong>AIR</strong>. El número de versión del archivo<br />

descriptor no coincide con el número de versión del archivo de actualización de <strong>AIR</strong>, el marco de actualización<br />

emitirá una excepción.<br />

version: nueva versión de la aplicación de <strong>AIR</strong>. Utilice el elemento version en los descriptores de actualización<br />

utilizados para actualizar las aplicaciones creadas antes de <strong>AIR</strong> 2.5. El valor debe ser la misma cadena empleada en<br />

el elemento de la versión version del nuevo archivo descriptor de la aplicación de <strong>AIR</strong>. Si la versión del archivo<br />

descriptor no coincide con la versión del archivo de actualización de <strong>AIR</strong>, el marco de actualización emitirá una<br />

excepción.<br />

versionLabel: cadena de versión que puede leer el usuario para mostrar a los usuarios. versionLabel es<br />

opcional, pero sólo se puede especificar en los archivos del descriptor de actualización de la versión 2.5. Utilícelo si<br />

se emplea un elemento versionLabel en el descriptor de la aplicación y establézcalo en el mismo valor.<br />

url: ubicación del archivo de actualización de <strong>AIR</strong>. Se trata del archivo que contiene la versión de actualización de<br />

la aplicación de <strong>AIR</strong>.<br />

description: información sobre la nueva versión. Esta información se puede mostrar al usuario durante el<br />

proceso de actualización.<br />

Los elementos version y url son obligatorios. El elemento description es opcional.<br />

A continuación se incluye un archivo descriptor de actualización de ejemplo de la versión 2.5:<br />

<br />

<br />

1.1.1<br />

http://example.com/updates/sample_1.1.1.air<br />

This is the latest version of the Sample application.<br />

<br />

A continuación se incluye un archivo descriptor de actualización de ejemplo de la versión 1.0:<br />

Última modificación 30/10/2012<br />

272

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!