@capgo/capacitor-background-task

Resumen

Define tareas con alcance de módulo, programa intervalos y devuelve resultados que el SO entienda para sincronización y precarga de caché.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	Identificadores de BGTaskScheduler en Info.plist
Android	Sí	Jobs estilo WorkManager
Web	No	Usa service workers

Funcionalidades principales

• defineTask - Registra el callback de JavaScript para una tarea con nombre.
• registerTaskAsync - Persiste y programa una tarea periódica.
• unregisterTaskAsync - Cancela ejecuciones futuras de una tarea.
• isTaskRegisteredAsync - Comprueba si una tarea está registrada.
• getRegisteredTasksAsync - Lista los nombres de las tareas registradas.
• getPendingTaskRunsAsync - Inspecciona eventos de tareas nativas registrados antes de que JavaScript estuviera listo.
• getStatusAsync - Comprueba la disponibilidad de tareas en segundo plano nativas.
• triggerTaskWorkerForTestingAsync - Ejecuta tareas registradas inmediatamente durante el desarrollo.
• addExpirationListener - Gestiona los callbacks de expiración en iOS.
• define, schedule, cancel, statusAsync, y finish - Helpers de compatibilidad para react-native-background-task.

Comportamiento por plataforma

Las tareas en segundo plano no son temporizadores exactos. Android e iOS deciden cuándo ejecutar el trabajo programado según la batería, red, uso de la app y políticas del sistema.

Plataforma	Scheduler nativo	Comportamiento importante
Android	WorkManager	El trabajo periódico tiene un intervalo mínimo de 15 minutos.
iOS	BGTaskScheduler	minimumInterval es la fecha de inicio más temprana, no una cadencia garantizada.
Web	Fallback solo para pruebas	No hay un scheduler de background disponible.

Público API

Método	Descripción
defineTask	Define el callback de JavaScript para una tarea con nombre.
registerTaskAsync	Registra una tarea de background periódica con nombre.
unregisterTaskAsync	Cancela las ejecuciones futuras de la tarea.
isTaskRegisteredAsync	Indica si una tarea está registrada.
getRegisteredTasksAsync	Lista los nombres de las tareas registradas.
getPendingTaskRunsAsync	Lista los eventos de tareas nativas pendientes.
getStatusAsync	Indica si la programación nativa en segundo plano está disponible.
triggerTaskWorkerForTestingAsync	Ejecuta las tareas registradas para desarrollo y QA.
addExpirationListener	Escucha los eventos de expiración en iOS.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-background-task.

Continúa desde @capgo/capacitor-background-task

Si estás usando @capgo/capacitor-background-task para planificar el trabajo con plugins nativos, conéctalo con Uso de @capgo/capacitor-background-task para la capacidad nativa en Uso de @capgo/capacitor-background-task, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.