Zum Inhalt springen

@capgo/capacitor-Hintergrundaufgabe

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

Benutzen @capgo/capacitor-background-task wenn Ihre Capacitor-App periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Aktualisierung von Cache, Polling von Eingangsboxen, 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 Entwicklungs-Trigger und iOS-Verfallsereignissen.

  • defineTask - Registrieren Sie die JavaScript-Rückrufmethode für eine benannte Aufgabe.
  • registerTaskAsync - Persistieren und planen Sie eine periodische Aufgabe.
  • unregisterTaskAsync - Zukunftsvorhaben für eine Aufgabe stornieren.
  • isTaskRegisteredAsync - Überprüfen Sie, ob eine Aufgabe registriert ist.
  • getRegisteredTasksAsync - Liste derzeit registrierter Aufgaben namen.
  • getPendingTaskRunsAsync - Ereignisse von native Aufgaben vor der Bereitschaft von JavaScript überprüfen.
  • getStatusAsync - Überprüfung der Verfügbarkeit von native Hintergrundaufgaben.
  • triggerTaskWorkerForTestingAsync - Ausführung von registrierten Aufgaben sofort während der Entwicklung.
  • addExpirationListener - Behandlung von iOS-Ablaufaufrufen.
  • define, schedule, cancel, statusAsync, und finish - Kompatibilitäts-Hilfsmittel für react-native-background-task.

Verhaltensweise der Plattform

Section titled “Platform Behavior”

Hintergrundaufgaben sind keine genauen Timer. Android und iOS entscheiden, wann sie geplante Arbeit ausführen, basierend auf der Batterie, dem Netzwerk, der Anwendungsverwendung und der Systempolitik.

PlattformNative SchedulerWichtige Verhaltensweisen
AndroidWorkManagerPeriodische Arbeit hat einen Mindestabstand von 15 Minuten.
iOSBGTaskSchedulerminimumInterval ist ein frühestes Beginndatum, kein garantiertes Rhythmus.
WebTest-fallbare AlternativeKein 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 Aufgabendurchführungen.
isTaskRegisteredAsyncGibt an, ob ein Auftrag registriert ist.
getRegisteredTasksAsyncListet die registrierten Auftragsnamen auf.
getPendingTaskRunsAsyncListet native Aufgabenevents auf, die abgeschlossen werden müssen.
getStatusAsyncGibt an, ob native Hintergrundscheduling verfügbar ist.
triggerTaskWorkerForTestingAsyncAuslöst registrierte Aufgaben für Entwicklung und QA.
addExpirationListenerHört auf iOS-Abgelaufenevents an.

Dieser Bezug wird von src/definitions.ts auf capacitor-Hintergrundaufgabe.

Wenn Sie Capgo verwenden @capgo/capacitor-Hintergrundaufgabe um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwendung von @capgo/capacitor-Hintergrundaufgabe für die native Fähigkeit in Verwendung von @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 für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.