| Pacote | flash.desktop |
| Classe | public final class Updater |
| Herança | Updater  Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
update().
A classe Atualizador só é suportada no perfil desktop. Não há suporte para aplicativos de área de trabalho estendida (aplicativos instalados com um instalador nativo) nem há suporte no perfil móvel do AIR ou nos perfis do AIR for TV. Verifique a propriedade Updater.isSupported.
O aplicativo de desktop extenso (aplicativos instalados com um instalador nativo) pode carregar de uma nova versão do instalador nativo e lançá-lo usando o método File.openWithDefaultApplication().
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| isSupported : Boolean [estático] [somente leitura]
A propriedade isSupported será definida como true se a classe Atualizador estiver disponível na plataforma atual; de outra maneira, ela será definida como falsa. | Updater | ||
| Método | Definido por | ||
|---|---|---|---|
Updater()
A função do construtor para a classe Updater. | Updater | ||
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
Atualiza o aplicativo atualmente em execução com a versão do aplicativo contida no arquivo AIR especificado. | Updater | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
isSupported | propriedade |
isSupported:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
A propriedade isSupported será definida como true se a classe EncryptedLocalStore estiver disponível na plataforma atual. de outra maneira, ela será definida como false.
Implementação
public static function get isSupported():Boolean Updater | () | Construtor |
public function Updater()| Versões de runtime: | AIR 1.0 |
A função do construtor para a classe Updater. Observe que o método update() não é um membro estático da classe. Você deverá iniciar a ocorrência de um objeto Updater e chamar o método update().
update | () | método |
public function update(airFile:File, version:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Atualiza o aplicativo atualmente em execução com a versão do aplicativo contida no arquivo AIR especificado. O aplicativo no arquivo AIR deve ter o mesmo identificador de aplicativo (appID) do aplicativo atualmente em execução.
Chamar esse método faz com que o aplicativo atual seja encerrado (como se o método NativeApplication.exit() tivesse sido chamado). Isso é necessário porque o Adobe AIR não pode atualizar completamente um aplicativo enquanto o aplicativo está em execução. Mediante uma instalação bem-sucedida da nova versão do aplicativo, o aplicativo é iniciado. Se o tempo de execução não puder instalar com êxito a nova versão (por exemplo, se seu ID de aplicativo não corresponder à versão existente), o instalador AIR apresentará uma mensagem de erro ao usuário e, então, a versão antiga será reiniciada.
O processo de atualização reinicia o aplicativo se a atualização foi ou não bem-sucedida. As atualizações podem falhar por vários motivos, incluindo alguns que o aplicativo não pode controlar (como o fato de o usuário ter privilégios insuficientes para instalar o aplicativo). Os aplicativos deverão tomar cuidado para detectar falhas e evitar tentar repetidamente a mesma atualização que apresentou falha. O loop infinito resultante desativaria efetivamente o aplicativo. Um modo de verificar se uma atualização foi bem-sucedida é gravar o número da versão atual em um arquivo antes de iniciar a atualização e, depois, compará-lo com o número da versão quando o aplicativo for reiniciado.
Ao testar um aplicativo usando o aplicativo AIR Debug Launcher (ADL), chamar o método update() resultará em uma exceção de IllegalOperationError.
No Mac OS, para instalar uma versão atualizada de um aplicativo, o usuário precisa ter privilégios adequados do sistema para instalar no diretório do aplicativo. No Windows ou no Linux, o usuário precisa ter privilégios administrativos.
Se a versão atualizada do aplicativo exigir uma versão atualizada do tempo de execução, a nova versão do tempo de execução será instalada. Para atualizar o tempo de execução, um usuário precisa ter privilégios administrativos para o computador.
Observação: É necessário especificar o parâmetro version por motivos de segurança. Ao exigir que o aplicativo verifique o número da versão no arquivo AIR, o aplicativo não instalará inadvertidamente uma versão mais antiga, que pode conter uma vulnerabilidade de segurança que já foi reparada.
Parâmetros
airFile:File — O objeto File indicando o arquivo AIR que contém a versão de atualização do aplicativo.
| |
version:String — A versão exigida no novo arquivo AIR. A string no atributo version do elemento application principal do arquivo do descritor do aplicativo para o arquivo AIR deve corresponder a esse valor para que a atualização seja bem-sucedida.
|
Lança
IllegalOperationError — O método foi chamado ao ser executado no ADL.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
update() não é um método estático da classe. Inicie uma ocorrência de um objeto Updater e chame o método update() desse objeto.
import flash.fileSystem.File;
import flash.desktop.Updater;
var updater:Updater = new Updater();
var airFile:File = File.applicationStorageDirectory.resolvePath("Example Application.air");
var version:String = "2.01";
updater.update(airFile, version);
Wed Jun 13 2018, 11:10 AM Z