Jobs Releases

v5

5.0.0 - TBD

BREAKING Enhancement

JobRegistration.Identifier removed — the job’s CLR Type is now the unique identifier. The WithIdentifier(...) fluent extension is gone. Log messages now reference JobType.FullName. Migrate by deleting .WithIdentifier("...") calls; the registration’s identity is implicit in the type you registered.

BREAKING Enhancement

IJobManager.RunJobAsTask(string, CancellationToken) replaced by IJobManager.RunJob(Type jobType, bool runAsTask = false, CancellationToken). The job is looked up by its registered CLR type. When runAsTask is true, the run is wrapped in platform-specific extended-execution semantics (iOS BeginBackgroundTask, Android partial wake-lock); when false, runs inline. Platform managers can override the new protected virtual Task<JobRunResult> RunAsTask(Type, JobRegistration, CancellationToken) template if they have a longer-lived background-task API. Migrate mgr.RunJobAsTask("MyJob") → mgr.RunJob(typeof(MyJob), runAsTask: true).

Feature

Plain .NET (base TFM) support added — Shiny.Jobs now ships an in-process managed JobManager for Linux, macOS, Blazor WebAssembly, console, and any other non-iOS/Android .NET host. Driven by a recurring timer (default 30s, configurable via JobManager.Interval, min 15s / max 5m). Honours the same BatteryNotLow, DeviceCharging, and RequiredInternetAccess constraints as the native platforms and auto-registers a default JSON filesystem repository under {LocalApplicationData}/Shiny. Jobs only execute while the host process is alive — there is no OS-level scheduler on these targets.

Feature

Blazor WebAssembly (Web) support added via the base Shiny.Jobs package (no separate meta-package). Reference Shiny.Jobs directly and bring in Shiny.Support.DeviceMonitoring.Blazor for IBattery/IConnectivity; optionally add Shiny.Support.Storage.Blazor to persist job state to browser localStorage instead of the default filesystem repository. The in-process scheduler runs while the tab is open. Note: Service Worker / Periodic Background Sync cannot invoke C# jobs because the SW has no access to the Blazor WASM runtime — for background HTTP specifically, use the new Shiny.Net.Http.Blazor package instead.

Fix

Plain .NET AddJobs() now self-registers IObjectStoreBinder and IKeyValueStoreFactory. Previously, resolving JobManager on Linux/Blazor/console hosts threw a DI validation error (CannotResolveService, Shiny.Stores.IObjectStoreBinder) because the binder was only registered by the MAUI platform infrastructure layer.

Fix iOS

JobManager.Start() no longer iterates an empty registration set on iOS/Mac Catalyst — the Apple JobManager constructor now receives the JobRegistrar directly, so background task scheduling via BGTaskScheduler happens against the real registered jobs at host boot.

Fix Android

JobManager.Start() no longer iterates an empty registration set on Android — the Android JobManager constructor now receives the JobRegistrar directly, so WorkManager periodic categories are enqueued with the real registered jobs at host boot.

Fix Windows

JobManager.Start() no longer iterates an empty registration set on Windows — the Windows JobManager constructor now receives the JobRegistrar directly, so the COM-activated background task categories are registered with the real jobs at host boot.

Enhancement

AbstractJobManager now treats JobRegistrar.Jobs as the single source of truth. The duplicate internal registrations dictionary and the AddRegistrations lazy-hydration method are gone, and GetJobs() / GetJobsByCategory() read straight from the registrar. JobLifecycleTask no longer needs the registrar injected.

BREAKING Enhancement

Removed the empty Shiny.Jobs.Blazor meta-package. It contained no code — just project references. Consumers should reference Shiny.Jobs + Shiny.Support.DeviceMonitoring.Blazor (and optionally Shiny.Support.Storage.Blazor) directly.

BREAKING Enhancement

Restructured job scheduling API - Register/Cancel replaced with explicit RegisterPlatformJob, UnRegisterPlatformJob, UnRegisterAllPlatformJobs, and GetPlatformJobs

Enhancement

JobLifecycleTask now manages registered jobs via DI and re-registers on startup

Enhancement Android

Improved ShinyJobWorker implementation

v4

4.0.1 - March 26, 2026

Fix Android

AndroidX version pins

4.0.0 - March 26, 2026

Fix Android

Successful jobs that run too long often tend to have Android completion already disposed

v3

3.1.2 - November 7, 2023

Fix

Base Job was not calculating runtime difference properly

3.0.0 - September 5, 2023

BREAKING iOS

We no longer support the background fetch style (old) job management - only bgtasks will be used going forward