ApplicationUpdater  - AS3

O local do arquivo de configuração que define os valores das propriedades delay e updateURL. 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>
        </configuration>

Em vez de carregar um arquivo de configuração, você pode usar o código ActionScript para definir as propriedades delay e updateURL.

Elementos da API relacionados

O estado interno do atualizador. A propriedade pode ser definida como os seguintes valores:

• "UNINITIALIZED" – O atualizador não foi inicializado.

• "INITIALIZING" – O atualizador está sendo inicializado.

• "READY" – O atualizador foi inicializado.

• "BEFORE_CHECKING" – O atualizador ainda não procurou o arquivo descritor de atualização.

• "CHECKING" – O atualizador está procurando um arquivo descritor de atualização.

• "AVAILABLE" – O arquivo descritor de atualização está disponível.

• "DOWNLOADING" – O atualizador está baixando o arquivo do AIR.

• "DOWNLOADED" – O atualizador baixou o arquivo do AIR.

• "INSTALLING" – O atualizador está instalando o arquivo do AIR.

• "PENDING_INSTALLING" – O atualizador foi inicializado e há atualizações pendentes.

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. Isso 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.

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

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;
}

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 caso o objeto updater despache 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.

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.

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".

Baixa e interpreta assincronamente o arquivo de descritor de atualização. Chamar esse método avança o estado do atualizador para "CHECKING". Só chame esse método se o evento checkForUpdate tiver sido cancelado.

Esse método só é executado quando o atualizador se encontra no estado "BEFORE_CHECKING".

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:

Baixa assincronamente o arquivo de atualização. Chamar esse método avança a máquina do estado para "DOWNLOADING". Esse método só precisa ser chamado caso o evento StatusUpdateEvent.UPDATE_STATUS tenha sido cancelado quando a propriedade disponível do evento era verdadeira.

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

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 "DOWNLOADED").

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

Instala o arquivo de atualização. A chamada do método avança a máquina do estado para "INSTALLING" e só precisa ser chamado caso o evento downLoadComplete tenha sido cancelado.

Chame esse método quando o atualizador se encontrar no estado "DOWNLOADED". Chamá-lo em qualquer outro estado não fará nada.

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

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).

O comportamento padrão da biblioteca ApplicationUpdater é baixar o arquivo descritor de atualização. Você pode chamar o método preventDefault() para cancelar esse comportamento.

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.

Normalmente, esse evento é usado para exibir uma mensagem que pergunta ao usuário se ele deseja continuar a instalação da atualização.

O comportamento padrão da biblioteca ApplicationUpdater é chamar automaticamente o método installUpdate().

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.

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.

O comportamento padrão é iniciar o download da atualização caso a propriedade disponível do objeto StatusUpdateEvent esteja definida como true. O comportamento padrão só pode ser impedido durante o uso da classe ApplicationUpdater, e não durante o uso da classe ApplicationUpdatorUI.

Esse evento tem as seguintes propriedades: