Soferity/Hesoyamv1.0.1
.NET 9.0-android35.0.NET 9.0-ios18.0.NET 9.0-maccatalyst18.0.NET 9.0-windows10.0.19041
Hesoyam is a cross-platform background task scheduler for .NET MAUI that enables scheduling and executing tasks even when the application is closed. Supports Android (WorkManager), iOS (BGTaskScheduler), macOS Catalyst (BGTaskScheduler), and Windows (BackgroundTaskBuilder). Features include periodic/one-shot/immediate scheduling, network/charging/battery constraints, automatic retries with exponential backoff, state persistence across app restarts and device reboots, and full AOT/Trimming compatibility.
Get Started
$ dotnet add package HesoyamReadme
Hesoyam
A cross-platform background task scheduler for .NET MAUI applications. Hesoyam enables you to schedule and execute background tasks that run even when your application is closed.
Features
- Cross-Platform Support: Works on Android, iOS, macOS Catalyst, and Windows
- Persistent Tasks: Tasks survive app restarts and device reboots
- Flexible Scheduling: One-shot, periodic, and immediate task execution
- Constraints: Network, charging, idle, and battery level requirements
- Retry Logic: Automatic retry with exponential backoff
- State Persistence: Save and restore task state across executions
- Progress Reporting: Track task progress with numeric or message-based updates
- AOT/Trimming Compatible: Full Native AOT and IL Linker support
Platform Implementations
| Platform | Technology | Minimum Version |
|---|---|---|
| Android | WorkManager | API 21 (Android 5.0) |
| iOS | BGTaskScheduler | iOS 15.0 |
| macOS Catalyst | BGTaskScheduler | macOS 15.0 |
| Windows | BackgroundTaskBuilder | Windows 10 1809 |
Installation
dotnet add package Hesoyam
Quick Start
1. Register Services
// MauiProgram.cs
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.UseHesoyam();
// Register your background tasks
builder.Services.AddBackgroundTask<DataSyncTask>();
2. Create a Background Task
public class DataSyncTask : IBackgroundTask
{
private readonly IDataService _dataService;
public DataSyncTask(IDataService dataService)
{
_dataService = dataService;
}
public async Task ExecuteAsync(ITaskContext context, CancellationToken cancellationToken)
{
// Report progress
await context.ReportProgressAsync("Starting sync...");
// Do your work
await _dataService.SyncAsync(cancellationToken);
// Save state for resumable tasks
await context.SetStateAsync("lastSync", DateTime.UtcNow);
}
}