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

The Updater class is used to update the currently running application with a different version. To use it, instantiate an Updater object and then call its update() method.



Propriedades Públicas
 PropriedadeDefinido por
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Métodos Públicos
 MétodoDefinido por
  
The constructor function for the Updater class.
Updater
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of the specified object.
Object
  
update(airFile:File, version:String):void
Updates the currently running application with the version of the application contained in the specified AIR file.
Updater
 Inherited
Returns the primitive value of the specified object.
Object
Detalhes do construtor
Updater()Construtor
public function Updater()

The constructor function for the Updater class. Note that the update() method is not a static member of the class. You must instantiate an Updater object and call the update() method on it.

Detalhes do método
update()método
public function update(airFile:File, version:String):void

Updates the currently running application with the version of the application contained in the specified AIR file. The application in the AIR file must have the same application identifier (appID) as the currently running application.

Calling this method causes the current application to exit (as if the Shell.exit() method had been called). This is necessary because the Adobe Integrated Runtime cannot fully update an application while the application is running. Upon successfully installing the new version of the application, the application launches. If the runtime cannot successfully install the new version (for exemplo, if its application ID does not match the existing version), the AIR installer presents an error message to the user, and then the old version re-launches.

When testing an application using ADL, calling the update() method installs and runs a new version of the application only if the runtime is installed. If the runtime is not installed, the call to the method results in a runtime exception.

Note: Specifying the version parameter is required for security reasons. By requiring the application to verify the version number in the AIR file, the application will not inadvertantly install an older version, which might contain a security vulnerability that has been fixed.

Parâmetros

airFile:File — The File object pointing to the AIR file that contains the update version of the application.
 
version:String — The required version in the update AIR file. The string in the version attribute of the main application element of the application descriptor file for the AIR file must match this value in order for the update to succeed.


Exemplo

Note that the update() method is not a static method of the class. You instantiate a Updater object and call the update() method of that object.
import flash.fileSystem.File;
import flash.system.Updater;
 
var updater:Updater = new Updater();
var airFile:File = File.applicationStore.resolvePath("Example Application.air");
var version:String = "2.01";
updater.update(airFile, version);