ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
air.update 

ApplicationUpdaterUI  - AS3

Pakietair.update
Klasapublic class ApplicationUpdaterUI
DziedziczenieApplicationUpdaterUI Inheritance EventDispatcher Inheritance Object

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Klasa ApplicationUpdaterUI definiuje podstawową funkcjonalność architektury aktualizacji aplikacji Adobe® AIR® oraz udostępnia domyślny interfejs użytkownika. (Klasa ApplicationUpdater definiuje funkcjonalność aktualizacji bez implementacji domyślnego interfejsu użytkownika).

Ta klasa jest zawarta w pliku applicationupdater_ui.swc zawartym w środowisku Adobe AIR SDK. Plik applicationupdater_ui.swc znajduje się w katalogu frameworks/libs/air środowiska AIR SDK. Wersja z katalogu frameworks/libs/air środowiska AIR 2 SDK jest przeznaczona do programowania w środowisku Flex 4. Jeśli użytkownik korzysta ze środowiska Flex 3, należy używać wersji z podkatalogu frameworks/libs/air/flex3.

Program Adobe® Flex™ Builder™ ładuje tę klasę automatycznie podczas tworzenia projektu dla środowiska Adobe AIR. Plik SWC należy uwzględnić podczas kompilowania aplikacji za pomocą środowiska Adobe® Flex™ SDK.

Zarządzanie aktualizowaniem aplikacji może być skomplikowanym zagadnieniem. Architektura aktualizacji aplikacji AIR obejmuje elementy interfejsu API pomagające programistom w tworzeniu sprawnych mechanizmów aktualizacji. Funkcje architektury aktualizacji środowiska AIR wspomagają realizację następujących zadań:

  • Regularne sprawdzanie, czy są dostępne aktualizacje — w stałych odstępach czasu lub na żądanie użytkownika.

  • Pobieranie plików AIR (aktualizacji) ze źródła w sieci WWW.

  • Powiadamianie użytkownika o nowo zainstalowanej wersji przy pierwszym uruchomieniu.

  • Potwierdzanie, czy użytkownik chce sprawdzić dostępność aktualizacji.

  • Wyświetlanie informacji o nowej wersji aktualizacji.

  • Wyświetlanie postępu pobierania i informacji o błędach.

Architektura aktualizacji aplikacji AIR umożliwia przechowywanie informacji o wersji aktualizacji aplikacji AIR w prostych plikach konfiguracyjnych XML. W przypadku większości aplikacji przygotowanie tych plików konfiguracyjnych i dodanie prostego kodu wystarczy do zapewnienia użytkownikom końcowym odpowiedniej funkcjonalności aktualizacji.

Klasa AIRUpdateUI implementuje domyślny interfejs użytkownika, z którego może korzystać aplikacja. Interfejs ten udostępnia użytkownikowi podstawowe informacje i opcje związane z aktualizacją aplikacji.

W procesie aktualizacji występuje kolejno szereg stanów.

Stan Opis
UninitializedObiekt Updater nie został zainicjowany.
InitializingTrwa inicjowanie obiektu Updater.
ReadyObiekt Updater został zainicjowany.
Before checkingObiekt Updater nie sprawdził jeszcze, czy istnieje plik deskryptora aktualizacji.
CheckingObiekt Updater sprawdza, czy istnieje plik deskryptora aktualizacji.
AvailablePlik deskryptora aktualizacji jest dostępny.
DownloadingObiekt Updater pobiera plik AIR.
DownloadedObiekt Updater pobrał plik AIR.
InstallingObiekt Updater instaluje plik AIR.
Pending installObiekt Updater jest zainicjowany i istnieją oczekujące aktualizacje.

Podczas testowania aplikacji za pomocą programu AIR Debug Launcher (ADL) próba zaktualizowania aplikacji spowoduje wygenerowanie wyjątku IllegalOperationError.

Architektura aktualizacji środowiska AIR jest obsługiwana jedynie w profilu aplikacji lokalnej. Nie jest ona obsługiwana w przypadku aplikacji z rozszerzonym profilem aplikacji lokalnej (aplikacji instalowanych za pomocą rodzimego instalatora). Nie jest również obsługiwana w profilu urządzeń przenośnych (aplikacji iPhone napisanych z użyciem języka ActionScript 3.0). Aby w czasie wykonywania dowiedzieć się, czy jest obsługiwana architektura aktualizacji, należy sprawdzić wartość właściwości Updater.isSupported.

Szczegółowe informacje na temat platformy aktualizacji AIR zawiera rozdział Aktualizowanie aplikacji AIR w dokumencie Budowanie aplikacji dla środowiska Adobe AIR.

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
      configurationFile : File
Położenie pliku konfiguracyjnego, w którym określone są wartości właściwości delay i updateURL.
ApplicationUpdaterUI
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
      currentVersion : String
[tylko do odczytu] Bieżąca wersja aplikacji.
ApplicationUpdaterUI
      delay : Number
Odstęp czasu (w dniach) między sprawdzeniami dostępności nowych aktualizacji.
ApplicationUpdaterUI
      isCheckForUpdateVisible : Boolean
Powoduje, że okna Sprawdzanie dostępności aktualizacji, Brak aktualizacji i Błąd aktualizacji są widoczne.
ApplicationUpdaterUI
      isDownloadProgressVisible : Boolean
Powoduje, że okno Pobieranie aktualizacji jest widoczne.
ApplicationUpdaterUI
      isDownloadUpdateVisible : Boolean
Powoduje, że okno Pobieranie aktualizacji jest widoczne.
ApplicationUpdaterUI
      isFileUpdateVisible : Boolean
Powoduje, że okna dialogowe Plik - aktualizacja, Plik - brak aktualizacji i Błąd pliku są widoczne.
ApplicationUpdaterUI
      isFirstRun : Boolean
[tylko do odczytu] Określa, czy jest to pierwsze uruchomienie po pomyślnej aktualizacji (true), czy nie (false).
ApplicationUpdaterUI
      isInstallUpdateVisible : Boolean
Powoduje, że okno dialogowe Instalowanie aktualizacji jest widoczne.
ApplicationUpdaterUI
      isNewerVersionFunction : Function
Funkcja, której obiekt Updater powinien używać do porównywania wersji.
ApplicationUpdaterUI
      isUnexpectedErrorVisible : Boolean
Powoduje, że okno dialogowe Nieoczekiwany błąd jest widoczne.
ApplicationUpdaterUI
      isUpdateInProgress : Boolean
[tylko do odczytu] Właściwość typu Boolean, która ma wartość true, jeśli proces aktualizacji jest uruchomiony, a wartość false w przeciwnym wypadku.
ApplicationUpdaterUI
      localeChain : Array
Tablica definiująca łańcuch ustawień narodowych stosowany w interfejsie użytkownika.
ApplicationUpdaterUI
      previousApplicationStorageDirectory : File
[tylko do odczytu] Poprzednie położenie katalogu magazynu aplikacji, jeśli zmieniło się po aktualizacji.
ApplicationUpdaterUI
      previousVersion : String
[tylko do odczytu] Poprzednia wersja aplikacji.
ApplicationUpdaterUI
      updateDescriptor : XML
[tylko do odczytu] Treść pliku deskryptora aktualizacji pobranego spod adresu URL aktualizacji.
ApplicationUpdaterUI
      updateURL : String
Położenie pliku deskryptora aktualizacji.
ApplicationUpdaterUI
      wasPendingUpdate : Boolean
[tylko do odczytu] Określa, czy istniała aktualizacja odłożona w czasie, nawet jeśli jej instalacja nie powiodła się (true); false w przeciwnym wypadku.
ApplicationUpdaterUI
Metody publiczne
 MetodaZdefiniowane przez
  
Funkcja konstruktora.
ApplicationUpdaterUI
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.
EventDispatcher
  
    addResources(lang:String, res:Object):void
Dynamicznie dodaje nowy pakunek zasobów dla określonego języka.
ApplicationUpdaterUI
  
    cancelUpdate():void
Anuluje proces aktualizacji.
ApplicationUpdaterUI
  
    checkNow():void
Rozpoczyna proces aktualizacji.
ApplicationUpdaterUI
 Inherited
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
 Inherited
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
  
    initialize():void
Inicjuje obiekt Updater.
ApplicationUpdaterUI
  
Rozpoczyna proces aktualizacji przy użyciu lokalnego pliku AIR.
ApplicationUpdaterUI
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
 Zdarzenie Podsumowanie Zdefiniowane przez
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.EventDispatcher
  Wywoływane tuż przed zainstalowaniem aktualizacji, po wywołaniu metody installUpdate().ApplicationUpdaterUI
  Wywoływane przed rozpoczęciem procesu aktualizacji, tuż zanim obiekt Updater podejmie próbę pobrania pliku deskryptora aktualizacji.ApplicationUpdaterUI
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.EventDispatcher
  Wywoływane po ukończeniu pobierania pliku aktualizacji.ApplicationUpdaterUI
  Wywoływane, jeśli podczas nawiązywania połączenia lub pobierania pliku aktualizacji wystąpi błąd.ApplicationUpdaterUI
  Wywoływane po wywołaniu metody downloadUpdate() i nawiązaniu połączenia z serwerem.ApplicationUpdaterUI
  
    error
Wywoływane, gdy wystąpi błąd podczas inicjowania lub podczas procesu aktualizacji (w razie zajścia nieoczekiwanego zdarzenia).ApplicationUpdaterUI
  Wywoływane, gdy wystąpi błąd podczas weryfikacji pliku przekazanego jako parametr airFile w wywołaniu metody installFromAIRFile().ApplicationUpdaterUI
  Wywoływane po tym, jak obiekt Updater pomyślnie zweryfikuje plik w wywołaniu metody installFromAIRFile().ApplicationUpdaterUI
  
    initialized
Wywoływane po zakończeniu inicjowania.ApplicationUpdaterUI
  
    progress
Wywoływane w chwili pobrania pliku aktualizacji.ApplicationUpdaterUI
  
    updateError
Wywoływane, gdy wystąpi błąd przy próbie pobrania lub przeanalizowania pliku deskryptora aktualizacji.ApplicationUpdaterUI
  
    updateStatus
Wywoływane po tym, jak obiekt Updater pomyślnie pobierze i zinterpretuje plik deskryptora aktualizacji.ApplicationUpdaterUI
Szczegół właściwości
    

configurationFile

właściwość
configurationFile:File

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Położenie pliku konfiguracyjnego, w którym określone są wartości właściwości delay i updateURL. Plik zawiera także ustawienia decydujące o tym, czy aplikacja wyświetla różne okna dialogowe potwierdzeń w procesie aktualizacji. Jeśli ta właściwość wskazuje na nieistniejący plik, wywołanie metody initialize() spowoduje wygenerowanie wyjątku Error.

Oto przykładowy plik konfiguracyjny:

 <?xml version="1.0" encoding="utf-8"?> 
         <configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
           <url>app:/server/update.xml</url>
           <delay>1</delay>
           <defaultUI>
              <dialog name="checkForUpdate" visible="true" />
               <dialog name="downloadUpdate" visible="false" />
               <dialog name="downloadProgress" visible="true" />
               <dialog name="installUpdate" visible="true" />    
           </defaultUI>
        </configuration>

Zamiast ładować plik konfiguracyjny, można za pomocą kodu ActionScript przypisać wartości następującym właściwościom obiektu ApplicationUpdaterUI: delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible oraz updateURL.



Implementacja
    public function get configurationFile():File
    public function set configurationFile(value:File):void

Powiązane elementy interfejsu API

    

currentVersion

właściwość 
currentVersion:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Bieżąca wersja aplikacji. Wartość tej właściwości jest przypisywana podczas wywołania metody initialize(). Przypisana wartość jest równa wersji określonej w pliku deskryptora aplikacji.



Implementacja
    public function get currentVersion():String
    

delay

właściwość 
delay:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Odstęp czasu (w dniach) między sprawdzeniami dostępności nowych aktualizacji.

Wartość 0 (domyślna) oznacza, że licznik czasu nie jest aktywny, a zatem dostępność aktualizacji nie jest regularnie sprawdzana. Opóźnienie można określić za pośrednictwem tej właściwości lub w pliku konfiguracyjnym. Gdy wartość jest określona na oba sposoby, przyjmowana jest wartość przypisana właściwości.

Wartością domyślną jest 0.



Implementacja
    public function get delay():Number
    public function set delay(value:Number):void

Powiązane elementy interfejsu API

    

isCheckForUpdateVisible

właściwość 
isCheckForUpdateVisible:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Powoduje, że okna Sprawdzanie dostępności aktualizacji, Brak aktualizacji i Błąd aktualizacji są widoczne. Gdy ta właściwość ma wartość true, obiekt Updater wyświetla powyższe okna dialogowe w toku aktualizacji. To samo ustawienie można określić w pliku konfiguracyjnym aktualizacji. Wartość określona za pośrednictwem tej właściwości przesłania ustawienie określone w pliku konfiguracyjnym.



Implementacja
    public function get isCheckForUpdateVisible():Boolean
    public function set isCheckForUpdateVisible(value:Boolean):void
    

isDownloadProgressVisible

właściwość 
isDownloadProgressVisible:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Powoduje, że okno Pobieranie aktualizacji jest widoczne. Gdy ta właściwość ma wartość true, obiekt Updater wyświetla powyższe okno dialogowe w toku aktualizacji. To samo ustawienie można określić w pliku konfiguracyjnym aktualizacji. Wartość określona za pośrednictwem tej właściwości przesłania ustawienie określone w pliku konfiguracyjnym.



Implementacja
    public function get isDownloadProgressVisible():Boolean
    public function set isDownloadProgressVisible(value:Boolean):void
    

isDownloadUpdateVisible

właściwość 
isDownloadUpdateVisible:Boolean

Wersje środowiska wykonawczego: AIR 1.5

Powoduje, że okno Pobieranie aktualizacji jest widoczne. Gdy ta właściwość ma wartość true, obiekt Updater wyświetla powyższe okna dialogowe w toku aktualizacji. To samo ustawienie można określić w pliku konfiguracyjnym aktualizacji. Wartość określona za pośrednictwem tej właściwości przesłania ustawienie określone w pliku konfiguracyjnym.



Implementacja
    public function get isDownloadUpdateVisible():Boolean
    public function set isDownloadUpdateVisible(value:Boolean):void
    

isFileUpdateVisible

właściwość 
isFileUpdateVisible:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Powoduje, że okna dialogowe Plik - aktualizacja, Plik - brak aktualizacji i Błąd pliku są widoczne. Gdy ta właściwość ma wartość true, obiekt Updater wyświetla powyższe okna dialogowe w toku aktualizacji. To samo ustawienie można określić w pliku konfiguracyjnym aktualizacji. Wartość określona za pośrednictwem tej właściwości przesłania ustawienie określone w pliku konfiguracyjnym.



Implementacja
    public function get isFileUpdateVisible():Boolean
    public function set isFileUpdateVisible(value:Boolean):void
    

isFirstRun

właściwość 
isFirstRun:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Określa, czy jest to pierwsze uruchomienie po pomyślnej aktualizacji (true), czy nie (false). Obiekt Updater ustawia tę wartość podczas wywołania metody initialize(). Program powinien sprawdzać, czy właściwość isFirstRun jest ustawiona na true, jeśli istnieje potrzeba migracji danych z jednej wersji do drugiej.



Implementacja
    public function get isFirstRun():Boolean

Powiązane elementy interfejsu API

    

isInstallUpdateVisible

właściwość 
isInstallUpdateVisible:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Powoduje, że okno dialogowe Instalowanie aktualizacji jest widoczne. Gdy ta właściwość ma wartość true, obiekt Updater wyświetla powyższe okno dialogowe w toku aktualizacji. To samo ustawienie można określić w pliku konfiguracyjnym aktualizacji. Wartość określona za pośrednictwem tej właściwości przesłania ustawienie określone w pliku konfiguracyjnym.



Implementacja
    public function get isInstallUpdateVisible():Boolean
    public function set isInstallUpdateVisible(value:Boolean):void
    

isNewerVersionFunction

właściwość 
isNewerVersionFunction:Function

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Funkcja, której obiekt Updater powinien używać do porównywania wersji. Domyślnie architektura aktualizacji porównuje wersje w celu wykrycia, czy wersja z witryny zdalnej jest nowsza od zainstalowanej wersji aplikacji. Jednak niekiedy domyślny sposób porównywania nie jest zgodny z systemem oznaczania wersji przyjętym przez programistę. Ta właściwość umożliwia określenie nowej funkcji realizującej porównanie.

Domyślna funkcja porównująca przyjmuje numery wersji w postaci x.y.z, gdzie x, y, i z mogą zawierać litery i cyfry. Domyślna funkcja porównująca rozpoznaje pewne sytuacje szczególne. Jeśli funkcja testująca znajdzie w ciągu wersji ciąg znaków "alpha", "beta", lub "rc", to obowiązuje zasada alpha < beta < rc.



Implementacja
    public function get isNewerVersionFunction():Function
    public function set isNewerVersionFunction(value:Function):void

Przykład  ( Sposób korzystania z tego przykładu )
W poniższym kodzie zdefiniowano funkcję niestandardową customFn dla obiektu Updater o nazwie appUpdate. Przykładowa funkcja jest bardzo uproszczona. Funkcja niestandardowa powinna zwracać wartość typu Boolean wyznaczoną na podstawie reguł porównywania wersji przyjętych przez programistę.
appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}
    

isUnexpectedErrorVisible

właściwość 
isUnexpectedErrorVisible:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Powoduje, że okno dialogowe Nieoczekiwany błąd jest widoczne. Gdy ta właściwość ma wartość true, obiekt ApplicationUpdater wyświetla powyższe okno dialogowe w toku instalacji. To samo ustawienie można określić w pliku konfiguracyjnym aktualizacji. Wartość określona za pośrednictwem tej właściwości przesłania ustawienie określone w pliku konfiguracyjnym.



Implementacja
    public function get isUnexpectedErrorVisible():Boolean
    public function set isUnexpectedErrorVisible(value:Boolean):void
    

isUpdateInProgress

właściwość 
isUpdateInProgress:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Właściwość typu Boolean, która ma wartość true, jeśli proces aktualizacji jest uruchomiony, a wartość false w przeciwnym wypadku.



Implementacja
    public function get isUpdateInProgress():Boolean
    

localeChain

właściwość 
localeChain:Array

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Tablica definiująca łańcuch ustawień narodowych stosowany w interfejsie użytkownika. Zazwyczaj z właściwości tej korzystają tylko programiści posługujący się językiem JavaScript (HTML).

W środowisku Flex do obsługi łańcucha ustawień narodowych można używać menedżera zasobów.

Domyślnie w aplikacjach opartych na języku HTML języki są podzielone na grupę języków wymienionych w tablicy Capabilities.languages i grupę dziesięciu języków obsługiwanych przez interfejs użytkownika. Jeśli nie zostanie znaleziony zgodny język, w interfejsie użytkownika stosowany jest język angielski.

W tym przykładzie, napisanym w języku JavaScript, zastosowano architekturę lokalizacji HTML środowiska AIR, wchodzącą w skład pakietu SDK środowiska AIR. Aplikacja sortuje języki, porównując języki dostępne z listą wszystkich języków, a następnie wskazuje angielski jako domyślny język obowiązujący w razie nieznalezienia języka lokalnego:

 appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
        appUpdater.addResources("hu", {titleCheck: "Cím", msgCheck: "Üzenet"}); 
        var languages = ["ro", "hu"];
        languages = languages.concat(air.Capabilities.languages);
        var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");  
        sortedLanguages.push("en-US");
        appUpdater.localeChain = sortedLanguages;



Implementacja
    public function get localeChain():Array
    public function set localeChain(value:Array):void

Powiązane elementy interfejsu API

    

previousApplicationStorageDirectory

właściwość 
previousApplicationStorageDirectory:File  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Poprzednie położenie katalogu magazynu aplikacji, jeśli zmieniło się po aktualizacji. Położenie katalogu magazynu aplikacji zmienia się po uaktualnieniu, któremu towarzyszy migracja certyfikatu. Jeśli nie ma miejsca migracja certyfikatu, katalog magazynu aplikacji nie ulega zmianie podczas aktualizacji aplikacji. Wówczas ta właściwość przyjmuje wartość null. Wartość tej właściwości jest przypisywana podczas wywołania metody initialize().

Programista może podpisać nową wersję aplikacji AIR nowym certyfikatem, korzystając z opcji -migrate podczas tworzenia pakietu z plikiem AIR za pomocą programu ADT. Jeśli do podpisania nowej wersji aplikacji AIR użyty został nowy certyfikat, katalog magazynu lokalnego aplikacji zmieni się, gdy użytkownik zainstaluje nową wersję. Ta właściwość umożliwia przeniesienie danych ze starego katalogu magazynu aplikacji do nowego katalogu magazynu aplikacji (File.applicationStorageDirectory). Więcej informacji zawiera sekcja „Podpisywanie pliku AIR w celu zmiany certyfikatu aplikacji” w rozdziale „Tworzenie aplikacji AIR za pomocą narzędzi wiersza poleceń” podręcznika programowania w środowisku Adobe AIR.



Implementacja
    public function get previousApplicationStorageDirectory():File
    

previousVersion

właściwość 
previousVersion:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Poprzednia wersja aplikacji. Wartość tej właściwości jest przypisywana podczas wywołania metody initialize(). Zwraca numer poprzedniej wersji aplikacji przed uaktualnieniem (wartość przypisana tylko wtedy, gdy właściwość isfirstRun jest równa true); w przeciwnym razie przyjmuje wartość null.



Implementacja
    public function get previousVersion():String
    

updateDescriptor

właściwość 
updateDescriptor:XML  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Treść pliku deskryptora aktualizacji pobranego spod adresu URL aktualizacji. Ta właściwość ma wartość różną od null po wywołaniu przez obiekt Updater zdarzenia updateStatus.



Implementacja
    public function get updateDescriptor():XML
    

updateURL

właściwość 
updateURL:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Położenie pliku deskryptora aktualizacji. Dozwolone jest każde położenie, jakiego można użyć w ścieżce URLRequest. Jest to jedyne ustawienie obowiązkowe wymagane przez obiekt Updater. Adres URL aktualizacji można określić albo za pośrednictwem tej właściwości, albo w pliku konfiguracyjnym. Gdy wartość jest określona na oba sposoby, obiekt Updater przyjmuje wartość przypisaną tej właściwości.



Implementacja
    public function get updateURL():String
    public function set updateURL(value:String):void

Powiązane elementy interfejsu API

    

wasPendingUpdate

właściwość 
wasPendingUpdate:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Określa, czy istniała aktualizacja odłożona w czasie, nawet jeśli jej instalacja nie powiodła się (true); false w przeciwnym wypadku. Obiekt Updater przypisuje wartość tej właściwości podczas wywołania metody initialize(). Właściwości wasPendingUpdate i isFirstRun umożliwiają sprawdzenie, czy instalacja aktualizacji nie powiodła się (wówczas wasPendingUpdate przyjmuje wartość true, a isFirstRun przyjmuje wartość false).



Implementacja
    public function get wasPendingUpdate():Boolean

Powiązane elementy interfejsu API

Konstruktor Szczegół
    

ApplicationUpdaterUI

()Konstruktor
public function ApplicationUpdaterUI()

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Funkcja konstruktora.

Szczegół metody

    addResources

()metoda
public function addResources(lang:String, res:Object):void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Dynamicznie dodaje nowy pakunek zasobów dla określonego języka. Programiści korzystający z języka JavaScript stosują tę metodę w celu dynamicznego dodawania nowych języków dla okien dialogowych wyświetlanych przez interfejs użytkownika aktualizacji aplikacji. (Programiści korzystający ze środowiska Flex mogą bezpośrednio dodać nowy język do pakunku zasobów „ApplicationUpdaterDialogs”).

Parametry

lang:String — Kod języka (na przykład "ro" w przypadku rumuńskiego).
 
res:Object — Obiekt zawiera klucze i wartości do tłumaczenia. Klucze pochodzą z pliku właściwości języka. W poniższej tabeli wymieniono możliwe klucze (nazwy właściwości).

Klucz Wartość dla języka angielskiego Okno dialogowe Opis
appWidth 530 Wszystkie Szerokość okna dialogowego.
titleWindow Updating: Wszystkie Wyświetlany na pasku tytułu rodzimego okna przed nazwą aplikacji.
titleCheck Check for updates Sprawdzanie dostępności aktualizacji Tytuł okna dialogowego.
msgCheck Allow the application to check for updates? Sprawdzanie dostępności aktualizacji Komunikat w oknie dialogowym.
btnCheck Check for Updates Sprawdzanie dostępności aktualizacji Etykieta przycisku sprawdzania dostępności aktualizacji.
btnCancel Cancel Wszystkie okna dialogowe z przyciskiem Anuluj. Etykieta przycisku Anuluj.
titleCheckNoUpdates No updates available Sprawdzanie dostępności aktualizacji - brak dostępnych aktualizacji Tytuł okna dialogowego.
msgCheckNoUpdates There are no updates available for the application. Sprawdzanie dostępności aktualizacji - brak dostepnych aktualizacji Komunikat w oknie dialogowym.
btnClose Close Wszystkie okna dialogowe z przyciskiem Zamknij. Etykieta przycisku Zamknij.
titleCheckError Update error Sprawdzanie dostępności aktualizacji - błąd połączenia Tytuł okna dialogowego.
msgCheckError There was an error checking for updates. Błąd {0} Sprawdzanie dostępności aktualizacji — błąd połączenia Komunikat w oknie dialogowym. Symbol {0} zostanie zastąpiony identyfikatorem błędu.
titleUpdate Update available Aktualizacja jest dostępna Tytuł okna dialogowego.
msgUpdate An updated version of the application is available for download. Dostępna aktualizacja Komunikat w oknie dialogowym.
lblApplication Application: Dostępna aktualizacja Etykieta wyświetlana przed nazwą aplikacji.
lblInstalledVersion Installed Version: Dostępna aktualizacja Etykieta wyświetlana przed numerem zainstalowanej wersji.
lblAvailableVersion Update Version: Dostępna aktualizacja Etykieta wyświetlana przed numerem wersji aktualizacji.
btnDownload Download now Dostępna aktualizacja Etykieta przycisku Pobierz teraz.
btnDownloadLater Download later Dostępna aktualizacja Etykieta przycisku Pobierz później.
lnkReleaseNotes Release notes Wszystkie okna z łączem do uwag do wydania. Nazwa łącza „Uwagi do wydania”.
titleProgress Download progress... Postęp pobierania Tytuł okna dialogowego.
msgProgress Downloading update Postęp pobierania Komunikat w oknie dialogowym.
titleDownloadError Download failed Błąd pobierania Tytuł okna dialogowego.
msgDownloadError There was an error downloading the update. Błąd {0} Błąd pobierania Komunikat w oknie dialogowym. Symbol {0} zostanie zastąpiony identyfikatorem błędu.
titleInstall Install update Instalowanie aktualizacji Tytuł okna dialogowego.
msgInstall The update for the application is downloaded and ready to be installed. Instalowanie aktualizacji Komunikat w oknie dialogowym.
btnInstall Install now Instalowanie aktualizacji Etykieta przycisku „Zainstaluj”.
btnInstallLater Postpone until restart Instalowanie aktualizacji Etykieta przycisku „Odłóż do następnego uruchomienia”.
titleFileUpdate Dostępna aktualizacja Plik - dostępna aktualizacja Tytuł okna dialogowego.
msgFileUpdate The file contains an updated version of the application. Install? Plik — dostępna aktualizacja Komunikat w oknie dialogowym.
lblFile File: Plik — dostępna aktualizacja Etykieta wyświetlana przed nazwą pliku.
titleFileNoUpdate No update available Plik — brak dostępnych aktualizacji Tytuł okna dialogowego.
msgFileNoUpdate The file doesn't contain a newer version of the application. Plik - brak dostępnych aktualizacji Komunikat w oknie dialogowym.
titleFileError File error Plik — błąd Tytuł okna dialogowego.
msgFileError An error occurred validating the update file. Error# {0} Plik - błąd Komunikat w oknie dialogowym. Symbol {0} zostanie zastąpiony identyfikatorem błędu.
titleUnexpectedError Unexpected error Nieoczekiwany błąd Tytuł okna dialogowego.
msgUnexpectedError An unexpected error occurred. Błąd {0} Nieoczekiwany błąd Komunikat w oknie dialogowym. Symbol {0} zostanie zastąpiony identyfikatorem błędu.

Powiązane elementy interfejsu API

    cancelUpdate

()metoda 
public function cancelUpdate():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Anuluje proces aktualizacji. Wywołanie tej metody anuluje wszystkie oczekujące operacje pobierania, usuwa wszystkie nie w pełni pobrane pliki i ponownie uruchamia zegar odliczający interwał między sprawdzeniami dostępności aktualizacji.

Proces aktualizacji można anulować w dowolnym momencie, o ile tylko maszyna stanu nie jest w stanie "uninitialized" ani "initializing". Metoda nie wykonuje żadnych czynności, jeśli zostanie wywołana w stanie "uninitialized" lub "initializing".

    checkNow

()metoda 
public function checkNow():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Rozpoczyna proces aktualizacji. Wywołanie tej metody nie powoduje zatrzymania licznika czasu opóźnienia między sprawdzaniem dostępności aktualizacji; metoda wykrywa jednak uruchomiony proces aktualizacji i pomija bieżącą iterację.

Ta metoda jest wykonywana tylko wtedy, gdy bieżący stan to "Ready".

Wywołanie tej metody może spowodować, że obiekt Updater wywoła następujące zdarzenie:


Zdarzenia
checkForUpdate:UpdateEvent — Wywoływane tuż przed rozpoczęciem procesu aktualizacji.

    initialize

()metoda 
public function initialize():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Inicjuje obiekt Updater. Po wywołaniu metoda wykonuje następujące operacje:

  1. Inicjuje architekturę aktualizacji i cicho (oraz synchroniczne) instaluje wszelkie oczekujące aktualizacje. Metodę tę należy wywołać w fazie uruchamiania aplikacji, ponieważ może spowodować ponowne jej uruchomienie.

  2. Sprawdza, czy istnieje oczekująca (odłożona w czasie) aktualizacja, a jeśli tak, instaluje ją.

  3. Jeśli wcześniejsza aktualizacja nie powiodła się, usuwa z pamięci informacje o pliku aktualizacji i o wersji.

  4. Jeśli upłynął czas opóźnienia między automatycznym sprawdzaniem dostępności aktualizacji, rozpoczyna aktualizację; w przeciwnym razie uruchamia licznik czasu opóźnienia. Jednak podczas testowania aplikacji za pomocą programu AIR Debug Launcher (ADL) próba zaktualizowania aplikacji spowoduje wygenerowanie wyjątku IllegalOperationError.


Zdarzenia
initialized:UpdateEvent — Inicjowanie zostało ukończone.
 
error:ErrorEvent — Wystąpił błąd podczas inicjowania.

    installFromAIRFile

()metoda 
public function installFromAIRFile(file:File):void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Rozpoczyna proces aktualizacji przy użyciu lokalnego pliku AIR.

Wywołanie tej metody nie odnosi skutku, jeśli trwa już proces aktualizacji (w stanie innym niż "Downloaded").

Ta funkcja jest przydatna w aplikacjach, dla których w pliku deskryptora element customUpdateUI jest ustawiony na true.

Podczas testowania aplikacji za pomocą aplikacji ADL (AIR Debug Launcher) wywoływanie tej metody powoduje wygenerowanie wyjątku IllegalOperationError.

Parametry

file:File — Lokalny plik AIR do zainstalowania.


Zdarzenia
fileUpdateStatus:StatusFileUpdateEvent — Wywoływane po pomyślnym zweryfikowaniu pliku AIR przez obiekt Updater.
 
updateError:StatusFileUpdateErrorEvent — Wywoływane, gdy wystąpi błąd przy próbie przeanalizowania pliku deskryptora aktualizacji.
Szczegół zdarzenia
    

beforeInstall

Zdarzenie
Typ obiektu zdarzenia: air.update.events.UpdateEvent
właściwość UpdateEvent.type = air.update.events.UpdateEvent.BEFORE_INSTALL

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane tuż przed zainstalowaniem aktualizacji, po wywołaniu metody installUpdate(). Niekiedy celowe jest uniemożliwienie instalacji na tym etapie, ponieważ użytkownik mógłby utracić wszystkie wyniki pracy po zakończeniu pracy aplikacji wymuszonym w celu zainstalowania aktualizacji.

Wywołanie metody preventDefault() obiektu zdarzenia powoduje odłożenie instalacji do momentu następnego uruchomienia aplikacji. Po wywołaniu metody preventDefault() nie jest możliwe uruchomienie jakiegokolwiek następnego procesu aktualizacji w tej sesji aplikacji (poprzez wywołanie metody installUpdate() lub po automatycznym okresowym sprawdzeniu).

Stała UpdateEvent.BEFORE_INSTALL definiuje wartość właściwości type obiektu zdarzenia beforeInstall.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt Updater.
    

checkForUpdate

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.UpdateEvent
właściwość UpdateEvent.type = air.update.events.UpdateEvent.CHECK_FOR_UPDATE

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane przed rozpoczęciem procesu aktualizacji, tuż zanim obiekt Updater podejmie próbę pobrania pliku deskryptora aktualizacji. Obiekt Updater może wywołać to zdarzenie w wyniku bezpośredniego wywołania metody checkNow() lub po upływie czasu odmierzanego przez licznik opóźnienia między sprawdzaniem dostępności aktualizacji.

Stała UpdateEvent.CHECK_FOR_UPDATE definiuje wartość właściwości type obiektu zdarzenia checkForUpdate.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt Updater.
    

downloadComplete

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.UpdateEvent
właściwość UpdateEvent.type = air.update.events.UpdateEvent.DOWNLOAD_COMPLETE

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane po ukończeniu pobierania pliku aktualizacji.

Stała UpdateEvent.DOWNLOAD_COMPLETE definiuje wartość właściwości type obiektu zdarzenia downloadComplete.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt Updater.
    

downloadError

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.DownloadErrorEvent
właściwość DownloadErrorEvent.type = air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane, jeśli podczas nawiązywania połączenia lub pobierania pliku aktualizacji wystąpi błąd. To zdarzenie jest także wywoływane w wypadku odebrania niepoprawnego statusu HTTP (np. „404 - nie znaleziono pliku”).

Z chwilą wywołania tego zdarzenia automatycznie uruchamiany jest licznik czasu (jeśli opóźnienie jest większe od 0).

Stała DownloadErrorEvent.DOWNLOAD_ERROR definiuje wartość właściwości type obiektu zdarzenia downloadError.

Właściwość errorID obiektu DownloadErrorEvent jest liczbą całkowitą definiującą informacje o błędzie (zob. poniższą tabelę). Dodatkowa właściwość subErrorID może zawierać dalsze informacje o błędzie.

Kod błędu errorIDOpis
16800Występuje podczas weryfikacji pobranego pliku aktualizacji. Właściwość subErrorID może zawierać dodatkowe informacje.
16801Niepoprawny plik Adobe AIR (brak pliku application.xml).
16802Niepoprawny plik Adobe AIR (brak typu MIME).
16803Niepoprawny plik Adobe AIR (format).
16804Niepoprawny plik Adobe AIR (niepoprawne znaczniki).
16805Niepoprawny plik Adobe AIR (nieznany format kompresji).
16806Niepoprawny plik Adobe AIR (niepoprawna nazwa pliku).
16807Niepoprawny plik Adobe AIR (uszkodzony).
16808Plik konfiguracyjny nie istnieje.
16809Właściwość updateURL nie jest ustawiona.
16810Zarezerwowany.
16811Niepoprawny plik konfiguracyjny (nieznana wersja konfiguracji).
16812Niepoprawny plik konfiguracyjny (brak adresu URL).
16813Niepoprawny plik konfiguracyjny (format opóźnienia).
16814Niepoprawny plik konfiguracyjny (niepoprawne wartości defaultUI).
16815Niepoprawny deskryptor aktualizacji (nieznana wersja deskryptora).
16816Niepoprawny deskryptor aktualizacji (brak wersji aktualizacji).
16817Niepoprawny deskryptor aktualizacji (niepoprawny opis).
16818Błąd wejścia/wyjścia podczas zapisywania danych na dysku. Więcej informacji można uzyskać na podstawie wartości właściwości subErrorID.
16819Błąd zabezpieczeń podczas pobierania. Więcej informacji można uzyskać na podstawie wartości właściwości subErrorID.
16820Niepoprawny kod statusu HTTP. Możliwe, że właściwość subErrorID zawiera niepoprawny kod statusu.
16821Zarezerwowany.
16822Błąd wejścia/wyjścia podczas pobierania. Więcej informacji można uzyskać na podstawie wartości właściwości subErrorID.
16823Błąd końca pliku podczas zapisywania danych na dysku. Więcej informacji można uzyskać na podstawie wartości właściwości subErrorID.
16824Niepoprawny deskryptor aktualizacji. Więcej informacji można uzyskać na podstawie wartości właściwości subErrorID.
16825Plik aktualizacji zawiera aplikację z innym identyfikatorem.
16826Plik aktualizacji nie zawiera nowszej wersji aplikacji.
16827Wersja zapisana w pliku aktualizacji jest różna od wersji w deskryptorze aktualizacji.
16828Zaktualizowanie aplikacji nie jest możliwe; zwykle wynika to z faktu, że aplikacja jest uruchomiona wewnątrz programu AIR Debug Launcher (ADL).
16829Brak pliku aktualizacji podczas instalowania.
    

downloadStart

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.UpdateEvent
właściwość UpdateEvent.type = air.update.events.UpdateEvent.DOWNLOAD_START

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane po wywołaniu metody downloadUpdate() i nawiązaniu połączenia z serwerem. W przypadku użycia biblioteki ApplicationUpdater często stosowanym rozwiązaniem jest wyświetlanie paska postępu pobierania w procedurze obsługi tego zdarzenia.

Stała UpdateEvent.DOWNLOAD_START definiuje wartość właściwości type obiektu zdarzenia downloadStart.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt Updater.
    

error

Zdarzenie  
Typ obiektu zdarzenia: flash.events.ErrorEvent
właściwość ErrorEvent.type = flash.events.ErrorEvent.ERROR

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane, gdy wystąpi błąd podczas inicjowania lub podczas procesu aktualizacji (w razie zajścia nieoczekiwanego zdarzenia).

Definiuje wartość właściwości type obiektu zdarzenia error.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt, w którym wystąpiło niepowodzenie operacji sieciowej.
textTekst, który ma być wyświetlany w charakterze komunikatu o błędzie.
    

fileUpdateError

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.StatusFileUpdateErrorEvent
właściwość StatusFileUpdateErrorEvent.type = air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane, gdy wystąpi błąd podczas weryfikacji pliku przekazanego jako parametr airFile w wywołaniu metody installFromAIRFile().

Stała StatusUpdateErrorEvent.UPDATE_ERROR definiuje wartość właściwości type obiektu zdarzenia statusUpdateError.
    

fileUpdateStatus

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.StatusFileUpdateEvent
właściwość StatusFileUpdateEvent.type = air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane po tym, jak obiekt Updater pomyślnie zweryfikuje plik w wywołaniu metody installFromAIRFile().

Stała StatusUpdateEvent.UPDATE_STATUS definiuje wartość właściwości type obiektu zdarzenia updateStatus.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
availableOkreśla, czy jest dostępna wersja inna niż wersja bieżącej aplikacji (true); false w przeciwnym wypadku (ta sama wersja).
pathWłaściwość nativePath obiektu File aktualizacji określonego przez parametr airFile w wywołaniu metody installFromAIRFile().
versionOkreśla wersję nowej aktualizacji.

    

initialized

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.UpdateEvent
właściwość UpdateEvent.type = air.update.events.UpdateEvent.INITIALIZED

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane po zakończeniu inicjowania.

To zdarzenie ma następujące właściwości przeznaczone tylko do odczytu:

  • isFirstRun (Boolean) true, jeśli jest to pierwsze uruchomienie po pomyślnej aktualizacji; false w przeciwnym wypadku.

  • previousVersion (String) Poprzednia wersja aplikacji przed uaktualnieniem (wartość przypisywana tylko wtedy, gdy isfirstRun ma wartość true).

  • currentVersion (String) Wersja odczytana z pliku deskryptora obecnie zainstalowanej wersji aplikacji.

Stała UpdateEvent.INITIALIZED definiuje wartość właściwości type obiektu zdarzenia initialized.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt Updater.
    

progress

Zdarzenie  
Typ obiektu zdarzenia: flash.events.ProgressEvent
właściwość ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane w chwili pobrania pliku aktualizacji.

Definiuje wartość właściwości type obiektu zdarzenia progress.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
bytesLoadedLiczba elementów lub bajtów załadowanych w momencie, w którym detektor przetwarza zdarzenie.
bytesTotalŁączna liczba elementów lub bajtów, które zostaną ostatecznie załadowane w razie pomyślnego zakończenia operacji ładowania.
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt informujący o postępie.
    

updateError

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.StatusUpdateErrorEvent
właściwość StatusUpdateErrorEvent.type = air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane, gdy wystąpi błąd przy próbie pobrania lub przeanalizowania pliku deskryptora aktualizacji.

Gdy obiekt Updater wywoła to zdarzenie, automatycznie uruchamiany jest licznik czasu (jeśli opóźnienie jest ustawione na wartość większą niż 0). Wskazane jest, aby aplikacja ukrywała wszelkie okna dialogowe błędów, gdy obiekt Updater wywoła nowe zdarzenie checkForUpdate.

Stała StatusUpdateErrorEvent.UPDATE_ERROR definiuje wartość właściwości type obiektu zdarzenia statusUpdateError.
    

updateStatus

Zdarzenie  
Typ obiektu zdarzenia: air.update.events.StatusUpdateEvent
właściwość StatusUpdateEvent.type = air.update.events.StatusUpdateEvent.UPDATE_STATUS

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.5

Wywoływane po tym, jak obiekt Updater pomyślnie pobierze i zinterpretuje plik deskryptora aktualizacji.

Stała StatusUpdateEvent.UPDATE_STATUS definiuje wartość właściwości type obiektu zdarzenia updateStatus.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
availableUstawiana na true, jeśli w pliku deskryptora aktualizacji jest określona wersja różna od wersji bieżącej aplikacji; false w przeciwnym wypadku (ta sama wersja).
versionCiąg znaków reprezentujący nową dostępną wersję.
detailsTablica definiująca ciąg znaków details dla każdego z obsługiwanych języków. W wypadku braku zlokalizowanego opisu właściwość ta jest tablicą, której pierwszym elementem jest pusty ciąg znaków (""), natomiast drugim elementem jest ciąg znaków ze szczegółami. Gdy istnieją zlokalizowane opisy, każdy element tablicy jest tablicą dwuelementową. Pierwszy element to kod ustawień narodowych, a drugi element to opis. Na przykład następująca tablica zawiera podtablice dla dwóch języków (angielskiego amerykańskiego oraz francuskiego): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. Języki są wymienione w tej samej kolejności co w deskryptorze aktualizacji. W pliku deskryptora aktualizacji jest podany tekst właściwości details.
versionLabel(AIR 2.5 i nowsze wersje) Etykieta wersji z deskryptora aplikacji aktualizacji. Etykieta wersji powinna być przedstawiana użytkownikom zamiast wersji. Jeśli nie określono etykiety wersji, ta właściwość jest pustym ciągiem.




[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.