Skip to content
Docs Try Aspire

MauiMacCatalystExtensions Methods

Class Methods 2 members
Provides extension methods for adding Mac Catalyst platform resources to MAUI projects.
AddMacCatalystDevice(IResourceBuilder<MauiProjectResource>) Section titled AddMacCatalystDevice(IResourceBuilder<MauiProjectResource>) extension IResourceBuilder<MauiMacCatalystPlatformResource>
Adds a Mac Catalyst device resource to run the MAUI application on the macOS platform.
public static class MauiMacCatalystExtensions
{
public static IResourceBuilder<MauiMacCatalystPlatformResource> AddMacCatalystDevice(
this IResourceBuilder<MauiProjectResource> builder)
{
// ...
}
}
builder IResourceBuilder<MauiProjectResource> The MAUI project resource builder.
IResourceBuilder<MauiMacCatalystPlatformResource> A reference to the ApplicationModel.IResourceBuilder`1.
This method creates a new Mac Catalyst platform resource that will run the MAUI application targeting the Mac Catalyst platform using dotnet run. The resource does not auto-start and must be explicitly started from the dashboard by clicking the start button.

The resource name will default to "{projectName}-maccatalyst".

Add a Mac Catalyst device to a MAUI project:

var builder = DistributedApplication.CreateBuilder(args);
var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
var macCatalystDevice = maui.AddMacCatalystDevice();
builder.Build().Run();
AddMacCatalystDevice(IResourceBuilder<MauiProjectResource>, string) Section titled AddMacCatalystDevice(IResourceBuilder<MauiProjectResource>, string) extension IResourceBuilder<MauiMacCatalystPlatformResource>
Adds a Mac Catalyst device resource to run the MAUI application on the macOS platform with a specific name.
public static class MauiMacCatalystExtensions
{
public static IResourceBuilder<MauiMacCatalystPlatformResource> AddMacCatalystDevice(
this IResourceBuilder<MauiProjectResource> builder,
string name)
{
// ...
}
}
builder IResourceBuilder<MauiProjectResource> The MAUI project resource builder.
name string The name of the Mac Catalyst device resource.
IResourceBuilder<MauiMacCatalystPlatformResource> A reference to the ApplicationModel.IResourceBuilder`1.
This method creates a new Mac Catalyst platform resource that will run the MAUI application targeting the Mac Catalyst platform using dotnet run. The resource does not auto-start and must be explicitly started from the dashboard by clicking the start button.

You can add multiple Mac Catalyst device resources to a MAUI project by calling this method multiple times with different names.

Add multiple Mac Catalyst devices to a MAUI project:

var builder = DistributedApplication.CreateBuilder(args);
var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
var macCatalystDevice1 = maui.AddMacCatalystDevice("maccatalyst-device-1");
var macCatalystDevice2 = maui.AddMacCatalystDevice("maccatalyst-device-2");
builder.Build().Run();