Zum Inhalt springen

@capgo/capacitor-Hintergrund-Aufgabe

Expo-stil benannte Hintergrundaufgaben für Capacitor-Apps, die von Android WorkManager und iOS BGTaskScheduler unterstützt werden.

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.

  • 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- und finish - Kompatibilitäts-Hilfsmittel für react-native-background-task.

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.

PlattformNatives SchedulerWichtige Verhaltensweise
AndroidWorkManagerPeriodische Arbeit hat einen Mindestabstand von 15 Minuten.
iOSBGTaskSchedulerminimumInterval ist ein frühestes Beginndatum und nicht ein garantiertes Rhythmus.
WebTest-only ErsatzfallKein echter Hintergrundschlüssel ist verfügbar.
MethodeBeschreibung
defineTaskDefiniert die JavaScript-Rückrufmethode für einen benannten Auftrag.
registerTaskAsyncRegistriert einen benannten periodischen Hintergrundauftrag.
unregisterTaskAsyncStorniert zukünftige Aufgabenausführungen.
isTaskRegisteredAsyncGibt an, ob ein Auftrag registriert ist.
getRegisteredTasksAsyncListet die registrierten Aufgabennamen auf.
getPendingTaskRunsAsyncListet native Aufgabenevents auf, die abgeschlossen werden müssen.
getStatusAsyncWird native Hintergrund-Scheduling verfügbar sein?
triggerTaskWorkerForTestingAsyncRegistrierte Aufgaben für Entwicklung und QA auslöst.
addExpirationListenerHorcht nach iOS-Abgelaufenevents.

Diese Referenz wird von src/definitions.ts in 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