@capgo/capacitor-background-task

Resumen

Usar @capgo/capacitor-background-task cuando su aplicación Capacitor necesita trabajo de recuperación de fondo periódico, como sincronización, refrescos de caché, conteo de mensajes de bandeja, eliminación de análisis o tareas de mantenimiento ligeras.

El complemento sigue el conjunto de características prácticas de Expo BackgroundTask con tareas con nombres, registro persistente, verificaciones de estado, desregistro, un disparador de desarrollo y eventos de expiración de iOS.

Capacidades Fundamentales

• defineTask - Registre la llamada de llamada de JavaScript para una tarea con nombre.
• registerTaskAsync - Persista y programar una tarea periódica.
• unregisterTaskAsync - Cancelar futuras ejecuciones para una tarea.
• isTaskRegisteredAsync - Verificar si una tarea está registrada.
• getRegisteredTasksAsync - Listar nombres de tareas registradas actualmente.
• getPendingTaskRunsAsync - Inspeccionar eventos de tareas nativas registrados antes de que estuviera lista la ejecución de JavaScript.
• getStatusAsync - Verificar la disponibilidad de tareas de fondo nativas.
• triggerTaskWorkerForTestingAsync - Ejecutar tareas registradas inmediatamente durante el desarrollo.
• addExpirationListener - Manejar llamadas de retorno de expiración de iOS.
• define, schedule, cancel, statusAsync, y finish - Ayudas de compatibilidad para react-native-background-task.

Comportamiento de la plataforma

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

Plataforma	Programador nativo	Comportamiento importante
Android	WorkManager	El trabajo periódico tiene un mínimo de intervalo de 15 minutos.
iOS	BGTaskScheduler	minimumInterval es una fecha de inicio más temprana, no un ritmo garantizado.
Web	Fallo de prueba solo	No está disponible ningún programador de fondo real.

Público API

Método	Descripción
defineTask	Define el callback de JavaScript para una tarea nombrada.
registerTaskAsync	Registra una tarea periódica de fondo nombrada.
unregisterTaskAsync	Cancela ejecuciones de tareas futuras.
isTaskRegisteredAsync	Devuelve si una tarea está registrada.
getRegisteredTasksAsync	Lista nombres de tareas registradas.
getPendingTaskRunsAsync	Lista eventos de tareas nativas pendientes de finalización.
getStatusAsync	Devuelve si está disponible la programación de fondo nativa.
triggerTaskWorkerForTestingAsync	Dispara tareas registradas para desarrollo y pruebas de QA.
addExpirationListener	Escucha eventos de expiración de iOS.

Fuente de Verdad

Esta referencia está sincronizada desde src/definitions.ts en capacitor-tarea de fondo.