自 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)` 检查序列的格式是否符合预期 :port
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` 连接到 Wi-Fi 网络。
`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)

检查串行端口的格式是否符合预期 :port

参数
`serialString`	`String`

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

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

连接到 Wi-Fi 网络。

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

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

返回
`boolean`	如果成功连接到 Wi-Fi 网络，则返回 `true`。`false` 否则

抛出
`DeviceNotAvailableException`

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

从设备信息返回 DeviceDescriptor，以获取其相关信息，而无需传递实际的设备对象。

参数
`shortDescriptor`	`boolean`：是否将描述符限制为仅包含必要信息

返回
`DeviceDescriptor`

public String getMacAddress ()

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

返回
`String`

public boolean isEncryptionSupported ()

返回设备是否支持加密。

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