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ć bieżący stan, możesz odwołać się do AppState.currentState, który jest stale aktualizowany.

informacja

Jeśli używasz starszej architektury, currentState będzie miał wartość null podczas uruchamiania, dopóki nie zostanie asynchronicznie pobrany z natywnej strony.

Ten przykład zawsze będzie wyświetlał "Current state is: active", ponieważ aplikacja jest widoczna dla użytkownika tylko w stanie active. Jeśli chcesz eksperymentować z kodem, zalecamy użycie własnego urządzenia zamiast wbudowanego 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;