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()の一部である。

まとめ

パブリックメソッド

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 ()

デバイスが応答し、テストできるようになるまで待機します。

abstract IDevice waitForDeviceAvailable (long waitTime)

デバイスが応答し、テストできるようになるまで待機します。

default IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

処理を調整するために回復パス中に呼び出されるwaitForDeviceAvailable(long)の特別なバリアント。

abstract boolean waitForDeviceBootloader (long waitTime)

デバイスがブートローダーに入るのを待ちます。

abstract void waitForDeviceBootloaderStateUpdate ()

デバイスのブートローダーの状態が更新されるのを待ちます

abstract boolean waitForDeviceFastbootd (String fastbootPath, long waitTime)

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

abstract boolean waitForDeviceInRecovery (long waitTime)

デバイスが「adb リカバリ」状態になるまで待機します

abstract IDevice waitForDeviceInRecovery ()

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

abstract boolean waitForDeviceInSideload (long waitTime)

デバイスが「adb サイドロード」状態になるまで待機します

abstract boolean waitForDeviceNotAvailable (long waitTime)

デバイスが利用できなくなるまで待機します

abstract IDevice waitForDeviceOnline ()

標準のブート タイムアウトを使用して、デバイスがオンラインになるまで待機します。

abstract IDevice waitForDeviceOnline (long time)

デバイスがオンラインになるのを待ちます。

abstract boolean waitForDeviceShell (long waitTime)

デバイスが基本的な adb シェル コマンドに応答するまで待機します。

パブリックメソッド

デバイス状態の取得

public abstract TestDeviceState getDeviceState ()

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

戻り値
TestDeviceStateデバイスのTestDeviceState

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

戻り値
String

マウントポイントの取得

public abstract String getMountPoint (String mountName)

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

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

TODO: この動作をIDevice#getMountPoint(String)に移動します。

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

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

投げる
DeviceNotAvailableException

以下も参照してください。

getシリアル番号

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)

デバイスの現在の状態を設定します。

ブート完了を待つ

public abstract boolean waitForBootComplete (long waitTime)

デバイスの起動完了フラグが設定されるまでブロックします

パラメーター
waitTime long : 待機する量 (ミリ秒)

戻り値
boolean

デバイスが利用可能になるまで待機します

public abstract IDevice waitForDeviceAvailable ()

デバイスが応答し、テストできるようになるまで待機します。

waitForDeviceAvailable(long)と同等ですが、デフォルトのデバイス起動タイムアウトを使用します。

戻り値
IDevice時間が経過する前にデバイスがオンラインになった場合、 IDevice 。それ以外の場合はnull

デバイスが利用可能になるまで待機します

public abstract IDevice waitForDeviceAvailable (long waitTime)

デバイスが応答し、テストできるようになるまで待機します。現時点では、これはパッケージ マネージャーと外部ストレージが利用できることを意味します。

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

戻り値
IDevice時間が経過する前にデバイスがオンラインになった場合、 IDevice 。それ以外の場合はnull

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

処理を調整するために回復パス中に呼び出されるwaitForDeviceAvailable(long)の特別なバリアント。

パラメーター
waitTime long

戻り値
IDevice

投げる
DeviceNotAvailableExceptionデバイスが使用できなくなった場合。

デバイスブートローダーの待機

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時間が経過する前にデバイスが fastbootd にある場合はtrue

デバイスの回復を待つ

public abstract boolean waitForDeviceInRecovery (long waitTime)

デバイスが「adb リカバリ」状態になるまで待機します

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

戻り値
booleanタイムアウト前にデバイスが回復状態にある場合は True、それ以外の場合は False。

デバイスの回復を待つ

public abstract IDevice waitForDeviceInRecovery ()

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

戻り値
IDevice時間が経過する前にデバイスが回復した場合、 IDevice 。それ以外の場合はnull

デバイスインサイドロードを待つ

public abstract boolean waitForDeviceInSideload (long waitTime)

デバイスが「adb サイドロード」状態になるまで待機します

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

戻り値
booleanタイムアウト前にデバイスがサイドロード状態にある場合は True、それ以外の場合は False。

デバイスが利用できないのを待ちます

public abstract boolean waitForDeviceNotAvailable (long waitTime)

デバイスが利用できなくなるまで待機します

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

戻り値
booleanデバイスが使用できなくなった場合はtrue

デバイスオンラインで待つ

public abstract IDevice waitForDeviceOnline ()

標準のブート タイムアウトを使用して、デバイスがオンラインになるまで待機します。

注: このメソッドは、DDMS 経由でデバイスが表示されると戻ります。デバイスが実際に adb コマンドに応答するかどうかは保証されません。代わりにwaitForDeviceAvailable()を使用してください。

戻り値
IDevice時間が経過する前にデバイスがオンラインになった場合、 IDevice 。それ以外の場合はnull

デバイスオンラインで待つ

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