@capgo/capacitor-background-task

Resumen

Utilice @capgo/capacitor-background-task cuando su aplicación Capacitor necesita trabajo de fondo periódico de recuperación de datos como sincronización, refrescos de caché, monitoreo de bandeja de entrada, vaciado de análisis o tareas de mantenimiento ligeras.

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

Capacidades básicas

• defineTask - Registrar la llamada de JavaScript para una tarea nombrada.
• registerTaskAsync - Persistir 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 tarea nativa registrados antes de que estuviera lista la JavaScript.
• getStatusAsync - Verificar la disponibilidad de tareas de fondo nativas.
• triggerTaskWorkerForTestingAsync - Ejecutar tareas registradas inmediatamente durante el desarrollo.
• addExpirationListener - Manejar 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 una fecha de inicio más temprana, no una cadencia garantizada.
Web	Fallo de prueba solo	No está disponible un 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 de fondo periódica nombrada.
unregisterTaskAsync	Cancela futuras ejecuciones de tarea.
isTaskRegisteredAsync	Devuelve si una tarea está registrada.
getRegisteredTasksAsync	Lista los nombres de tarea registrados.
getPendingTaskRunsAsync	Lista los eventos de tarea nativa pendientes de finalización.
getStatusAsync	Devuelve si está disponible la programación de fondo nativa.
triggerTaskWorkerForTestingAsync	Dispara las 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

If you are using @capgo/capacitor-tarea-de-fondo para planificar el trabajo de plugin nativo, conecte con Usando @capgo/capacitor-tarea-de-fondo para la capacidad nativa en Usando @capgo/capacitor-tarea-de-fondo, Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise {"targetLanguage":"Spanish","pagePath":"/es/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives."},{"text":"Editar página"}]}