@capgo/capacitor-background-task

Übersicht

Definiere Module, plane Intervalle und gib Ergebnisse zurück, die das OS für Synchronisation und Cache-Vorbereitung versteht.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	BGTaskScheduler-Identifikatoren in Info.plist
Android	Ja	WorkManager-ähnliche Jobs
Web	Nein	Service Worker verwenden

Kernfunktionen

• defineTask - JavaScript-Callback für eine benannte Aufgabe registrieren.
• registerTaskAsync - Periodische Aufgabe persistieren und planen.
• unregisterTaskAsync - Cancel future runs for one task.
• isTaskRegisteredAsync - Prüfen, ob eine Aufgabe registriert ist.
• getRegisteredTasksAsync - Aktuell registrierte Aufgabennamen auflisten.
• getPendingTaskRunsAsync - Native Task-Events prüfen, die vor der JavaScript-Initialisierung aufgezeichnet wurden.
• getStatusAsync - Verfügbarkeit nativer Hintergrundaufgaben prüfen.
• triggerTaskWorkerForTestingAsync - Registrierte Aufgaben während der Entwicklung sofort ausführen.
• addExpirationListener - iOS-Ablauf-Callbacks verarbeiten.
• define, schedule, cancel, statusAsync, und finish - Kompatibilitätshilfen für react-native-background-task.

Plattformverhalten

Background Tasks sind keine exakten Timer. Android und iOS entscheiden anhand von Akkustand, Netzwerk, App-Nutzung und Systemvorgaben, wann geplante Aufgaben ausgeführt werden.

Plattform	Nativer Scheduler	Wichtiges Verhalten
Android	WorkManager	Periodische Arbeit hat ein Mindestintervall von 15 Minuten.
iOS	BGTaskScheduler	minimumInterval ist ein frühestes Startdatum, keine garantierte Frequenz.
Web	Nur für Tests: Fallback	Kein echter Hintergrund-Planer verfügbar.

Öffentliches API

Methode	Beschreibung
defineTask	Definiert den JavaScript-Callback für eine benannte Aufgabe.
registerTaskAsync	Registriert eine benannte periodische Hintergrundaufgabe.
unregisterTaskAsync	Storniert zukünftige Task-Ausführungen.
isTaskRegisteredAsync	Gibt an, ob ein Task registriert ist.
getRegisteredTasksAsync	Listet registrierte Task-Namen auf.
getPendingTaskRunsAsync	Listet native Task-Events auf, die auf Abschluss warten.
getStatusAsync	Gibt an, ob native Hintergrundplanung verfügbar ist.
triggerTaskWorkerForTestingAsync	Löst registrierte Tasks für Entwicklung und QA aus.
addExpirationListener	Hört auf iOS-Ablaufereignisse.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-background-task.

Weiter mit @capgo/capacitor-background-task

Wenn du es nutzt @capgo/capacitor-background-task Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-background-task verwenden für die native Funktion in „@capgo/capacitor-background-task verwenden“, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.