Passer à la navigation

@capgo/capacitor-tâche d'arrière-plan

Tâches d'arrière-plan nommées à la manière d'Expo pour les applications Capacitor, basées sur Android WorkManager et iOS BGTaskScheduler.

Le plugin suit l'ensemble de fonctionnalités pratique de Expo BackgroundTask avec des tâches nommées, l'enregistrement persistant, les vérifications d'état, la désinscription, un déclencheur de développement et les événements d'expiration iOS. @capgo/capacitor-background-task when your Capacitor app needs periodic background fetch work such as sync, cache refreshes, inbox polling, analytics flushing, or lightweight maintenance jobs.

Section intitulée « Capacités de base »

Utilisez-le lorsque votre application __CAPGO_KEEP_0__ nécessite des travaux de récupération de fond d'écran périodiques comme la synchronisation, les mises à jour de cache, la lecture de la boîte de réception, l'écoulement des données d'analytique ou des tâches de maintenance légères.

Le plugin suit l'ensemble de fonctionnalités pratique de Expo BackgroundTask avec des tâches nommées, l'enregistrement persistant, les vérifications d'état, la désinscription, un déclencheur de développement et les événements d'expiration iOS.
  • defineTask - Enregistrez le callback JavaScript pour une tâche nommée.
  • registerTaskAsync - Enregistrez et planifiez une tâche périodique.
  • unregisterTaskAsync - Annulez les futures exécutions pour une tâche.
  • isTaskRegisteredAsync - Vérifiez si une tâche est enregistrée.
  • getRegisteredTasksAsync - Affichez les noms des tâches actuellement enregistrées.
  • getPendingTaskRunsAsync - Inspectez les événements de tâche native enregistrés avant que JavaScript soit prêt.
  • getStatusAsync - Vérifiez la disponibilité des tâches de fond native.
  • triggerTaskWorkerForTestingAsync - Exécutez les tâches enregistrées immédiatement pendant le développement.
  • addExpirationListener - Gérez les appels de rappel d'expiration iOS.
  • define, schedule, cancel, statusAsync, et finish - Aidez à la compatibilité pour react-native-background-task.

Les tâches de fond ne sont pas des temporisations exactes. Android et iOS décident quand exécuter le travail planifié en fonction de la batterie, du réseau, de l'utilisation de l'application et de la politique du système.

PlateformePlanificateur natifComportement important
AndroidWorkManagerLe travail périodique a un intervalle minimum de 15 minutes.
iOSBGTaskSchedulerminimumInterval est une date de début la plus tôt, et non une cadence garantie.
WebTest-only fallbackAucun planificateur de fond réel n'est disponible.
MéthodeDescription
defineTaskDéfinit l'appel de rappel JavaScript pour une tâche nommée.
registerTaskAsyncEnregistre une tâche de fond périodique nommée.
unregisterTaskAsyncAnnule les futures exécutions de tâche.
isTaskRegisteredAsyncRenvoie si une tâche est enregistrée.
getRegisteredTasksAsyncAffiche les noms de tâches enregistrées.
getPendingTaskRunsAsyncAffiche les événements de tâche natifs en attente de fin.
getStatusAsyncIndique si la planification de fond est disponible pour les applications natives.
triggerTaskWorkerForTestingAsyncDéclenche les tâches enregistrées pour le développement et la QA.
addExpirationListenerÉcoute les événements d'expiration iOS.

Cette référence est synchronisée à partir de src/definitions.ts en capacitor-tâche de fond.

Si vous utilisez @capgo/capacitor-tâche de fond planer le travail de plugin natif, le connecter avec En utilisant @capgo/capacitor-tâche de fond pour la capacité native dans En utilisant @capgo/capacitor-tâche de fond Capgo Répertoire de plugins pour le flux de travail du produit dans Capgo Répertoire de plugins Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins par Capgo, Ajouter ou Mettre à jour les plugins pour le détail d'implémentation dans Ajouter ou Mettre à jour les plugins, et Alternatives de plugins d'entreprise Ionic pour le flux de travail du produit dans Alternatives de plugins d'entreprise Ionic.