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) 阻塞，直到设备的启动完成标志设置完毕
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

公共方法

附加 FinalState

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

等待设备恢复

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 旁加载”状态

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

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

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

等待设备不可用

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

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

等待设备在线

public IDevice waitForDeviceOnline ()

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

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

返回
IDevice	如果设备在时间到期之前变为在线状态，则 IDevice。否则为 null。

等待设备在线

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