AppState

Nieoficjalne Tłumaczenie Beta

Ta strona została przetłumaczona przez PageTurner AI (beta). Nie jest oficjalnie zatwierdzona przez projekt. Znalazłeś błąd? Zgłoś problem →

AppState informuje, czy aplikacja działa na pierwszym planie czy w tle, oraz powiadamia o zmianie stanu.

AppState jest często używany do określania intencji i właściwego zachowania podczas obsługi powiadomień push.

Stany aplikacji

• active - Aplikacja działa na pierwszym planie

• background - Aplikacja działa w tle. Użytkownik może być:

  • w innej aplikacji
  • na ekranie głównym
  • [Android] w innej Activity (nawet jeśli została uruchomiona przez twoją aplikację)

• [iOS] inactive - Stan występujący podczas przejścia między pierwszym planem a tłem oraz w okresach bezczynności, takich jak wejście w widok multitaskingu, otwarcie Centrum Powiadomień lub podczas przychodzącego połączenia.

Więcej informacji znajdziesz w dokumentacji Apple

Podstawowe użycie

Aby sprawdzić aktualny stan, możesz odwołać się do AppState.currentState, który jest stale aktualizowany. Jednak currentState będzie miał wartość null przy uruchomieniu, dopóki AppState nie pobierze go przez most (bridge).

Ten przykład zawsze będzie wyświetlał "Current state is: active", ponieważ aplikacja jest widoczna dla użytkownika tylko w stanie active, a stan null występuje tylko chwilowo. Do testowania kodu zalecamy użycie własnego urządzenia zamiast osadzonego podglądu.

---

Dokumentacja

Zdarzenia

change

To zdarzenie jest emitowane przy zmianie stanu aplikacji. Listener jest wywoływany z jedną z aktualnych wartości stanu.

memoryWarning

iOS

Wyzwalane, gdy aplikacja otrzyma ostrzeżenie o pamięci od systemu operacyjnego.

focus

Android

Odbierane gdy aplikacja zyskuje focus (użytkownik wchodzi w interakcję z aplikacją).

blur

Android

Odbierane gdy użytkownik nie wchodzi aktywnie w interakcję z aplikacją. Przydatne np. gdy użytkownik ściąga szufladę powiadomień. AppState nie zmieni się, ale zdarzenie blur zostanie wyemitowane.

Metody

addEventListener()

tsx

static addEventListener(
  type: AppStateEvent,
  listener: (state: AppStateStatus) => void,
): NativeEventSubscription;

Konfiguruje funkcję wywoływaną przy wystąpieniu określonego typu zdarzenia w AppState. Prawidłowe wartości eventType są wymienione powyżej. Zwraca EventSubscription.

Zatrzymuje działającą animację i resetuje wartość do oryginalnej.

currentState

tsx

static currentState: AppStateStatus;