ApplicationUpdaterUI  - AS3

O local do arquivo de configuração que define os valores das propriedades delay e updateURL. Ele também tem configurações para determinar se o aplicativo exibe várias caixas de diálogo de confirmação durante o processo de atualização. Caso essa propriedade aponte para um arquivo não existente, chamar o método initialize() resulta no lançamento de um erro.

Este é um arquivo de configuração de amostra:

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

Em vez de carregar um arquivo de configuração, você pode usar o código ActionScript para definir as propriedades a seguir do objeto ApplicationUpdaterUI: propriedades delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible e updateURL.

Elementos da API relacionados

A versão atual do aplicativo. Essa propriedade é definida durante uma chamada para o método initialize(). Ela é definida como a versão do arquivo descritor do aplicativo.

O intervalo, em dias, entre as verificações periódicas de novas atualizações.

Um valor igual a 0 (o valor padrão) indica que o timer não está ativo, logo, nenhuma verificação periódica é feita. Esse atraso pode ser definido por meio dessa propriedade ou do arquivo de configuração. Quando o valor está definido para usar ambos os métodos, é usado o valor definido com essa propriedade.

O valor padrão é 0.

Elementos da API relacionados

Permite a visibilidade das caixas de diálogo Verificar atualizações, Nenhuma atualização e Erro de atualização. Quando definido como true, o atualizador exibe essas caixas de diálogo como parte do processo de atualização. Isso também pode ser definido no arquivo de configuração da atualização. Um valor definido com essa propriedade substitui a configuração no arquivo de configuração da atualização.

Permite a visibilidade da caixa de diálogo Baixar atualização. Quando definido como true, o atualizador exibe essa caixa de diálogo como parte do processo de atualização. Isso também pode ser definido no arquivo de configuração da atualização. Um valor definido com essa propriedade substitui a configuração no arquivo de configuração da atualização.

Permite a visibilidade da caixa de diálogo Baixar atualização. Quando definido como true, o atualizador exibe essas caixas de diálogo como parte do processo de atualização. Isso também pode ser definido no arquivo de configuração da atualização. Um valor definido com essa propriedade substitui a configuração no arquivo de configuração da atualização.

Permite a visibilidade das caixas de diálogo Atualização de arquivo, Nenhuma atualização de arquivo e Erro de arquivo. Quando definido como true, o atualizador exibe essas caixas de diálogo como parte do processo de atualização. Isso também pode ser definido no arquivo de configuração da atualização. Um valor definido com essa propriedade substitui a configuração no arquivo de configuração da atualização.

Independentemente desta ser a primeira execução após uma atualização bem-sucedida (true) ou malsucedida (false). O atualizador define o valor durante a chamada para o método initialize(). O desenvolvedor deve verificar se isFirstRun está definido como true caso haja a necessidade de migração dos dados de uma versão para outra.

Elementos da API relacionados

Permite a visibilidade da caixa de diálogo Instalar atualização. Quando definido como true, o atualizador exibe essa caixa de diálogo como parte do processo de atualização. Isso também pode ser definido no arquivo de configuração da atualização. Um valor definido com essa propriedade substitui a configuração no arquivo de configuração da atualização.

Uma função que o atualizador deve usar para realizar comparações entre versões. Por padrão, a estrutura de atualização compara as versões para detectar se a versão do site remoto é mais recente do que a do aplicativo instalado. No entanto, às vezes a comparação padrão não corresponde ao esquema de versão do desenvolvedor. Defina essa propriedade para fornecer uma nova função que faça a comparação.

A função de comparação padrão aceita versões como x.y.z, em que x, y e z podem conter letras e dígitos. Existem algumas condições especiais reconhecidas pela função de comparação padrão. Caso a função de teste encontre "alpha", "beta" ou "rc" nas strings da versão, a ordem é alpha < beta < rc.

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

Permite a visibilidade da caixa de diálogo Erro inesperado. Quando definido como true, o atualizador de aplicativo exibe essa caixa de diálogo como parte do processo de atualização. Isso também pode ser definido no arquivo de configuração da atualização. Um valor definido com essa propriedade substitui a configuração no arquivo de configuração da atualização.

Uma propriedade Boolean que será true se uma atualização estiver sendo executada; caso contrário, será false.

Uma matriz que define a cadeia de local usada pela interface do usuário. Normalmente, apenas os desenvolvedores JavaScript (HTML) usam essa propriedade.

Os desenvolvedores Flex podem usar o ResourceManager para manipular a cadeia de código de idiomas.

Por padrão, em um aplicativo baseado em HTML, os idiomas são classificados entre os idiomas da matriz Capabilities.languages e os dez suportados pela interface de usuário. Caso não seja encontrada nenhuma correspondência, a interface de usuário usa o idioma inglês.

Este exemplo JavaScript usa a estrutura de localização HTML do AIR, incluída no SDK do AIR. Ele classifica os idiomas de acordo com a lista dos idiomas e, em seguida, define inglês como o idioma padrão:

 appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
        appUpdater.addResources("hu", {titleCheck: "Cím", msgCheck: "Üzenet"}); 
        var languages = ["ro", "hu"];
        languages = languages.concat(air.Capabilities.languages);
        var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");  
        sortedLanguages.push("en-US");
        appUpdater.localeChain = sortedLanguages;

Elementos da API relacionados

O local anterior do diretório de armazenamento do aplicativo, caso ele tenha sido alterado após uma atualização. O local do diretório de armazenamento do aplicativo é alterado após uma atualização com uma migração de certificado. Caso não haja nenhuma migração de certificado, o diretório de armazenamento do aplicativo não é alterado quando o usuário atualiza o aplicativo. e essa propriedade é definida como null. Essa propriedade é definida durante uma chamada para o método initialize().

Um desenvolvedor pode assinar uma nova versão do aplicativo do AIR com um novo certificado caso use a opção -migrate ao empacotar o arquivo AIR com ADT. Caso uma nova versão de um aplicativo do AIR use um novo certificado de assinatura, o diretório de armazenamento local do aplicativo é alterado quando o usuário instala a nova versão. Use essa propriedade para transferir dados do diretório de armazenamento do aplicativo anterior para o novo (File.applicationStorageDirectory). Para obter mais informações, consulte "Assinatura de um arquivo do AIR para alterar o certificado do aplicativo" no capítulo "Criação de aplicativo do AIR usando as ferramentas de linha de comando" do guia de desenvolvedor do Adobe AIR.

A versão anterior do aplicativo. Essa propriedade é definida durante uma chamada para o método initialize(). Restaura a versão anterior do aplicativo antes da atualização (só definida caso isfirstRun seja true); do contrário, ela é definida como null.

O conteúdo do arquivo de descritor de atualização baixado da URL de atualização. Essa propriedade só não é nula após o despacho do objeto updater de um evento updateStatus.

O local do arquivo de descritor de atualização. Qualquer local válido para um caminho URLRequest é aceito. Trata-se da única configuração exigida pelo atualizador. Você pode definir a URL de atualização por meio dessa propriedade ou do arquivo de configuração. Quando o valor está definido para usar ambos os métodos, o atualizador usa o valor definido com essa propriedade.

Elementos da API relacionados

Independentemente de haver uma atualização adiada, mesmo que tenha ocorrido falha na instalação (true); caso contrário, false. O atualizador define essa propriedade durante uma chamada para o método initialize(). Use as propriedades wasPendingUpdate e isFirstRun para verificar se houve falha na instalação de uma atualização (quando wasPendingUpdate é definido como true e isFirstRun, false).

Elementos da API relacionados

A função de construtor.

Adiciona dinamicamente um novo grupo de recursos para o idioma especificado. Os desenvolvedores JavaScript usam esse método para adicionar dinamicamente um novo idioma às caixas de diálogo exibidas pela interface de usuário do atualizador de aplicativo. (Os desenvolvedores Flex podem adicionar diretamente um novo idioma ao grupo de recursos "ApplicationUpdaterDialogs".)

Parâmetros

Elementos da API relacionados

Cancela o processo de atualização. A chamada desse método cancela todos os downloads pendentes, excluindo todos os arquivos baixados incompletos e reinicia o timer de verificação periódica.

O processo de atualização pode ser cancelado a qualquer momento, exceto quanto a máquina se encontra no estado "uninitialized" ou "initializing". Ele não faz nada quando chamado em um dos estados "uninitialized" ou "initializing".

Inicia o processo de atualização. A chamada desse método não para o timer periódico, mas o método detecta a execução de um processo de atualização e ignora a iteração atual.

Esse método só é executado caso o estado atual seja "Ready".

Esse método pode resultar no despacho do evento a seguir pelo objeto updater:

Inicializa o atualizador. A chamada desse método faz o seguinte:

1. Ela inicializa a estrutura de atualização, instalando silenciosamente (e de maneira síncrona) todas as atualizações pendentes. Você deve chamar esse método durante a inicialização do aplicativo, porque ele pode reiniciar o aplicativo.

2. Ele verifica se existe uma atualização adiada e a instala.

3. Caso algo tenha dado errado com uma atualização anterior, ele limpa o arquivo de atualização e as informações sobre a versão da área de armazenamento.

4. Caso o atraso do timer periódico tenha expirado, ele inicia o processo de atualização; do contrário, ele inicia o timer periódico. No entanto, ao testar um aplicativo usando o aplicativo AIR Debug Launcher (ADL), tentar atualizar o aplicativo resulta em uma exceção IllegalOperationError.

Inicia o processo de atualização usando um arquivo AIR local.

A chamada desse método não tem nenhum efeito caso haja um processo de atualização em execução (caso o estado não seja "Baixado").

Essa função é útil para um aplicativo cujo elemento customUpdateUI esteja definido como true no arquivo descritor do aplicativo.

Ao testar um aplicativo usando o aplicativo AIR Debug Launcher (ADL), chamar esse método resulta em uma exceção IllegalOperationError.

Parâmetros

Despachado logo antes da instalação da atualização, após o método installUpdate() ter sido chamado. Às vezes, é útil impedir a instalação da atualização no momento, porque o usuário poderia perder todo o trabalho atual quando o tempo de execução deixasse o aplicativo para instalar a atualização.

Chamar o método preventDefault() do evento adia a instalação até a próxima reinicialização. Caso você chame o método preventDefault(), nenhum processo de atualização adicional pode ser iniciado durante essa sessão de aplicativo (por meio de uma chamada para o método installUpdate() ou por conta da verificação periódica).

Esse evento tem as seguintes propriedades:

Despachado antes do início do processo de atualização e logo antes do atualizador tentar baixar o arquivo descritor de atualização. O atualizador pode despachar esse evento em decorrência da chamada direta do método checkNow() ou porque o timer de verificação periódica expirou.

Esse evento tem as seguintes propriedades:

Despachado quando o download do arquivo de atualização tiver sido concluído.

Esse evento tem as seguintes propriedades:

Despachado se houver um erro durante a conexão ou o download do arquivo de atualização. Ele também é despachado para um status HTTP inválido (como, por exemplo, 404 - Arquivo não encontrado).

Quando esse evento é despachado, o timer periódico é reiniciado automaticamente (caso o atraso seja maior que 0).

A propriedade errorID de um objeto DownloadErrorEvent é um inteiro que define informações sobre o erro (consulte a tabela a seguir). Uma propriedade subErrorID adicional pode conter mais informações sobre o erro.

Despachado após uma chamada para o método downloadUpdate() e o estabelecimento da conexão com o servidor. Ao usar a biblioteca ApplicationUpdater, você talvez queira que o manipulador desse evento exiba uma barra de progresso para informar o andamento do download para o usuário.

Esse evento tem as seguintes propriedades:

Despachado quando tiver ocorrido um erro durante a inicialização ou durante o processo de atualização (se ocorrer algo inesperado).

Esse evento tem as seguintes propriedades:

Despachado quando ocorre um erro ao validar o arquivo passado como o parâmetro airFile em uma chamada para o método installFromAIRFile().

Despachado após o atualizador ter validado com êxito o arquivo na chamada para o método installFromAIRFile().

Esse evento tem as seguintes propriedades:

Despachado após a inicialização ter sido concluída.

Este evento tem as seguintes propriedades somente leitura:

• isFirstRun (booliano) true caso esta seja a primeira execução após uma atualização bem-sucedida; do contrário, false.

• previousVersion (string) A versão anterior à atualização (só definida caso isfirstRun seja true).

• currentVersion (string) A versão do arquivo descritor do aplicativo da versão instalada atualmente.

Esse evento tem as seguintes propriedades:

Despachado quando o arquivo de atualização é baixado.

Esse evento tem as seguintes propriedades:

Despachado caso ocorra um erro ao tentar baixar ou analisar o arquivo de descritor de atualização.

Quando o atualizador despacha esse evento, o timer periódico é reiniciado automaticamente (caso a configuração do atraso seja maior que 0). O aplicativo deve considerar ocultar todas as caixas de diálogo de erro quando o atualizador despacha um novo evento checkForUpdate.

Despachado após o atualizador baixar e interpretar com êxito o arquivo de descritor de atualização.

Esse evento tem as seguintes propriedades: