Add AdbRunner for adb CLI operations

Port adb device parsing, formatting, and merging logic from
dotnet/android GetAvailableAndroidDevices MSBuild task into a
shared AdbRunner class.
New files:
- AdbRunner.cs — ListDevicesAsync, WaitForDeviceAsync, StopEmulatorAsync,
ParseAdbDevicesOutput, BuildDeviceDescription, FormatDisplayName,
MapAdbStateToStatus, MergeDevicesAndEmulators
- AdbDeviceInfo/AdbDeviceType/AdbDeviceStatus — device models
- AndroidEnvironmentHelper — shared env var builder for all runners
- ProcessUtils.ThrowIfFailed — shared exit code validation
Modified files:
- EnvironmentVariableNames — add ANDROID_USER_HOME, ANDROID_AVD_HOME
- SdkManager.Process.cs — deduplicate env var logic via AndroidEnvironmentHelper
Tests:
- 43 unit tests (parsing, formatting, merging, path discovery, timeout)
- 5 integration tests (CI-only, real SDK tools)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: rmarinho

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";

src/Xamarin.Android.Tools.AndroidSdk/EnvironmentVariableNames.cs

@@ -40,5 +40,17 @@ internal static class EnvironmentVariableNames
 /// Executable file extensions (Windows).
 /// </summary>
 publicconststringPathExt="PATHEXT";
+
+/// <summary>
+/// Overrides the default location for Android user-specific data
+/// (AVDs, preferences, etc.). Defaults to $HOME/.android.
+/// </summary>
+publicconststringAndroidUserHome="ANDROID_USER_HOME";
+
+/// <summary>
+/// Overrides the AVD storage directory. Takes precedence over
+/// <see cref="AndroidUserHome"/>/avd.
+/// </summary>
+publicconststringAndroidAvdHome="ANDROID_AVD_HOME";
 }
 }

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceInfo.cs

@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents an Android device or emulator from 'adb devices -l' output.
+/// Mirrors the metadata produced by dotnet/android's GetAvailableAndroidDevices task.
+/// </summary>
+publicclassAdbDeviceInfo
+{
+/// <summary>
+/// Serial number of the device (e.g., "emulator-5554", "0A041FDD400327").
+/// For non-running emulators, this is the AVD name.
+/// </summary>
+publicstringSerial{get;set;}=string.Empty;
+
+/// <summary>
+/// Human-friendly description of the device (e.g., "Pixel 7 API 35", "Pixel 6 Pro").
+/// </summary>
+publicstringDescription{get;set;}=string.Empty;
+
+/// <summary>
+/// Device type: Device or Emulator.
+/// </summary>
+publicAdbDeviceTypeType{get;set;}
+
+/// <summary>
+/// Device status: Online, Offline, Unauthorized, NoPermissions, NotRunning, Unknown.
+/// </summary>
+publicAdbDeviceStatusStatus{get;set;}
+
+/// <summary>
+/// AVD name for emulators (e.g., "pixel_7_api_35"). Null for physical devices.
+/// </summary>
+publicstring?AvdName{get;set;}
+
+/// <summary>
+/// Device model from adb properties (e.g., "Pixel_6_Pro").
+/// </summary>
+publicstring?Model{get;set;}
+
+/// <summary>
+/// Product name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Product{get;set;}
+
+/// <summary>
+/// Device code name from adb properties (e.g., "raven").
+/// </summary>
+publicstring?Device{get;set;}
+
+/// <summary>
+/// Transport ID from adb properties.
+/// </summary>
+publicstring?TransportId{get;set;}
+
+/// <summary>
+/// Whether this device is an emulator.
+/// </summary>
+publicboolIsEmulator=>Type==AdbDeviceType.Emulator;
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceStatus.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the status of an Android device.
+/// </summary>
+publicenumAdbDeviceStatus
+{
+Online,
+Offline,
+Unauthorized,
+NoPermissions,
+NotRunning,
+Unknown
+}

src/Xamarin.Android.Tools.AndroidSdk/Models/AdbDeviceType.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespaceXamarin.Android.Tools;
+
+/// <summary>
+/// Represents the type of an Android device.
+/// </summary>
+publicenumAdbDeviceType
+{
+Device,
+Emulator
+}

src/Xamarin.Android.Tools.AndroidSdk/ProcessUtils.cs

@@ -203,6 +203,25 @@ static string JoinArguments (string[] args)
 }
 #endif
 
+/// <summary>
+/// Throws <see cref="InvalidOperationException"/> when <paramref name="exitCode"/> is non-zero.
+/// Includes stderr/stdout context in the message when available.
+/// </summary>
+publicstaticvoidThrowIfFailed(intexitCode,stringcommand,string?stderr=null,string?stdout=null)
+{
+if(exitCode==0)
+return;
+
+varmessage=$"'{command}' failed with exit code {exitCode}.";
+
+if(!string.IsNullOrEmpty(stderr))
+message+=$" stderr:{Environment.NewLine}{stderr!.Trim()}";
+if(!string.IsNullOrEmpty(stdout))
+message+=$" stdout:{Environment.NewLine}{stdout!.Trim()}";
+
+thrownewInvalidOperationException(message);
+}
+
 internalstaticIEnumerable<string>FindExecutablesInPath(stringexecutable)
 {
 varpath=Environment.GetEnvironmentVariable(EnvironmentVariableNames.Path)??"";