MauiAndroidExtensions.AddAndroidDevice 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
| 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.