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.

__CAPGO_KEEP_0__

  • defineTask - Registriere die JavaScript-Rückrufmethode für einen benannten Auftrag.
  • registerTaskAsync - Speichere und plane einen periodischen Auftrag.
  • unregisterTaskAsync - Storniere zukünftige Ausführungen für einen Auftrag.
  • isTaskRegisteredAsync - Überprüfe, ob ein Auftrag registriert ist.
  • getRegisteredTasksAsync - Liste derzeit registrierte Auftragsnamen auf.
  • getPendingTaskRunsAsync - Überprüfe native Auftragsereignisse, die vor der JavaScript-Verfügbarkeit aufgezeichnet wurden.
  • getStatusAsync - Überprüfe die Verfügbarkeit von native Hintergrundaufgaben.
  • triggerTaskWorkerForTestingAsync - Führe registrierte Aufgaben sofort während der Entwicklung aus.
  • addExpirationListener - Behandle iOS-Ablaufaufrufe.
  • 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 der Batterie, dem Netzwerk, der Anwendungsnutzung und der Systempolitik.

PlattformNatives SchedulerWichtige Verhaltensweise
AndroidWorkManagerPeriodische Arbeit hat einen Mindestintervall von 15 Minuten.
iOSBGTaskSchedulerminimumInterval is eine frühester Beginnstag, kein garantiertes Tempo.
WebTest-only-FallbackKein echter Hintergrundschlüssel ist verfügbar.
MethodeBeschreibung
defineTaskDefiniert die JavaScript-Rückruf für einen benannten Auftrag.
registerTaskAsyncEine benannte periodische Hintergrundaufgabe registriert.
unregisterTaskAsyncZukünftige Aufgabeanfänge storniert.
isTaskRegisteredAsyncOb eine Aufgabe registriert ist, zurückgibt.
getRegisteredTasksAsyncListet registrierte Aufgaben auf.
getPendingTaskRunsAsyncListet native Aufgabenereignisse auf, die abgeschlossen werden müssen.
getStatusAsyncGibt an, ob native Hintergrundschulung verfügbar ist.
triggerTaskWorkerForTestingAsyncAuslöst registrierte Aufgaben für Entwicklung und QA.
addExpirationListenerHört auf iOS-Ablaufereignisse zu.

Diese Referenz wird von src/definitions.ts in capacitor-Hintergrundaufgabe.

Wenn Sie @capgo/capacitor-Hintergrundaufgabe für die Planung von nativem Plugin-Arbeiten verwenden, verbinden Sie es mit Mit @capgo/capacitor-Hintergrundaufgabe für die native Fähigkeit in Mit @capgo/capacitor-Hintergrundaufgabe, Capgo Plugin-Ordner für den Produktworkflow in Capgo Plugin-Ordner, Capacitor Plugins von Capgo für die Implementierungsdetail in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.