Vue d'ensemble
Section intitulée « Vue d'ensemble »Utilisez @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.
Le plugin suit le jeu de fonctionnalités pratique 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
Section intitulée « Capacités de base »defineTask- Enregistrez l'appel de callback JavaScript pour une tâche nommée.registerTaskAsync- Persiste et planifiez une tâche périodique.unregisterTaskAsync- Annulez les exécutions futures pour une tâche.isTaskRegisteredAsync- Vérifiez si une tâche est enregistrée.getRegisteredTasksAsync- Liste des noms de tâches actuellement enregistrés.getPendingTaskRunsAsync- Inspecter les événements de tâches natives enregistrés avant que JavaScript soit prêt.getStatusAsync- Vérifier la disponibilité des tâches de fond natives.triggerTaskWorkerForTestingAsync- Exécuter les tâches enregistrées immédiatement pendant le développement.addExpirationListenerGérer les rappels de expiration iOS.define,schedule,cancel,statusAsync, etfinish- Aide à la compatibilité pourreact-native-background-task.
Comportement de la plateforme
Sous-titre : Comportement de la plateformeLes tâches de fond ne sont pas des horloges 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 un intervalle minimum de 15 minutes. |
| iOS | BGTaskScheduler | minimumInterval c'est une date de début la plus tôt, pas une cadence garantie. |
| Web | Fallback de test uniquement | Aucun vrai planificateur de fond d'écran 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 | Inscrive 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âches enregistrées. |
getPendingTaskRunsAsync | Affiche les événements de tâche natifs 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é
Titre de la section « Source De Vérité »Cette référence est synchronisée à partir de src/definitions.ts en capacitor-tâche-en-arrière-plan.
Continuez à partir de @capgo/capacitor-tâche-en-arrière-plan
Titre de la section « Continuez à partir de @capgo/capacitor-tâche-en-arrière-plan »Si vous utilisez @capgo/capacitor-tâche-en-arrière-plan pour planifier le travail du plugin natif, connectez-l’avec En utilisant @capgo/capacitor-tâche-en-arrière-plan pour la capacité native dans En utilisant @capgo/capacitor-tâche-en-arrière-plan, Répertoire du plugin Capgo pour le flux de travail du produit dans le répertoire de plugin Capgo les plugins Capacitor par Capgo pour le détail d'implémentation dans les plugins Capacitor 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 Ionic Enterprise pour le flux de travail du produit dans les plugins Ionic Enterprise Alternatifs.