Vue d'ensemble
Section intitulée « Vue d'ensemble »Utilisez @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 de statut, la désinscription, un déclencheur de développement et des événements d'expiration iOS.
Capacités de base
Section intitulée « Capacités de base »defineTask- Enregistrer l'appel de rappel 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 des 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 rappels de fin de vie iOS.define,schedule,cancel,statusAsync, etfinish- Les aides de compatibilité pourreact-native-background-task.
Le comportement de la plateforme
Section intitulée « Le comportement de la plateforme »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.
| La plateforme | Planificateur natif | Comportement important |
|---|---|---|
| Android | Gestionnaire de travail | La période de travail périodique a une plage minimale de 15 minutes. |
| iOS | BGTaskScheduler | minimumInterval est une date de début la plus tôt, pas une cadence garantie. |
| Web | Champ de test uniquement | Aucun planificateur de fond réel n'est disponible. |
Public API
Section intitulée « 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 exécutions futures de la tâche. |
isTaskRegisteredAsync | Retourne si une tâche est enregistrée. |
getRegisteredTasksAsync | Liste des noms de tâches enregistrées. |
getPendingTaskRunsAsync | Liste des é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 | Écoute les événements d'expiration iOS. |
Source De Vérité
Section intitulée « Source De Vérité »Cette référence est synchronisée à partir de src/definitions.ts dans capacitor-tâche de fond.
Continuez de là à @capgo/capacitor-tâche de fond
Section intitulée « Continuez de là à @capgo/capacitor-tâche de fond »If 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, Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour le détail d'implémentation dans Ajouter ou mettre à jour des 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 travail du produit dans les alternatives du plugin Ionic Enterprise."},{"text":"Éditer la page"}]}