Zum Inhalt springen

@capgo/capacitor-Hintergrundaufgabe

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

Übersicht

Übersicht

Verwenden Sie dies, wenn Ihre __CAPGO_KEEP_0__-App periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Aktualisierung von Zwischenspeichern, Abfrage des Posteingangs, Entleerung von Analyseprotokollen 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.

Verwenden Sie dies, wenn Ihre __CAPGO_KEEP_0__-App periodische Hintergrundabfragen benötigt, wie z.B. Synchronisierung, Zwischenspeicheraktualisierung, Posteingangsabfrage, Analyseprotokollentleerung oder leichte Wartungsarbeiten.

  • 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 Hintergrundaufgabenereignisse, die vor der Bereitschaft von JavaScript 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-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.

PlattformNative SchedulerWichtige Verhaltensweisen
AndroidWorkManagerPeriodische Arbeit hat einen Mindestintervall von 15 Minuten.
iOSBGTaskSchedulerminimumInterval ist ein frühestmöglicher Beginnstag, kein garantiertes Rhythmus.
WebTest-fallbare AusweichmöglichkeitKein echter Hintergrundschlüssel 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 Aufgaben namen auf.
getPendingTaskRunsAsyncListet die native Aufgaben Ereignisse auf, die abgeschlossen werden müssen.
getStatusAsyncGibt an, ob native Hintergrund Scheduling verfügbar ist.
triggerTaskWorkerForTestingAsyncAuslöst die registrierten Aufgaben für Entwicklung und QA.
addExpirationListenerHört auf iOS Ablaufzeit Ereignisse ab.

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

If Sie native Plugins verwenden @capgo/capacitor-Hintergrundaufgabe 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, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Ionische Enterprise-Plugin-Alternativen {"targetLanguage":"German","pagePath":"/de/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"für das Produktworkflow in Ionic Enterprise Plugin Alternativen."},{"text":"Seite bearbeiten"}]}