Übersicht
Abschnitt mit dem Titel „Übersicht“Verwenden Sie @capgo/capacitor-background-task wenn Ihre Capacitor-Anwendung periodische Hintergrundabfragen wie Synchronisierung, Cacheaktualisierungen, E-Mail-Polling, Analytik-Entleerung oder leichte Wartungsarbeiten benötigt.
Die Erweiterung folgt dem praktischen Funktionsumfang von Expo BackgroundTask mit benannten Aufgaben, persistenter Registrierung, Statusprüfungen, Entregistrierung, einem Entwicklungs-Trigger und iOS-Ablaufereignissen.
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“defineTask- Registrieren Sie die JavaScript-Rückrufmethode für eine benannte Aufgabe.registerTaskAsync- Persistieren und planen Sie eine periodische Aufgabe.unregisterTaskAsync- Zukunftsvorkehrungen für eine Aufgabe stornieren.isTaskRegisteredAsync- Überprüfen, ob eine Aufgabe registriert ist.getRegisteredTasksAsync- Liste der derzeit registrierten Aufgabenamen anzeigen.getPendingTaskRunsAsync- Inspektion von Ereignissen von native Aufgaben, die vor der Bereitstellung von JavaScript aufgezeichnet wurden.getStatusAsync- Überprüfen, ob native Hintergrundaufgaben verfügbar sind.triggerTaskWorkerForTestingAsync- Registrierte Aufgaben sofort während der Entwicklung ausführen.addExpirationListener- iOS-Ablaufaufrufe verarbeiten.define,schedule,cancel,statusAsyncundfinish- Kompatibilitäts-Hilfsmittel fürreact-native-background-task.
Bereich mit dem Titel „Bereichsverhalten“
Hintergrundaufgaben sind keine genauen Timer. Android und iOS entscheiden, wann geplante Arbeit ausgeführt wird, basierend auf Batterie, Netzwerk, Anwendungsverwendung und Systemrichtlinien.- Compatibility helpers for Capgo
| Plattform | Eigener Scheduler | Wichtige Verhaltensweise |
|---|---|---|
| Android | WorkManager | Periodische Arbeit hat einen Mindestabstand von 15 Minuten. |
| iOS | BGTaskScheduler | minimumInterval ist ein frühestes Beginndatum und nicht ein garantiertes Rhythmus. |
| Web | Test-fallweises Fallback | Kein echter Hintergrundscheduler ist verfügbar. |
Öffentlich API
Abschnitt mit dem Titel “Öffentlich API”| Methode | Beschreibung |
|---|---|
defineTask | Definiert die JavaScript-Rückrufmethode für einen benannten Auftrag. |
registerTaskAsync | Registriert einen benannten periodischen Hintergrundauftrag. |
unregisterTaskAsync | Storniert zukünftige Aufgabendurchführungen. |
isTaskRegisteredAsync | Gibt an, ob ein Auftrag registriert ist. |
getRegisteredTasksAsync | Listet die registrierten Aufgabennamen auf. |
getPendingTaskRunsAsync | Listet native Aufgabenereignisse auf, die abgeschlossen werden müssen. |
getStatusAsync | Gibt an, ob native Hintergrundscheduling verfügbar ist. |
triggerTaskWorkerForTestingAsync | Auslöst die registrierten Aufgaben für Entwicklung und QA. |
addExpirationListener | Listet iOS-Ablaufereignisse ab. |
Quelle der Wahrheit
Abschnitt mit dem Titel “Quelle der Wahrheit”Diese Referenz wird von src/definitions.ts in capacitor-Hintergrundaufgabe.