INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
信頼性が高く、少し高いレベルの API を ddmlib IDevice
に提供します。
まとめ
定数 | |
---|---|
int | UNKNOWN_API_LEVEL APIレベルが検出できない場合のデフォルト値 |
パブリックメソッド | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) 最小限のサポート レベルを指定して、機能が現在サポートされているかどうかを確認します。 |
abstract void | clearLogcat () 蓄積された logcat データを削除します。 |
abstract void | deleteFile (String deviceFilePath) デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。 |
abstract boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) 現在の system_server と以前の system_server |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) デバイスとその |
abstract boolean | disableAdbRoot () adb root をオフにします。 |
abstract boolean | doesFileExist (String deviceFilePath) デバイス上にファイルが存在するかどうかを判断するヘルパー メソッド。 |
abstract boolean | enableAdbRoot () adb root をオンにします。 |
abstract String | executeAdbCommand (long timeout, String... commandArgs) 指定されたタイムアウトで adb コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
abstract String | executeAdbCommand (String... commandArgs) adbコマンドをシステムコマンドとして実行するヘルパーメソッド。 |
abstract String | executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs) 指定されたタイムアウトで adb コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) fastboot コマンドをシステムコマンドとして実行するヘルパーメソッド。 |
abstract CommandResult | executeFastbootCommand (String... commandArgs) fastboot コマンドをデフォルトのタイムアウト 2 分でシステム コマンドとして実行するヘルパー メソッド。 |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) 長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) システム環境変数を使用して、長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
abstract String | executeShellCommand (String command) adb シェル コマンドを実行し、出力を |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。 |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。 |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) 指定された adb シェル コマンドを実行し、コマンドが失敗した場合は複数回再試行します。 |
abstract CommandResult | executeShellV2Command (String command) adb シェル コマンドを実行し、コマンド ステータス出力、stdout および stderr が適切に設定された |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) adb シェル コマンドを実行し、コマンド ステータス出力と標準エラー出力が適切に設定された |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) adb シェル コマンドを実行し、コマンド ステータス出力、stdout および stderr が適切に設定された |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。 |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。 |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。 |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。 |
abstract CommandResult | fastbootWipePartition (String partition) デバイスのパーティションを消去するヘルパー メソッド。 |
abstract int | getApiLevel () デバイスの API レベルを取得します。 |
abstract String | getBasebandVersion () このデバイスのベースバンド (無線) バージョンを取得するための便利な方法。 |
abstract Integer | getBattery () デバイスの現在のバッテリー レベルを返すか、バッテリー レベルが利用できない場合は Null を返します。 |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) 指定されたプロパティのブール値を返します。 |
abstract | getBootHistory () ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。 |
abstract | getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) ヘルパー メソッドは、デバイスからのエポックからの指定された時間以降のブート時刻とブート理由、および指定された時間単位を含むブート履歴マップを収集します。 |
abstract String | getBootloaderVersion () このデバイスのブートローダーのバージョンを取得するための便利なメソッド。 |
abstract String | getBuildAlias () デバイスが現在実行しているビルドのエイリアスを取得します。 |
abstract String | getBuildFlavor () デバイスのビルド フレーバーを取得します。 |
abstract String | getBuildId () デバイスが現在実行しているビルドを取得します。 |
abstract String | getBuildSigningKeys () デバイスイメージの署名に使用されるキーのタイプを返します。 通常、Android デバイスは、テスト キー (AOSP など) またはリリース キー (個々のデバイス メーカーによって制御される) で署名されます。 |
abstract DeviceDescriptor | getCachedDeviceDescriptor () デバイスが割り当てられている場合はキャッシュされた |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) デバイスが割り当てられている場合はキャッシュされた |
abstract String[] | getChildren (String deviceFilePath) アクセス許可が原因で機能しない場合がある |
abstract AbstractConnection | getConnection () デバイスに関連付けられた接続を返します。 |
abstract String | getDeviceClass () デバイスクラスを取得します。 |
abstract long | getDeviceDate () デバイスの日付をエポックからのミリ秒単位で返します。 |
abstract DeviceDescriptor | getDeviceDescriptor () 実際のデバイス オブジェクトを渡さずにデバイス情報を取得するには、デバイス情報から |
abstract DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) 実際のデバイス オブジェクトを渡さずにデバイス情報を取得するには、デバイス情報から |
abstract TestDeviceState | getDeviceState () デバイスの状態を取得します。 |
abstract long | getDeviceTimeOffset (Date date) デバイスと指定された |
abstract InputStreamSource | getEmulatorOutput () エミュレータの標準出力と標準エラー出力のストリームを取得します。 |
abstract long | getExternalStoreFreeSpace () デバイスの外部ストレージ上の空き領域の量を決定するヘルパー メソッド。 |
abstract String | getFastbootProductType () 高速ブート モードのときにこのデバイスの製品タイプを取得する便利なメソッド。 |
abstract String | getFastbootProductVariant () 高速ブート モードのときにこのデバイスの製品タイプを取得する便利なメソッド。 |
abstract String | getFastbootSerialNumber () fastboot モードのシリアル番号を返します。 |
abstract String | getFastbootVariable (String variableName) 指定された fastboot 変数値をデバイスから取得します。 |
abstract IFileEntry | getFileEntry (String path) デバイス上のリモート ファイルへの参照を取得します。 |
abstract IDevice | getIDevice () 関連付けられた ddmlib |
abstract long | getIntProperty (String name, long defaultValue) デバイスから指定されたプロパティの整数値を返します。 |
abstract long | getLastExpectedRebootTimeMillis () |
abstract int | getLaunchApiLevel () デバイスの最初に起動された API レベルを取得します。 |
abstract InputStreamSource | getLogcat () logcat データのスナップショット ストリームを取得します。 |
abstract InputStreamSource | getLogcat (int maxBytes) キャプチャされた logcat データの最後の |
abstract InputStreamSource | getLogcatDump () デバイスの現在の logcat のダンプを取得します。 |
abstract InputStreamSource | getLogcatSince (long date) 指定された日付から始まる、キャプチャされた logcat データのスナップショット ストリームを取得します。 |
abstract String | getMountPoint (String mountName) マウントポイントを返します。 |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) 指定されたマウントポイント パスに対応する |
abstract | getMountPointInfo () デバイス上の /proc/mounts 内の情報の解析されたバージョンを返します。 |
abstract long | getPartitionFreeSpace (String partition) デバイス パーティション上の空き領域の量を決定するヘルパー メソッド。 |
abstract ProcessInfo | getProcessByName (String processName) ヘルパー メソッドは、「pidof」および「stat」コマンドを実行し、指定されたプロセスの PID とプロセス開始時間を含む |
abstract String | getProcessPid (String process) サービスの PID を返すか、何か問題があった場合は null を返します。 |
abstract String | getProductType () このデバイスの製品タイプを取得するための便利なメソッド。 |
abstract String | getProductVariant () このデバイスの製品バリアントを取得するための便利な方法。 |
abstract String | getProperty (String name) デバイスから指定されたプロパティ値を取得します。 |
abstract ITestDevice.RecoveryMode | getRecoveryMode () デバイスに使用されている現在の回復モードを取得します。 |
abstract String | getSerialNumber () このデバイスのシリアル番号を取得するための便利なメソッド。 |
abstract | getTombstones () デバイスからトゥームストーンのリストを取得して返します。 |
abstract long | getTotalMemory () 物理メモリの合計サイズをバイト単位で返します。内部エラーの場合は -1 を返します。 |
abstract boolean | getUseFastbootErase () デバイス上のパーティションを消去するために fastboot 消去または fastboot フォーマットを使用するかどうかを取得します。 |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する |
abstract boolean | isBypassLowTargetSdkBlockSupported () デバイス上のプラットフォームがアプリのインストール時の低ターゲット SDK ブロックのバイパスをサポートしているかどうかを確認します |
abstract boolean | isDebugfsMounted () debugfs がマウントされているかどうかを確認します。 |
abstract boolean | isDeviceEncrypted () デバイスが暗号化されているかどうかを返します。 |
abstract boolean | isDirectory (String deviceFilePath) デバイス上のパスがディレクトリの場合は True を返し、それ以外の場合は false を返します。 |
abstract boolean | isEncryptionSupported () デバイスで暗号化がサポートされているかどうかを返します。 |
abstract boolean | isExecutable (String fullPath) デバイス上のファイル パスが実行可能ファイルの場合は True を返し、それ以外の場合は false を返します。 |
abstract boolean | isHeadless () デバイスがヘッドレス (画面なし) の場合は true を返し、それ以外の場合は false を返します。 |
abstract boolean | isRuntimePermissionSupported () デバイス上のプラットフォームが実行時権限付与をサポートしているかどうかを確認する |
abstract boolean | isStateBootloaderOrFastbootd () デバイスが |
abstract boolean | logAnrs ( ITestLogger logger) デバイスから ANR を収集して記録します。 |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) デバイスの logcat にメッセージを記録します。 |
abstract void | mountDebugfs () debugfs をマウントします。 |
abstract void | nonBlockingReboot () デバイスを再起動するコマンドを発行し、コマンドが完了し、デバイスが adb に認識されなくなったときに戻ります。 |
abstract void | postBootSetup () 毎回の起動後にテスト用にデバイスを構成する手順を実行します。 |
default void | postInvocationTearDown () このメソッドは廃止されました。代わりに |
abstract void | postInvocationTearDown (Throwable invocationException) デバイス固有の必要なクリーンアップの追加手順は、呼び出しの完了後に実行されます。 |
default void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) 呼び出しフローの前にデバイス上で実行される、デバイス固有の必要なセットアップのための追加の手順。 |
abstract boolean | pullDir (String deviceFilePath, File localDir) デバイスからディレクトリの内容を再帰的にプルします。 |
abstract File | pullFile (String remoteFilePath, int userId) デバイスからファイルを取得し、それをローカルの一時 |
abstract File | pullFile (String remoteFilePath) デバイスからファイルを取得し、それをローカルの一時 |
abstract boolean | pullFile (String remoteFilePath, File localFile) デバイスからファイルを取得します。 |
abstract boolean | pullFile (String remoteFilePath, File localFile, int userId) デバイスからファイルを取得します。 |
abstract String | pullFileContents (String remoteFilePath) デバイスからファイルを取得し、その内容を返します。 |
abstract File | pullFileFromExternal (String remoteFilePath) デバイスの外部ストレージからファイルを取得し、それをローカルの一時 |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) フィルタリングされた一部のディレクトリを除外しながら、ディレクトリの内容をデバイスに再帰的にプッシュします。 |
abstract boolean | pushDir (File localDir, String deviceFilePath) ディレクトリの内容をデバイスに再帰的にプッシュします。 |
abstract boolean | pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) |
abstract boolean | pushFile (File localFile, String deviceFilePath) ファイルをデバイスにプッシュします。 |
abstract boolean | pushString (String contents, String deviceFilePath) 文字列から作成されたファイルをデバイスにプッシュします |
abstract void | reboot () デバイスを adb モードで再起動します。 |
abstract void | reboot (String reason) デバイスを再起動して、再起動後も保持されるように指定された |
abstract void | rebootIntoBootloader () デバイスをブートローダー モードで再起動します。 |
abstract void | rebootIntoFastbootd () デバイスを fastbootd モードで再起動します。 |
abstract void | rebootIntoRecovery () デバイスを adb リカバリ モードで再起動します。 |
abstract void | rebootIntoSideload (boolean autoReboot) デバイスを adb サイドロード モードで再起動します (これは回復中の特別なモードであることに注意してください) デバイスがサイドロード モードに入るまでブロックします |
abstract void | rebootIntoSideload () デバイスを adb サイドロード モードで再起動します (これは回復中の特別なモードであることに注意してください) デバイスがサイドロード モードに入るまでブロックします |
abstract void | rebootUntilOnline () |
abstract void | rebootUntilOnline (String reason) |
abstract void | rebootUserspace () デバイスのユーザースペース部分のみを再起動します。 |
abstract void | rebootUserspaceUntilOnline () |
abstract void | remountSystemReadOnly () デバイス上のシステム パーティションを読み取り専用にします。 |
abstract void | remountSystemWritable () デバイス上のシステム パーティションを書き込み可能にします。 |
abstract void | remountVendorReadOnly () デバイス上のベンダー パーティションを読み取り専用にします。 |
abstract void | remountVendorWritable () デバイス上のベンダー パーティションを書き込み可能にします。 |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) パラメーターとして渡された 1 つ以上のリスナーを使用 |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) インストルメンテーション テストを実行し、デバイスのリカバリを提供します。 |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) |
abstract void | setDate (Date date) デバイスに日付を設定します 注: デバイスの日付を設定するには root が必要です |
abstract void | setOptions ( TestDeviceOptions options) デバイスの |
abstract boolean | setProperty (String propKey, String propValue) 指定されたプロパティ値をデバイスに設定します。 |
abstract void | setRecovery ( IDeviceRecovery recovery) このデバイスに使用する |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) デバイスに使用する現在の回復モードを設定します。 |
abstract void | setUseFastbootErase (boolean useFastbootErase) デバイス上のパーティションを消去するために fastboot 消去または fastboot フォーマットを使用するかどうかを設定します。 |
abstract void | startLogcat () バックグラウンドでデバイスからの logcat 出力のキャプチャを開始します。 |
abstract void | stopEmulatorOutput () エミュレータ出力を閉じて削除します。 |
abstract void | stopLogcat () デバイスからの logcat 出力のキャプチャを停止し、現在保存されている logcat データを破棄します。 |
abstract String | switchToAdbTcp () デバイスを adb-over-tcp モードに切り替えます。 |
abstract boolean | switchToAdbUsb () デバイスを adb over USB モードに切り替えます。 |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) ローカル ファイル ディレクトリの内容をデバイスに増分同期します。 |
abstract boolean | unlockDevice () デバイスが暗号化状態にある場合、デバイスのロックを解除します。 |
abstract void | unmountDebugfs () debugfs をアンマウントします。 |
abstract boolean | waitForBootComplete (long timeOut) デバイスのブート完了フラグが設定されるまでブロックします。 |
abstract boolean | waitForDeviceAvailable () デバイスが応答し、テストできるようになるまで待ちます。 |
abstract boolean | waitForDeviceAvailable (long waitTime) デバイスが応答し、テストできるようになるまで待ちます。 |
abstract boolean | waitForDeviceAvailableInRecoverPath (long waitTime) 回復パスを考慮せずに、デバイスが応答して使用可能になるまで待機します。 |
abstract void | waitForDeviceBootloader () fastboot 経由でデバイスが表示されるまでブロックします。 |
abstract boolean | waitForDeviceInRecovery (long waitTime) デバイスが「adb Recovery」状態になることをブロックします (これは |
abstract boolean | waitForDeviceInSideload (long waitTime) デバイスが「adb サイドロード」状態になるためのブロック |
abstract boolean | waitForDeviceNotAvailable (long waitTime) デバイスが利用できないようにブロックします。つまり、adb から欠落しています。 |
abstract void | waitForDeviceOnline () デバイスが adb 経由で表示されるまでブロックします。 |
abstract void | waitForDeviceOnline (long waitTime) デバイスが adb 経由で表示されるまでブロックします。 |
abstract boolean | waitForDeviceShell (long waitTime) デバイスが基本的な adb シェル コマンドに応答するまで待機します。 |
定数
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
APIレベルが検出できない場合のデフォルト値
定数値: -1 (0xffffffff)
パブリックメソッド
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
最小限のサポート レベルを指定して、機能が現在サポートされているかどうかを確認します。この方法では、API レベルが上がる前に、まだリリースされていない機能が考慮されます。
パラメーター | |
---|---|
strictMinLevel | int : 機能をサポートする厳密な最小可能レベル。 |
戻り値 | |
---|---|
boolean | レベルがサポートされている場合は True。それ以外の場合は false。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
クリアログキャット
public abstract void clearLogcat ()
蓄積された logcat データを削除します。
これは、ITestDevice#getLogcat()
が特定の時点 (新しいデバイス ビルドをフラッシュした後など) 以降に生成されたログ データのみを返すようにする場合に便利です。 ファイルを削除する
public abstract void deleteFile (String deviceFilePath)
デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。
パラメーター | |
---|---|
deviceFilePath | String : デバイス上のファイルの絶対パス。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
デバイスソフト再起動
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
現在の system_server と以前の system_server ProcessInfo
を比較することで、デバイスがソフト再起動したかどうかを確認するヘルパー メソッド。 getProcessByName(String)
を使用してProcessInfo
を取得します。
パラメーター | |
---|---|
prevSystemServerProcess | ProcessInfo : 以前の system_server プロセスProcessInfo 。 |
戻り値 | |
---|---|
boolean | デバイスがソフト再起動された場合はtrue |
投げる | |
---|---|
RuntimeException | デバイスに異常な起動理由がある場合 |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
デバイスソフト再起動以来
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
デバイスとそのERROR(/TimeUnit)
からのエポック以降の UTC 時間以降にデバイスがソフト再起動したかどうかを確認するヘルパー メソッド。ソフト再起動とは、デバイスのハード リブート (例: 要求された再起動) 以外で再起動された system_server を指します。現在のデバイスの utcEpochTime (ミリ秒単位) はgetDeviceDate()
メソッドで取得できます。
パラメーター | |
---|---|
utcEpochTime | long : エポックからの秒単位のデバイス時間。 |
timeUnit | TimeUnit : 指定された utcEpochTime の時間単位TimeUnit 。 |
戻り値 | |
---|---|
boolean | デバイスがソフト再起動された場合はtrue |
投げる | |
---|---|
RuntimeException | デバイスに異常な起動理由がある場合 |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
AdbRootを無効にする
public abstract boolean disableAdbRoot ()
adb root をオフにします。
adb root を無効にすると、デバイスが adb から切断される可能性があります。このメソッドは、デバイスが使用可能になるまでブロックされます。戻り値 | |
---|---|
boolean | 成功した場合はtrue 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
ファイルが存在しますか
public abstract boolean doesFileExist (String deviceFilePath)
デバイス上にファイルが存在するかどうかを判断するヘルパー メソッド。
パラメーター | |
---|---|
deviceFilePath | String : チェックするデバイス上のファイルの絶対パス |
戻り値 | |
---|---|
boolean | ファイルが存在する場合はtrue 、存在しない場合はfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
AdbRoot を有効にする
public abstract boolean enableAdbRoot ()
adb root をオンにします。 「enable-root」設定が「false」の場合、メッセージをログに記録し、root を有効にせずに戻ります。
adb root を有効にすると、デバイスが adb から切断される可能性があります。このメソッドは、デバイスが使用可能になるまでブロックされます。戻り値 | |
---|---|
boolean | 成功した場合はtrue 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行Adbコマンド
public abstract String executeAdbCommand (long timeout, String... commandArgs)
指定されたタイムアウトで adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
代わりに、可能な限り、 executeShellCommand(String)
を使用してください。このメソッドの方が障害検出とパフォーマンスが向上します。
パラメーター | |
---|---|
timeout | long : デバイスが応答なしとみなされるまでの時間 (ミリ秒)、タイムアウトなしの場合は 0L |
commandArgs | String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String | コマンドからの標準出力。コマンドの実行に失敗した場合はnull 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行Adbコマンド
public abstract String executeAdbCommand (String... commandArgs)
adbコマンドをシステムコマンドとして実行するヘルパーメソッド。
代わりに、可能な限り、executeShellCommand(String)
を使用してください。このメソッドの方が障害検出とパフォーマンスが向上します。パラメーター | |
---|---|
commandArgs | String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String | コマンドからの標準出力。コマンドの実行に失敗した場合はnull 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行Adbコマンド
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
指定されたタイムアウトで adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
代わりに、可能な限り、 executeShellCommand(String)
を使用してください。このメソッドの方が障害検出とパフォーマンスが向上します。
パラメーター | |
---|---|
timeout | long : デバイスが応答なしとみなされるまでの時間 (ミリ秒)、タイムアウトなしの場合は 0L |
envMap | |
commandArgs | String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String | コマンドからの標準出力。コマンドの実行に失敗した場合はnull 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
高速起動コマンドの実行
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
fastboot コマンドをシステムコマンドとして実行するヘルパーメソッド。
デバイスがすでに fastboot モードになっている場合に使用されることが予想されます。パラメーター | |
---|---|
timeout | long : コマンドの有効期限が切れるまでの時間 (ミリ秒) |
commandArgs | String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult | コマンドの出力を含む CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
高速起動コマンドの実行
public abstract CommandResult executeFastbootCommand (String... commandArgs)
fastboot コマンドをデフォルトのタイムアウト 2 分でシステム コマンドとして実行するヘルパー メソッド。
デバイスがすでに fastboot モードになっている場合に使用されることが予想されます。
パラメーター | |
---|---|
commandArgs | String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult | コマンドの出力を含む CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
executeLongFastbootコマンド
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。
より長いタイムアウトを使用することを除いて、executeFastbootCommand(String)
と同じです。パラメーター | |
---|---|
commandArgs | String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult | コマンドの出力を含む CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
executeLongFastbootコマンド
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
システム環境変数を使用して、長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。
より長いタイムアウトを使用することを除いて、 executeFastbootCommand(String)
と同じです。
パラメーター | |
---|---|
envVarMap | |
commandArgs | String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult | コマンドの出力を含む CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
シェルコマンドの実行
public abstract String executeShellCommand (String command)
adb シェル コマンドを実行し、出力をString
として返すヘルパー メソッド。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
戻り値 | |
---|---|
String | シェルの出力 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
シェルコマンドの実行
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
receiver | IShellOutputReceiver : シェル出力を送信する先のIShellOutputReceiver 。 |
maxTimeToOutputShellResponse | long : コマンドが応答を出力しないことが許可される最大時間。 timeUnit で指定された単位 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts | int : 例外によりコマンドが失敗した場合にコマンドを再試行する最大回数。 retryAttempts正常に実行されなかった場合は、DeviceNotResponsiveException がスローされます。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
シェルコマンドの実行
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
receiver | IShellOutputReceiver : シェル出力を送信する先のIShellOutputReceiver 。 |
maxTimeoutForCommand | long : コマンドが完了するまでの最大タイムアウト。 timeUnit で指定された単位 |
maxTimeToOutputShellResponse | long : コマンドが応答を出力しないことが許可される最大時間。 timeUnit で指定された単位 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts | int : 例外によりコマンドが失敗した場合にコマンドを再試行する最大回数。 retryAttempts正常に実行されなかった場合は、DeviceNotResponsiveException がスローされます。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
シェルコマンドの実行
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
指定された adb シェル コマンドを実行し、コマンドが失敗した場合は複数回再試行します。
デフォルト値を使用した、より単純な形式のexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
。パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
receiver | IShellOutputReceiver : シェル出力を送信する先のIShellOutputReceiver 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command)
adb シェル コマンドを実行し、コマンド ステータス出力、stdout および stderr が適切に設定されたCommandResult
として結果を返すヘルパー メソッド。
パラメーター | |
---|---|
command | String : 実行するコマンド。 |
戻り値 | |
---|---|
CommandResult | 結果はCommandResult に格納されます。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
adb シェル コマンドを実行し、コマンド ステータス出力と標準エラー出力が適切に設定されたCommandResult
として結果を返すヘルパー メソッド。 stdout は指定されたストリームに送信されます。
パラメーター | |
---|---|
command | String : 実行するコマンド。 |
pipeToOutput | OutputStream : 標準出力がリダイレクトされるERROR(/OutputStream) 、または null。 |
戻り値 | |
---|---|
CommandResult | 結果はCommandResult に格納されます。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
adb シェル コマンドを実行し、コマンド ステータス出力、stdout および stderr が適切に設定されたCommandResult
として結果を返すヘルパー メソッド。
パラメーター | |
---|---|
command | String : 実行するコマンド。 |
pipeAsInput | File : コマンドへの入力としてパイプされるERROR(/File) 、または null。 |
戻り値 | |
---|---|
CommandResult | 結果はCommandResult に格納されます。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
maxTimeoutForCommand | long : コマンドが完了するまでの最大タイムアウト。 timeUnit で指定された単位 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts | int : 例外によりコマンドが失敗した場合にコマンドを再試行する最大回数。 retryAttempts正常に実行されなかった場合は、DeviceNotResponsiveException がスローされます。 |
戻り値 | |
---|---|
CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
以下も参照してください。
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
maxTimeoutForCommand | long : コマンドが完了するまでの最大タイムアウト。 timeUnit で指定された単位 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse の単位 |
戻り値 | |
---|---|
CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
以下も参照してください。
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
pipeAsInput | File : コマンドへの入力としてパイプされるERROR(/File) 、または null。 |
pipeToOutput | OutputStream : 標準出力がリダイレクトされるERROR(/OutputStream) 、または null。 |
maxTimeoutForCommand | long : コマンドが完了するまでの最大タイムアウト。 timeUnit で指定された単位 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts | int : 例外によりコマンドが失敗した場合にコマンドを再試行する最大回数。 retryAttempts正常に実行されなかった場合は、DeviceNotResponsiveException がスローされます。 |
戻り値 | |
---|---|
CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
以下も参照してください。
実行ShellV2コマンド
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するためのパラメータをさらに指定して、adb シェル コマンドを実行します。
パラメーター | |
---|---|
command | String : 実行する adb シェル コマンド |
pipeAsInput | File : コマンドへの入力としてパイプされるERROR(/File) 、または null。 |
pipeToOutput | OutputStream : 標準出力がリダイレクトされるERROR(/OutputStream) 、または null。 |
pipeToError | OutputStream : 標準エラーがリダイレクトされるERROR(/OutputStream) 、または null。 |
maxTimeoutForCommand | long : コマンドが完了するまでの最大タイムアウト。 timeUnit で指定された単位 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts | int : 例外によりコマンドが失敗した場合にコマンドを再試行する最大回数。 retryAttempts正常に実行されなかった場合は、DeviceNotResponsiveException がスローされます。 |
戻り値 | |
---|---|
CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
以下も参照してください。
高速ブートワイプパーティション
public abstract CommandResult fastbootWipePartition (String partition)
デバイスのパーティションを消去するヘルパー メソッド。
getUseFastbootErase()
がtrue
の場合、fastboot 消去がパーティションのワイプに使用されます。デバイスは、次回デバイスを起動するときにファイルシステムを作成する必要があります。それ以外の場合は、デバイス上に新しいファイルシステムを作成する fastboot 形式が使用されます。デバイスがすでに fastboot モードになっている場合に使用されることが予想されます。パラメーター | |
---|---|
partition | String : ワイプするパーティション |
戻り値 | |
---|---|
CommandResult | コマンドの出力を含む CommandResult |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getApiLevel
public abstract int getApiLevel ()
デバイスの API レベルを取得します。デフォルトはUNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int | デバイスの API レベルを示す整数 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
このデバイスのベースバンド (無線) バージョンを取得するための便利な方法。無線バージョンの取得はデバイス固有であるため、すべてのデバイスに対して正しい情報が返されるとは限りません。このメソッドは、gsm.version.baseband プロパティに依存して正しいバージョン情報を返します。これは一部の CDMA デバイスでは正確ではなく、ここで返されるバージョンは fastboot から報告されるバージョンと一致しない可能性があり、CDMA 無線のバージョンを返さない場合があります。 TL;DR このメソッドは、 gsm.version.baseband プロパティがfastboot getvar version-baseband
によって返されるバージョンと同じである場合にのみ、正確なバージョンを報告します。
戻り値 | |
---|---|
String | String ベースバンド バージョン、または決定できない場合はnull (デバイスに無線がない、またはバージョン文字列を読み取れない) |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
バッテリーを取得する
public abstract Integer getBattery ()
デバイスの現在のバッテリー レベルを返すか、バッテリー レベルが利用できない場合は Null を返します。
戻り値 | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
指定されたプロパティのブール値を返します。
パラメーター | |
---|---|
name | String : プロパティ名 |
defaultValue | boolean : プロパティが空か存在しない場合に返されるデフォルト値。 |
戻り値 | |
---|---|
boolean | プロパティの値が"1" 、 "y" 、 "yes" 、 "on" または"true" の場合はtrue 、プロパティの値が"0" 、 "n" 、 "no" 、 "off" の場合はfalse "false" 、それ以外の場合はdefaultValue 。 |
投げる | |
---|---|
DeviceNotAvailableException |
ブート履歴の取得
public abstractgetBootHistory ()
ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。
戻り値 | |
---|---|
ブート時間 (エポックからの秒単位の UTC 時間) とブート理由のマップ |
投げる | |
---|---|
DeviceNotAvailableException |
ブート履歴の取得
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
ヘルパー メソッドは、デバイスからのエポックからの指定された時間以降のブート時刻とブート理由、および指定された時間単位を含むブート履歴マップを収集します。現在のデバイスの utcEpochTime (ミリ秒単位) はgetDeviceDate()
メソッドで取得できます。
パラメーター | |
---|---|
utcEpochTime | long : エポック以降のデバイス時間。 |
timeUnit | TimeUnit : 時間単位TimeUnit 。 |
戻り値 | |
---|---|
ブート時間 (エポックからの秒単位の UTC 時間) とブート理由のマップ |
投げる | |
---|---|
DeviceNotAvailableException |
ブートローダーのバージョンの取得
public abstract String getBootloaderVersion ()
このデバイスのブートローダーのバージョンを取得するための便利なメソッド。
デバイスの現在の状態からブートローダーのバージョンを取得しようとします。 (つまり、デバイスが fastboot モードの場合、fastboot からバージョンを取得しようとします)戻り値 | |
---|---|
String | String ブートローダーのバージョン、または見つからない場合はnull |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getBuildAlias
public abstract String getBuildAlias ()
デバイスが現在実行しているビルドのエイリアスを取得します。
ビルド エイリアスは通常、ビルド ID (通常は Nexus ビルドの数値) よりも読みやすい文字列です。たとえば、最終的な Android 4.2 リリースのビルド エイリアスは JDQ39、ビルド ID は 573038 です。
戻り値 | |
---|---|
String | ビルド エイリアス、または取得できなかった場合はビルド ID にフォールバックします |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
デバイスのビルド フレーバーを取得します。
戻り値 | |
---|---|
String | ビルドフレーバー、または取得できなかった場合は null |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
デバイスが現在実行しているビルドを取得します。
戻り値 | |
---|---|
String | ビルド ID または取得できなかった場合はIBuildInfo#UNKNOWN_BUILD_ID |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
デバイスイメージの署名に使用されるキーのタイプを返します。
通常、Android デバイスは、テスト キー (AOSP など) またはリリース キー (個々のデバイス メーカーによって制御される) で署名されます。
戻り値 | |
---|---|
String | 署名キーが見つかった場合は、それ以外の場合は null。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
デバイスが割り当てられている場合はキャッシュされたDeviceDescriptor
を返し、それ以外の場合は現在のDeviceDescriptor
を返します。
戻り値 | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
デバイスが割り当てられている場合はキャッシュされたDeviceDescriptor
を返し、それ以外の場合は現在のDeviceDescriptor
を返します。
パラメーター | |
---|---|
shortDescriptor | boolean : 記述子を最小限の情報に制限するかどうか |
戻り値 | |
---|---|
DeviceDescriptor |
取得
public abstract String[] getChildren (String deviceFilePath)
アクセス許可が原因で機能しない場合があるIFileEntry
を使用する代わりに。
パラメーター | |
---|---|
deviceFilePath | String : 検索を実行するデバイス上のパスです。 |
戻り値 | |
---|---|
String[] | デバイス上のパス内のすべてのファイルを含む文字列の配列。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
接続を取得する
public abstract AbstractConnection getConnection ()
デバイスに関連付けられた接続を返します。
戻り値 | |
---|---|
AbstractConnection |
getDeviceDate
public abstract long getDeviceDate ()
デバイスの日付をエポックからのミリ秒単位で返します。
戻り値 | |
---|---|
long | エポック形式でのデバイスの日付。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
実際のデバイス オブジェクトを渡さずにデバイス情報を取得するには、デバイス情報からDeviceDescriptor
を返します。
戻り値 | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
実際のデバイス オブジェクトを渡さずにデバイス情報を取得するには、デバイス情報からDeviceDescriptor
を返します。
パラメーター | |
---|---|
shortDescriptor | boolean : 記述子を最小限の情報に制限するかどうか |
戻り値 | |
---|---|
DeviceDescriptor |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
デバイスと指定されたERROR(/Date)
の間の時差を取得するヘルパー。内部的にエポックタイムを使用します。
パラメーター | |
---|---|
date | Date |
戻り値 | |
---|---|
long | ミリ秒単位の違い |
投げる | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
エミュレータの標準出力と標準エラー出力のストリームを取得します。
戻り値 | |
---|---|
InputStreamSource | エミュレータの出力 |
get外部ストアフリースペース
public abstract long getExternalStoreFreeSpace ()
デバイスの外部ストレージ上の空き領域の量を決定するヘルパー メソッド。
戻り値 | |
---|---|
long | 空き容量 (KB) |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getFastbootProductType
public abstract String getFastbootProductType ()
高速ブート モードのときにこのデバイスの製品タイプを取得する便利なメソッド。
この方法は、デバイスを高速ブートする必要がある場合にのみ使用してください。この場合、一般的なgetProductType()
メソッドよりも少し安全なバリアントです。ITestDevice は、デバイスが不正な状態にある場合、または応答しない場合にデバイスを fastboot に回復することを認識しているためです。戻り値 | |
---|---|
String | String 製品タイプ名、または判断できない場合はnull |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
高速ブート モードのときにこのデバイスの製品タイプを取得する便利なメソッド。
この方法は、デバイスを高速ブートする必要がある場合にのみ使用してください。この場合、一般的なgetProductType()
メソッドよりも少し安全なバリアントです。ITestDevice は、デバイスが不正な状態にある場合、または応答しない場合にデバイスを fastboot に回復することを認識しているためです。戻り値 | |
---|---|
String | String 製品タイプ名、または判断できない場合はnull |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
fastboot モードのシリアル番号を返します。
戻り値 | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
指定された fastboot 変数値をデバイスから取得します。
パラメーター | |
---|---|
variableName | String : 変数名 |
戻り値 | |
---|---|
String | プロパティ値、または存在しない場合はnull |
投げる | |
---|---|
| UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
デバイス上のリモート ファイルへの参照を取得します。
パラメーター | |
---|---|
path | String : 取得するファイルのパス。絶対パスまたは「/」を基準とした相対パスを指定できます。 (つまり、「/system」と「system」の両方の構文がサポートされています) |
戻り値 | |
---|---|
IFileEntry | IFileEntry 、または指定されたpathにファイルが見つからない場合はnull |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
関連付けられた ddmlib IDevice
への参照を返します。
IDevice
が割り当てられる場合があります。したがって、呼び出し元はIDevice
への参照を保持すべきではありません。その参照は古くなってしまう可能性があるからです。戻り値 | |
---|---|
IDevice | IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
デバイスから指定されたプロパティの整数値を返します。
パラメーター | |
---|---|
name | String : プロパティ名 |
defaultValue | long : プロパティが空か存在しない場合に返されるデフォルト値。 |
戻り値 | |
---|---|
long | プロパティ値、またはプロパティが空、存在しない、または整数値を持たない場合は、 defaultValue 。 |
投げる | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
System.currentTimeMillis()
によって返される EPOCH 以降、Tradefed API が最後に再起動をトリガーした時間をミリ秒単位で返します。
戻り値 | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
デバイスの最初に起動された API レベルを取得します。デフォルトはUNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int | デバイスの最初に起動された API レベルを示す整数 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
logcat データのスナップショット ストリームを取得します。
2 つのモードで動作します。
TestDeviceOptions.getMaxLogcatDataSize()
バイトが返されます。戻り値 | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
キャプチャされた logcat データの最後のmaxBytes
のスナップショット ストリームを取得します。
getLogcat()
ショット全体を取得するという潜在的に大きなディスクスペースのペナルティを負うことなく、キャプチャされたログキャットデータの頻繁なスナップショットをキャプチャしたい場合に役立ちます。
パラメーター | |
---|---|
maxBytes | int :返すデータの最大量。メモリに快適に収まることができる量である必要があります |
戻り値 | |
---|---|
InputStreamSource |
getlogcatdump
public abstract InputStreamSource getLogcatDump ()
デバイス用の現在のログキャットのダンプを取得します。 getLogcat()
とは異なり、このメソッドは常にログキャットの静的ダンプを返します。
デバイスが到達できない場合、何も返されないという欠点があります。
戻り値 | |
---|---|
InputStreamSource | logcatデータのInputStreamSource 。 LogCatデータをキャプチャできない場合、空のストリームが返されます。 |
GetLogcatsince
public abstract InputStreamSource getLogcatSince (long date)
提供された日付を開始するキャプチャされたログキャットデータのスナップショットストリームをつかみます。デバイス上の時間getDeviceDate()
使用する必要があります。
パラメーター | |
---|---|
date | long :スナップショットをいつ開始するかという時代のエポック形式以来、ミリ秒で存在するまで。 (「日付 +%s」を使用して取得できます) |
戻り値 | |
---|---|
InputStreamSource |
GetMountPoint
public abstract String getMountPoint (String mountName)
マウントポイントを返します。
IDevice
のキャッシュされた情報が利用できない場合は、デバイスを直接照会します。 TODO:この動作をIDevice#getMountPoint(String)
に移動しますパラメーター | |
---|---|
mountName | String :マウントポイントの名前 |
戻り値 | |
---|---|
String | マウントポイントまたはnull |
以下も参照してください。
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
指定されたマウントポイントパスに対応するMountPointInfo
を返します。または、そのパスにマウントされていない、またはMountPointとして /Proc /Mountsに表示されない場合はnull
返します。
パラメーター | |
---|---|
mountpoint | String |
戻り値 | |
---|---|
ITestDevice.MountPointInfo | 「/proc/mounts」に情報を含むMountPointInfo のERROR(/List) |
投げる | |
---|---|
DeviceNotAvailableException |
以下も参照してください。
getMountPointInfo
public abstractgetMountPointInfo ()
デバイスに /proc /マウントの情報の解析バージョンを返します
戻り値 | |
---|---|
「/proc/mounts」に情報を含むMountPointInfo のERROR(/List) |
投げる | |
---|---|
DeviceNotAvailableException |
getPartitionFreespace
public abstract long getPartitionFreeSpace (String partition)
デバイスパーティションの自由空間の量を決定するヘルパー方法。
パラメーター | |
---|---|
partition | String |
戻り値 | |
---|---|
long | KBの空きスペースの量 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getProcessByname
public abstract ProcessInfo getProcessByName (String processName)
ヘルパーメソッドは、「PIDOF」および「STAT」コマンドを実行し、PIDおよびProcessの開始時間を使用してProcessInfo
オブジェクトを返します。
パラメーター | |
---|---|
processName | String :Proces名文字列。 |
戻り値 | |
---|---|
ProcessInfo | 指定されたProcessNameのProcessInfo |
投げる | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
何かがうまくいかなかった場合、サービスまたはヌルのPIDを返します。
パラメーター | |
---|---|
process | String :Proces名文字列。 |
戻り値 | |
---|---|
String |
投げる | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
このデバイスの製品タイプを取得するための利便性方法。
この方法は、デバイスがADBまたはFastBootモードのいずれかである場合に機能します。戻り値 | |
---|---|
String | String 製品タイプ名。ヌルにはなりません |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合、または製品タイプを決定できない場合 |
GetProductVariant
public abstract String getProductVariant ()
このデバイスの製品バリアントを取得するための利便性方法。
この方法は、デバイスがADBまたはFastBootモードのいずれかである場合に機能します。戻り値 | |
---|---|
String | String 製品のバリアント名またはnull が決定できない場合 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
getプロパティ
public abstract String getProperty (String name)
デバイスから指定されたプロパティ値を取得します。
パラメーター | |
---|---|
name | String :プロパティ名 |
戻り値 | |
---|---|
String | 存在しない場合のプロパティ値またはnull |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
GetRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
デバイスに使用される現在の回復モードを取得します。
戻り値 | |
---|---|
ITestDevice.RecoveryMode | デバイスに使用される現在の回復モード。 |
GetSerialNumber
public abstract String getSerialNumber ()
このデバイスのシリアル番号を取得するための利便性方法。
戻り値 | |
---|---|
String | String シリアル番号 |
Gettomstones
public abstractgetTombstones ()
デバイスから墓石のリストを取得して返します。ルートが必要です。
メソッドは最適なものであるため、何らかの理由で1つの墓石が引っ張られない場合、リストから欠落します。 DeviceNotAvailableException
のみがメソッドを早期に終了します。
戻り値 | |
---|---|
墓石がない場合は空の墓石ファイルのリスト。 |
投げる | |
---|---|
DeviceNotAvailableException |
以下も参照してください。
gettotalmemory
public abstract long getTotalMemory ()
内部エラーの場合、バイトまたは-1の合計物理メモリサイズを返します
戻り値 | |
---|---|
long |
getUseFastBooterase
public abstract boolean getUseFastbootErase ()
FastBoot EraseまたはFastBoot形式を使用して、デバイス上のパーティションをワイプするかどうかを取得します。
戻り値 | |
---|---|
boolean | FastBoot消去が使用される場合、またはFastBoot形式false 使用される場合はtrue 。 |
以下も参照してください。
isadbroot
public abstract boolean isAdbRoot ()
戻り値 | |
---|---|
boolean | false デバイスに現在ADBルートがある場合、それ以外の場合はtrue 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
ISADBTCP
public abstract boolean isAdbTcp ()
戻り値 | |
---|---|
boolean | true デバイスがADBオーバーTCPに接続されている場合、それ以外の場合はfalse 。 |
IsAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
プラットフォーム上のプラットフォームがアプリの列挙をサポートするかどうかを確認します
戻り値 | |
---|---|
boolean | アプリの列挙がサポートされている場合、それ以外の場合はtrue |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isbypasslowtargetsdkblocksupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
プラットフォーム上のプラットフォームがアプリのインストールで低いターゲットSDKブロックのバイパスをサポートするかどうかを確認します
戻り値 | |
---|---|
boolean | 低いターゲットSDKブロックがサポートされている場合、それ以外の場合はtrue |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isdebugfsmounted
public abstract boolean isDebugfsMounted ()
debugfsがマウントされているかどうかを確認してください。
戻り値 | |
---|---|
boolean | DEBUGFSがマウントされている場合はtrue |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isdeviceEncrypted
public abstract boolean isDeviceEncrypted ()
デバイスが暗号化されている場合は返されます。
戻り値 | |
---|---|
boolean | デバイスが暗号化されている場合はtrue 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
iSDirectory
public abstract boolean isDirectory (String deviceFilePath)
デバイス上のパスがディレクトリである場合はtrueを返し、それ以外の場合はfalse。
パラメーター | |
---|---|
deviceFilePath | String |
戻り値 | |
---|---|
boolean |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
IsEncryptionsupported
public abstract boolean isEncryptionSupported ()
デバイスで暗号化がサポートされている場合は返されます。
戻り値 | |
---|---|
boolean | デバイスが暗号化をサポートする場合はtrue 。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
exexecutable
public abstract boolean isExecutable (String fullPath)
デバイス上のファイルパスが実行可能ファイルである場合はtrueを返します。
パラメーター | |
---|---|
fullPath | String |
戻り値 | |
---|---|
boolean |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isheadless
public abstract boolean isHeadless ()
デバイスがヘッドレス(画面なし)の場合はtrueを返し、それ以外の場合はfalse。
戻り値 | |
---|---|
boolean |
投げる | |
---|---|
DeviceNotAvailableException |
isruntimepermissionsionsupted
public abstract boolean isRuntimePermissionSupported ()
プラットフォーム上のプラットフォームがランタイム許可の付与をサポートするかどうかを確認します
戻り値 | |
---|---|
boolean | ランタイム許可がサポートされている場合は、そうでない場合は誤りです。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ISSTATEBOOTLOADERORFASTBOOTD
public abstract boolean isStateBootloaderOrFastbootd ()
デバイスがTestDeviceState#FASTBOOT
またはTestDeviceState.FASTBOOTD
にある場合、trueを返します。
戻り値 | |
---|---|
boolean |
ローガル
public abstract boolean logAnrs (ITestLogger logger)
デバイスからANRを収集してログを記録します。
パラメーター | |
---|---|
logger | ITestLogger :ANRSをログに記録するITestLogger 。 |
戻り値 | |
---|---|
boolean | ロギングが成功した場合、それ以外の場合は虚偽です。 |
投げる | |
---|---|
DeviceNotAvailableException |
logondevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
デバイスのログキャットにメッセージを記録します。これは、ロギングが失敗しても投げない安全な電話です。
パラメーター | |
---|---|
tag | String :ログキャットにメッセージを記録するタグ。 |
level | Log.LogLevel :ログキャット内のメッセージのデバッグレベル。 |
format | String :メッセージ形式。 |
args | Object :string.format()を介して交換されるargs。 |
Mountdebugfs
public abstract void mountDebugfs ()
デバッグをマウントします。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
nonblockingReboot
public abstract void nonBlockingReboot ()
デバイスを再起動するコマンドを発行し、Command Completeで戻り、デバイスがADBに表示されなくなった場合。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Postbootsetup
public abstract void postBootSetup ()
ブートするたびにテストするためにデバイスを構成する手順を実行します。
デバイスが完全に起動された/利用可能な後に呼び出される必要があります通常の状況では、再起動を実行するときに実装がこれらの手順を自動的に実行する必要があるため、この方法を明示的に呼び出す必要はありません。呼び出される必要がある場合は、他のイベントのためにデバイスの再起動の場合です(たとえば、FastBoot Updateコマンドが完了した場合)投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
InvocationTearDown後
public void postInvocationTearDown ()
この方法は非推奨です。
代わりにpostInvocationTearDown(Throwable)
を使用してください。
呼び出しが完了した後に実行されるデバイス固有の必要なクリーンアップの追加ステップ。
InvocationTearDown後
public abstract void postInvocationTearDown (Throwable invocationException)
呼び出しが完了した後に実行されるデバイス固有の必要なクリーンアップの追加ステップ。
パラメーター | |
---|---|
invocationException | Throwable :もしあれば、呼び出し障害によって提起された最終的な例外。 |
PreinvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
呼び出しフローの前にデバイスで実行されるデバイス固有の必要なセットアップの追加手順。
パラメーター | |
---|---|
info | IBuildInfo :デバイスのIBuildInfo 。 |
attributes | MultiMap :呼び出しコンテキストに保存されている属性 |
投げる | |
---|---|
| com.android.tradefed.targetprep.targetsetuperror |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
TargetSetupError |
プルディル
public abstract boolean pullDir (String deviceFilePath, File localDir)
デバイスからディレクトリのコンテンツを再帰的に引き出します。
パラメーター | |
---|---|
deviceFilePath | String :リモートソースの絶対ファイルパス |
localDir | File :ファイルをプルするためのローカルディレクトリ |
戻り値 | |
---|---|
boolean | ファイルが正常にプルされた場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プルファイル
public abstract File pullFile (String remoteFilePath, int userId)
ファイルオフデバイスを取得し、ローカルの一時ERROR(/File)
に保存し、そのFile
を返します。
パラメーター | |
---|---|
remoteFilePath | String :デバイス上にファイルする絶対パス。 |
userId | int :ユーザーIDから引っ張る |
戻り値 | |
---|---|
File | デバイスファイルの内容を含むERROR(/File) 、または何らかの理由でコピーが失敗した場合(ホストファイルシステムの問題を含む) null |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プルファイル
public abstract File pullFile (String remoteFilePath)
ファイルオフデバイスを取得し、ローカルの一時ERROR(/File)
に保存し、そのFile
を返します。
パラメーター | |
---|---|
remoteFilePath | String :デバイス上にファイルする絶対パス。 |
戻り値 | |
---|---|
File | デバイスファイルの内容を含むERROR(/File) 、または何らかの理由でコピーが失敗した場合(ホストファイルシステムの問題を含む) null |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プルファイル
public abstract boolean pullFile (String remoteFilePath, File localFile)
ファイルオフデバイスを取得します。
パラメーター | |
---|---|
remoteFilePath | String :デバイス上にファイルする絶対パス。 |
localFile | File :コンテンツを保存するローカルファイル。空でない場合、コンテンツが交換されます。 |
戻り値 | |
---|---|
boolean | ファイルが正常に取得された場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プルファイル
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
ファイルオフデバイスを取得します。
パラメーター | |
---|---|
remoteFilePath | String :デバイス上にファイルする絶対パス。 |
localFile | File :コンテンツを保存するローカルファイル。空でない場合、コンテンツが交換されます。 |
userId | int :ユーザーIDから引っ張る |
戻り値 | |
---|---|
boolean | ファイルが正常に取得された場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プルフィールセント
public abstract String pullFileContents (String remoteFilePath)
ファイルオフデバイスを取得し、コンテンツを返します。
パラメーター | |
---|---|
remoteFilePath | String :デバイス上にファイルする絶対パス。 |
戻り値 | |
---|---|
String | デバイスファイルのコンテンツを含むString 、または何らかの理由でコピーが故障した場合のnull (ホストファイルシステムの問題を含む) |
投げる | |
---|---|
DeviceNotAvailableException |
pullfilefromexternal
public abstract File pullFileFromExternal (String remoteFilePath)
デバイスの外部ストレージからファイルを取得し、ローカルの一時ERROR(/File)
に保存し、そのFile
への参照を返す便利な方法。
パラメーター | |
---|---|
remoteFilePath | String :デバイスの外部ストレージマウントポイントに対して、デバイス上にファイルするパス |
戻り値 | |
---|---|
File | デバイスファイルの内容を含むERROR(/File) 、または何らかの理由でコピーが失敗した場合(ホストファイルシステムの問題を含む) null |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プッシュディール
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
フィルタリングされたディレクトリを除外しながら、ディレクトリコンテンツをデバイスに再帰的にプッシュします。
パラメーター | |
---|---|
localDir | File :プッシュするローカルディレクトリ |
deviceFilePath | String :リモート宛先の絶対ファイルパス |
excludedDirectories |
戻り値 | |
---|---|
boolean | ファイルが正常にプッシュされた場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プッシュディール
public abstract boolean pushDir (File localDir, String deviceFilePath)
再帰的にディレクトリコンテンツをデバイスにプッシュします。
パラメーター | |
---|---|
localDir | File :プッシュするローカルディレクトリ |
deviceFilePath | String :リモート宛先の絶対ファイルパス |
戻り値 | |
---|---|
boolean | ファイルが正常にプッシュされた場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プッシュファイル
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
pushFile(File, String)
のバリアントは、オプションでコンテンツプロバイダーの必要性を評価することを検討できます。
パラメーター | |
---|---|
localFile | File :プッシュするローカルファイル |
deviceFilePath | String :リモート宛先絶対ファイルパス |
evaluateContentProviderNeeded | boolean :コンテンツプロバイダーが必要かどうかを確認するかどうか |
戻り値 | |
---|---|
boolean | ファイルが正常にプッシュされた場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プッシュファイル
public abstract boolean pushFile (File localFile, String deviceFilePath)
ファイルをデバイスに押します。デフォルトでは、コンテンツプロバイダーを使用します。
パラメーター | |
---|---|
localFile | File :プッシュするローカルファイル |
deviceFilePath | String :リモート宛先絶対ファイルパス |
戻り値 | |
---|---|
boolean | ファイルが正常にプッシュされた場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
プッシュストリング
public abstract boolean pushString (String contents, String deviceFilePath)
文字列からデバイスに作成されたファイルを押します
パラメーター | |
---|---|
contents | String :プッシュするファイルの内容 |
deviceFilePath | String :リモート宛先絶対ファイルパス |
戻り値 | |
---|---|
boolean | 文字列が正常にプッシュされた場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
リブート
public abstract void reboot ()
デバイスをADBモードに再起動します。
デバイスが使用可能になるまでブロックします。投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
リブート
public abstract void reboot (String reason)
リブート全体で持続するreason
与えられた、指定された理由でデバイスをADBモードに再起動します。
デバイスが使用可能になるまでブロックします。
最後の再起動の理由は、 sys.boot.reason
Propetyを照会することで取得できます。
パラメーター | |
---|---|
reason | String :この再起動の理由、または理由が指定されていない場合はnull 。 |
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
rebootintobootloader
public abstract void rebootIntoBootloader ()
デバイスをブートローダーモードに再起動します。
デバイスがブートローダーモードになるまでブロックします。投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
rebootintofastbootd
public abstract void rebootIntoFastbootd ()
デバイスをFastBootDモードに再起動します。
デバイスがFastBootdモードになるまでブロックします。
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
rebootintorecovery
public abstract void rebootIntoRecovery ()
デバイスをADB回復モードに再起動します。
デバイスが回復に入るまでブロックします投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
rebootintosideload
public abstract void rebootIntoSideload (boolean autoReboot)
デバイスをADBサイドロードモードに再起動します(これは回復中の特別なモードであることに注意してください)
デバイスがサイドロードモードに入るまでブロックします
パラメーター | |
---|---|
autoReboot | boolean :サイドロード後にデバイスを自動的に再起動するかどうか |
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスがサイドロードにない場合 |
rebootintosideload
public abstract void rebootIntoSideload ()
デバイスをADBサイドロードモードに再起動します(これは回復中の特別なモードであることに注意してください)
デバイスがサイドロードモードに入るまでブロックします
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスがサイドロードにない場合 |
rebootuntilonline
public abstract void rebootUntilOnline ()
デバイスがオンラインになるまでブロックするreboot()
の代替、つまりADBに表示されます。
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
rebootuntilonline
public abstract void rebootUntilOnline (String reason)
デバイスがオンラインになるまでブロックするreboot()
の代替、つまりADBに表示されます。
パラメーター | |
---|---|
reason | String :この再起動の理由、または理由が指定されていない場合はnull 。 |
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
以下も参照してください。
RebootuserSpace
public abstract void rebootUserspace ()
デバイスのユーザースペースのみを再起動します。
デバイスが使用可能になるまでブロックします。
警告。ユーザースペースの再起動は現在アクティブな開発中であり、あなた自身の責任でそれを使用してください。
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
rebootuserspaceuntilonline
public abstract void rebootUserspaceUntilOnline ()
DeviceがオンラインになるまでADBに表示されるまでのみブロックするrebootUserspace()
()}の代替。
投げる | |
---|---|
DeviceNotAvailableException | 再起動後にデバイスが使用できない場合 |
RemountSystemReadonly
public abstract void remountSystemReadOnly ()
デバイス上のシステムパーティションを読み取り専用にします。デバイスを再起動する場合があります。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
RemountsystemWritable
public abstract void remountSystemWritable ()
デバイス上のシステムパーティションを書き込み可能にします。デバイスを再起動する場合があります。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
RemountVendorreadonly
public abstract void remountVendorReadOnly ()
デバイス上のベンダーパーティションを読み取り専用にします。デバイスを再起動する場合があります。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
RemountVendorWritable
public abstract void remountVendorWritable ()
デバイス上のベンダーパーティションを書くことができるようにします。デバイスを再起動する場合があります。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
RunInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
人以上のリスナーがパラメーターとして渡されました。
パラメーター | |
---|---|
runner | IRemoteAndroidTestRunner :テストを実行するIRemoteAndroidTestRunner |
listeners | ITestLifeCycleReceiver :テスト結果リスナー |
戻り値 | |
---|---|
boolean | true テストコマンドが完了した場合。それが完了できなかった場合にfalse が、回復は成功しました |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 IEテストコマンドは完了できず、回復に失敗しました。 |
RunInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
計装テストを実行し、デバイスの回復を提供します。
テスト実行が完了する前にデバイスとの接続が失われ、回復が成功すると、すべてのリスナーがtestRunfailedを通知され、「false」が返されます。テストコマンドは再実行されません。必要に応じて再試行することは発信者に任されています。
テストの実行が完了する前にデバイスとの接続が失われ、回復が失敗すると、すべてのリスナーがtestRunfailedとDevicenotavailableExceptionについて通知されます。
パラメーター | |
---|---|
runner | IRemoteAndroidTestRunner :テストを実行するIRemoteAndroidTestRunner |
listeners |
戻り値 | |
---|---|
boolean | true テストコマンドが完了した場合。デバイス通信の例外のために完了できなかった場合はfalse ですが、回復は成功しました |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 IEテストコマンドは完了できず、回復に失敗しました。 |
RunInstrumentationTestSasuser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
パラメーター | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
戻り値 | |
---|---|
boolean |
投げる | |
---|---|
DeviceNotAvailableException |
RunInstrumentationTestSasuser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
と同じですが、特定のユーザーのテストを実行します。
パラメーター | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
戻り値 | |
---|---|
boolean |
投げる | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
デバイスに日付を設定します
注:デバイスに日付を設定するには、ルートが必要です
パラメーター | |
---|---|
date | Date :特定の日付を指定します。 null の場合、ホスト日付を使用します |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setoptions
public abstract void setOptions (TestDeviceOptions options)
デバイスのTestDeviceOptions
を設定します
パラメーター | |
---|---|
options | TestDeviceOptions |
SetProperty
public abstract boolean setProperty (String propKey, String propValue)
指定されたプロパティ値をデバイスに設定します。 ADBルートが必要です。
パラメーター | |
---|---|
propKey | String :設定するためのターゲットを絞ったキー。 |
propValue | String :設定するプロパティ値。 |
戻り値 | |
---|---|
boolean | SetPropコマンドが成功した場合、 True を返します。 |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
SetRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
このデバイスに使用するIDeviceRecovery
を設定します。デバイスが最初に割り当てられたときに設定する必要があります。
パラメーター | |
---|---|
recovery | IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
デバイスに使用する現在の回復モードを設定します。
デバイス通信の問題が発生したときに使用する回復方法を制御するために使用されます。必要に応じてこの方法を控えめに使用することをお勧めします(たとえば、フレームワークがダウンしている場合などパラメーター | |
---|---|
mode | ITestDevice.RecoveryMode :「オンラインのみ」モードがオンになるかどうかを「回復するかどうか。 |
setusefastbooterase
public abstract void setUseFastbootErase (boolean useFastbootErase)
FastBoot EraseまたはFastBoot形式を使用して、デバイス上のパーティションをワイプするかどうかを設定します。
パラメーター | |
---|---|
useFastbootErase | boolean :FastBootのfalse を使用するか、FastBootフォーマットを使用する場合はtrue 。 |
以下も参照してください。
startlogcat
public abstract void startLogcat ()
背景のデバイスからのLogCat出力のキャプチャを開始します。
LogCat出力がすでにキャプチャされている場合、効果はありません。データは、GetLogcatを介して後で取得できます。デバイスが使用されなくなった場合、stopLogcat()
を呼び出す必要があります。 TFフレームワークstartLogcat()
およびstopLogcat()
ため、TFの呼び出しコンテキスト内で通常呼び出される必要はありません。 StopeMulatorOutput
public abstract void stopEmulatorOutput ()
エミュレータ出力を閉じて削除します。
stoplogcat
public abstract void stopLogcat ()
デバイスからのLogCat出力のキャプチャを停止し、現在保存されているLogCatデータを破棄します。
LogCat出力がキャプチャされていない場合、効果はありません。SwitchToADBTCP
public abstract String switchToAdbTcp ()
デバイスをADBオーバーTCPモードに切り替えます。
戻り値 | |
---|---|
String | デバイスを切り替えられなかった場合のTCPシリアル番号またはnull |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
SwitchToAdbusb
public abstract boolean switchToAdbUsb ()
USBモードでデバイスをADBに切り替えます。
戻り値 | |
---|---|
boolean | スイッチfalse true |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Syncfiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
ローカルファイルディレクトリのコンテンツをデバイスに増分します。
ローカルファイルのタイムスタンプをリモートの等価物と比較することにより、どのファイルをプッシュするかを決定します。 「新しい」または存在しないファイルのみがデバイスにプッシュされます。したがって、デバイスに設定されたファイルがすでに最新である場合、オーバーヘッドは比較的小さくなるはずです。非表示ファイル(「。」から始まる名前があります)は無視されます。使用法の例:syncfiles( "/tmp/files"、 "/sdcard")は、まだ存在しない場合はa/sdcard/filesディレクトリを作成し、/tmp/ファイルのコンテンツを/sdcard/filesに再帰的にプッシュします。パラメーター | |
---|---|
localFileDir | File :再帰的にプッシュするファイルを含むローカルファイルディレクトリ。 |
deviceFilePath | String :リモート宛先絶対ファイルパスルート。 Thosファイルパスのすべてのディレクトリは読み取り可能でなければなりません。つまり、ADBがrootでないときに/data/local/tmpにプッシュする |
戻り値 | |
---|---|
boolean | ファイルが正常に同期された場合はtrue 。それ以外のfalse 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
lockdeviceを解除します
public abstract boolean unlockDevice ()
デバイスが暗号化された状態にある場合、デバイスのロックを解除します。
この方法では、フレームワークを再起動する場合がありますが、postBootSetup()
を呼び出しません。したがって、このメソッドが返されたときにデバイスを完全にテストする準備ができていない場合があります。戻り値 | |
---|---|
boolean | 成功した場合、またはデバイスが暗号化されていない場合はtrue 。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
UnsupportedOperationException | 暗号化がデバイスでサポートされていない場合。 |
unmountdebugfs
public abstract void unmountDebugfs ()
アンマウントDEBUGFS。
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitforbootcomplete
public abstract boolean waitForBootComplete (long timeOut)
デバイスのブートが完全なフラグが設定されるまでブロックします。
パラメーター | |
---|---|
timeOut | long :フラグが設定されるのを待つMSECSの時間 |
戻り値 | |
---|---|
boolean | デバイスのブート完全フラグがタイムアウト内で設定されている場合はtrue |
投げる | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitfordeviceavailable
public abstract boolean waitForDeviceAvailable ()
デバイスがレスポンシブでテストできるのを待ちます。デフォルトのタイムアウトを使用します。
戻り値 | |
---|---|
boolean | TRUEデバイスが利用可能である場合、回復が無効で利用できない場合はfalse。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
waitfordeviceavailable
public abstract boolean waitForDeviceAvailable (long waitTime)
デバイスがレスポンシブでテストできるのを待ちます。
パラメーター | |
---|---|
waitTime | long :MSの時間を待つ時間 |
戻り値 | |
---|---|
boolean | TRUEデバイスが利用可能である場合、回復が無効で利用できない場合はfalse。 |
投げる | |
---|---|
DeviceNotAvailableException | waittimeが期限切れになった後、デバイスがまだ反応しない場合。 |
waitfordeviceavailable inrecoverpath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
リカバリパスを考慮せずに、デバイスがレスポンシブで利用可能になるのを待ちます。
パラメーター | |
---|---|
waitTime | long |
戻り値 | |
---|---|
boolean | デバイスが利用可能な場合はtrue、利用できない場合はfalse。 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
waitfordevicebootloader
public abstract void waitForDeviceBootloader ()
FastBootを介してデバイスが表示されるまでブロックします。デフォルトのタイムアウトを使用します。
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
WaitfordeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
デバイスが「ADB回復」状態にあるためのブロック(これはIDeviceRecovery
とは異なることに注意してください)。
パラメーター | |
---|---|
waitTime | long :MSの時間を待つ時間 |
戻り値 | |
---|---|
boolean | 時間が切れる前にデバイスが回復する場合はtrue 。それ以外のfalse |
waitfordeviceinsideload
public abstract boolean waitForDeviceInSideload (long waitTime)
デバイスが「ADBサイドロード」状態にあるためのブロック
パラメーター | |
---|---|
waitTime | long :MSの時間を待つ時間 |
戻り値 | |
---|---|
boolean | 時間が切れる前にデバイスがサイドロードに起動する場合はtrue 。それ以外のfalse |
waitfordeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
デバイスが利用できないためのブロック、つまりADBから欠落している
パラメーター | |
---|---|
waitTime | long :MSの時間を待つ時間 |
戻り値 | |
---|---|
boolean | 時間が切れる前にデバイスが利用できない場合はtrue 。それ以外のfalse |
WaitfordeviceOnline
public abstract void waitForDeviceOnline ()
ADBを介してデバイスが表示されるまでブロックします。デフォルトのタイムアウトを使用します
注意デバイスは、必ずしも完了時にコマンドに応答するとは限りません。代わりにwaitForDeviceAvailable()
を使用してください。投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
WaitfordeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
ADBを介してデバイスが表示されるまでブロックします。
注意デバイスは、必ずしも完了時にコマンドに応答するとは限りません。代わりにwaitForDeviceAvailable()
を使用してください。パラメーター | |
---|---|
waitTime | long :MSの時間を待つ時間 |
投げる | |
---|---|
DeviceNotAvailableException | デバイスとの接続が失われ、回復できない場合。 |
Waitfordeviceshell
public abstract boolean waitForDeviceShell (long waitTime)
デバイスが基本的なADBシェルコマンドに応答するのを待ちます。
パラメーター | |
---|---|
waitTime | long :MSの時間を待つ時間 |
戻り値 | |
---|---|
boolean | waitTime経過する前にデバイスが応答する場合にtrue 。 |