IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor


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

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

概要

パブリック メソッド

default void attachFinalState(TestDeviceState finalState)

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

default void clearTcpFastbootMonitor()

デバイス マネージャーのすべての状態をクリアします。

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

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

デバイス マネージャーのすべての状態をクリアします。

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 デバイスが tcp 経由で adb に接続されている場合は true

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