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.

Utilice @capgo/capacitor-background-task cuando su aplicación Capacitor necesita trabajo de fondo periódico de actualización, como sincronización, refrescos de caché, lectura 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.

  • defineTask - Registrar la llamada de JavaScript para una tarea nombrada.
  • registerTaskAsync - Persistir y programar una tarea periódica.
  • unregisterTaskAsync - Cancelar ejecuciones futuras para una tarea.
  • isTaskRegisteredAsync - Verificar si una tarea está registrada.
  • getRegisteredTasksAsync - Listar nombres de tareas registradas actualmente.
  • getPendingTaskRunsAsync - Inspeccionar eventos de tarea nativa grabados antes de que estuviera lista la JavaScript.
  • getStatusAsync - Verificar la disponibilidad de tarea de fondo nativa.
  • 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.

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 del aplicativo y la política del sistema.

PlataformaProgramador nativoComportamiento importante
AndroidWorkManagerEl trabajo periódico tiene un mínimo de intervalo de 15 minutos.
iOSBGTaskSchedulerminimumInterval es una fecha de inicio más temprana, no una cadencia garantizada.
WebFallo de pruebaNo está disponible un programador de fondo real.
MétodoDescripción
defineTaskDefine la llamada de llamada de JavaScript para una tarea nombrada.
registerTaskAsyncRegistra una tarea de fondo periódica nombrada.
unregisterTaskAsyncCancela futuras ejecuciones de tarea.
isTaskRegisteredAsyncDevuelve si una tarea está registrada.
getRegisteredTasksAsyncLista los nombres de tarea registrados.
getPendingTaskRunsAsyncLista eventos de tarea nativa pendientes de finalización.
getStatusAsyncDevuelve si está disponible la programación de fondo nativa.
triggerTaskWorkerForTestingAsyncDispara las tareas registradas para desarrollo y pruebas de QA.
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”

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"}]}