Resumen
Sección titulada “Resumen”Usar @capgo/capacitor-background-task cuando su aplicación Capacitor necesita trabajo de recarga de fondo periódico, como sincronización, refrescos de caché, monitoreo de bandeja de entrada, eliminación 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 Fundamentales
Sección titulada “Capacidades Fundamentales”defineTask- Registra la llamada de llamada 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- Listar nombres de tarea registrados actualmente.getPendingTaskRunsAsync- Inspecciona eventos de tarea nativa grabados antes de que estuviera lista JavaScript.getStatusAsync- Verificar la disponibilidad de tareas de fondo nativas.triggerTaskWorkerForTestingAsync- Ejecutar tareas registradas inmediatamente durante el desarrollo.addExpirationListener- Manejar llamadas de vencimiento de iOS.define,schedule,cancel,statusAsync, yfinish- Ayudas de compatibilidad parareact-native-background-task.
- Comportamiento de la plataforma
Sección titulada “Comportamiento de la plataforma”Tareas de fondo no son temporizadores exactos. Android e iOS deciden cuándo ejecutar trabajo programado según la batería, la red, el uso de la aplicación y la política del sistema.
| Plataforma | Programador nativo | Comportamiento importante |
|---|---|---|
| Android | WorkManager | Trabajo periódico tiene un intervalo mínimo de 15 minutos. |
| iOS | BGTaskScheduler | minimumInterval es una fecha de inicio más temprana, no un ritmo garantizado. |
| Web | Alternativa de prueba solo | No está disponible un verdadero programador de fondo. |
Público API
Título de sección “Público API”| Método | Descripción |
|---|---|
defineTask | Define la llamada de retorno de JavaScript para una tarea nombrada. |
registerTaskAsync | Registra una tarea de fondo periódica 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. |
addExpirationListener | Escucha eventos de expiración de iOS. |
Fuente de Verdad
Sección titulada “Fuente de Verdad”Esta referencia está sincronizada desde src/definitions.ts en capacitor-tarea de fondo.
Sigue adelante desde @capgo/capacitor-tarea de fondo
Sección titulada “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 Capgo Directorio de Plugin para el flujo de trabajo del producto en el directorio de plugins Capgo 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 para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas.