Passer à la navigation principale

@capgo/capacitor-tâche de fond

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

Utilisez-le @capgo/capacitor-background-task lorsque votre application Capacitor nécessite des travaux de récupération de fond périodiques, comme la synchronisation, les mises à jour de cache, la lecture de la boîte de réception, l'évacuation des données d'analyse ou des tâches de maintenance légères.

Le plugin suit l'ensemble des fonctionnalités pratiques de Expo BackgroundTask, avec des tâches nommées, une inscription persistante, des vérifications d'état, la désinscription, un déclencheur de développement et des événements d'expiration iOS.

  • defineTask - Enregistrer l'appel de callback JavaScript pour une tâche nommée.
  • registerTaskAsync - Persister et planifier une tâche périodique.
  • unregisterTaskAsync - Annuler les futures exécutions pour une tâche.
  • isTaskRegisteredAsync - Vérifier si une tâche est enregistrée.
  • getRegisteredTasksAsync - Listez les noms de tâches actuellement enregistrées.
  • getPendingTaskRunsAsync - Inspecter les événements de tâche native enregistrés avant que JavaScript soit prêt.
  • getStatusAsync - Vérifier la disponibilité de la tâche de fond native.
  • triggerTaskWorkerForTestingAsync - Exécuter les tâches enregistrées immédiatement pendant le développement.
  • addExpirationListener - Gérer les appels de rappel de fin de période iOS.
  • define, schedule, cancel, statusAsync, et finish - Aideurs de compatibilité pour react-native-background-task.

Les tâches d'arrière-plan 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, pas une cadence garantie.
WebFallback de test uniquementAucun 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.
getRegisteredTasksAsyncListe des noms de tâches enregistrées.
getPendingTaskRunsAsyncListe des événements de tâche natives en attente de fin.
getStatusAsyncRenvoie si la planification de fond native est disponible.
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 dans capacitor-tâche de fond.

Continuez à partir de @capgo/capacitor-tâche de fond

Section intitulée « Continuez à partir de @capgo/capacitor-tâche de fond »

Si vous utilisez @capgo/capacitor-task de fond pour planifier le travail du plugin natif, connectez-l’à En utilisant @capgo/capacitor-task de fond pour la capacité native dans En utilisant @capgo/capacitor-task de fond, Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo, 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 aux plugins d'entreprise Ionic {"targetLanguage":"French","pagePath":"/fr/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Pour le flux de workflow du produit dans les alternatives du plugin Ionic Enterprise."},{"text":"Modifier la page"}]}