IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor

已知間接子類別 DeviceStateMonitor、NativeDeviceStateMonitor、NestedDeviceStateMonitor DeviceStateMonitor 用於監控 IDevice 狀態的輔助類別。  NativeDeviceStateMonitor 輔助類別，用於監控沒有架構支援的 IDevice 狀態。  NestedDeviceStateMonitor 裝置狀態監控器，可針對巢狀裝置執行額外檢查，以因應虛擬化環境的特定需求。

---

提供監控 IDevice 狀態的設施。

只有在下列四個事件皆為 True 時，裝置才會被視為「可用」： 1. 裝置已連線，可透過 DDMS/adb 查看 (waitForDeviceOnline() 2. 裝置已設定 dev.bootcomplete 旗標 (@link #waitForBootComplete(long)} 3. 裝置的套件管理工具有回應 (可能無法運作) 4. 裝置的外部儲存空間已掛接 3. & 4. 是 waitForDeviceAvailable() 的一部分。

摘要

公用方法
default void	attachFinalState(TestDeviceState finalState) 附加最終狀態，以便在達到該狀態時終止 waitForDeviceState。
abstract TestDeviceState	getDeviceState() 取得裝置狀態。
abstract String	getFastbootSerialNumber() 取得快速系統啟動模式序號。
abstract String	getMountPoint(String mountName) 傳回掛接點。
abstract String	getSerialNumber() 取得裝置的序號。
abstract boolean	isAdbTcp()
abstract void	setDefaultAvailableTimeout(long timeoutMs) 設定等待裝置可用所需的時間 (以毫秒為單位)。 waitForDeviceAvailable()
abstract void	setDefaultOnlineTimeout(long timeoutMs) 在 waitForDeviceOnline() 中，以毫秒為單位設定等待裝置上線的時間。
abstract void	setFastbootSerialNumber(String serial) 設定快速啟動模式序號。
abstract void	setIDevice(IDevice device) 更新目前的 IDevice。
abstract void	setState(TestDeviceState deviceState) 設定裝置目前狀態。
abstract boolean	waitForBootComplete(long waitTime) 阻斷裝置，直到裝置的啟動完成標記設定為止
abstract IDevice	waitForDeviceAvailable(long waitTime) 等待裝置回應並可供測試。
abstract IDevice	waitForDeviceAvailable() 等待裝置回應並可供測試。
default IDevice	waitForDeviceAvailableInRecoverPath(long waitTime) waitForDeviceAvailable(long) 的特殊變化版本，可在復原路徑中呼叫，以便針對處理方式進行調整。
abstract boolean	waitForDeviceBootloader(long waitTime) 等待裝置進入引導程式。
abstract void	waitForDeviceBootloaderStateUpdate() 等待裝置系統啟動載入程式狀態更新
abstract boolean	waitForDeviceFastbootd(String fastbootPath, long waitTime) 等待裝置進入快速啟動模式。
abstract IDevice	waitForDeviceInRecovery() 使用標準啟動逾時值，等待裝置進入 Recovery 模式。
abstract boolean	waitForDeviceInRecovery(long waitTime) 等待裝置進入「adb recovery」狀態
abstract boolean	waitForDeviceInSideload(long waitTime) 等待裝置進入「adb sideload」狀態
abstract boolean	waitForDeviceNotAvailable(long waitTime) 等待裝置無法使用
abstract IDevice	waitForDeviceOnline() 使用標準啟動逾時值，等待裝置上線。
abstract IDevice	waitForDeviceOnline(long time) 等待裝置連上網路。
abstract boolean	waitForDeviceShell(long waitTime) 等待裝置回應基本 ADB 殼層指令。

公用方法

attachFinalState

public void attachFinalState (TestDeviceState finalState)

附加最終狀態，以便在達到該狀態時中止 waitForDeviceState。

參數
finalState	TestDeviceState

getDeviceState

public abstract TestDeviceState getDeviceState ()

取得裝置狀態。

傳回
TestDeviceState	裝置的 TestDeviceState

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

取得快速啟動模式序號。

傳回
String

getMountPoint

public abstract String getMountPoint (String mountName)

傳回掛接點。

如果 IDevice 中的快取資訊無法使用，則直接查詢裝置。

TODO：將此行為移至 IDevice.getMountPoint(String)

參數
mountName	String：掛接點的名稱

傳回
String	掛接點或 null

擲回
DeviceNotAvailableException

另請參閱：

• IDevice.getMountPoint(String)

getSerialNumber

public abstract String getSerialNumber ()

取得裝置的序號。

傳回
String

isAdbTcp

public abstract boolean isAdbTcp ()

傳回
boolean	true 裝置是否已透過 TCP 連線至 ADB

setDefaultAvailableTimeout

public abstract void setDefaultAvailableTimeout (long timeoutMs)

設定等待裝置可用所需的時間 (以毫秒為單位)，以便在 waitForDeviceAvailable() 中使用。

參數
timeoutMs	long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

在 waitForDeviceOnline() 中，以毫秒為單位設定等待裝置上線的時間。

參數
timeoutMs	long

setFastbootSerialNumber

public abstract void setFastbootSerialNumber (String serial)

設定快速啟動模式序號。

參數
serial	String

setIDevice

public abstract void setIDevice (IDevice device)

更新目前的 IDevice。

另請參閱：

• IManagedTestDevice.setIDevice(IDevice)

setState

public abstract void setState (TestDeviceState deviceState)

設定裝置目前狀態。

waitForBootComplete

public abstract boolean waitForBootComplete (long waitTime)

阻斷，直到裝置的啟動完成標記設定為止

參數
waitTime	long：等待時間 (以毫秒為單位)

傳回
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

等待裝置回應並可供測試。目前這表示套件管理工具和外部儲存空間可供使用。

參數
waitTime	long：等待時間 (以毫秒為單位)

傳回
IDevice	如果裝置在時間到期前連上網路，系統會 IDevice。否則為 null。

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

等待裝置回應並可供測試。

等同於 waitForDeviceAvailable(long)，但會使用預設的裝置啟動逾時時間。

傳回
IDevice	如果裝置在時間到期前連上網路，系統會 IDevice。否則為 null。

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

waitForDeviceAvailable(long) 的特殊變化版本，可在復原路徑中呼叫，以便針對處理方式進行調整。

參數
waitTime	long

傳回
IDevice

擲回
DeviceNotAvailableException	裝置無法使用。

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

等待裝置進入系統啟動載入程式。

參數
waitTime	long：等待的最大時間 (以毫秒為單位)

傳回
boolean	true 如果裝置在時間到期前處於系統啟動載入程式狀態

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

等待裝置系統啟動載入程式狀態更新

waitForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

等待裝置進入快速系統啟動模式。

參數
fastbootPath	String：要使用的 fastboot 二進位檔路徑。
waitTime	long：等待的最大時間 (以毫秒為單位)

傳回
boolean	true 如果裝置在時間到期前處於快速啟動狀態

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

使用標準啟動逾時值，等待裝置進入 Recovery 模式。

傳回
IDevice	如果裝置在時間到期前恢復，則會傳送 IDevice。否則為 null。

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

等待裝置進入「adb recovery」狀態

參數
waitTime	long：等待的最大時間 (以毫秒為單位)

傳回
boolean	如果裝置在逾時前處於復原狀態，則傳回「是」；否則傳回「否」。

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

等待裝置進入「adb sideload」狀態

參數
waitTime	long：等待的最大時間 (以毫秒為單位)

傳回
boolean	如果裝置在逾時前處於側載狀態，則傳回「是」；否則傳回「否」。

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

等待裝置無法使用

參數
waitTime	long：等待的最大時間 (以毫秒為單位)

傳回
boolean	true 裝置無法使用

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

使用標準啟動逾時值，等待裝置上線。

注意：裝置透過 DDMS 顯示後，這個方法就會傳回。這並不保證裝置實際上會回應 ADB 指令 - 請改用 waitForDeviceAvailable()。

傳回
IDevice	如果裝置在時間到期前連上網路，系統會 IDevice。否則為 null。

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

等待裝置連上網路。

注意：裝置透過 DDMS 顯示後，這個方法就會傳回。這並不保證裝置實際上會回應 ADB 指令 - 請改用 waitForDeviceAvailable()。

參數
time	long：等待的最大時間 (以毫秒為單位)

傳回
IDevice	如果裝置在時間到期前連上網路，系統會 IDevice。否則為 null。

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

等待裝置回應基本 ADB 殼層指令。

參數
waitTime	long：等待時間 (以毫秒為單位)

傳回
boolean	如果裝置在 waitTime 到期前開始回應，則為 true。