Add AdbRunner for adb CLI operations

[rmarinho]

Summary

Wraps adb CLI operations for device management. Addresses #279.

Changes

New: ConfigureEnvironment

Sets ANDROID_HOME on all child process ProcessStartInfo.

New: WaitForDeviceAsync

public async Task WaitForDeviceAsync (string? serial = null, TimeSpan? timeout = null, CancellationToken ct = default)

• Optional serial filter (waits for any device when null)
• Configurable timeout (default 60s), throws TimeoutException
• Uses CancellationTokenSource.CreateLinkedTokenSource for clean timeout handling

Updated: ListDevicesAsync / StopEmulatorAsync

Now call ConfigureEnvironment(psi) to set ANDROID_HOME.

API

public class AdbRunner
{
    public AdbRunner (Func<string?> getSdkPath);
    public string? AdbPath { get; }
    public bool IsAvailable { get; }
    
    Task<List<AdbDeviceInfo>> ListDevicesAsync (CancellationToken ct = default);
    Task WaitForDeviceAsync (string? serial = null, TimeSpan? timeout = null, CancellationToken ct = default);
    Task StopEmulatorAsync (string serial, CancellationToken ct = default);
}

[Copilot]

Pull request overview

Adds new “runner” infrastructure and an AdbRunner wrapper intended to simplify invoking Android SDK command-line tools (notably adb) from Xamarin.Android.Tools.AndroidSdk.

Changes:

• Introduces AndroidToolRunner + ToolRunnerResult models for executing tools with captured output, timeouts, and cancellation.
• Adds AndroidEnvironmentHelper utilities for env var setup and some Android mapping helpers.
• Adds AdbRunner for listing devices, waiting for boot completion, emulator control, and property enrichment.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
src/Xamarin.Android.Tools.AndroidSdk/Runners/AndroidToolRunner.cs	New process execution helper (sync/async/timeout/background).
src/Xamarin.Android.Tools.AndroidSdk/Runners/AndroidEnvironmentHelper.cs	New helper for tool env vars and mapping helpers.
src/Xamarin.Android.Tools.AndroidSdk/Runners/AdbRunner.cs	New adb wrapper for device/emulator operations and parsing.
src/Xamarin.Android.Tools.AndroidSdk/Models/ToolRunnerResult.cs	New execution result model (+ generic variant).
src/Xamarin.Android.Tools.AndroidSdk/Models/AndroidDeviceInfo.cs	New device model + enums used by AdbRunner.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jonathanpeppers]

I'd like to get the System.Diagnostics.Process code unified like mentioned here:

• Add base Android tool runner infrastructure #281 (comment)