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) |
abstract void | setDefaultOnlineTimeout (long timeoutMs) |
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) 処理を調整するために回復パス中に呼び出される |
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 を更新します。
以下も参照してください。
ブート完了を待つ
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 。 |