@capgo/capacitor-background-task

Panoramica

Usa @capgo/capacitor-background-task quando il tuo app Capacitor 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 pratica di Expo BackgroundTask con compiti denominati, registrazione persistente, controlli di stato, disiscrizione, un trigger di sviluppo e eventi di scadenza di iOS.

Capacità di base

• defineTask - Registra il callback JavaScript per un compito denominato.
• registerTaskAsync - Persiste e programma un compito periodico.
• unregisterTaskAsync - Annulla le future esecuzioni per un compito.
• isTaskRegisteredAsync - Controlla se un compito è registrato.
• getRegisteredTasksAsync - Elencare i nomi dei compiti attualmente registrati.
• getPendingTaskRunsAsync - Ispeziona gli eventi di compito nativi registrati prima che JavaScript fosse pronto.
• getStatusAsync - Controlla la disponibilità del compito di background nativo.
• triggerTaskWorkerForTestingAsync - Esegui i compiti registrati immediatamente durante lo sviluppo.
• addExpirationListener - Gestisci le chiamate di 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 ritmo garantito.
Web	Fallback di test	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 la pianificazione di background nativa è disponibile.
triggerTaskWorkerForTestingAsync	Attiva le attività 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-task di background per pianificare il lavoro del plugin nativo, connettilo con Usando @capgo/capacitor-task di background per la capacità nativa in Usando @capgo/capacitor-task di background, Cartella dei plugin di Capgo per il flusso di lavoro del prodotto in Cartella dei plugin di Capgo, Plugin di Capacitor da Capgo per il dettaglio di implementazione in Plugin di Capacitor da Capgo, Aggiungere o aggiornare i plugin per il dettaglio di implementazione in Aggiungere o aggiornare i plugin, e Alternative per plugin aziendali di Ionic Enterprise {"targetLanguage":"Italian","pagePath":"/it/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Per il flusso di lavoro del prodotto nelle alternative del plugin Enterprise Ionic."},{"text":"Modifica pagina"}]}