HTTP Transfers

Getting Started

• 
• 
• 

Operating Systems

Android

iOS

Windows

macOS

Linux

Web

Shiny HTTP Transfers enables background uploads and downloads that continue even when your app is suspended. On iOS/Android, transfers are managed by the OS and will resume after app restarts. On Windows, Linux, macOS, and plain .NET hosts a managed HttpClient loop drives transfers and supports resumable downloads via HTTP Range requests. On Blazor WebAssembly, transfers are queued to IndexedDB and drained by a Service Worker via the Background Sync API.

Caution

HTTP Transfers do not work on the iOS Simulator. You must test on a real device.

Features

• Background uploads and downloads
• Multipart and raw upload support
• Progress tracking with speed and ETA
• Automatic resume after app restart
• Resumable downloads on plain .NET (Linux/macOS/Windows) via HTTP Range requests
• Metered/unmetered network control
• Managed transfer list for UI binding
• Cross-platform: iOS, Android, Windows, Linux, macOS, Blazor WebAssembly

Platform Notes

Platform	Package	Backing
iOS	Shiny.Net.Http	NSURLSession background session
Android	Shiny.Net.Http	Foreground service + WorkManager
Windows	Shiny.Net.Http	Managed HttpClient loop
Linux / macOS / Plain .NET	Shiny.Net.Http	Managed HttpClient + IConnectivity loop; resumable downloads via HTTP Range
Blazor WebAssembly	Shiny.Net.Http.Blazor	Service Worker Background Sync + IndexedDB; downloads not resumable

Blazor WebAssembly limitations

• No resumable downloads — the Service Worker fetch() returns a whole Blob, and partial-body appending isn’t supported.
• Upload bodies are base64-bridged through JS interop and persisted as IndexedDB Blobs. Suitable for small/medium files; very large uploads should wait for a future streaming path.
• Background Sync support is Chromium-only (no Firefox, no Safari). On unsupported browsers the queue still drains while the tab is foreground, then sits in IndexedDB until the user returns.
• Use GetDownloadBytes(identifier) on the Blazor HttpTransferManager to read a completed download’s bytes back from IndexedDB.

Setup

CAUTION

You are using a component that uses an Android foreground service! You must have an application icon set or a drawable resource called notification in order for this background operation to work. For additional information, please read Android Foreground Services

• NuGet Packages
• Project File
• MauiProgram.cs
• AndroidManifest.xml
• Info.plist
• PrivacyInfo.xcprivacy
• Package.appxmanifest

Shiny.Net.Http

Shiny.Hosting.Maui

Background Delegate

Implement IHttpTransferDelegate to handle transfer completion and errors in the background.

public partial class MyTransferDelegate : IHttpTransferDelegate
{
    readonly ILogger<MyTransferDelegate> logger;

    public MyTransferDelegate(ILogger<MyTransferDelegate> logger)
    {
        this.logger = logger;
    }

    public Task OnCompleted(HttpTransferRequest request)
    {
        this.logger.LogInformation("Transfer completed: {Id}", request.Identifier);
        return Task.CompletedTask;
    }

    public Task OnError(HttpTransferRequest request, int statusCode, Exception ex)
    {
        this.logger.LogError(ex, "Transfer failed: {Id}, Status: {Status}", request.Identifier, statusCode);
        return Task.CompletedTask;
    }
}

Android Foreground Service

On Android, background transfers run as a foreground service. Customize the notification:

#if ANDROID
public partial class MyTransferDelegate : IAndroidForegroundServiceDelegate
{
    public void Configure(AndroidX.Core.App.NotificationCompat.Builder builder)
    {
        builder
            .SetContentTitle("My App")
            .SetContentText("Transferring files...")
            .SetSmallIcon(Resource.Mipmap.appicon);
    }
}
#endif

Note

You can also extend HttpTransferDelegate base class which combines IHttpTransferDelegate and IAndroidForegroundServiceDelegate with retry support.

Registration

// iOS / Android / Windows / Linux / macOS / plain .NET
services.AddHttpTransfers<MyTransferDelegate>();

// Blazor WebAssembly
services.AddBlazorHttpTransfers<MyTransferDelegate>(opts =>
{
    // Optional — defaults to the bundled Shiny service worker
    opts.ServiceWorkerPath = "./_content/Shiny.Net.Http.Blazor/http-transfer-sw.js";
});

On Blazor, ship the bundled SW at the configured path, or import its handlers from your own service worker:

my-sw.js

importScripts('./_content/Shiny.Net.Http.Blazor/http-transfer-sw.js');

AI Coding Assistant

Claude Code GitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-client@shiny

Coming soon — Copilot plugin install instructions will be added here.

View shiny-client Plugin

Samples

• MAUI Sample