Exemplo básico: Uso da versão ApplicationUpdaterUI

A versão ApplicationUpdaterUI da estrutura de atualização fornece uma interface básica que pode ser facilmente usada no seu aplicativo. A seguir há um exemplo básico:

Primeiro, crie um aplicativo do AIR que chame a estrutura de atualização:

  1. Se seu aplicativo for um aplicativo do AIR baseado em HTML, carregue o arquivo applicationupdaterui.swf: 

    <script src="ApplicationUpdater_UI.swf" type="application/x-shockwave-flash"/>

  2. Na lógica de programação do aplicativo do AIR, instancie um objeto do ApplicationUpdaterUI.

    No ActionScript, use o seguinte código: 

    var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();

    No JavaScript, use o seguinte código: 

    var appUpdater = new runtime.air.update.ApplicationUpdaterUI();

    Você pode adicionar esse código a uma função de inicialização executada quando o aplicativo é carregado.

  3. Crie um arquivo de texto updateConfig.xml e adicione o seguinte a ele: 

    <?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>

    Edite o elemento URL do arquivo updateConfig.xml para que corresponda à localização eventual do arquivo de descritor de atualização do seu servidor da Web (veja o próximo procedimento).

    O delay é o número de dias que o aplicativo aguarda entre as verificações de atualizações.

  4. Adicione o arquivo updateConfig.xml ao diretório do projeto do seu aplicativo do AIR.

  5. Faça com que o objeto updater referencie o arquivo updateConfig.xml e chame o método initialize() do objeto.

    No ActionScript, use o seguinte código: 
    appUpdater.configurationFile = new File("app:/updateConfig.xml"); 
appUpdater.initialize();
    No JavaScript, use o seguinte código: 
    appUpdater.configurationFile = new air.File("app:/updateConfig.xml"); 
appUpdater.initialize();

  6. Crie uma segunda versão do aplicativo do AIR que tenha uma versão diferente do primeiro aplicativo. (A versão é especificada no arquivo de descritor do aplicativo, no elemento version .)

Em seguida, adicione a versão de atualização do aplicativo do AIR ao servidor da Web:

  1. Coloque a versão de atualização do arquivo AIR no servidor da Web.

  2. Crie um arquivo de texto updateDescriptor.2.5.xml e adicione o seguinte conteúdo a ele: 

    <?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

    Edite versionNumber , URL e description do arquivo updateDescriptor.xml para que corresponda ao seu arquivo do AIR. Este formato de descritor de atualização é usado por aplicativos que utilizam a estrutura de atualização incluída com o AIR 2.5 SDK (e posterior).

  3. Crie um arquivo de texto updateDescriptor.1.0.xml e adicione o seguinte conteúdo a ele: 

    <?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
       <version>1.1</version> 
       <url>http://example.com/updates/sample_1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

    Edite version , URL e description do arquivo updateDescriptor.xml para que corresponda ao seu arquivo AIR. Este formato de descritor de atualização é usado por aplicativos que utilizam a estrutura de atualização incluída com o AIR 2 SDK (e anterior).

    Nota: A criação deste segundo arquivo descritor de atualização só é necessária quando você oferece suporte para a atualização para aplicativos criados antes do AIR 2.5.

  4. Inclua os arquivos updateDescriptor.2.5.xml e updateDescriptor.1.0.xml no mesmo diretório do servidor Web que contém o arquivo AIR de atualização.

Esse é um exemplo básico, mas fornece a funcionalidade de atualização suficiente para vários aplicativos. O restante deste documento descreve como usar a estrutura de atualização para atender melhor suas necessidades.

Para obter outro exemplo de uso da estrutura de atualização, consulte o aplicativo de amostra a seguir no Adobe AIR Developer Center: