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 ProcessInfoを比較することで、デバイスがソフト再起動したかどうかを確認するヘルパー メソッド。

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

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

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 シェル コマンドを実行し、出力を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 シェル コマンドを実行し、コマンド ステータス出力と標準エラー出力が適切に設定された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 ()

エミュレータの標準出力と標準エラー出力のストリームを取得します。

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 IDeviceへの参照を返します。

abstract long getIntProperty (String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis ()

System.currentTimeMillis()によって返される EPOCH 以降、Tradefed API が最後に再起動をトリガーした時間をミリ秒単位で返します。

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を返します。そのパスに何もマウントされていない場合、またはマウントポイントとして /proc/mounts に表示されない場合はnull返します。

abstract getMountPointInfo ()

デバイス上の /proc/mounts 内の情報の解析されたバージョンを返します。

abstract long getPartitionFreeSpace (String partition)

デバイス パーティション上の空き領域の量を決定するヘルパー メソッド。

abstract ProcessInfo getProcessByName (String processName)

ヘルパー メソッドは、「pidof」および「stat」コマンドを実行し、指定されたプロセスの PID とプロセス開始時間を含むProcessInfoオブジェクトを返します。

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

デバイスが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 ()

このメソッドは廃止されました。代わりにpostInvocationTearDown(Throwable)を使用してください。

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)

デバイスからファイルを取得し、それをローカルの一時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, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories)

フィルタリングされた一部のディレクトリを除外しながら、ディレクトリの内容をデバイスに再帰的にプッシュします。

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

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

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) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

インストルメンテーション テストを実行し、デバイスのリカバリを提供します。

abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) 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 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」状態になることをブロックします (これはIDeviceRecoveryとは異なることに注意してください)。

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 : fastboot コマンドを実行するときに使用するシステム環境変数

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

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

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

投げる
DeviceNotAvailableException

ブート履歴の取得

public abstract  getBootHistorySince (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

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

デバイス状態の取得

public abstract TestDeviceState getDeviceState ()

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

戻り値
TestDeviceState

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への参照を返します。

デバイスが adb から切断され、再接続されるたびに、DDMS によって新しい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 つのモードで動作します。

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

    戻り値
    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」に情報を含むMountPointInfoERROR(/List)

    投げる
    DeviceNotAvailableException

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

    getMountPointInfo

    public abstract  getMountPointInfo ()

    デバイスに /proc /マウントの情報の解析バージョンを返します

    戻り値
    「/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」コマンドを実行し、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 abstract  getTombstones ()

    デバイスから墓石のリストを取得して返します。ルートが必要です。

    メソッドは最適なものであるため、何らかの理由で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)

    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)

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

    注:デバイスに日付を設定するには、ルートが必要です

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

    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