DSoft.System.Mvvm.UI.MAUI 3.4.2411.191

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package DSoft.System.Mvvm.UI.MAUI --version 3.4.2411.191                

                    
                

            
NuGet\Install-Package DSoft.System.Mvvm.UI.MAUI -Version 3.4.2411.191
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="DSoft.System.Mvvm.UI.MAUI" Version="3.4.2411.191" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add DSoft.System.Mvvm.UI.MAUI --version 3.4.2411.191                

                    
                

            
#r "nuget: DSoft.System.Mvvm.UI.MAUI, 3.4.2411.191"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install DSoft.System.Mvvm.UI.MAUI as a Cake Addin
#addin nuget:?package=DSoft.System.Mvvm.UI.MAUI&version=3.4.2411.191

// Install DSoft.System.Mvvm.UI.MAUI as a Cake Tool
#tool nuget:?package=DSoft.System.Mvvm.UI.MAUI&version=3.4.2411.191

System.Mvvm.UI.MAUI

Provides MAUI platform implementations for DSoft.System.Mvvm.UI

Functionality

  • UI
    • Core UI functions for Showing Alerts and Confirmation Dialogs
    • UI Thread execution
    • Dependency injection support with IPlatformCoreUIProvider

Using System.Mvvm.UI.MAUI

The UI static class provides four methods as defined in the IPlatformCoreUIProvider interface.

  • A central interface for calling some simple UI functions
    • ShowAlert(string title, string message)
      • Show an alert with a title and message using the platform implementation
    • ShowConfirmation(string title, string message)
      • Show a confirmation dialog and return the result using the platform implementation
    • InvokeOnUIThread(Action)
      • Execute the action on the UI thread using the platform implementation
    • InvokeOnUIThreadAsync(Action)
      • Execute the action on the UI thread asyncronously using the platform implementation

The standard UI functions can be called directly after adding the DSoft.Mvvm.UI package to your shared code

using System.Mvvm;
... 

var result = await UI.ShowConfirmationDialogAsync("Confirm this", "This is a platform specific confirmation message");

if (result)
    await UI.ShowAlertAsync("YAY!", "You confirmed that");

In the MAUI project that contains the App class(or other sub-class of Application), add the DSoft.System.Mvvm.UI.MAUI package.

Call the MvvmManager.Init method in the shared code, such as Application.OnStart

using System.Mvvm;
... 
public partial class App : Application
{
    protected override OnStart()
    {
        base.OnStart();

        MvvmManager.Init();
    }
}

Dependency Injection

Instead of using the static UI class you can use dependency injection to access the platform implementation of IPlatformCoreUIProvider using extensions for IServiceCollection provided by the platform specific packages.

After adding DSoft.System.Mvvm.UI.MAUI to the application project you can register the core UI implementations of IPlatformCoreUIProvider with the ServiceProvider during configuration of the services using the AddCoreUI extension method.

using System.Mvvm;
... 
public static class MauiProgram
{
	public static MauiApp CreateMauiApp()
	{
		var builder = MauiApp.CreateBuilder();
		builder
			.UseMauiApp<App>()
			.ConfigureFonts(fonts =>
			{
				fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
				fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
			});

        builder.Services.AddCore();

		return builder.Build();
	}
}

Once the core UI is registered you can use IPlatformCoreUIProvider with dependency injection in class constructors.

using System.Mvvm;
... 
public class SharedClassToDoThingsIn
{
   private readonly IPlatformCoreUIProvider _coreUIProvider;

    public SharedClassToDoThingsIn(IPlatformCoreUIProvider coreUIProvider)
    {
        _coreUIProvider = coreUIProvider;
    }

    public async Task SayHello()
    {
        await _coreUIProvider.ShowAlertAsync("Congrats", "You called the ICoreUIProvider instance");
    }
}

ISevicesCollection extensions

On other platforms, when configuring the services there is normally a ConfigureServices extension to make it easier to parse a delegate to configure the services. With MauiAppBuilder this is not available so we created MauiExtensions to add this functionality back in.

	public static MauiApp CreateMauiApp()
	{
		var builder = MauiApp.CreateBuilder();
		builder
			.UseMauiApp<App>()
			.ConfigureFonts(fonts =>
			{
				fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
				fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
			})
			.ConfigureServices(services =>
            {
                services.AddCoreUI();
            });

		return builder.Build();
	}

MauiHostProxy

MauiApp does not implement IHost and so it cannot be used directly with DSoft.System.Mvvm.Hosting. This makes it harder to access the IServiceProvider instance to retrieve the services. We've created MauiHostProxy to allow you to use MauiApp with DSoft.System.Mvvm.Hosting by providing a simple wrapper around it which does implement IHost.

You simply instatiate a new instance of MauiHostProxy with the output of MauiAppBuilder.Build and assigned it to ServiceHost.Host as usual.

    public static MauiApp CreateMauiApp()
    {
      var builder = MauiApp.CreateBuilder();
      builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
          fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
          fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
        })
        .ConfigureServices(ConfigureServices);

      var app = builder.Build();

      //configure the servicehost host
      ServiceHost.Host = new MauiHostProxy(app);

      return app;
    }

You can then retrieve the implementation directly from ServiceHost as before, theres not need to keep a refernce to MauiApp in your shared code.

using System.Mvvm;
... 

var _coreUIProvider = ServiceHost.GetRequiredService<IPlatformCoreUIProvider>();

await _coreUIProvider.ShowAlertAsync("Congrats", "You called the ICoreUIProvider instance");

IMAUIPlatformUIProvider

IMAUIPlatformUIProvider is a platform specific interface that the platform implementation of IPlatformCoreUIProvider implements. It provides access to some additonal MAUI properties such as the current Application.

Use can retrieve the implementation directly from the services provider or ServiceHost if you are using DSoft.System.Mvvm.Hosting

using System.Mvvm;
... 

var _formsUIProvider = ServiceHost.GetRequiredService<IMAUIPlatformUIProvider>();

var currentApp = _formsUIProvider.CurrentApplication;
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-android34.0 is compatible.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-ios18.0 is compatible.  net8.0-maccatalyst was computed.  net8.0-maccatalyst18.0 is compatible.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net8.0-windows10.0.19041 is compatible.  net9.0 is compatible.  net9.0-android35.0 is compatible.  net9.0-ios18.0 is compatible.  net9.0-maccatalyst18.0 is compatible.  net9.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.4.2411.191 74 11/19/2024
3.4.2406.251 227 6/25/2024
3.3.2405.241 128 5/24/2024
3.3.2405.21 163 5/5/2024
3.2.2301.91 300 1/9/2023
3.1.2208.151 289 8/15/2022

Updated to .NET 9.0 and latest packages