Pobieranie i interpretowanie pliku deskryptora aktualizacji

Obiekt ApplicationUpdater wywołuje zdarzenie checkForUpdate przed rozpoczęciem procesu aktualizacji, tuż przed próbą pobrania pliku deskryptora aktualizacji. Jeśli domyślne zachowanie zdarzenia checkForUpdate zostanie anulowane, obiekt Updater nie pobierze pliku deskryptora aktualizacji. Można wywołać metodę checkForUpdate() i tym samym wznowić proces aktualizacji:

appUpdater.checkForUpdate();

Wywołanie metody checkForUpdate() powoduje, że obiekt Updater asynchronicznie pobierze i zinterpretuje plik deskryptora. W wyniku wywołania metody checkForUpdate() obiekt Updater może wywołać następujące zdarzenia:

  • StatusUpdateEvent.UPDATE_STATUS — obiekt Updater pomyślnie pobrał i zinterpretował plik deskryptora aktualizacji. To zdarzenie ma następujące właściwości:

    • available — wartość typu Boolean. Ustawiana na true , jeśli dostępna jest wersja aplikacji inna niż bieżąca; false w przeciwnym wypadku (wersje są takie same).

    • version — ciąg znaków (String). Wersja odczytana z pliku deskryptora aplikacji pliku aktualizacji.

    • details — tablica (Array). Jeśli nie istnieją zlokalizowane wersje opisu, jako pierwszy element tej tablicy jest zwracany pusty ciąg znaków ( "" ), a jako drugi element zwracany jest opis.

      Jeśli istnieje wiele wersji opisu (w pliku deskryptora aplikacji), tablica zawiera wiele podtablic. Każda tablica ma dwa elementy: pierwszy jest kodem języka (na przykład "en" ), a drugi jest odpowiednim opisem (typu String) w tym języku. Zobacz Definiowanie plików deskryptora aktualizacji i dodawanie pliku AIR do serwera internetowego .

  • StatusUpdateErrorEvent.UPDATE_ERROR — wystąpił błąd i obiekt Updater nie mógł pobrać lub zinterpretować pliku deskryptora aktualizacji.