自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

RemoteAndroidDevice

public class RemoteAndroidDevice
extends TestDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice
		↳	com.android.tradefed.device.RemoteAndroidDevice

已知的直接子类

LocalAndroidVirtualDevice	在 TradeFed 主机上运行的本地虚拟设备的类。
RemoteAndroidVirtualDevice	针对在 Google Compute Engine (GCE) 中运行的完整堆栈 Android 设备扩展了 `RemoteAndroidDevice` 行为。

通过 adb connect 连接的全堆栈 Android 设备的 ITestDevice 实现。假设设备序列号在 adb 中采用 : 格式。

摘要

公共构造函数
`RemoteAndroidDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` 创建 `RemoteAndroidDevice`。

公共方法
`static boolean`	`checkSerialFormatValid(String serialString)` 检查序列的格式是否符合预期：端口
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` 连接到 WLAN 网络。
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` 从设备信息返回 `DeviceDescriptor`，以便在不传递实际设备对象的情况下获取设备信息。
`String`	`getMacAddress()` 返回设备的 MAC 地址；如果无法从设备查询，则返回 null。
`boolean`	`isEncryptionSupported()` 返回设备是否支持加密。

protected static final long DEFAULT_SHORT_CMD_TIMEOUT

常量值： 20000 (0x0000000000004e20)

protected static final int MAX_RETRIES

常量值： 5 (0x00000005)

protected static final long RETRY_INTERVAL_MS

常量值： 5000 (0x0000000000001388)

public static final long WAIT_FOR_ADB_CONNECT

常量值： 120000 (0x000000000001d4c0)

public RemoteAndroidDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

参数
`device`	`IDevice`：关联的 `IDevice`
`stateMonitor`	`IDeviceStateMonitor`：要使用的 `IDeviceStateMonitor` 机制
`allocationMonitor`	`IDeviceMonitor`：用于通知分配状态变化的 `IDeviceMonitor`。

public static boolean checkSerialFormatValid (String serialString)

检查序列的格式是否符合预期：端口

参数
`serialString`	`String`

返回
`boolean`	如果格式有效，则为 true；否则为 false。

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

连接到 WLAN 网络。

开启 wifi 并阻塞，直到与 wifiSsidToPsk 映射中给定的某个 wifi 网络成功建立连接。建立连接后，实例会在每次重新启动后尝试恢复连接，直到调用 ITestDevice.disconnectFromWifi() 或 ITestDevice.clearLastConnectedWifiNetwork()。

参数
`wifiSsidToPsk`	：一个将 Wi-Fi SSID 映射到密码的映射。
`scanSsid`	`boolean`：是否扫描此网络的隐藏 SSID。

返回
`boolean`	`true` 如果已成功连接到 WLAN 网络。`false` 否则

抛出
`DeviceNotAvailableException`

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

从设备信息返回 DeviceDescriptor，以便在不传递实际设备对象的情况下获取相关信息。

参数
`shortDescriptor`	`boolean`：是否将描述符限制为仅包含最基本的信息

返回
`DeviceDescriptor`

public String getMacAddress ()

返回设备的 MAC 地址；如果无法从设备查询，则返回 null。

返回
`String`

public boolean isEncryptionSupported ()

返回设备是否支持加密。

返回
`boolean`	`true`（前提是设备支持加密）。