Saltar al contenido

@capgo/capacitor-tarea-de-fondo

Tareas de fondo con estilo de Expo, para aplicaciones Capacitor, respaldadas por Android WorkManager e iOS BGTaskScheduler.

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.

  • 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, y finish - Ayudas de compatibilidad para react-native-background-task.

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.

PlataformaProgramador nativoComportamiento importante
AndroidWorkManagerTrabajo periódico tiene un intervalo mínimo de 15 minutos.
iOSBGTaskSchedulerminimumInterval es una fecha de inicio más temprana, no un ritmo garantizado.
WebAlternativa de prueba soloNo está disponible un verdadero programador de fondo.
MétodoDescripción
defineTaskDefine la llamada de retorno de JavaScript para una tarea nombrada.
registerTaskAsyncRegistra una tarea de fondo periódica nombrada.
unregisterTaskAsyncCancela ejecuciones de tareas futuras.
isTaskRegisteredAsyncDevuelve si una tarea está registrada.
getRegisteredTasksAsyncLista nombres de tareas registradas.
getPendingTaskRunsAsyncLista eventos de tareas nativas pendientes de finalización.
getStatusAsyncDevuelve si está disponible la programación de fondo nativa.
triggerTaskWorkerForTestingAsyncDispara tareas registradas para desarrollo y pruebas.
addExpirationListenerEscucha eventos de expiración de iOS.

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.