@capgo/capacitor-background-task

Panoramica

Usa @capgo/capacitor-background-task quando la tua app Capacitor ha bisogno di lavoro di fetch di sfondo periodico come sincronizzazione, aggiornamento della cache, polling della posta in arrivo, svuotamento degli eventi di analytics, o lavori di manutenzione leggera.

Il plugin segue il set di funzionalità pratico di Expo BackgroundTask con task denominate, registrazione persistente, controlli di stato, disiscrizione, un trigger di sviluppo e eventi di scadenza iOS.

Capacità di base

• defineTask - Registra il callback JavaScript per una task denominata.
• registerTaskAsync - Persisti e programma una task periodica.
• unregisterTaskAsync - Annulla le future esecuzioni per una task.
• isTaskRegisteredAsync - Controlla se una task è registrata.
• getRegisteredTasksAsync - Elencare i nomi delle task attualmente registrate.
• getPendingTaskRunsAsync - Ispeziona gli eventi di task nativi registrati prima che JavaScript fosse pronto.
• getStatusAsync - Controlla la disponibilità di task di background nativi.
• triggerTaskWorkerForTestingAsync - Esegui le task registrate immediatamente durante lo sviluppo.
• addExpirationListener - Gestisci i callback di scadenza iOS.
• define, schedule, cancel, statusAsync, e finish - Aiuti di compatibilità per react-native-background-task.

Comportamento della piattaforma

Le attività di background non sono timer esatti. Android e iOS decidono quando eseguire il lavoro programmato in base alla batteria, alla rete, all'uso dell'app e alla politica del sistema.

Piattaforma	Scheduler nativo	Comportamento importante
Android	WorkManager	Il lavoro periodico ha un intervallo minimo di 15 minuti.
iOS	BGTaskScheduler	minimumInterval E' una data di inizio più antica, non un calendario garantito.
Web	Fallback di testo solo	Non è disponibile alcun scheduler di background reale.

Pubblico API

Metodo	Descrizione
defineTask	Definisce il callback JavaScript per un compito denominato.
registerTaskAsync	Registra un compito di background periodico denominato.
unregisterTaskAsync	Annulla le future esecuzioni del compito.
isTaskRegisteredAsync	Restituisce se è registrato un compito.
getRegisteredTasksAsync	Elenco dei nomi delle attività registrate.
getPendingTaskRunsAsync	Elenco degli eventi delle attività native in attesa di completamento.
getStatusAsync	Restituisce se è disponibile la programmazione di background nativa.
triggerTaskWorkerForTestingAsync	Avvia le attività registrate per lo sviluppo e la QA.
addExpirationListener	Ascolta per gli eventi di scadenza di iOS.

Fonte di Verità

Questa documentazione è sincronizzata da src/definitions.ts in capacitor-background-task.

Continua da @capgo/capacitor-background-task

If sei stai utilizzando @capgo/capacitor-background-task per pianificare il lavoro del plugin nativo, connettilo con Utilizza @capgo/capacitor-background-task per la capacità nativa in Utilizza @capgo/capacitor-background-task Capgo Directory dei plugin per il flusso di lavoro del prodotto in Capgo Directory dei plugin Capacitor Plugin da Capgo per il dettaglio di implementazione in Capacitor Plugin da Capgo Aggiungere o Aggiornare i Plugin per il dettaglio di implementazione in Aggiungere o Aggiornare i Plugin, e Alternative per Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Alternative Plugin Enterprise Ionic.