IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor


IDevice の状態をモニタリングするための機能を提供します。

現在、デバイスは次の 4 つのイベントが true の場合にのみ「利用可能」と見なされます。 1. デバイスがオンラインである(DDMS/adb で検出可能)(waitForDeviceOnline() 2. デバイスに dev.bootcomplete フラグが設定されている(@link #waitForBootComplete(long)} 3. デバイスのパッケージ マネージャーが応答する(動作していない可能性あり) 4. デバイスの外部ストレージがマウントされている。4. waitForDeviceAvailable() の一部である。

概要

パブリック メソッド

default void attachFinalState(TestDeviceState finalState)

最終状態をアタッチして、到達した場合に waitForDeviceState を中止します。

abstract TestDeviceState getDeviceState()

デバイスの状態を取得します。

abstract String getFastbootSerialNumber()

fastboot モードのシリアル番号を取得します。

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)

Fastboot モードのシリアル番号を設定します。

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)

デバイスが fastbootd になるまで待ちます。

abstract IDevice waitForDeviceInRecovery()

標準の起動タイムアウトを使用して、デバイスがリカバリモードになるまで待ちます。

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 shell コマンドに応答するまで待ちます。

パブリック メソッド

attachFinalState

public void attachFinalState (TestDeviceState finalState)

最終状態をアタッチして、到達した場合に waitForDeviceState を中止します。

パラメータ
finalState TestDeviceState

getDeviceState

public abstract TestDeviceState getDeviceState ()

デバイスの状態を取得します。

戻り値
TestDeviceState デバイスの TestDeviceState

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

fastboot モードのシリアル番号を取得します。

戻り値
String

getMountPoint

public abstract String getMountPoint (String mountName)

マウント ポイントを返します。

IDevice のキャッシュに保存された情報が利用できない場合は、デバイスに直接クエリを実行します。

TODO: この動作を IDevice.getMountPoint(String) に移動

パラメータ
mountName String: マウント ポイントの名前

戻り値
String マウント ポイントまたは null

例外
DeviceNotAvailableException

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)

Fastboot モードのシリアル番号を設定します。

パラメータ
serial String

setIDevice

public abstract void setIDevice (IDevice device)

現在の 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)

デバイスが fastbootd になるまで待ちます。

パラメータ
fastbootPath String: 使用する fastboot バイナリのパス。

waitTime long: 待機する最大時間(ミリ秒)

戻り値
boolean true: 時間切れになる前にデバイスが fastbootd にある場合

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

標準の起動タイムアウトを使用して、デバイスがリカバリモードになるまで待ちます。

戻り値
IDevice IDevice(デバイスが期限切れになる前に復元された場合)。そうでない場合は null

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

デバイスが「adb recovery」状態になるまで待ちます。

パラメータ
waitTime long: 待機する最大時間(ミリ秒)

戻り値
boolean タイムアウト前にデバイスがリカバリ状態にある場合は true、そうでない場合は false です。

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

デバイスが「adb sideload」状態になるまで待ちます。

パラメータ
waitTime long: 待機する最大時間(ミリ秒)

戻り値
boolean タイムアウト前にデバイスがサイドロード中の場合は true、それ以外の場合は false。

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 shell コマンドに応答するまで待ちます。

パラメータ
waitTime long: 待機時間(ミリ秒)

戻り値
boolean waitTime が経過する前にデバイスが応答した場合は true