Configurar iOS

El procesamiento en segundo plano de iOS usa BGTaskScheduler. La app debe declarar el modo background y el identificador de tarea permitido para que el scheduling funcione en un dispositivo físico.

Info.plist

Añade estas claves 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>

Sincronizar

npx cap sync ios

Comportamiento

• minimumInterval se mapea a earliestBeginDate.
• iOS decide el tiempo de ejecución real según la batería, la red, los patrones de uso y la política del sistema.
• La ejecución de tareas en segundo plano no es fiable en el simulador. Prueba en un dispositivo físico.
• El plugin reprograma la siguiente solicitud de procesamiento en segundo plano tras cada inicio de tarea.

Expiración

Usa addExpirationListener cuando hay que limpiar el trabajo si iOS termina la tarea antes.

const handle = await BackgroundTask.addExpirationListener((event) => {
  console.warn('Task expired', event.taskName);
});

await handle.remove();

Continúa desde la configuración de iOS

Si estás usando Configurar iOS para planificar el trabajo con plugins nativos, conéctalo con Uso de @capgo/capacitor-background-task para la capacidad nativa en Uso de @capgo/capacitor-background-task, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.