Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: Recuperando dados do servidor...
Recuperando dados do servidor...
flash.desktop 

Updater  - AS3

Pacoteflash.desktop
Classepublic final class Updater
HerançaUpdater Inheritance Object

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

A classe Updater é usada para atualizar o aplicativo em execução atual com uma versão diferente. Para usá-la, inicie uma ocorrência do objeto Updater e, então, chame o método 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



Propriedades públicas
 PropriedadeDefinido por
 Inheritedconstructor : 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étodos públicos
 MétodoDefinido por
  
    Updater()
A função do construtor para a classe Updater.
Updater
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
  
    update(airFile:File, version:String):void
Atualiza o aplicativo atualmente em execução com a versão do aplicativo contida no arquivo AIR especificado.
Updater
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
Detalhes da propriedade
    

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
Detalhes do construtor
    

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

Detalhes do método

    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 )

Observe que o método 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);




[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.