Panoramica
Sezione intitolata “Panoramica”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.
Capacità fondamentali
Sezione intitolata “Capacità fondamentali”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, efinish- Aiuti di compatibilità perreact-native-background-task.
Comportamento della piattaforma
Comportamento del PlatformLe 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 è una data di inizio più antica, non un ritmo garantito. |
| Web | Fallback di prova solo | Non è disponibile alcun scheduler di background reale. |
Pubblico API
Sezione intitolata “Pubblico API”| Metodo | Descrizione |
|---|---|
defineTask | Definisce il callback JavaScript per una task denominata. |
registerTaskAsync | Registra una task di background periodica denominata. |
unregisterTaskAsync | Cancella future esecuzioni di task. |
isTaskRegisteredAsync | Restituisce se una task è registrata. |
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à
Sottosezione intitolata “Fonte di Verità”Questa riferimento è sincronizzato da src/definitions.ts in capacitor-background-task.
Continua da @capgo/capacitor-background-task
Sottosezione intitolata “Continua da @capgo/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.