Iniziare

@capgo/capacitor-background-task Consente a un'app Capacitor di registrare dei lavori periodici denominati per la sincronizzazione, l'aggiornamento del cache, la consegna degli analytics e altre operazioni di fetch in background.

Installare

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi utilizza il seguente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-background-task` plugin in my project.

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

npm install @capgo/capacitor-background-task
npx cap sync

Configurazione per iOS

Aggiungi il modello di elaborazione in background e l'identificatore della task autorizzata a ios/App/App/Info.plist:

<key>UIBackgroundModes</key>
<array>
  <string>processing</string>
</array>
<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
  <string>app.capgo.backgroundtask.processing</string>
</array>

E poi esegui:

npx cap sync ios

Importa

import { BackgroundTask, BackgroundTaskResult } from '@capgo/capacitor-background-task';

Definisci una Task

Definisci il callback all'interno dello scope del modulo affinché venga registrato non appena l'applicazione viene avviata dal sistema operativo.

import { BackgroundTask, BackgroundTaskResult } from '@capgo/capacitor-background-task';

const SYNC_TASK = 'sync-offline-data';

BackgroundTask.defineTask(SYNC_TASK, async () => {
  try {
    await fetch('https://api.example.com/sync', { method: 'POST' });
    return BackgroundTaskResult.Success;
  } catch {
    return BackgroundTaskResult.Failed;
  }
});

Registra La Programmazione

Chiamata registerTaskAsync context

await BackgroundTask.registerTaskAsync(SYNC_TASK, {
  minimumInterval: 30,
  requiresNetwork: true,
});

minimumInterval Copiarlo nella clipboard

è in minuti. Android impone un minimo di 15 minuti. iOS interpreta il valore come data di inizio più presto e può eseguire in un momento successivo.

const status = await BackgroundTask.getStatusAsync();
const isRegistered = await BackgroundTask.isTaskRegisteredAsync(SYNC_TASK);
const registeredTasks = await BackgroundTask.getRegisteredTasksAsync();

console.log({ status, isRegistered, registeredTasks });

Copiarlo nella clipboard

Esegui il titolo “Esegui un test”

await BackgroundTask.triggerTaskWorkerForTestingAsync();

Disiscrivere una Task

await BackgroundTask.unregisterTaskAsync(SYNC_TASK);

Scadenza per iOS

Il sistema iOS può interrompere una task di background prima che il tuo codice JavaScript sia completato. Ascolta gli eventi di scadenza quando è necessario pulire o effettuare il checkpointing.

const expiration = await BackgroundTask.addExpirationListener((event) => {
  console.warn('Background task expired', event.taskName, event.taskId);
});

await expiration.remove();

Compatibilità delle Task di Background per React Native

Il plugin esporre anche una piccola layer di compatibilità per le app che stanno migrando da react-native-background-task.

import { BackgroundTask } from '@capgo/capacitor-background-task';

BackgroundTask.define(async () => {
  await fetch('https://api.example.com/sync', { method: 'POST' });
});

await BackgroundTask.schedule({
  period: 1800,
});

Note di produzione

• La pianificazione in background è occasionale, non esatta.
• Tenere i lavori brevi e idempotenti.
• Persistere qualsiasi stato necessario prima di tornare BackgroundTaskResult.Success.
• Evitare di affidarsi alle attività in background per scadenze o allarmi visibili dall'utente.

Continua da Iniziare

Iniziare per pianificare il lavoro di plugin nativo, connettilo con Utilizzare @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-task-background per la capacità nativa in Utilizzare @capgo/capacitor-task-background, for the native capability in Using @capgo/capacitor-background-task, Directory dei plugin Capgo per il workflow del prodotto in Directory dei plugin Capgo Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo Aggiunta o Aggiornamento dei Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento dei Plugin, e Sostituti dei Plugin Enterprise di Ionic per il workflow del prodotto in Sostituti dei Plugin Enterprise di Ionic.