| Paket | flash.desktop |
| Klass | public final class Updater |
| Arv | Updater  Object |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
update()-metod.
Klassen Updater stöds bara i skrivbordsprofilen. Den stöds inte för utökade skrivbordsprogram (program som installeras med ett inbyggt installationsprogram) och inte heller i AIR-mobilprofilen eller profiler i AIR for TV. Kontrollera egenskapen Updater.isSupported.
Utökade skrivbordsprogram (program som installeras med ett inbyggt installationsprogram) kan hämta en ny version av det inbyggda installationsprogrammet och starta det med metoden File.openWithDefaultApplication().
Relaterade API-element
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
 | constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| isSupported : Boolean [statisk] [skrivskyddad]
Egenskapen isSupported är true om klassen Updater är tillgänglig på den aktuella plattformen, och i annat fall är värdet false. | Updater | ||
| Metod | Definieras med | ||
|---|---|---|---|
Updater()
Konstruktorfunktionen för Updater-klassen. | Updater | ||
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
Uppdaterar det program som körs för tillfället med den programversion som finns i den angivna AIR-filen. | Updater | ||
|
Returnerar det angivna objektets primitiva värde. | Object | |
isSupported | egenskap |
Updater | () | Konstruktor |
public function Updater()| Körningsmiljöversioner: | AIR 1.0 |
Konstruktorfunktionen för Updater-klassen. Tänk på att update()-metoden inte är en statisk klassmedlem. Du måste skapa ett Updater-objekt och anropa update()-metoden för det.
update | () | metod |
public function update(airFile:File, version:String):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Uppdaterar det program som körs för tillfället med den programversion som finns i den angivna AIR-filen. Programmet i AIR-filen måste ha samma programidentifierare (appID) som det program som körs.
När den här metoden anropas avslutas det aktuella programmet (som om metoden NativeApplication.exit() hade anropats). Detta är nödvändigt eftersom Adobe AIR inte kan slutföra uppdateringen av ett program som är igång. När den nya programversionen har installerats startas programmet. Om den nya versionen inte kan installeras (t.ex. om dess program-ID inte matchar den befintliga versionens) visas ett felmeddelande i AIR-installationsprogrammet, och sedan startas den gamla versionen om.
Uppdateringsprocessen startar om programmet, oavsett om uppdateringen lyckas eller inte. Uppdateringar kan misslyckas av flera skäl, och vissa ligger utanför programmets kontroll (till exempel om användaren saknar den behörighet som krävs för att installera program). Du bör vara noga med att programmet kan identifiera sådana misslyckanden och undvika att utföra samma misslyckade uppdatering flera gånger. Den oändliga slinga som då skulle skapas innebär i praktiken att programmet upphör att fungera. Ett sätt att kontrollera om uppdateringen har lyckats är att skriva det aktuella versionsnumret till en fil innan du startar uppdateringen och sedan jämföra det med versionsnumret när programmet startas om.
När du testar ett program med AIR Debug Launcher (ADL) orsakar anrop till metoden update() ett IllegalOperationError-undantag.
För att kunna installera en uppdaterad version av ett program i Mac OS måste användaren ha tillräcklig behörighet för att installera i programkatalogen. I Windows och Linux måste användaren ha administrationsbehörighet.
Om den uppdaterade programversionen kräver en uppdaterad körningsversion installeras den nya körningsversionen. Användaren måste ha administrationsbehörighet för datorn för att kunna uppdatera körningen.
Obs! Av säkerhetsskäl måste parametern version anges. Eftersom programmet måste kontrollera versionsnumret i AIR-filen riskerar du inte att av misstag installera en äldre version, som skulle kunna ha säkerhetsbrister som har åtgärdats i senare versioner.
Parametrar
airFile:File — File-objektet som pekar på den AIR-fil som innehåller uppdateringsversionen av programmet.
| |
version:String — Nödvändig version i den nya AIR-filen. Strängen i attributet version, i application-huvudelementet i programbeskrivningsfilen för AIR-filen, måste matcha det här värdet för att uppdateringen ska lyckas.
|
Utlöser
IllegalOperationError — Metoden anropades i ADL.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
update()-metoden inte är en statisk klassmetod. Du instansierar ett Updater-objekt och anropar metoden update() för det objektet.
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, 01:40 PM Z