MauiAndroidExtensions.AddAndroidEmulator Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| AddAndroidEmulator(IResourceBuilder<MauiProjectResource>) |
Adds an Android emulator resource to run the MAUI application on an Android emulator. |
| AddAndroidEmulator(IResourceBuilder<MauiProjectResource>, String) |
Adds an Android emulator resource to run the MAUI application on an Android emulator with a specific name. |
| AddAndroidEmulator(IResourceBuilder<MauiProjectResource>, String, String) |
Adds an Android emulator resource to run the MAUI application on an Android emulator with a specific name. |
AddAndroidEmulator(IResourceBuilder<MauiProjectResource>)
- Source:
- MauiAndroidExtensions.cs
Adds an Android emulator resource to run the MAUI application on an Android emulator.
public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidEmulatorResource> AddAndroidEmulator(this Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> builder);static member AddAndroidEmulator : Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidEmulatorResource><Extension()>
Public Function AddAndroidEmulator (builder As IResourceBuilder(Of MauiProjectResource)) As IResourceBuilder(Of MauiAndroidEmulatorResource)Parameters
- builder
- IResourceBuilder<MauiProjectResource>
The MAUI project resource builder.
Returns
A reference to the IResourceBuilder<T>.
Examples
Add an Android emulator to a MAUI project:
var builder = DistributedApplication.CreateBuilder(args);
var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
// Uses default/running emulator
var defaultEmulator = maui.AddAndroidEmulator();
builder.Build().Run();
Remarks
This method creates a new Android emulator platform resource that will run the MAUI application targeting the Android 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}-android-emulator".
This will run the application on an Android emulator. Make sure you have created an Android Virtual Device (AVD) using Android Studio or avdmanager. The emulator should be running and visible via adb devices.
To target a specific emulator, use the overload that accepts an emulatorId parameter.
Applies to
AddAndroidEmulator(IResourceBuilder<MauiProjectResource>, String)
- Source:
- MauiAndroidExtensions.cs
Adds an Android emulator resource to run the MAUI application on an Android emulator with a specific name.
public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidEmulatorResource> AddAndroidEmulator(this Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> builder, string name);static member AddAndroidEmulator : Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> * string -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidEmulatorResource><Extension()>
Public Function AddAndroidEmulator (builder As IResourceBuilder(Of MauiProjectResource), name As String) As IResourceBuilder(Of MauiAndroidEmulatorResource)Parameters
- builder
- IResourceBuilder<MauiProjectResource>
The MAUI project resource builder.
- name
- String
The name of the Android emulator resource.
Returns
A reference to the IResourceBuilder<T>.
Examples
Add multiple Android emulators to a MAUI project:
var builder = DistributedApplication.CreateBuilder(args);
var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
var emulator1 = maui.AddAndroidEmulator("android-emulator-1");
var emulator2 = maui.AddAndroidEmulator("android-emulator-2");
builder.Build().Run();
Remarks
This method creates a new Android emulator platform resource that will run the MAUI application targeting the Android platform using dotnet run. The resource does not auto-start and must be explicitly started from the dashboard by clicking the start button.
Multiple Android emulator resources can be added to the same MAUI project if needed, each with a unique name.
This will run the application on an Android emulator. Make sure you have created an Android Virtual Device (AVD) using Android Studio or avdmanager. The emulator should be running and visible via adb devices.
To target a specific emulator, use the overload that accepts an emulatorId parameter.
Applies to
AddAndroidEmulator(IResourceBuilder<MauiProjectResource>, String, String)
- Source:
- MauiAndroidExtensions.cs
Adds an Android emulator resource to run the MAUI application on an Android emulator with a specific name.
public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidEmulatorResource> AddAndroidEmulator(this Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> builder, string name, string? emulatorId = default);static member AddAndroidEmulator : Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> * string * string -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidEmulatorResource><Extension()>
Public Function AddAndroidEmulator (builder As IResourceBuilder(Of MauiProjectResource), name As String, Optional emulatorId As String = Nothing) As IResourceBuilder(Of MauiAndroidEmulatorResource)Parameters
- builder
- IResourceBuilder<MauiProjectResource>
The MAUI project resource builder.
- name
- String
The name of the Android emulator resource.
- emulatorId
- String
Optional emulator ID to target a specific Android emulator. If not specified, uses the currently running emulator or starts the default emulator.
Returns
A reference to the IResourceBuilder<T>.
Examples
Add multiple Android emulators to a MAUI project:
var builder = DistributedApplication.CreateBuilder(args);
var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
// Default emulator
var emulator1 = maui.AddAndroidEmulator("android-emulator-default");
// Specific Pixel 5 emulator
var emulator2 = maui.AddAndroidEmulator("android-emulator-pixel5", "Pixel_5_API_33");
// Specific emulator by serial
var emulator3 = maui.AddAndroidEmulator("android-emulator-5554", "emulator-5554");
builder.Build().Run();
Remarks
This method creates a new Android emulator platform resource that will run the MAUI application targeting the Android platform using dotnet run. The resource does not auto-start and must be explicitly started from the dashboard by clicking the start button.
Multiple Android emulator resources can be added to the same MAUI project if needed, each with a unique name.
This will run the application on an Android emulator. Make sure you have created an Android Virtual Device (AVD) using Android Studio or avdmanager. The emulator should be running and visible via adb devices.
To target a specific emulator, provide the emulator ID (e.g., "Pixel_5_API_33" or "emulator-5554"). Use adb devices to list available emulator IDs.