Skip to content

Platform API Matrix

Every native background-execution API × every platform that worker-kmp targets. v2.1.0 baseline. Per Phase 7 of the v3.0.0 epic.

Legend

Symbol Meaning
Fully supported via the worker-kmp API
Partially supported (per-platform notes)
Not available on this platform
🕒 Lands in a future alpha (per-cell note)

Core scheduling

Native API Android iOS Desktop Web
One-time work
Periodic work ✓ (BGAppRefresh — Phase 7 alpha04.X) ✓ (in-process timer) ◐ (Background Sync — Chrome only; Web Push — Phase 9)
Work chaining
Unique work names

Constraints

Constraint Android iOS Desktop Web
Network type (CONNECTED/UNMETERED/etc.) ✓ (navigator.onLine)
Charging ✓ (BGProcessingTask flag) ◐ (JVM system properties) ◐ (Battery Status API)
Battery not low
Storage not low ◐ (StorageManager.estimate)
Device idle
Content URI triggers

Retry + backoff

Feature Android iOS Desktop Web
Exponential backoff
Linear backoff
Custom max attempts

Phase 7 additions (alpha04 + alpha04.X)

Feature Android iOS Desktop Web
setExpedited(OutOfQuotaPolicy) (12+) 🕒 alpha04.X ✗ no-op ✗ no-op ✗ no-op
Foreground service types (14+) 🕒 alpha04.X
setInitialDelay(Duration) 🕒 alpha04.X 🕒 (earliestBeginDate) 🕒 (delay before launch) 🕒 (setTimeout)
BGAppRefreshTaskRequest 🕒 alpha04.X
Info.plist contract validation 🕒 alpha04.X (init-time check)
Periodic Background Sync API 🕒 alpha04.X (Chrome only)
Notifications API n/a (uses Android notifications) n/a (UNNotifications) n/a (system tray) 🕒 alpha04.X (consumer-opt-in)

Phase 1 — Foreground tasks (alpha01)

Feature Android iOS Desktop Web
ForegroundWorker base class ✓ API ✓ API ✓ API ✓ API
setForeground(ForegroundInfo) ✓ API; alpha01.X impl ✓ API; alpha01.X impl ✓ API; alpha01.X impl ✓ API; alpha01.X impl
ForegroundServiceType enum (13 values) n/a n/a n/a

Phase 8 — Desktop true-background (alpha05)

Feature Win macOS Linux
OS scheduler integration 🕒 (schtasks) 🕒 (launchd) 🕒 (systemd-user + cron fallback)
JAR integrity SHA-256 check 🕒 🕒 🕒
HMAC-signed persistence 🕒 🕒 🕒

Phase 9 — Web universal background (alpha06)

Feature Chrome Firefox Safari 16.4+ Edge
Web Push subscription 🕒 alpha06 🕒 🕒 (iOS PWA only) 🕒
Service Worker push handler 🕒 🕒 🕒 🕒

See also