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 を中止するために最終状態をアタッチします。

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

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

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 シェルコマンドに応答するまで待機します。

パブリック メソッド

applyFinalState

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 デバイスが 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 期限が切れる前にデバイスがオンラインになった場合は、IDevicenull できません。

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

デバイスが応答してテストに使用可能になるまで待機します。

waitForDeviceAvailable(long) と同じですが、デフォルトのデバイスを使用します。 あります。

戻り値
IDevice 期限が切れる前にデバイスがオンラインになった場合は、IDevicenull できません。

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 期限が切れる前にデバイスが fastbootd の場合は true

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

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

戻り値
IDevice 時間が経過する前にデバイスがリカバリになった場合、IDevicenull できません。

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 期限が切れる前にデバイスがオンラインになった場合は、IDevicenull できません。

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

デバイスがオンラインになるまで待機します。

注: このメソッドは、DDMS を介してデバイスを認識すると返されます。ただし、 デバイスが実際には adb コマンドに反応する - waitForDeviceAvailable() を使用 してください。

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

戻り値
IDevice 期限が切れる前にデバイスがオンラインになった場合は、IDevicenull できません。

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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