Zum Inhalt springen

@capgo/capacitor-Hintergrundaufgabe

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

Verwenden Sie dies, wenn Ihre __CAPGO_KEEP_0__-Anwendung periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Aktualisierung von Zwischenspeichern, Abfrage von Eingangsboxen, Auslösung von Analysen 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 - 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ückrufe.
  • 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 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-fall-back-FallKein echter Hintergrund-Scheduler ist verfügbar.
MethodeBeschreibung
defineTaskDefiniert die JavaScript-Rückruf-Funktion für einen benannten Auftrag.
registerTaskAsyncRegistriert einen benannten periodischen Hintergrundauftrag.
unregisterTaskAsyncStorniert zukünftige Aufgabendurchgänge.
isTaskRegisteredAsyncGibt an, ob ein Auftrag registriert ist.
getRegisteredTasksAsyncListet die registrierten Aufgabennamen auf.
getPendingTaskRunsAsyncListet native Aufgabenevents auf, die abgeschlossen werden müssen.
getStatusAsyncErmittelt, ob native Hintergrund-Scheduling verfügbar ist.
triggerTaskWorkerForTestingAsyncAuslöst registrierte Aufgaben für Entwicklung und QA.
addExpirationListenerHört auf iOS-Abgelaufenevents zu.

Diese Referenz wird von “@__CAPGO_KEEP_0__” synchronisiert. src/definitions.ts in capacitor-Hintergrund-Aufgabe.

Wenn Sie “@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Hintergrund-Aufgabe” verwenden @capgo/capacitor-Hintergrund-Aufgabe 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.