Saltare al contenuto

@capgo/capacitor-task di background

Task di background a stile Expo per Capacitor app, supportate da Android WorkManager e iOS BGTaskScheduler.

Utilizza @capgo/capacitor-background-task quando il tuo Capacitor app necessita di lavoro di fetch di background periodico come sincronizzazione, aggiornamento della cache, polling della posta in arrivo, svuotamento degli analytics o lavori di manutenzione leggera.

Il plugin segue l'impostazione di funzionalità pratica di Expo BackgroundTask con compiti denominati, registrazione persistente, controlli di stato, disiscrizione, un trigger di sviluppo e eventi di scadenza iOS.

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

Comportamento della piattaforma

Comportamento del Platform

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.

PiattaformaScheduler nativoComportamento importante
AndroidWorkManagerIl lavoro periodico ha un intervallo minimo di 15 minuti.
iOSBGTaskSchedulerminimumInterval è una data di inizio più antica, non un ritmo garantito.
WebFallback di prova soloNon è disponibile alcun scheduler di background reale.
MetodoDescrizione
defineTaskDefinisce il callback JavaScript per una task denominata.
registerTaskAsyncRegistra una task di background periodica denominata.
unregisterTaskAsyncCancella future esecuzioni di task.
isTaskRegisteredAsyncRestituisce se una task è registrata.
getRegisteredTasksAsyncElencare i nomi delle task registrate.
getPendingTaskRunsAsyncElencare gli eventi di task nativi in attesa di completamento.
getStatusAsyncRestituisce se è disponibile la programmazione di background nativa.
triggerTaskWorkerForTestingAsyncAttiva le task registrate per lo sviluppo e la QA.
addExpirationListenerAscolta gli eventi di scadenza iOS.

Questa riferimento è sincronizzato da src/definitions.ts in capacitor-background-task.

Se stai utilizzando @capgo/capacitor-task di background per pianificare il lavoro del plugin nativo, connettilo con Utilizzando @capgo/capacitor-background-task per la capacità nativa in Utilizzando @capgo/capacitor-background-task, Capgo Directory dei plugin per il workflow del prodotto nella directory del plugin Capgo Plugin Capgo di Capacitor per i dettagli di implementazione in Plugin Capgo di Capacitor Aggiungere o aggiornare Plugin per i dettagli di implementazione in Aggiungere o aggiornare Plugin, e Alternative per Plugin Enterprise di Ionic Per il flusso di lavoro del prodotto negli alternative Plugin Enterprise Ionic.