Share via


MauiAndroidExtensions.AddAndroidDevice Method

Definition

Overloads

AddAndroidDevice(IResourceBuilder<MauiProjectResource>)

Adds an Android physical device resource to run the MAUI application on an Android device.

AddAndroidDevice(IResourceBuilder<MauiProjectResource>, String)

Adds an Android physical device resource to run the MAUI application on an Android device with a specific name.

AddAndroidDevice(IResourceBuilder<MauiProjectResource>, String, String)

Adds an Android physical device resource to run the MAUI application on an Android device with a specific name and device ID.

AddAndroidDevice(IResourceBuilder<MauiProjectResource>)

Source:
MauiAndroidExtensions.cs

Adds an Android physical device resource to run the MAUI application on an Android device.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidDeviceResource> AddAndroidDevice(this Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> builder);
static member AddAndroidDevice : Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidDeviceResource>
<Extension()>
Public Function AddAndroidDevice (builder As IResourceBuilder(Of MauiProjectResource)) As IResourceBuilder(Of MauiAndroidDeviceResource)

Parameters

builder
IResourceBuilder<MauiProjectResource>

The MAUI project resource builder.

Returns

A reference to the IResourceBuilder<T>.

Examples

Add an Android device to a MAUI project:

var builder = DistributedApplication.CreateBuilder(args);

var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
var androidDevice = maui.AddAndroidDevice();

builder.Build().Run();

Remarks

This method creates a new Android device 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-device".

This will run the application on a physical Android device connected via USB/WiFi debugging. If only one device is attached, it will automatically use that device. If multiple devices are attached, use the overload with deviceId parameter to specify which device to use. Make sure an Android device is connected and visible via adb devices.

Applies to

AddAndroidDevice(IResourceBuilder<MauiProjectResource>, String)

Source:
MauiAndroidExtensions.cs

Adds an Android physical device resource to run the MAUI application on an Android device with a specific name.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidDeviceResource> AddAndroidDevice(this Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> builder, string name);
static member AddAndroidDevice : Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> * string -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidDeviceResource>
<Extension()>
Public Function AddAndroidDevice (builder As IResourceBuilder(Of MauiProjectResource), name As String) As IResourceBuilder(Of MauiAndroidDeviceResource)

Parameters

builder
IResourceBuilder<MauiProjectResource>

The MAUI project resource builder.

name
String

The name of the Android device resource.

Returns

A reference to the IResourceBuilder<T>.

Examples

Add multiple Android devices to a MAUI project:

var builder = DistributedApplication.CreateBuilder(args);

var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");
var device1 = maui.AddAndroidDevice("android-device-1");
var device2 = maui.AddAndroidDevice("android-device-2");

builder.Build().Run();

Remarks

This method creates a new Android device 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 device resources can be added to the same MAUI project if needed, each with a unique name.

This will run the application on a physical Android device connected via USB/WiFi debugging. If only one device is attached, it will automatically use that device. If multiple devices are attached, use the overload with deviceId parameter to specify which device to use. Make sure an Android device is connected and visible via adb devices.

Applies to

AddAndroidDevice(IResourceBuilder<MauiProjectResource>, String, String)

Source:
MauiAndroidExtensions.cs

Adds an Android physical device resource to run the MAUI application on an Android device with a specific name and device ID.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidDeviceResource> AddAndroidDevice(this Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> builder, string name, string? deviceId = default);
static member AddAndroidDevice : Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiProjectResource> * string * string -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.Maui.MauiAndroidDeviceResource>
<Extension()>
Public Function AddAndroidDevice (builder As IResourceBuilder(Of MauiProjectResource), name As String, Optional deviceId As String = Nothing) As IResourceBuilder(Of MauiAndroidDeviceResource)

Parameters

builder
IResourceBuilder<MauiProjectResource>

The MAUI project resource builder.

name
String

The name of the Android device resource.

deviceId
String

Optional device ID to target a specific Android device. If not specified, uses the only attached device (requires exactly one device to be connected).

Returns

A reference to the IResourceBuilder<T>.

Examples

Add multiple Android devices to a MAUI project:

var builder = DistributedApplication.CreateBuilder(args);

var maui = builder.AddMauiProject("mauiapp", "../MyMauiApp/MyMauiApp.csproj");

// Default device (only one attached)
var device1 = maui.AddAndroidDevice("android-device-default");

// Specific device by serial number
var device2 = maui.AddAndroidDevice("android-device-pixel", "abc12345");

// WiFi debugging device
var device3 = maui.AddAndroidDevice("android-device-wifi", "192.168.1.100:5555");

builder.Build().Run();

Remarks

This method creates a new Android device 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 device resources can be added to the same MAUI project if needed, each with a unique name.

This will run the application on a physical Android device connected via USB/WiFi debugging. Make sure an Android device is connected and visible via adb devices.

To target a specific device when multiple are attached, provide the device ID (e.g., "abc12345" or "192.168.1.100:5555" for WiFi debugging). Use adb devices to list available device IDs.

Applies to