Definición de la configuración de actualización en un archivo de configuración XML

El archivo de configuración de actualización es un archivo XML. Puede incluir los siguientes elementos:

  • updateURL : una cadena. Representa la ubicación del descriptor de actualización en el servidor remoto. Se permite cualquier ubicación URLRequest válida. Se debe definir la propiedad updateURL , a través del archivo de configuración o mediante un script (consulte Definición del archivo descriptor de actualización y adición del archivo de AIR al servidor web ). Esta propiedad se debe definir antes de utilizar el elemento updater (antes de llamar al método initialize() del objeto updater, descrito en Inicialización del marco de actualización ).

  • delay : un número. Representa un intervalo de tiempo determinado en días (se permiten valores similares a 0,25 ) para buscar actualizaciones. El valor de 0 (valor predeterminado) especifica que updater no realiza ninguna comprobación periódica automática.

El archivo de configuración para ApplicationUpdaterUI puede incluir el siguiente elemento además de los elementos updateURL y delay :

  • defaultUI : una lista de elementos dialog . Cada elemento dialog dispone de un atributo name que se corresponde con el cuadro de diálogo en la interfaz de usuario. Todos los elementos dialog cuentan con un atributo visible que define si el cuadro de diálogo es visible. El valor predeterminado es true . Entre los posibles valores para el atributo name se encuentran los siguientes:

    • "checkForUpdate" : corresponde a los cuadros de diálogo de búsqueda de actualizaciones, sin actualizaciones y error de actualización.

    • "downloadUpdate" : corresponde al cuadro de diálogo de descarga de actualizaciones.

    • "downloadProgress" : corresponde a los cuadros de diálogo de progreso y error de descarga.

    • "installUpdate" : corresponde al cuadro de diálogo de instalación de la actualización.

    • "fileUpdate" : corresponde a los cuadros de diálogo de actualización de archivo, no actualización de archivo y error de archivo.

  • "unexpectedError" : corresponde al cuadro de diálogo de error inesperado.

    Cuando se establece en false , el cuadro de diálogo correspondiente no aparece como parte del proceso de actualización.

A continuación se incluye un ejemplo del archivo de configuración para el marco ApplicationUpdater: 

<?xml version="1.0" encoding="utf-8"?> 
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
      <url>http://example.com/updates/update.xml</url> 
      <delay>1</delay> 
</configuration>

Se muestra un ejemplo del archivo de configuración para el marco ApplicationUpdaterUI, que incluye una definición para el elemento defaultUI : 

<?xml version="1.0" encoding="utf-8"?> 
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
      <url>http://example.com/updates/update.xml</url> 
      <delay>1</delay> 
      <defaultUI> 
         <dialog name="checkForUpdate" visible="false" /> 
         <dialog name="downloadUpdate" visible="false" /> 
         <dialog name="downloadProgress" visible="false" /> 
      </defaultUI> 
</configuration>

Seleccione la propiedad configurationFile en la ubicación de ese archivo:

Ejemplo de ActionScript: 

appUpdater.configurationFile = new File("app:/cfg/updateConfig.xml");
Ejemplo de JavaScript: 
appUpdater.configurationFile = new air.File("app:/cfg/updateConfig.xml");

El directorio de plantillas del marco de actualización incluye un archivo de configuración de ejemplo, config-template.xml.