@capgo/capacitor-tarea de fondo

Resumen

Usa @capgo/capacitor-background-task cuando tu aplicación Capacitor necesita trabajo de recarga de fondo periódico como sincronización, refrescos de caché, conteo de mensajes de bandeja, vaciado de análisis o trabajos de mantenimiento ligeros.

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

Capacidades básicas

• defineTask - Registra la llamada de JavaScript para una tarea nombrada.
• registerTaskAsync - Persiste y programa una tarea periódica.
• unregisterTaskAsync - Cancela futuras ejecuciones para una tarea.
• isTaskRegisteredAsync - Verifica si una tarea está registrada.
• getRegisteredTasksAsync - Muestra los nombres de las tareas registradas actualmente.
• getPendingTaskRunsAsync - Inspecciona eventos de tareas nativas registrados antes de que estuviera lista la JavaScript.
• getStatusAsync - Verifica la disponibilidad de tareas de fondo nativas.
• triggerTaskWorkerForTestingAsync - Ejecuta tareas registradas inmediatamente durante el desarrollo.
• addExpirationListener - Maneja callbacks 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 en función de la batería, la red, el uso de la aplicación 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 un fecha de inicio más temprano, no un ritmo garantizado.
Web	Alternativa de prueba solo	No está disponible un programador de fondo real.

Público API

Método	Descripción
defineTask	Define la llamada de llamada 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 tarea registrados.
getPendingTaskRunsAsync	Lista eventos de tarea nativa pendientes de finalización.
getStatusAsync	Devuelve si está disponible la programación de fondo nativa.
triggerTaskWorkerForTestingAsync	Dispara tareas registradas para desarrollo y 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.

Sigue adelante desde @capgo/capacitor-tarea-de-fondo

Si estás utilizando @capgo/capacitor-tarea-de-fondo para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-tarea-de-fondo para la capacidad nativa en Usando @capgo/capacitor-tarea-de-fondo, Directorio de Plugins de Capgo para el flujo de trabajo del producto en Directorio de Plugins de Capgo, Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Empresa de Ionic para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives.