@capgo/capacitor-Hintergrund-Aufgabe

Übersicht

Verwenden @capgo/capacitor-background-task wenn Ihre Capacitor-App periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Aktualisierung von Cache, Polling des Posteingangs, Auslösung von Analysen oder leichte Wartungsarbeiten.

Das Plugin folgt dem praktischen Funktionsumfang von Expo BackgroundTask mit benannten Aufgaben, persistenter Registrierung, Statusprüfungen, Entregistrierung, einem Entwicklungsstarter und iOS-Verfallsereignissen.

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-Bereitstellung aufgezeichnet wurden.
• getStatusAsync - Überprüfen Sie die Verfügbarkeit von native Hintergrundaufträgen.
• triggerTaskWorkerForTestingAsync - Ausführen Sie registrierte Aufgaben sofort während der Entwicklung.
• addExpirationListener - Behandeln Sie iOS-Ablaufrückrufanfragen.
• define, schedule, cancel, statusAsync, und finish - Kompatibilitäts-Hilfsmittel für react-native-background-task.

Plattformen-Verhalten

Hintergrundaufgaben sind keine genauen Timer. Android und iOS entscheiden, wann geplante Arbeit ausgeführt wird, 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-Fallback	Kein echter Hintergrundschlüssel ist verfügbar.

Öffentliche 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 Aufgabenamen auf.
getPendingTaskRunsAsync	Listet native Aufgabenereignisse auf, die abgeschlossen werden müssen.
getStatusAsync	Gibt an, ob native Hintergrund-Scheduling verfügbar ist.
triggerTaskWorkerForTestingAsync	Registrierte Aufgaben für Entwicklung und QA auslöst.
addExpirationListener	Hört sich auf iOS-Abgelaufenevents an.

Quelle der Wahrheit

Dieses Referenzwerk wird von src/definitions.ts in capacitor-Hintergrundaufgabe.

Weitergehen von @capgo/capacitor-Hintergrundaufgabe

Wenn Sie @capgo/capacitor-Hintergrundaufgabe um 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, und Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen.