AngryMonkey.CloudBlazor.App.Maui 1.0.1

CloudBlazor.App.Maui

.NET MAUI Blazor Hybrid integration for CloudBlazor.App: native navigation, hardware back button handling, and platform launcher support.

Formerly published as AngryMonkey.CloudApp.Maui and AngryMonkey.CloudApp.Mobile. See Migrating.

Supported platforms

Android · iOS · macOS (Mac Catalyst) · Windows

Installation

dotnet add package AngryMonkey.CloudBlazor.App.Maui

This package references AngryMonkey.CloudBlazor.App, so the shared navigation contract comes with it.

Quick start

public static MauiApp CreateMauiApp()
{
    MauiAppBuilder builder = MauiApp.CreateBuilder();

    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts => fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular"));

    builder.Services.AddMauiBlazorWebView();

    // Registers MauiNavigationService as the INavigationService.
    builder.Services.AddCloudAppMaui();

    return builder.Build();
}

Application code depends only on INavigationService, so the same components run unchanged in a browser host that calls AddCloudApp() instead.

Hardware back button

TryNavigateBack returns false on the root page with no popup open, which is exactly the signal needed to let the platform close the application:

protected override bool OnBackButtonPressed() => _navigation.TryNavigateBack();

Returning true means the service handled the navigation, so the platform should not.

What differs from the web service

MauiNavigationService shares all of NavigationServiceBase with WebNavigationService. Only external navigation behaves differently.

await Navigation.NavigateToExternalAsync("https://angrymonkeycloud.com");
await Navigation.NavigateToExternalAsync("tel:+96112345678");
await Navigation.NavigateToExternalAsync("www.angrymonkeycloud.com");   // promoted to https

Opening these through the launcher rather than the web view is the point: a tel: link inside a BlazorWebView does nothing useful on its own.

When the launcher fails — typically because no handler is installed for the scheme — the navigation falls back to the web view rather than being dropped.

Deep links

public override bool TryHandleDeepLink(Uri uri)
{
    // Return true once the link has been consumed.
    return false;
}

The string overload parses and delegates to the Uri overload, so only one needs overriding.

Migrating

The previous packages are no longer updated. The repositories were merged into CloudBlazor, where all four packages ship as a matched set.

Required changes

MauiNavigationService keeps its name and members. Two behaviours changed as bug fixes:

• SoftNavigate is no longer async void. An exception inside it used to be unobservable and could tear down the process.
• A wider set of URI schemes reaches the launcher. sms: was previously routed into the web view.

Related packages

License

MIT © Angry Monkey Cloud