@capgo/capacitor-background-task

Vue d'ensemble

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'analytique 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.

Capacités de base

• 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 exécutions futures 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 iOS d'expiration.
• define, schedule, cancel, statusAsync, et finish - Aideurs de compatibilité pour react-native-background-task.

Comportement de la plateforme

Les tâches de fond ne sont pas des temporisations exactes. Les appareils 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.

Plateforme	Planificateur natif	Comportement important
Android	WorkManager	Le travail périodique a un minimum d'intervalle de 15 minutes.
iOS	BGTaskScheduler	minimumInterval est une date de début la plus tôt, pas une cadence garantie.
Web	Fallback de test uniquement	Aucun planificateur de fond réel n'est disponible.

Public API

Méthode	Description
defineTask	Définit l'appel de rappel JavaScript pour une tâche nommée.
registerTaskAsync	Enregistre une tâche de fond périodique nommée.
unregisterTaskAsync	Annule les futures exécutions de tâche.
isTaskRegisteredAsync	Renvoie si une tâche est enregistrée.
getRegisteredTasksAsync	Affiche les noms des tâches enregistrées.
getPendingTaskRunsAsync	Affiche les événements de tâches natives en attente de fin.
getStatusAsync	Renvoie si la planification de fond native est disponible.
triggerTaskWorkerForTestingAsync	Déclenche les tâches enregistrées pour le développement et la QA.
addExpirationListener	Ecoute les événements d'expiration iOS.

Source De Vérité

Cette référence est synchronisée à partir de src/definitions.ts dans capgo-capacitor-background-task.

Continuez à partir de @capgo/ capgo /capacitor-background-task

Si vous utilisez @capgo/capacitor-tâche de fond pour planifier le travail du plugin natif, connectez-l’avec Utilisez @capgo/capacitor-tâche de fond pour la capacité native dans Utilisez @capgo/capacitor-tâche 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, Ajout ou mise à jour de plugins pour le détail d'implémentation dans Ajout ou mise à jour de 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 Enterprise Ionic."},{"text":"Éditer la page"}]}