Package | flash.desktop |
Classe | public final class Updater |
Héritage | Updater Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
update()
.
La classe Updater est prise en charge uniquement dans le profil de bureau. Elle n’est prise en charge ni pour les applications de bureau étendu (applications installées avec un programme d’installation natif) ni sur le profil mobile AIR ou les profils AIR pour TV. Vérifiez la propriété Updater.isSupported
.
Les applications de bureau étendu (applications installées avec un programme d’installation natif) peuvent télécharger une nouvelle version du programme d’installation natif et lancer ce dernier à l’aide de la méthode File.openWithDefaultApplication()
.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
isSupported : Boolean [statique] [lecture seule]
La propriété isSupported est définie sur true si la classe Updater est prise en charge sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false. | Updater |
Méthode | Défini par | ||
---|---|---|---|
Updater()
Fonction constructeur de la classe Updater. | Updater | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Actualise l’application en cours d’exécution avec la version de l’application contenue dans le fichier AIR spécifié. | Updater | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
isSupported | propriété |
isSupported:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
La propriété isSupported
est définie sur true
si la classe Updater est prise en charge sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false
.
Implémentation
public static function get isSupported():Boolean
Updater | () | Constructeur |
public function Updater()
Versions du moteur d’exécution: | AIR 1.0 |
Fonction constructeur de la classe Updater. Notez que la méthode update()
n’est pas un membre statique de la classe. Vous devez instancier un objet Updater et appeler la méthode update()
sur ce dernier.
update | () | méthode |
public function update(airFile:File, version:String):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Actualise l’application en cours d’exécution avec la version de l’application contenue dans le fichier AIR spécifié. L’identificateur de l’application (appID
) du fichier AIR doit correspondre à celui de l’application en cours d’exécution.
Un appel à cette méthode entraîne la fermeture de l’application en cours (comme si la méthode NativeApplication.exit()
avait été appelée). Cette opération est nécessaire car Adobe AIR ne peut pas procéder à la mise à jour complète de l’application si cette dernière est en cours d’exécution. Après une installation réussie de la nouvelle version de l’application, cette dernière démarre. Si le moteur d’exécution ne peut pas installer la nouvelle version (par exemple si son ID d’application ne correspond pas à la version existante), le programme d’installation AIR présente un message d’erreur à l’utilisateur et l’ancienne version redémarre.
Le processus de mise à jour redémarre l’application, que la mise à jour ait réussi ou non. La mise à jour peut échouer pour diverses raisons, y compris pour des raisons que l’application ne peut pas contrôler (par exemple lorsque l’utilisateur ne dispose pas de privilèges suffisants pour installer l’application). Les applications doivent s’efforcer de détecter les défaillances et éviter de recommencer encore et encore la même mise à jour en échec. La boucle infinie qui en résulterait désactiverait radicalement l’application. Ecrire le numéro de version actuelle dans un fichier avant de commencer la mise à jour, puis comparer ce numéro au numéro de version lorsque l’application est redémarrée est un moyen de vérifier la réussite de la mise à jour.
Lorsqu’une application est testée à l’aide de l’application de débogage du lanceur AIR (ADL), un appel à la méthode update()
renvoie une exception IllegalOperationError.
Pour installer la version mise à jour d’une application sous Mac OS, l’utilisateur doit disposer des privilèges système adéquats sur le répertoire de l’application. Sous Windows ou Linux, l’utilisateur doit disposer de privilèges administratifs.
Si la version mise à jour de l’application requiert une mise à jour du moteur d’exécution, la nouvelle version du moteur est installée. Pour mettre à jour le moteur d’exécution, l’utilisateur doit disposer de privilèges administratifs sur l’ordinateur.
Remarque : par mesure de sécurité, la définition du paramètre version
est obligatoire. Obliger l’application à vérifier le numéro de version dans le fichier AIR l’empêche d’installer par inadvertance une version plus ancienne, pouvant éventuellement contenir une faille de sécurité corrigée.
Paramètres
airFile:File — Objet File pointant vers le fichier AIR contenant la version de mise à jour de l’application.
| |
version:String — Version requise dans le nouveau fichier AIR. La chaîne de l’attribut version de l’élément application principal du fichier descripteur d’application du fichier AIR doit correspondre à cette valeur pour que la mise à jour réussisse.
|
Valeur émise
IllegalOperationError — La méthode a été appelée alors qu’elle s’exécutait dans ADL.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
update()
n’est pas une méthode statique de la classe. Vous instanciez un objet Updater et appelez la méthode update()
de cet objet.
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);
Tue Jun 12 2018, 09:30 AM Z