Vue d'ensemble
Section intitulée “Vue d'ensemble”Utilisation @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'é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.
Capacités de base
Section intitulée “Capacités de base”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é de la tâche 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- etfinish- Aidez à la compatibilité pourreact-native-background-task.
- Comportement de la plateforme
Section intitulée “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.
| Plateforme | Planificateur natif | Comportement important |
|---|---|---|
| Android | WorkManager | Le travail périodique a une plage de 15 minutes comme intervalle minimum. |
| iOS | BGTaskScheduler | minimumInterval est une date de début la plus tôt, et non une cadence garantie. |
| Web | Test-only fallback | 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 futures exécutions de tâche. |
isTaskRegisteredAsync | Renvoie si une tâche est enregistrée. |
getRegisteredTasksAsync | Affiche les noms de tâche enregistrés. |
getPendingTaskRunsAsync | Affiche les événements de tâche 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 in 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-tâche de fond planifier le travail de plugin natif, le connecter à En utilisant @capgo/capacitor-tâche de fond pour la capacité native dans En utilisant @capgo/capacitor-tâche de fond, Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des 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.