Android 10 (nivel de API 29) y versiones posteriores imponen restricciones sobre cuándo las apps pueden iniciar actividades cuando se ejecutan en segundo plano. Estas restricciones ayudan a minimizar las interrupciones para el usuario y a darle más control de lo que aparece en la pantalla.
En esta guía, se presentan las notificaciones como una alternativa para iniciar actividades en segundo plano. También se enumeran los casos específicos en los que no se aplica la restricción.
Cómo mostrar notificaciones
En prácticamente todos los casos, las apps en segundo plano deben mostrar notificaciones urgentes para proporcionar información urgente al usuario en lugar de iniciar una actividad de forma directa. Estas notificaciones incluyen la administración de una llamada telefónica entrante o un reloj de alarma activo.
Este sistema de alertas y recordatorios basados en notificaciones presenta distintas ventajas para los usuarios:
- Cuando usa el dispositivo, el usuario ve una notificación emergente que le permite responder. El usuario conserva el contexto actual y controla el contenido que ve en la pantalla.
- Las notificaciones urgentes respetan las reglas de No interrumpir del usuario. Por ejemplo, cuando está activado el modo No interrumpir, los usuarios pueden aceptar llamadas provenientes de determinados contactos o emisores recurrentes.
- Cuando está apagada la pantalla del dispositivo, se inicia inmediatamente el intent en pantalla completa.
- En la pantalla de Configuración del dispositivo, el usuario puede ver qué apps enviaron notificaciones recientemente, incluso desde canales específicos. En esa pantalla, el usuario puede controlar sus preferencias de notificaciones.
Cuándo las apps pueden iniciar actividades
Las apps que se ejecutan en Android 10 o versiones posteriores pueden iniciar actividades cuando se cumple una o más de las siguientes condiciones:
- La app tiene una ventana visible, como una actividad en primer plano.
- La app tiene una actividad en la pila de actividades de la tarea en primer plano.
La app tiene una actividad en la pila de actividades de una tarea existente en la pantalla Recientes.
La app tiene una actividad que se inició muy recientemente.
La app llamó a
finish()
en una actividad muy recientemente. Esta condición se aplica solo cuando la app tenía una actividad en primer plano o una actividad en la pila de la tarea en primer plano en el momento en que se llamó afinish()
.La app tiene uno de los siguientes servicios que está vinculado por el sistema. Es posible que estos servicios deban iniciar una IU.
AccessibilityService
AutofillService
CallRedirectionService
HostApduService
InCallService
TileService
(no se aplica en Android 14 (nivel de API 34) y versiones posteriores)VoiceInteractionService
VrListenerService
.
La app tiene un servicio que está vinculado por una app diferente y visible. La app vinculada al servicio debe permanecer visible para que la app en segundo plano inicie las actividades correctamente.
La app recibe una notificación
PendingIntent
del sistema. En el caso de intents pendientes para servicios y receptores de emisión, la app puede iniciar actividades durante unos segundos después de que se envía el intent pendiente.La app recibe un
PendingIntent
que se envía desde una app diferente y visible.La app recibe una transmisión del sistema en la que se espera que inicie una IU. Los ejemplos incluyen
ACTION_NEW_OUTGOING_CALL
ySECRET_CODE_ACTION
. La app puede iniciar actividades durante unos segundos luego del envío de la transmisión.La app se asocia con un dispositivo de hardware complementario a través de la API de
CompanionDeviceManager
. Esta API permite que la app inicie actividades en respuesta a acciones que realiza el usuario en un dispositivo sincronizado.La app es un controlador de política de dispositivo que se ejecuta en el modo de propietario del dispositivo. Algunos ejemplos de casos de uso son dispositivos empresariales completamente administrados y dispositivos dedicados, como los de señalización digital y de kiosco.
El usuario le otorga a la app el permiso
SYSTEM_ALERT_WINDOW
.
Se requiere la habilitación cuando se inician actividades desde PendingIntents
Para evitar permitir inicios de actividades accidentales según las condiciones enumeradas, a partir de Android 14, hay APIs explícitas que te permiten habilitar o inhabilitar el otorgamiento de permisos a una app para el inicio de actividades.
De forma predeterminada, las apps orientadas a Android 15 o versiones posteriores ya no otorgarán privilegios de inicio de actividad en segundo plano (BAL) de forma implícita a los PendingIntents
que creen. Se requiere la habilitación explícita. Para ello, estas son las opciones según si la app envía o crea PendingIntents
.
Por el remitente del PendingIntent
Las apps orientadas a Android 14 o versiones posteriores que quieran iniciar un PendingIntent
deben cumplir con los siguientes requisitos:
- cumplir con las condiciones indicadas y
- habilitar el inicio de actividades en segundo plano según esas excepciones
Esta habilitación solo debe ocurrir si el desarrollador de la app sabe que la app iniciará una actividad.
Para hacerlo, la app debe pasar un paquete ActivityOptions
con setPendingIntentBackgroundActivityStartMode(ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED)
a PendingIntent.send()
o métodos similares.
Por el creador del PendingIntent
Las apps que se orientan a Android 15 o versiones posteriores y que crean un PendingIntent
ahora deben habilitar de forma explícita el inicio de actividades en segundo plano si desean que esos PendingIntents
se puedan iniciar en las condiciones enumeradas.
En la mayoría de los casos, la app que inicia el PendingIntent
debe ser la que acepte la opción.
Sin embargo, si la app que crea necesita otorgar estos privilegios, haz lo siguiente:
- El
PendingIntent
se puede iniciar en cualquier momento en que la app de creación esté visible. - Se puede iniciar
PendingIntent
en cualquier momento si la app de creación tiene privilegios especiales.
Para hacerlo, la app debe pasar un paquete ActivityOptions
con setPendingIntentCreatorBackgroundActivityStartMode
(ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED)
a PendingIntent.getActivity()
o métodos similares.
Lee la documentación de referencia relevante para obtener más detalles:
ActivityOptions.setPendingIntentBackgroundActivityStartMode
ActivityOptions.setPendingIntentCreatorBackgroundActivityStartMode
Modo estricto
A partir de Android 16, el desarrollador de la app puede habilitar el modo estricto para recibir una notificación cuando se bloquea el inicio de una actividad (o cuando corre el riesgo de bloquearse cuando se eleva el SDK de destino de la app).
Código de ejemplo para habilitar desde el principio de tu aplicación, actividad o cualquier otro
componente de la aplicación en el método Application.onCreate()
:
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
StrictMode.setVmPolicy(
StrictMode.VmPolicy.Builder()
.detectBlockedBackgroundActivityLaunch()
.penaltyLog()
.build());
)
}
Para obtener más detalles, consulta la documentación del modo estricto.