Zum Inhalt springen

@capgo/capacitor-Hintergrund-Aufgabe

Expo-stilige benannte Hintergrundaufgaben für Capacitor-Apps, unterstützt durch Android WorkManager und iOS BGTaskScheduler.

Wenn Ihre __CAPGO_KEEP_0__-App periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Cache-Updates, E-Mail-Abfragen, Analytik-Flushen oder leichte Wartungsarbeiten. @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.

Kernfunktionen

  • defineTask - Persistieren und planen Sie eine periodische Aufgabe.
  • registerTaskAsync - Stornieren Sie zukünftige Ausführungen für eine Aufgabe.
  • unregisterTaskAsync - Überprüfen Sie, ob eine Aufgabe registriert ist.
  • isTaskRegisteredAsync - Listen Sie die derzeit registrierten Aufgabenamen auf.
  • getRegisteredTasksAsync - Überprüfen Sie native Hintergrundaufgabenverfügbarkeit.
  • getPendingTaskRunsAsync - Inspect native task events recorded before JavaScript was ready.
  • getStatusAsync - Check native background task availability.
  • triggerTaskWorkerForTestingAsync - Aufgezeichnete Aufgaben werden sofort während der Entwicklung ausgeführt.
  • addExpirationListener - iOS-Ablauf-Ereignisrückrufe verwalten.
  • define, schedule, cancel, statusAsync, und finish - Kompatibilitäts-Helfer für react-native-background-task.

Hintergrundaufgaben sind keine genauen Timer. Android und iOS entscheiden, wann geplante Arbeit ausgeführt wird, basierend auf Akku, Netzwerk, Anwendungsnutzung und Systempolitik.

PlattformNatives SchedulerWichtige Verhaltensweisen
AndroidWorkManagerPeriodische Arbeit hat einen Mindestabstand von 15 Minuten.
iOSBGTaskSchedulerminimumInterval ist ein frühestes Beginndatum, kein garantiertes Rhythmus.
WebTest-only-FallbackKein echter Hintergrundscheduler ist verfügbar.
MethodeBeschreibung
defineTaskDefiniert die JavaScript-Rückruf-Funktion für einen benannten Auftrag.
registerTaskAsyncRegistriert einen benannten periodischen Hintergrundauftrag.
unregisterTaskAsyncStorniert zukünftige Aufgabenausführungen.
isTaskRegisteredAsyncGibt an, ob ein Auftrag registriert ist.
getRegisteredTasksAsyncListet registrierte Aufgabenamen auf.
getPendingTaskRunsAsyncListet native Aufgabenereignisse auf, die abgeschlossen werden müssen.
getStatusAsyncGibt an, ob native Hintergrundschulungen verfügbar sind.
triggerTaskWorkerForTestingAsyncAuslöst registrierte Aufgaben für Entwicklung und QA.
addExpirationListenerHört auf iOS-Abgelaufenevents zu.

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

Wenn Sie native Plugin-Arbeit planen @capgo/capacitor-Hintergrundaufgabe um sie 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 Hinzufügen oder Aktualisieren von Plugins __CAPGO_KEEP_0__ für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Alternativen zu Ionic Enterprise Plugins __CAPGO_KEEP_0__ für den Produktworkflow in Alternativen zu Ionic Enterprise Plugins.