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, puedes consultar AppState.currentState, que se mantendrá actualizado.

información

Si estás utilizando la arquitectura heredada, currentState será null al inicio hasta que se recupere de forma asíncrona desde el lado nativo.

Este ejemplo siempre mostrará "Estado actual: active" porque la aplicación solo es visible para el usuario cuando está en estado active. Si quieres experimentar con el código, te recomendamos usar tu propio dispositivo en lugar de la vista previa integrada.

---

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;