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

此页面由 Cloud Translation API 翻译。

NativeDeviceStateMonitor

public class NativeDeviceStateMonitor
extends Object implements IDeviceStateMonitor

java.lang.Object
↳	com.android.tradefed.device.NativeDeviceStateMonitor

已知的直接子类

DeviceStateMonitor

DeviceStateMonitor 用于监控 IDevice 状态的辅助类。

已知的间接子类

NestedDeviceStateMonitor

NestedDeviceStateMonitor 设备状态监视器，用于对嵌套设备执行额外检查，以适应虚拟化环境的具体情况。

用于监控无框架支持的 IDevice 状态的辅助类。

摘要

常量
`long`	`MAX_CHECK_POLL_TIME`
`int`	`MAX_OP_TIME` “轮询响应能力”命令的操作时长上限（以毫秒为单位）

字段
`protected static final String`	`PERM_DENIED_ERROR_PATTERN`

公共构造函数
`NativeDeviceStateMonitor(IDeviceManager mgr, IDevice device, boolean fastbootEnabled)`

公共方法
`void`	`attachFinalState(TestDeviceState finalState)` 附加最终状态以在达到时中止 waitForDeviceState。
`TestDeviceState`	`getDeviceState()` 获取设备状态。
`String`	`getFastbootSerialNumber()` 获取 fastboot 模式序列号。
`String`	`getMountPoint(String mountName)` 返回一个挂载点。
`String`	`getSerialNumber()` 获取设备的序列号。
`boolean`	`isAdbTcp()`
`void`	`setDefaultAvailableTimeout(long timeoutMs)` 在 `waitForDeviceAvailable()` 中设置等待设备可用的时间（以毫秒为单位）。
`void`	`setDefaultOnlineTimeout(long timeoutMs)` 在 `waitForDeviceOnline()` 中设置等待设备上线的时间（以毫秒为单位）。
`void`	`setFastbootSerialNumber(String serial)` 设置 fastboot 模式序列号。
`void`	`setIDevice(IDevice newDevice)` 更新当前 IDevice。
`void`	`setState(TestDeviceState deviceState)` 设置设备当前状态。
`boolean`	`waitForBootComplete(long waitTime)` 阻塞，直到设备的启动完成标志设置为 1
`IDevice`	`waitForDeviceAvailable(long waitTime)` 等待设备响应并可供测试。
`IDevice`	`waitForDeviceAvailable()` 等待设备响应并可供测试。
`IDevice`	`waitForDeviceAvailableInRecoverPath(long waitTime)` `waitForDeviceAvailable(long)` 的特殊变体，用于在恢复路径中调用以量身定制处理方式。
`boolean`	`waitForDeviceBootloader(long time)` 等待设备进入引导加载程序。
`void`	`waitForDeviceBootloaderStateUpdate()` 等待设备引导加载程序状态刷新
`boolean`	`waitForDeviceFastbootd(String fastbootPath, long time)` 等待设备进入 fastbootd 状态。
`IDevice`	`waitForDeviceInRecovery()` 使用标准启动超时等待设备进入恢复模式。
`boolean`	`waitForDeviceInRecovery(long waitTime)` 等待设备进入“adb recovery”状态
`boolean`	`waitForDeviceInSideload(long waitTime)` 等待设备处于“adb sideload”状态
`boolean`	`waitForDeviceNotAvailable(long waitTime)` 等待设备不可用
`IDevice`	`waitForDeviceOnline()` 使用标准启动超时等待设备上线。
`IDevice`	`waitForDeviceOnline(long waitTime)` 等待设备上线。
`boolean`	`waitForDeviceShell(long waitTime)` 等待设备响应基本 adb shell 命令。

受保护的方法
`CollectingOutputReceiver`	`createOutputReceiver()` 公开以供测试
`long`	`getCheckPollTime()` 公开以供测试
`long`	`getCurrentTime()` 公开以供测试
`IDevice`	`getIDevice()`
`boolean`	`postOnlineCheck(long waitTime)` 对在线设备执行的其他检查
`boolean`	`waitForStoreMount(long waitTime)` 等待挂载设备的外部存储空间。

常量

MAX_CHECK_POLL_TIME

protected static final long MAX_CHECK_POLL_TIME

常量值： 3000 (0x0000000000000bb8)

MAX_OP_TIME

protected static final int MAX_OP_TIME

“轮询响应能力”命令的操作时长上限（以毫秒为单位）

常量值： 10000 (0x00002710)

字段

PERM_DENIED_ERROR_PATTERN

protected static final String PERM_DENIED_ERROR_PATTERN

公共构造函数

NativeDeviceStateMonitor

public NativeDeviceStateMonitor (IDeviceManager mgr, 
                IDevice device, 
                boolean fastbootEnabled)

参数
`mgr`	`IDeviceManager`
`device`	`IDevice`
`fastbootEnabled`	`boolean`

公共方法

attachFinalState

public void attachFinalState (TestDeviceState finalState)

附加最终状态，以便在达到时中止 waitForDeviceState。

参数
`finalState`	`TestDeviceState`

getDeviceState

public TestDeviceState getDeviceState ()

获取设备状态。

返回
`TestDeviceState`	设备的 `TestDeviceState`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

获取 fastboot 模式序列号。

返回
`String`

getMountPoint

public String getMountPoint (String mountName)

返回一个挂载点。

如果 IDevice 中的缓存信息不可用，则直接查询设备。

TODO：将此行为移至 IDevice.getMountPoint(String)

参数
`mountName`	`String`：挂载点的名称

返回
`String`	装载点或 `null`

抛出
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

获取设备的序列号。

返回
`String`

isAdbTcp

public boolean isAdbTcp ()

返回
`boolean`

setDefaultAvailableTimeout

public void setDefaultAvailableTimeout (long timeoutMs)

在 waitForDeviceAvailable() 中设置等待设备可用的时间（以毫秒为单位）。

参数
`timeoutMs`	`long`

setDefaultOnlineTimeout

public void setDefaultOnlineTimeout (long timeoutMs)

在 waitForDeviceOnline() 中设置等待设备上线的时间（以毫秒为单位）。

参数
`timeoutMs`	`long`

setFastbootSerialNumber

public void setFastbootSerialNumber (String serial)

设置 Fastboot 模式序列号。

参数
`serial`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

更新当前 IDevice。

setState

public void setState (TestDeviceState deviceState)

设置设备当前状态。

waitForBootComplete

public boolean waitForBootComplete (long waitTime)

阻塞，直到设备的启动完成标志设置完毕

参数
`waitTime`	`long`：等待时间（以毫秒为单位）

返回
`boolean`

waitForDeviceAvailable

public IDevice waitForDeviceAvailable (long waitTime)

等待设备响应并可供测试。目前，这意味着软件包管理器和外部存储空间可用。

参数
`waitTime`	`long`：等待时间（以毫秒为单位）

返回
`IDevice`	`IDevice`，如果设备在时间到期前上线。否则为 `null`。

waitForDeviceAvailable

public IDevice waitForDeviceAvailable ()

等待设备响应并可供测试。

等同于 waitForDeviceAvailable(long)，但使用默认的设备启动超时。

返回
`IDevice`	`IDevice`，如果设备在时间到期前上线。否则为 `null`。

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

waitForDeviceAvailable(long) 的特殊变体，用于在恢复路径中调用以量身定制处理方式。

参数
`waitTime`	`long`

返回
`IDevice`

抛出
`DeviceNotAvailableException`

waitForDeviceBootloader

public boolean waitForDeviceBootloader (long time)

等待设备进入引导加载程序。

参数
`time`	`long`：等待的最长时间（以毫秒为单位）

返回
`boolean`	`true`（如果设备在时间到期前处于引导加载程序中）

waitForDeviceBootloaderStateUpdate

public void waitForDeviceBootloaderStateUpdate ()

等待设备引导加载程序状态刷新

waitForDeviceFastbootd

public boolean waitForDeviceFastbootd (String fastbootPath, 
                long time)

等待设备进入 fastbootd。

参数
`fastbootPath`	`String`：要使用的 fastboot 二进制文件的路径。
`time`	`long`：等待的最长时间（以毫秒为单位）

返回
`boolean`	如果设备在时间结束前处于 fastbootd 状态，则为 `true`

waitForDeviceInRecovery

public IDevice waitForDeviceInRecovery ()

使用标准启动超时等待设备进入恢复模式。

返回
`IDevice`	`IDevice`（如果设备在超时之前进入恢复状态）。`null` 否则。

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

等待设备进入“adb recovery”状态

参数
`waitTime`	`long`：等待的最长时间（以毫秒为单位）

返回
`boolean`	如果设备在超时之前处于恢复模式，则返回 True；否则返回 False。

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

等待设备处于“adb sideload”状态

参数
`waitTime`	`long`：等待的最长时间（以毫秒为单位）

返回
`boolean`	如果设备在超时之前处于旁加载状态，则返回 true；否则返回 false。

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

等待设备不可用

参数
`waitTime`	`long`：等待的最长时间（以毫秒为单位）

返回
`boolean`	如果设备变为不可用，则为 `true`

waitForDeviceOnline

public IDevice waitForDeviceOnline ()

使用标准启动超时等待设备上线。

注意：设备通过 DDMS 显示后，此方法将返回。这并不保证设备实际上会响应 adb 命令 - 请改用 waitForDeviceAvailable()。

返回
`IDevice`	`IDevice`，如果设备在时间到期前上线。否则为 `null`。

waitForDeviceOnline

public IDevice waitForDeviceOnline (long waitTime)

等待设备上线。

注意：设备通过 DDMS 显示后，此方法将返回。这并不保证设备实际上会响应 adb 命令 - 请改用 waitForDeviceAvailable()。

参数
`waitTime`	`long`：等待的最长时间（以毫秒为单位）

返回
`IDevice`	`IDevice`，如果设备在时间到期前上线。否则为 `null`。

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

等待设备响应基本 adb shell 命令。

参数
`waitTime`	`long`：等待时间（以毫秒为单位）

返回
`boolean`	如果设备在 `waitTime` 过期之前有响应，则返回 `true`。

受保护的方法

createOutputReceiver

protected CollectingOutputReceiver createOutputReceiver ()

公开以供测试

返回
`CollectingOutputReceiver`	`CollectingOutputReceiver`

getCheckPollTime

protected long getCheckPollTime ()

公开以供测试

返回
`long`

getCurrentTime

protected long getCurrentTime ()

公开以供测试

返回
`long`

getIDevice

protected IDevice getIDevice ()

返回
`IDevice`	`IDevice` 与状态监视器相关联

postOnlineCheck

protected boolean postOnlineCheck (long waitTime)

对在线设备执行的其他检查

参数
`waitTime`	`long`：放弃之前等待的时间（以毫秒为单位）

返回
`boolean`	如果在 waitTime 过期之前检查成功，则返回 `true`。否则返回 `false`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForStoreMount

protected boolean waitForStoreMount (long waitTime)

等待挂载设备的外部存储空间。

参数
`waitTime`	`long`：放弃之前等待的时间（以毫秒为单位）

返回
`boolean`	如果外部存储空间在 waitTime 到期之前挂载，则为 `true`。否则返回 `false`

抛出
`DeviceNotAvailableException`