Übersicht
Abschnitt mit dem Titel „Übersicht“Verwenden Sie @capgo/capacitor-background-task wenn Ihre Capacitor-App periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Aktualisierung von Cache, Abfragen des Posteingangs, Entleeren von Analytics oder leichte Wartungsarbeiten.
Die Erweiterung folgt dem praktischen Funktionsumfang von Expo BackgroundTask mit benannten Aufgaben, persistenter Registrierung, Statusprüfungen, Entregistrierung, einem Entwicklungsstarter und iOS-Ablaufereignissen.
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“defineTask- Die JavaScript-Rückrufregistrierung für einen benannten Auftrag.registerTaskAsync- Speichern und planen Sie einen periodischen Auftrag.unregisterTaskAsync- Stornieren Sie zukünftige Ausführungen für einen Auftrag.isTaskRegisteredAsync- Überprüfen Sie, ob ein Auftrag registriert ist.getRegisteredTasksAsync- Listen Sie derzeit registrierte Auftragsnamen auf.getPendingTaskRunsAsync- Überprüfen Sie native Auftragsereignisse, die vor der JavaScript-Verfügbarkeit aufgezeichnet wurden.getStatusAsync- Überprüfen Sie die Verfügbarkeit von native Hintergrundaufträgen.triggerTaskWorkerForTestingAsync- Führen Sie registrierte Aufträge sofort während der Entwicklung aus.addExpirationListener- Behandeln Sie iOS-Ablaufrückrufe.define,schedule,cancel,statusAsync- undfinish- Kompatibilitäts-Hilfsmittel fürreact-native-background-task.
- Plattformverhalten
Abschnitt mit dem Titel “Plattformverhalten”Hintergrundaufgaben sind keine genauen Timer. Android und iOS entscheiden, wann sie geplante Arbeit ausführen, basierend auf der Batterie, dem Netzwerk, der App-Nutzung und der Systempolitik.
| Plattform | Natives 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-only Ersatzfall | Kein echter Hintergrundschlüssel 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 Aufgabenausführungen. |
isTaskRegisteredAsync | Gibt an, ob ein Auftrag registriert ist. |
getRegisteredTasksAsync | Listet die registrierten Aufgabennamen auf. |
getPendingTaskRunsAsync | Listet native Aufgabenevents auf, die abgeschlossen werden müssen. |
getStatusAsync | Wird native Hintergrund-Scheduling verfügbar sein? |
triggerTaskWorkerForTestingAsync | Registrierte Aufgaben für Entwicklung und QA auslöst. |
addExpirationListener | Horcht nach iOS-Abgelaufenevents. |
Hauptquelle der Wahrheit
Abschnitt mit dem Titel “Hauptquelle der Wahrheit”Diese Referenz wird von src/definitions.ts in capacitor-Hintergrundaufgabe.
Fortsetzung von @capgo/capacitor-Hintergrundaufgabe
Abschnitt mit dem Titel “Fortsetzung von @capgo/capacitor-Hintergrundaufgabe”Wenn Sie @capgo/capacitor-Hintergrundaufgabe für die native Plugin-Arbeit zu planen, verbinden Sie es mit Mit @capgo/capacitor-Hintergrundaufgabe für die native Fähigkeit in Mit @capgo/capacitor-Hintergrundaufgabe Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen