@capgo/capacitor-background-task

Panoramica

Utilizzo @capgo/capacitor-background-task Quando il tuo app Capacitor richiede lavori di fetch di background periodici come sincronizzazione, aggiornamenti della cache, polling della posta in arrivo, svuotamento degli eventi di analisi o lavori di manutenzione leggera.

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

Capacità fondamentali

• defineTask - Registra il callback JavaScript per una task denominata.
• registerTaskAsync - Persisti e programma una task periodica.
• unregisterTaskAsync - Annulla future esecuzioni per una task.
• isTaskRegisteredAsync - Controlla se una task è registrata.
• getRegisteredTasksAsync - Elenco 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- Aiuti di compatibilità per finish - Comportamento della piattaforma react-native-background-task.

- Aiuti di compatibilità per Comportamento della piattaforma

Il lavoro 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	Schedulatore nativo	Comportamento importante
Android	WorkManager	Il lavoro periodico ha un intervallo minimo di 15 minuti.
IOS	BGTaskScheduler	minimumInterval è una data di inizio più presto, non un cadenza garantita.
Web	Fallback di testo solo	Non è disponibile alcun scheduler di background reale.

Pubblico API

Metodo	Descrizione
defineTask	Definisce il callback JavaScript per una task denominata.
registerTaskAsync	Registra una task di background periodica denominata.
unregisterTaskAsync	Annulla future esecuzioni di task.
isTaskRegisteredAsync	Restituisce se è registrata una task.
getRegisteredTasksAsync	Elencare i nomi delle task registrate.
getPendingTaskRunsAsync	Elencare gli eventi di task nativi in attesa di completamento.
getStatusAsync	Restituisce se è disponibile la programmazione di background nativa.
triggerTaskWorkerForTestingAsync	Attiva le task registrate per lo sviluppo e la QA.
addExpirationListener	Ascolta gli eventi di scadenza iOS.

Fonte di Verità

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

Continua da @capgo/capacitor-background-task

Se stai utilizzando @capgo/capacitor-background-task To pianificare il lavoro del plugin nativo, connettilo con Utilizzare @capgo/capacitor-task-di-sfondo nativo Per la capacità nativa in Utilizzare @capgo/capacitor-task-di-sfondo nativo, Directory dei plugin di Capgo Per il flusso di lavoro del prodotto in Directory dei plugin di Capgo, I plugin di Capacitor sviluppati da Capgo Per il dettaglio di implementazione in I plugin di Capacitor sviluppati da Capgo, Aggiungere o Aggiornare i plugin Per il dettaglio di implementazione in Aggiungere o Aggiornare i plugin, e Sostituti dei plugin Enterprise di Ionic Per il flusso di lavoro del prodotto in Sostituti dei plugin Enterprise di Ionic.