Background Processing (iOS · BackgroundTasks)

Run work when the app is not on screen. iOS never guarantees a wake — the system schedules opportunistically against battery, thermal, network, and usage budgets. Design every task to be short, idempotent, and resumable, and to finish cleanly the instant the system reclaims it.

• Android/KMP counterpart: WorkManager (no dedicated skill here) — expose a commonMain interface BackgroundSyncScheduler and bind a BGTaskScheduler actual in iosMain; see expect-actual.
• Related: push-notifications (APNs payload + registration for content-available wakeups) · swift-security (Keychain items a locked-device task reads need ...AfterFirstUnlock) · app-lifecycle (scenePhase → schedule on background) · activitykit (user-visible ongoing UI, not off-screen compute).

Contents