Saltar al contenido principal

Estado de la Aplicación

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

AppState puede indicarte si la aplicación está en primer plano o segundo plano, y notificarte cuando cambie su estado.

AppState se utiliza frecuentemente para determinar la intención y comportamiento adecuado al manejar notificaciones push.

Estados de la Aplicación​

  • active - La aplicación se ejecuta en primer plano

  • background - La aplicación se ejecuta en segundo plano. El usuario puede estar:

    • en otra aplicación
    • en la pantalla de inicio
    • [Android] en otra Activity (incluso si fue iniciada por tu aplicación)

  • [iOS] inactive - Estado que ocurre durante transiciones entre primer y segundo plano, y en periodos de inactividad como al entrar en la vista multitarea, abrir el Centro de Notificaciones o durante llamadas entrantes.

Para más información, consulta la documentación de Apple

Uso Básico​

Para ver el estado actual, consulta AppState.currentState, que se mantiene actualizado. Sin embargo, currentState será null durante el inicio mientras AppState lo recupera a través del puente.

Este ejemplo siempre mostrará "Estado actual: active" porque la app solo es visible en estado active, y el estado null ocurre momentáneamente. Para experimentar, recomendamos usar tu dispositivo en lugar de vistas previas incrustadas.

Referencia

Eventos​

change​

Evento recibido cuando cambia el estado de la app. El listener se llama con uno de los valores de estado actuales.

memoryWarning
iOS
​

Se dispara cuando la aplicación recibe una advertencia de memoria del sistema operativo.

focus
Android
​

Recibido cuando la app gana foco (el usuario interactúa con ella).

blur
Android
​

Recibido cuando el usuario no interactúa activamente con la app. Útil cuando el usuario despliega el cajón de notificaciones. AppState no cambiará pero se disparará el evento blur.

Métodos​

addEventListener()​

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

Configura una función que se llamará cuando ocurra el tipo de evento especificado en AppState. Los valores válidos para eventType están listados arriba. Retorna el EventSubscription.

Propiedades​

currentState​

tsx
static currentState: AppStateStatus;