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 void deleteFile(String deviceFilePath, int userId)

デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

現在の system_server を次と比較して、デバイスがソフトリブートしたかどうかを確認するヘルパー メソッド 以前の system_server ProcessInfo

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

エポックからの UTC 時間以降にデバイスがソフトリブートしたかどうかを確認するヘルパー メソッド デバイスと ERROR(/TimeUnit)

abstract boolean disableAdbRoot()

adb ルートをオフにします。

abstract boolean doesFileExist(String deviceFilePath)

デバイス上のファイルが存在するかどうかを判断するためのヘルパー メソッド。

abstract boolean enableAdbRoot()

adb ルートを有効にします。

abstract String executeAdbCommand(long timeout, String... commandArgs)

指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。

abstract String executeAdbCommand(String... commandArgs)

adb コマンドをシステム コマンドとして実行するヘルパー メソッド。

abstract String 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)

長時間実行の fastboot コマンドを、システム コマンドとして実行するヘルパー メソッドです。 使用します。

abstract String executeShellCommand(String command)

adb シェルコマンドを実行し、出力を String として返すヘルパー メソッド。

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 が正しく入力された CommandResult として結果を返すヘルパー メソッド。

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

adb シェルコマンドを実行し、コマンド ステータス出力と stderr が正しく入力された CommandResult として結果を返すヘルパー メソッド。

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が正しく入力された CommandResult として結果を返すヘルパー メソッド。

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

デバイスが割り当てられている場合は、キャッシュに保存された DeviceDescriptor を返します。割り当てられていない場合は、 現在の DeviceDescriptor

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

デバイスが割り当てられている場合は、キャッシュに保存された DeviceDescriptor を返します。割り当てられていない場合は、 現在の DeviceDescriptor

abstract String[] getChildren(String deviceFilePath)

権限が原因で機能しないことがある IFileEntry の使用に代わるものです。

abstract AbstractConnection getConnection()

デバイスに関連付けられた接続を返します。

abstract String getDeviceClass()

デバイスクラスを取得します。

abstract long getDeviceDate()

デバイスの日付をエポックからのミリ秒単位で返します。

abstract DeviceDescriptor getDeviceDescriptor()

デバイス情報から DeviceDescriptor を返すと、情報を取得せずに情報を取得できます 実際のデバイス オブジェクトを渡します。

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

デバイス情報から DeviceDescriptor を返すと、情報を取得せずに情報を取得できます 実際のデバイス オブジェクトを渡します。

abstract TestDeviceState getDeviceState()

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

abstract long getDeviceTimeOffset(Date date)

デバイスと指定された ERROR(/Date) との時間差を取得するヘルパー。

abstract InputStreamSource getEmulatorOutput()

エミュレータの stdout と stderr のストリームを取得する

abstract long getExternalStoreFreeSpace()

デバイスの外部ストレージの空き容量を判断するためのヘルパー メソッド。

abstract String getFastbootProductType()

デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。

abstract String getFastbootProductVariant()

デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。

abstract String getFastbootSerialNumber()

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

abstract String getFastbootVariable(String variableName)

指定された fastboot 変数の値をデバイスから取得します。

abstract IFileEntry getFileEntry(String path)

デバイス上のリモート ファイルへの参照を取得します。

abstract IDevice getIDevice()

関連付けられている ddmlib IDevice への参照を返します。

abstract long getIntProperty(String name, long defaultValue)

デバイスから指定されたプロパティの整数値を返します。

abstract long getLastExpectedRebootTimeMillis()

Tradefed API が最後に再起動をトリガーした時刻(エポックからのミリ秒数)を返します。 System.currentTimeMillis() から返されます。

abstract int getLaunchApiLevel()

デバイスで最初にリリースされた API レベルを取得します。

abstract InputStreamSource getLogcat()

logcat データのスナップショット ストリームを取得します。

abstract InputStreamSource getLogcat(int maxBytes)

キャプチャされた logcat データの最後の maxBytes のスナップショット ストリームを取得します。

abstract InputStreamSource getLogcatDump()

デバイスの現在の logcat のダンプを取得します。

abstract InputStreamSource getLogcatSince(long date)

指定された日付以降にキャプチャされた logcat データのスナップショット ストリームを取得します。

abstract String getMountPoint(String mountName)

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

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

指定されたマウントポイント パスに対応する MountPointInfo を返します。 そのパスに何もマウントされていない場合、またはパスが表示されない場合は null /proc/mounts をマウント ポイントとして指定します。

abstract getMountPointInfo()

デバイスの /proc/mounts にある情報の解析済みバージョンを返します

abstract long getPartitionFreeSpace(String partition)

デバイス パーティションの空き容量を判断するためのヘルパー メソッド。

abstract ProcessInfo getProcessByName(String processName)

ヘルパー メソッドが「pidof」を実行する「stat」などProcessInfo オブジェクトを返します。 指定されたプロセスの 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()

デバイスから Tombstone のリストを取得して返します。

abstract long getTotalMemory()

物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します

default String getTrackingSerial()

デバイス管理のため、デバイスの追跡に使用されているシリアル番号を入手します。

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

デバイスが TestDeviceState#FASTBOOT または TestDeviceState.FASTBOOTD にある場合、true を返します。

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

<ph type="x-smartling-placeholder"></ph> このメソッドは非推奨です。 代わりに postInvocationTearDown(Throwable) を使用してください。

abstract void postInvocationTearDown(Throwable invocationException)

呼び出し後に実行される、デバイス固有のクリーンアップに必要な追加の手順 完了です。

default void preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)

デバイス固有の必須設定のために、事前にデバイス上で実行される追加の手順 確認します。

abstract boolean pullDir(String deviceFilePath, File localDir)

デバイスからディレクトリの内容を再帰的に pull します。

abstract boolean pullDir(String deviceFilePath, File localDir, int userId)

デバイスからディレクトリの内容を再帰的に pull します。

abstract File pullFile(String remoteFilePath, int userId)

デバイスからファイルを取得し、ローカルの一時的な ERROR(/File) に保存して、それを返します。 File

abstract File pullFile(String remoteFilePath)

デバイスからファイルを取得し、ローカルの一時的な ERROR(/File) に保存して、それを返します。 File

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)

デバイスの外部ストレージからファイルを取得し、 ローカルの一時的な ERROR(/File) を実行し、その File への参照を返します。

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

ディレクトリの内容をデバイスに再帰的にプッシュします。

abstract boolean pushDir(File localDir, String deviceFilePath, excludedDirectories)

ディレクトリの内容を再帰的にデバイスに push する(ただし、一部のディレクトリは除外) フィルタされます。

abstract boolean pushDir(File localDir, String deviceFilePath)

ディレクトリの内容をデバイスに再帰的にプッシュします。

abstract boolean pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

pushFile(File, String) のバリエーション。必要に応じてニーズの評価を検討できます。 コンテンツプロバイダを指定します

abstract boolean pushFile(File localFile, String deviceFilePath)

ファイルをデバイスにプッシュします。

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

ファイルをデバイスにプッシュします。

abstract boolean pushString(String contents, String deviceFilePath)

作成されたファイルを文字列からデバイスにプッシュ

abstract void reboot()

デバイスを adb モードで再起動します。

abstract void reboot(String reason)

指定された reason を使用してデバイスを adb モードで再起動し、再起動しても保持されるようにします。

abstract void rebootIntoBootloader()

デバイスをブートローダー モードで再起動します。

abstract void rebootIntoFastbootd()

デバイスを Fastbootd モードで再起動します。

abstract void rebootIntoRecovery()

デバイスを adb リカバリモードで再起動します。

abstract void rebootIntoSideload(boolean autoReboot)

デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです)

デバイスがサイドロード モードになるまでブロック

abstract void rebootIntoSideload()

デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです)

デバイスがサイドロード モードになるまでブロック

abstract void rebootUntilOnline()

reboot() に代わるもので、デバイスがオンライン(adb に認識される)になるまでブロックする。

abstract void rebootUntilOnline(String reason)

reboot() に代わるもので、デバイスがオンライン(adb に認識される)になるまでブロックする。

abstract void rebootUserspace()

デバイスのユーザー空間部分のみ再起動します。

abstract void rebootUserspaceUntilOnline()

rebootUserspace() ()} の代替手段。デバイスがオンラインになるまでブロックする adb で参照できます。

abstract void remountSystemReadOnly()

デバイスのシステム パーティションを読み取り専用にします。

abstract void remountSystemWritable()

デバイスの system パーティションを書き込み可能にします。

abstract void remountVendorReadOnly()

デバイスのベンダー パーティションを読み取り専用にします。

abstract void remountVendorWritable()

デバイスのベンダー パーティションを書き込み可能にします。

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

パラメータとして渡される 1 つ以上のリスナーを使用して ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) を実行するためのコンビニエンス メソッド。

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

インストルメンテーション テストを実行し、デバイスを復元します。

abstract boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) と同じですが、 は、指定されたユーザーのテストを実行します。

abstract boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) と同じですが、特定のユーザーに対してテストを実行します。

abstract void setDate(Date date)

デバイスに日付を設定します

注: デバイスで日付を設定するには root が必要です

abstract void setOptions(TestDeviceOptions options)

デバイスの TestDeviceOptions を設定する

abstract boolean setProperty(String propKey, String propValue)

デバイスに指定されたプロパティ値を設定します。

abstract void setRecovery(IDeviceRecovery recovery)

このデバイスに使用する IDeviceRecovery を設定します。

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

デバイスに使用する現在のリカバリモードを設定します。

abstract void setTrackingSerial(String trackingSerial)

デバイス管理のため、デバイスの参照に使用しているシリアル番号を追跡します。

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

デバイスを USB 経由で adb モードに切り替えます。

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」に含めるためのブロック(これは Pod の IDeviceRecovery)。

abstract boolean waitForDeviceInSideload(long waitTime)

デバイスを「adb sideload」に配置するためのブロック州

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

ClearLogcat

public abstract void clearLogcat ()

蓄積された logcat データをすべて削除します。

これは、ITestDevice#getLogcat() のみが結果を返すようにする場合に便利です。 特定の時点の後に生成されたログデータ(新しいデバイスビルドのフラッシュ後など)。

deleteFile

public abstract void deleteFile (String deviceFilePath)

デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。

パラメータ
deviceFilePath String: デバイス上のファイルの絶対パス。

例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。

パラメータ
deviceFilePath String: デバイス上のファイルの絶対パス。

userId int: 削除するユーザー ID

例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

デバイスのソフト再起動

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

現在の system_server を次と比較して、デバイスがソフトリブートしたかどうかを確認するヘルパー メソッド 以前の system_server ProcessInfogetProcessByName(String) を使用して ProcessInfo を取得します。

パラメータ
prevSystemServerProcess ProcessInfo: 前の system_server プロセス ProcessInfo

戻り値
boolean true: デバイスがソフトリブートした場合

例外
RuntimeException デバイスの起動理由が異常の場合
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted since

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

エポックからの UTC 時間以降にデバイスがソフトリブートしたかどうかを確認するヘルパー メソッド デバイスと ERROR(/TimeUnit)。ソフトリブートとは、システム外で再起動された system_server を デバイスのハードリブート(リクエストされた再起動など)現在のデバイスの utcEpochTime Milliseccond は、メソッド getDeviceDate() で取得できます。

パラメータ
utcEpochTime long: エポックを経過したデバイス時刻(秒)。

timeUnit TimeUnit: 指定された utcEpochTime の時間単位 TimeUnit

戻り値
boolean true: デバイスがソフトリブートした場合

例外
RuntimeException デバイスの起動理由が異常の場合
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

adb ルートをオフにします。

adb ルートを無効にすると、デバイスが adb から切断されることがあります。この方法は、 確認しましょう。

戻り値
boolean 成功した場合は true

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

デバイス上のファイルが存在するかどうかを判断するためのヘルパー メソッド。

パラメータ
deviceFilePath String: 確認するデバイス上のファイルの絶対パス

戻り値
boolean ファイルが存在する場合は true、そうでない場合は false

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

enableAdbRoot

public abstract boolean enableAdbRoot ()

adb ルートを有効にします。「enable-root」コマンドを"false" に設定すると、メッセージがログに記録され、 返すことができます。

adb ルートを有効にすると、デバイスが adb から切断されることがあります。この方法は、 確認しましょう。

戻り値
boolean 成功した場合は true

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。

可能な限り、代わりに executeShellCommand(String) を使用してください。 障害検出とパフォーマンスが向上します。

パラメータ
timeout long: デバイスが応答していないと見なされるまでの時間(ミリ秒単位)。0L タイムアウトなし

commandArgs String: 実行する adb コマンドと引数

戻り値
String コマンドから stdout を取得します。コマンドの実行が失敗した場合は null

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

adb コマンドをシステム コマンドとして実行するヘルパー メソッド。

可能な限り、代わりに executeShellCommand(String) を使用してください。 障害検出とパフォーマンスが向上します。

パラメータ
commandArgs String: 実行する adb コマンドと引数

戻り値
String コマンドから stdout を取得します。コマンドの実行が失敗した場合は null

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。

可能な限り、代わりに executeShellCommand(String) を使用してください。 障害検出とパフォーマンスが向上します。

パラメータ
timeout long: デバイスが応答していないと見なされるまでの時間(ミリ秒単位)。0L タイムアウトなし

envMap : コマンドに設定する環境

commandArgs String: 実行する adb コマンドと引数

戻り値
String コマンドから stdout を取得します。コマンドの実行が失敗した場合は null

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

システム コマンドとして fastboot コマンドを実行するヘルパー メソッド。

デバイスがすでに Fastboot モードの場合に使用することが想定されています。

パラメータ
timeout long: コマンドが期限切れになるまでの時間(ミリ秒単位)

commandArgs String: 実行する fastboot コマンドと引数

戻り値
CommandResult コマンドの出力を含む CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

デフォルトのタイムアウトが設定されたシステム コマンドとして fastboot コマンドを実行するヘルパー メソッド 2 分。

デバイスがすでに Fastboot モードの場合に使用することが想定されています。

パラメータ
commandArgs String: 実行する fastboot コマンドと引数

戻り値
CommandResult コマンドの出力を含む CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッドです。

executeFastbootCommand(String) と同じですが、タイムアウトを長くします。

パラメータ
commandArgs String: 実行する fastboot コマンドと引数

戻り値
CommandResult コマンドの出力を含む CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

長時間実行の fastboot コマンドを、システム コマンドとして実行するヘルパー メソッドです。 使用します。

executeFastbootCommand(String) と同じですが、タイムアウトを長くします。

パラメータ
envVarMap : fastboot コマンドが実行されるシステム環境変数

commandArgs String: 実行する fastboot コマンドと引数

戻り値
CommandResult コマンドの出力を含む CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellCommand

public abstract String executeShellCommand (String command)

adb シェルコマンドを実行し、出力を String として返すヘルパー メソッド。

パラメータ
command String: 実行する adb シェルコマンド

戻り値
String シェルの出力が

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellCommand

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 の場合、DeviceNotRespondException がスローされる 成功しません。

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellCommand

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 が親の場合、DeviceNotRespondException がスローされます。 表示されます。

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellCommand

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 デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

public abstract CommandResult executeShellV2Command (String command)

adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が正しく入力された CommandResult として結果を返すヘルパー メソッド。

パラメータ
command String: 実行するコマンド。

戻り値
CommandResult CommandResult での結果。

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

adb シェルコマンドを実行し、コマンド ステータス出力と stderr が正しく入力された CommandResult として結果を返すヘルパー メソッド。stdout は 指定ストリームにルーティングされます

パラメータ
command String: 実行するコマンド。

pipeToOutput OutputStream: 標準出力がリダイレクトされる ERROR(/OutputStream)、または null。

戻り値
CommandResult CommandResult での結果。

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が正しく入力された CommandResult として結果を返すヘルパー メソッド。

パラメータ
command String: 実行するコマンド。

pipeAsInput File: コマンドへの入力としてパイプされる ERROR(/File)、または null。

戻り値
CommandResult CommandResult での結果。

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

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 が親の場合、DeviceNotRespondException がスローされます。 表示されます。

戻り値
CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。

パラメータ
command String: 実行する adb シェルコマンド

maxTimeoutForCommand long: コマンドが完了するまでの最大タイムアウト。単位として timeUnit で指定

timeUnit TimeUnit: maxTimeToOutputShellResponse の単位

戻り値
CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

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 が親の場合、DeviceNotRespondException がスローされます。 表示されます。

戻り値
CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

runShellV2Command

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 が親の場合、DeviceNotRespondException がスローされます。 表示されます。

戻り値
CommandResult

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

fastbootWipePartition

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 無線通信のバージョンが返されない場合があります。 要約: gsm.version.baseband プロパティが fastboot getvar version-baseband から返されるバージョンと同じです。

戻り値
String String ベースバンド バージョン、または特定できない場合は null (デバイスにラジオがないか、バージョン文字列を読み取れません)

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても 復元することはできません。

getBattery

public abstract Integer getBattery ()

デバイスの現在のバッテリー残量を返します。バッテリー残量が不明な場合は Null を返します。

戻り値
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

指定されたプロパティのブール値を返します。

パラメータ
name String: プロパティ名

defaultValue boolean: プロパティが空または存在しない場合に返されるデフォルト値。

戻り値
boolean プロパティの値が "1""y""yes" の場合は true "on" または "true"(プロパティの値が "0" の場合は false)。 "n""no""off""false"defaultValue できません。

例外
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。

戻り値
起動時間(エポックからの秒単位の UTC 時間)と起動理由のマップ

例外
DeviceNotAvailableException

getBootHistoryBefore

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。 デバイスからのエポックからの経過時間と、指定された時間単位。現在のデバイスの utcEpochTime ミリ秒は、メソッド getDeviceDate() で取得できます。

パラメータ
utcEpochTime long: エポックからのデバイス時刻。

timeUnit TimeUnit: 時間単位 TimeUnit

戻り値
起動時間(エポックからの秒単位の UTC 時間)と起動理由のマップ

例外
DeviceNotAvailableException

getBootloaderVersion

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 を取得できなかった場合はビルド 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

getChildren

public abstract String[] getChildren (String deviceFilePath)

権限が原因で機能しないことがある IFileEntry の使用に代わるものです。

パラメータ
deviceFilePath String: 検索を行うデバイス上のパス

戻り値
String[] デバイス上のパスにすべてのファイルを含む文字列の配列。

例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

デバイスに関連付けられた接続を返します。

戻り値
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

デバイスクラスを取得します。

戻り値
String String デバイスクラス。

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

戻り値
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

デバイスと指定された ERROR(/Date) との時間差を取得するヘルパー。エポック時刻を使用する 社内で取り扱っています

パラメータ
date Date

戻り値
long ミリ秒単位の差

例外
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

エミュレータの stdout と stderr のストリームを取得する

戻り値
InputStreamSource エミュレータ出力

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

デバイスの外部ストレージの空き容量を判断するためのヘルパー メソッド。

戻り値
long 空き容量(KB 単位)

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

getFastbootProductType

public abstract String getFastbootProductType ()

デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。

この方法は、デバイスを fastboot モードにする必要がある場合にのみ使用してください。より安全性の高いバリエーション この場合は、汎用の getProductType() メソッドよりも は、デバイスの状態が不適切である場合や、デバイスが 応答がありません。

戻り値
String String 商品カテゴリ名、または特定できない場合は null

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。

この方法は、デバイスを fastboot モードにする必要がある場合にのみ使用してください。より安全性の高いバリエーション この場合は、汎用の getProductType() メソッドよりも は、デバイスの状態が不適切である場合や、デバイスが 応答がありません。

戻り値
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 指定された path のファイルができない場合、IFileEntry または null 見つける

例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

関連付けられている ddmlib IDevice への参照を返します。

デバイスの接続が解除されたり、デバイスが切断されたりするたびに、DDMS によって新しい IDevice が割り当てられることがあります。 接続する必要があります。したがって、呼び出し元は IDevice への参照を保持しないようにする必要があります。 その参照が古くなる可能性があるためです

戻り値
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

デバイスから指定されたプロパティの整数値を返します。

パラメータ
name String: プロパティ名

defaultValue long: プロパティが空または存在しない場合に返されるデフォルト値。

戻り値
long プロパティ値、または defaultValue(プロパティが空、存在しない場合) 整数値がない場合などです

例外
DeviceNotAvailableException

getLastExpectRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Tradefed API が最後に再起動をトリガーした時刻(エポックからのミリ秒数)を返します。 System.currentTimeMillis() から返されます。

戻り値
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 つのモードで動作します。

  • 現在、logcat がバックグラウンドでキャプチャされている場合、現在のバックグラウンド コンテンツのうち最大 TestDeviceOptions.getMaxLogcatDataSize() バイトが返されます logcat キャプチャ
  • それ以外の場合は、デバイスが現在応答している場合は、logcat データの静的ダンプが返されます。

    戻り値
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    キャプチャされた logcat データの最後の maxBytes のスナップショット ストリームを取得します。

    キャプチャした logcat データのスナップショットを頻繁にキャプチャする場合に便利です getLogcat() スナップショット全体を取得することによる、ディスク容量が大きくなる可能性があるという心配もありません。

    パラメータ
    maxBytes int: 返されるデータの最大量。通信可能な量と メモリに無理なく収まる

    戻り値
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    デバイスの現在の logcat のダンプを取得します。getLogcat() とは異なり、このメソッドは 常に logcat の静的ダンプが返されます。

    デバイスにアクセスできない場合は何も返されないというデメリットがあります。

    戻り値
    InputStreamSource logcat データの InputStreamSource。失敗した場合は空のストリームが返されます logcat データをキャプチャします

    getLogcat since

    public abstract InputStreamSource getLogcatSince (long date)

    指定された日付以降にキャプチャされた logcat データのスナップショット ストリームを取得します。日時 デバイスは getDeviceDate() を使用してください。

    パラメータ
    date long: スナップショットを開始するタイミングをエポック形式で示したミリ秒単位の経過時間。 (「date +%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 を返します。 そのパスに何もマウントされていない場合、またはパスが表示されない場合は null /proc/mounts をマウント ポイントとして指定します。

    パラメータ
    mountpoint String

    戻り値
    ITestDevice.MountPointInfo 「/proc/mounts」の情報を含む MountPointInfoERROR(/List)

    例外
    DeviceNotAvailableException

    関連項目:

    getMountPointInfo

    public abstract  getMountPointInfo ()

    デバイスの /proc/mounts にある情報の解析済みバージョンを返します

    戻り値
    「/proc/mounts」の情報を含む MountPointInfoERROR(/List)

    例外
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    デバイス パーティションの空き容量を判断するヘルパー メソッド。

    パラメータ
    partition String

    戻り値
    long 空き容量(KB 単位)

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    ヘルパー メソッドが「pidof」を実行する「stat」などProcessInfo オブジェクトを返します。 指定されたプロセスの PID とプロセス開始時刻。

    パラメータ
    processName String: プロシージャ名の文字列。

    戻り値
    ProcessInfo 指定された processName の ProcessInfo

    例外
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    サービスの pid を返します。何か問題が発生した場合は null を返します。

    パラメータ
    process String: プロシージャ名の文字列。

    戻り値
    String

    例外
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    このデバイスの製品タイプを取得するためのコンビニエンス メソッド。

    この方法は、デバイスが adb モードまたは fastboot モードの場合に利用できます。

    戻り値
    String String 商品カテゴリ名。null にはならない

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても 商品タイプを特定できない場合

    getProductVariant

    public abstract String getProductVariant ()

    このデバイスの商品バリエーションを取得するためのコンビニエンス メソッド。

    この方法は、デバイスが adb モードまたは fastboot モードの場合に利用できます。

    戻り値
    String バリエーション商品の名前 String、または使用できない場合は null 意思決定

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    getProperty

    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 のシリアル番号

    getTombstone

    public abstract  getTombstones ()

    デバイスから Tombstone のリストを取得して返します。root が必要です。

    方法であるため、なんらかの理由で 1 つの Tombstone を pull できない場合、 リストにない指標が含まれます。メソッドを終了するのは DeviceNotAvailableException のみです 早期に発見できます

    戻り値
    Tombstone ファイルのリスト。Tombstone がない場合は空になります。

    例外
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

    物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します

    戻り値
    long

    getTrackingSerial

    public String getTrackingSerial ()

    デバイス管理のため、デバイスの追跡に使用されているシリアル番号を入手します。

    戻り値
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを確認します。

    戻り値
    boolean fastboot の消去を使用する場合は true、fastboot 形式を使用する場合は false 使用できます。

    isAdbRoot

    public abstract boolean isAdbRoot ()

    戻り値
    boolean デバイスに現在 adb root がある場合は true、そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    isAdbTcp

    public abstract boolean isAdbTcp ()

    戻り値
    boolean デバイスが adb-over-tcp に接続されている場合は truefalse できません。

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する

    戻り値
    boolean アプリの列挙がサポートされている場合は true、それ以外の場合は false

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    デバイス上のプラットフォームで、アプリのインストール時のターゲット SDK のブロックの回避がサポートされているかどうかを確認する

    戻り値
    boolean 低ターゲット SDK ブロックのバイパスがサポートされている場合は true、それ以外の場合は false

    例外
    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

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    デバイス上のファイルパスが実行可能ファイルである場合は true を返し、それ以外の場合は false を返します。

    パラメータ
    fullPath String

    戻り値
    boolean

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    デバイスがヘッドレス(画面なし)の場合は true を返し、それ以外の場合は false を返します。

    戻り値
    boolean

    例外
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    デバイス上のプラットフォームが実行時の権限の付与をサポートしているかどうかを確認する

    戻り値
    boolean 実行時の権限がサポートされている場合は true、それ以外の場合は false。

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    デバイスが TestDeviceState#FASTBOOT または TestDeviceState.FASTBOOTD にある場合、true を返します。

    戻り値
    boolean

    LogAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    デバイスから ANR を収集してログに記録します。

    パラメータ
    logger ITestLogger: ANR をログに記録する ITestLogger

    戻り値
    boolean ロギングが成功した場合は true、それ以外の場合は false。

    例外
    DeviceNotAvailableException

    logOnDevice

    public abstract void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    デバイスの logcat にメッセージを記録します。これは安全な呼び出しであり、 ロギングが失敗します

    パラメータ
    tag String: Logcat でメッセージをログに記録するタグ。

    level Log.LogLevel: Logcat のメッセージのデバッグレベル。

    format String: メッセージの形式。

    args Object: String.format() で置換される引数。

    mountDebugfs

    public abstract void mountDebugfs ()

    debugfs をマウントします。

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    デバイスを再起動するコマンドを発行し、コマンド完了時とデバイスが「いいえ」の場合に結果を返します。 adb で認識されなくなりました。

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    起動のたびにテストするためにデバイスを設定する手順を実施します。

    デバイスが完全に起動/使用可能になった後に呼び出す

    通常、このメソッドを次のように明示的に呼び出す必要はありません。 実装では、再起動時にこの手順を自動的に実行する必要があります。

    この関数を呼び出す必要があるのは、他のイベント(例: fastboot update コマンドが完了しました)

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    postInvocationTearDown

    public void postInvocationTearDown ()

    <ph type="x-smartling-placeholder"></ph> このメソッドは非推奨です。
    代わりに postInvocationTearDown(Throwable) を使用してください。

    呼び出し後に実行される、デバイス固有のクリーンアップのために追加の手順を実行する 完了です。

    postInvocationTearDown

    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

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    デバイスからディレクトリの内容を再帰的に pull します。

    パラメータ
    deviceFilePath String: リモートソースの絶対ファイルパス

    localDir File: ファイルを pull するローカル ディレクトリ

    戻り値
    boolean ファイルが正常に pull された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId)

    デバイスからディレクトリの内容を再帰的に pull します。

    パラメータ
    deviceFilePath String: リモートソースの絶対ファイルパス

    localDir File: ファイルを pull するローカル ディレクトリ

    userId int: pull 元のユーザー ID

    戻り値
    boolean ファイルが正常に pull された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    デバイスからファイルを取得し、ローカルの一時的な ERROR(/File) に保存して、それを返します。 File

    パラメータ
    remoteFilePath String: デバイス上のファイルの絶対パス。

    userId int: pull 元のユーザー ID

    戻り値
    File デバイス ファイルのコンテンツを含む ERROR(/File)。または、null なんらかの理由でコピーが失敗した(ホストのファイルシステムの問題を含む)

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pullFile

    public abstract File pullFile (String remoteFilePath)

    デバイスからファイルを取得し、ローカルの一時的な ERROR(/File) に保存して、それを返します。 File

    パラメータ
    remoteFilePath String: デバイス上のファイルの絶対パス。

    戻り値
    File デバイス ファイルのコンテンツを含む ERROR(/File)。または、null なんらかの理由でコピーが失敗した(ホストのファイルシステムの問題を含む)

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    デバイスからファイルを取得します。

    パラメータ
    remoteFilePath String: デバイス上のファイルの絶対パス。

    localFile File: コンテンツを保存するローカル ファイル。空でない場合、コンテンツは 交換されます。

    戻り値
    boolean ファイルが正常に取得された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    デバイスからファイルを取得します。

    パラメータ
    remoteFilePath String: デバイス上のファイルの絶対パス。

    localFile File: コンテンツを保存するローカル ファイル。空でない場合、コンテンツは 交換されます。

    userId int: pull 元のユーザー ID

    戻り値
    boolean ファイルが正常に取得された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pullFileContents

    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 デバイスとの接続が失われ、接続が失われても できます。

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                    int userId)

    ディレクトリの内容をデバイスに再帰的にプッシュします。

    パラメータ
    localDir File: push するローカル ディレクトリ

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    userId int: push 先のユーザー ID

    戻り値
    boolean ファイルが正常に push された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    ディレクトリの内容を再帰的にデバイスに push する(ただし、一部のディレクトリは除外) フィルタされます。

    パラメータ
    localDir File: push するローカル ディレクトリ

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    excludedDirectories : push 対象外の除外ディレクトリ名のセット。

    戻り値
    boolean ファイルが正常に push された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    ディレクトリの内容をデバイスに再帰的にプッシュします。

    パラメータ
    localDir File: push するローカル ディレクトリ

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    戻り値
    boolean ファイルが正常に push された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    boolean evaluateContentProviderNeeded)

    pushFile(File, String) のバリエーション。必要に応じてニーズの評価を検討できます。 コンテンツプロバイダを指定します

    パラメータ
    localFile File: push するローカル ファイル

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    evaluateContentProviderNeeded boolean: コンテンツ プロバイダが必要かどうかをチェックする

    戻り値
    boolean ファイルが正常に push された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    ファイルをデバイスにプッシュします。デフォルトではコンテンツ プロバイダを使用します。

    パラメータ
    localFile File: push するローカル ファイル

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    戻り値
    boolean ファイルが正常に push された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    int userId)

    ファイルをデバイスにプッシュします。デフォルトではコンテンツ プロバイダを使用します。

    パラメータ
    localFile File: push するローカル ファイル

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    userId int: push 先の userId

    戻り値
    boolean ファイルが正常に push された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    作成されたファイルを文字列からデバイスにプッシュ

    パラメータ
    contents String: push するファイルの内容

    deviceFilePath String: リモート デスティネーションの絶対ファイルパス

    戻り値
    boolean 文字列が正常にプッシュされた場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    再起動

    public abstract void reboot ()

    デバイスを adb モードで再起動します。

    デバイスが利用できるようになるまでブロックされます。

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    再起動

    public abstract void reboot (String reason)

    指定された reason を使用してデバイスを adb モードで再起動し、再起動しても保持されるようにします。

    デバイスが利用できるようになるまでブロックされます。

    最終再起動の理由を取得するには、sys.boot.reason プロパティをクエリします。

    パラメータ
    reason String: この再起動の理由。指定されていない場合は null

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    rememberIntoBootloader

    public abstract void rebootIntoBootloader ()

    デバイスをブートローダー モードで再起動します。

    デバイスがブートローダー モードになるまでブロックします。

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    restartIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    デバイスを Fastbootd モードで再起動します。

    デバイスが fastbootd モードになるまでブロックします。

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    launchIntoRecovery

    public abstract void rebootIntoRecovery ()

    デバイスを adb リカバリモードで再起動します。

    デバイスがリカバリ状態になるまでブロック

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    returnIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです)

    デバイスがサイドロード モードになるまでブロック

    パラメータ
    autoReboot boolean: サイドロード後にデバイスを自動的に再起動するかどうか

    例外
    DeviceNotAvailableException 再起動後にデバイスがサイドロードされていない場合

    returnIntoSideload

    public abstract void rebootIntoSideload ()

    デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです)

    デバイスがサイドロード モードになるまでブロック

    例外
    DeviceNotAvailableException 再起動後にデバイスがサイドロードされていない場合

    restartUntilOnline

    public abstract void rebootUntilOnline ()

    reboot() に代わるもので、デバイスがオンライン(adb に認識される)になるまでブロックする。

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    restartUntilOnline

    public abstract void rebootUntilOnline (String reason)

    reboot() に代わるもので、デバイスがオンライン(adb に認識される)になるまでブロックする。

    パラメータ
    reason String: この再起動の理由。指定されていない場合は null

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    関連項目:

    ユーザー空間を再起動

    public abstract void rebootUserspace ()

    デバイスのユーザー空間部分のみ再起動します。

    デバイスが利用できるようになるまでブロックされます。

    警告。ユーザー空間の再起動は現在開発中です。自己責任でご利用ください。

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    returnUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    rebootUserspace() ()} の代替手段。デバイスがオンラインになるまでブロックする adb で参照できます。

    例外
    DeviceNotAvailableException 再起動後にデバイスが利用できなくなった場合

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    デバイスのシステム パーティションを読み取り専用にします。デバイスを再起動する可能性があります。

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

    デバイスの system パーティションを書き込み可能にします。デバイスを再起動する可能性があります。

    例外
    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)

    パラメータとして渡される 1 つ以上のリスナーを使用して ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) を実行するためのコンビニエンス メソッド。

    パラメータ
    runner IRemoteAndroidTestRunner: テストを実行する IRemoteAndroidTestRunner

    listeners ITestLifeCycleReceiver: テスト結果リスナー

    戻り値
    boolean テストコマンドが完了した場合は true。失敗した場合は false 完了したが、復元は成功した

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。テストコマンドが完了し、復元に失敗します。

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    インストルメンテーション テストを実行し、デバイスを復元します。

    テスト実行が完了する前にデバイスとの接続が失われ、復元が成功すると、 testRunFailed と "false" がリスナーに通知されるが返されます。test コマンド 再実行されません。必要に応じて、呼び出し元が再試行します。

    テスト実行が完了する前にデバイスとの接続が失われ、復元に失敗した場合、 testRunFailed がリスナーに通知され、DeviceNotAvailableException がスローされます。

    パラメータ
    runner IRemoteAndroidTestRunner: テストを実行する IRemoteAndroidTestRunner

    listeners : テスト結果リスナー

    戻り値
    boolean テストコマンドが完了した場合は true。失敗した場合は false デバイス通信の例外により完了しましたが、復元は成功しました

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。テストコマンドが完了し、復元に失敗します。

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) と同じですが、 は、指定されたユーザーのテストを実行します。

    パラメータ
    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)

    デバイスに日付を設定します

    注: デバイスで日付を設定するには root が必要です

    パラメータ
    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 root が true である必要があります。

    パラメータ
    propKey String: 設定されるキー。

    propValue String: 設定するプロパティ値。

    戻り値
    boolean setprop コマンドが成功した場合は True を返し、成功した場合は False を返します。

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    このデバイスに使用する IDeviceRecovery を設定します。デバイスが 1 番目の場合に設定する必要があります 割り当てられています

    パラメータ
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    デバイスに使用する現在のリカバリモードを設定します。

    デバイスの通信で問題が発生した場合に、どの復旧方法を使用するかを制御するために使用します。 発生します。この方法は、必要な場合にのみ慎重に使用することをおすすめします(たとえば、 フレームワークが停止している場合など

    パラメータ
    mode ITestDevice.RecoveryMode: 「オンラインになるまで復元」かどうかオンにする必要があります。

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    デバイス管理のため、デバイスの参照に使用しているシリアル番号を追跡します。

    パラメータ
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを設定します。

    パラメータ
    useFastbootErase boolean: fastboot の消去を使用する場合は true、そうでない場合は false fastboot 形式を使用する必要があります。

    startLogcat

    public abstract void startLogcat ()

    バックグラウンドでデバイスからの logcat 出力のキャプチャを開始します。

    logcat 出力がすでにキャプチャされている場合、影響はありません。 データは後で getLogcat を使用して取得できます。

    デバイスを使用しなくなった場合は、stopLogcat() を呼び出す必要があります。

    通常、次の場合に startLogcat()stopLogcat() を呼び出す必要はありません。 TF フレームワークが logcat の開始と停止を行います。

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    エミュレータの出力を閉じて削除します。

    stopLogcat

    public abstract void stopLogcat ()

    デバイスからの logcat 出力のキャプチャを停止し、現在保存されている logcat データを破棄します。

    logcat 出力がキャプチャされていない場合、影響はありません。

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    デバイスを adb-over-tcp モードに切り替えます。

    戻り値
    String TCP シリアル番号または null(デバイスを切り替えられなかった場合)

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    デバイスを USB 経由で adb モードに切り替えます。

    戻り値
    boolean 切り替えが成功した場合は true、そうでない場合は false

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    ローカル ファイル ディレクトリの内容をデバイスに段階的に同期します。

    ローカル ファイルのタイムスタンプとリモート ファイルのタイムスタンプを比較して、プッシュするファイルを決定する 相当します。[新しいメッセージ] のみまたは存在しないファイルがデバイスにプッシュされます。したがって デバイスに設定されたファイルがすでに最新である場合、比較的小さいサイズにする必要があります。

    非表示のファイル(名前が「.」で始まるもの)は無視されます。

    使用例: syncFiles("/tmp/files", "/sdcard") は、次の場合に /sdcard/files ディレクトリを作成します。 /tmp/files の内容を /sdcard/files に再帰的にプッシュします。

    パラメータ
    localFileDir File: 再帰的に push するファイルを含むローカル ファイル ディレクトリ。

    deviceFilePath String: リモート デスティネーションの絶対ファイルパスのルート。thos のすべてのディレクトリ ファイルパスは読み取り可能でなければなりません。adb が root でない場合に /data/local/tmp にプッシュする 失敗する

    戻り値
    boolean ファイルが正常に同期された場合は true。そうでない場合は false

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    デバイスのロックを解除

    public abstract boolean unlockDevice ()

    デバイスが暗号化された状態の場合、デバイスのロックを解除します。

    このメソッドはフレームワークを再起動できますが、postBootSetup() は呼び出されません。したがって、 このメソッドが戻ったときに、デバイスはテストの準備ができていない可能性があります。

    戻り値
    boolean 成功したか、デバイスが暗号化されていない場合は true

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。
    UnsupportedOperationException 暗号化がデバイスでサポートされていない場合。

    DebugFS のマウント解除

    public abstract void unmountDebugfs ()

    debugfs のマウントを解除します。

    例外
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

    パラメータ
    timeOut long: フラグが設定されるまで待機する時間(ミリ秒)

    戻り値
    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: 待機時間(ミリ秒)

    戻り値
    boolean デバイスが利用可能な場合は true、リカバリが無効で利用できない場合は False。

    例外
    DeviceNotAvailableException waitTime 時間が経過してもデバイスが応答しない場合。

    waitForDeviceAvailableInRecoverPath

    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 recovery」に含めるためのブロック(これは Pod の IDeviceRecovery)。

    パラメータ
    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)

    デバイスを利用できないためのブロック(adb に欠落している)

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

    戻り値
    boolean 制限時間内にデバイスが利用できなくなった場合は true。 それ以外の場合は false

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    デバイスが adb を介して公開されるまで、ブロックします。デフォルトのタイムアウトを使用

    完了時にデバイスが必ずしもコマンドに反応するとは限りません。使用 代わりに waitForDeviceAvailable() を使用してください。

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    デバイスが adb を介して公開されるまで、ブロックします。

    完了時にデバイスが必ずしもコマンドに反応するとは限りません。使用 代わりに waitForDeviceAvailable() を使用してください。

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

    例外
    DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

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

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