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 |
abstract
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
エポックからの UTC 時間以降にデバイスがソフトリブートしたかどうかをデバイスの |
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,
指定したタイムアウトを設定して 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(
システム環境変数を使用して、長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
abstract
String
|
executeShellCommand(String command)
adb シェルコマンドを実行し、出力を |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するパラメータを追加して、adb シェルコマンドを実行します。 |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するパラメータを追加して、adb シェルコマンドを実行します。 |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
指定された adb シェルコマンドを実行し、コマンドが失敗した場合は複数回再試行します。 |
abstract
CommandResult
|
executeShellV2Command(String command)
adb シェルコマンドを実行し、コマンド ステータス出力(stdout、stderr)が適切な情報が入力された |
abstract
CommandResult
|
executeShellV2Command(String command, OutputStream pipeToOutput)
adb シェルコマンドを実行し、コマンド ステータス出力と stderr が正しく入力された |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
adb シェルコマンドを実行し、コマンド ステータス出力(stdout、stderr)が適切に入力された |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するパラメータを追加して、adb シェルコマンドを実行します。 |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)
コマンドの動作を制御するパラメータを追加して、adb シェルコマンドを実行します。 |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するパラメータを追加して、adb シェルコマンドを実行します。 |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するパラメータを追加して、adb シェルコマンドを実行します。 |
abstract
CommandResult
|
fastbootWipePartition(String partition)
デバイスのパーティションをワイプするヘルパー メソッド。 |
abstract
int
|
getApiLevel()
デバイスの API レベルを取得します。 |
abstract
String
|
getBasebandVersion()
このデバイスのベースバンド(無線)バージョンを取得するためのコンビニエンス メソッド。 |
abstract
Integer
|
getBattery()
デバイスの現在のバッテリー残量を返します。バッテリー残量が不明な場合は Null を返します。 |
abstract
boolean
|
getBooleanProperty(String name, boolean defaultValue)
指定されたプロパティのブール値を返します。 |
abstract
|
getBootHistory()
ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。 |
abstract
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
ヘルパー メソッドは、デバイスからエポックからの所定の時間および指定された時間単位から、起動時間と起動理由を含む起動履歴マップを収集します。 |
abstract
String
|
getBootloaderVersion()
このデバイスのブートローダー バージョンを取得するためのコンビニエンス メソッド。 |
abstract
String
|
getBuildAlias()
デバイスが現在実行しているビルドのエイリアスを取得します。 |
abstract
String
|
getBuildFlavor()
デバイスのビルド フレーバーを取得します。 |
abstract
String
|
getBuildId()
デバイスが現在実行中のビルドを取得します。 |
abstract
String
|
getBuildSigningKeys()
デバイス イメージの署名に使用される鍵のタイプを返します。 通常、Android デバイスはテストキー(AOSP など)またはリリースキー(個々のデバイス メーカーが制御)で署名されます。 |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor()
デバイスが割り当てられている場合は、キャッシュに保存された |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
デバイスが割り当てられている場合は、キャッシュに保存された |
abstract
String[]
|
getChildren(String deviceFilePath)
権限が原因で機能しないことがある |
abstract
AbstractConnection
|
getConnection()
デバイスに関連付けられた接続を返します。 |
abstract
String
|
getDeviceClass()
デバイスクラスを取得します。 |
abstract
long
|
getDeviceDate()
デバイスの日付をエポックからのミリ秒単位で返します。 |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
実際のデバイス オブジェクトを渡すことなく、デバイス情報から |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
実際のデバイス オブジェクトを渡すことなく、デバイス情報から |
abstract
TestDeviceState
|
getDeviceState()
デバイスの状態を取得します。 |
abstract
long
|
getDeviceTimeOffset(Date date)
デバイスと特定の |
abstract
InputStreamSource
|
getEmulatorOutput()
エミュレータの 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 |
abstract
long
|
getIntProperty(String name, long defaultValue)
デバイスから指定されたプロパティの整数値を返します。 |
abstract
long
|
getLastExpectedRebootTimeMillis()
Tradefed API が最後に再起動をトリガーした時間( |
abstract
int
|
getLaunchApiLevel()
デバイスで最初にリリースされた API レベルを取得します。 |
abstract
InputStreamSource
|
getLogcat()
logcat データのスナップショット ストリームを取得します。 |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
キャプチャした logcat データの最後の |
abstract
InputStreamSource
|
getLogcatDump()
デバイスの現在の logcat のダンプを取得します。 |
abstract
InputStreamSource
|
getLogcatSince(long date)
指定された日付以降にキャプチャされた logcat データのスナップショット ストリームを取得します。 |
abstract
String
|
getMountPoint(String mountName)
マウント ポイントを返します。 |
abstract
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
指定されたマウントポイント パスに対応する |
abstract
|
getMountPointInfo()
デバイスの /proc/mounts にある情報の解析済みバージョンを返します。 |
abstract
long
|
getPartitionFreeSpace(String partition)
デバイス パーティションの空き容量を判断するためのヘルパー メソッド。 |
abstract
ProcessInfo
|
getProcessByName(String processName)
ヘルパー メソッドは「pidof」コマンドと「stat」コマンドを実行し、指定されたプロセスの PID とプロセス開始時刻を含む |
abstract
String
|
getProcessPid(String process)
サービスの pid を返します。何か問題が発生した場合は null を返します。 |
abstract
String
|
getProductType()
このデバイスの製品タイプを取得するためのコンビニエンス メソッド。 |
abstract
String
|
getProductVariant()
このデバイスの商品バリエーションを取得するためのコンビニエンス メソッド。 |
abstract
String
|
getProperty(String name)
指定されたプロパティ値をデバイスから取得します。 |
abstract
ITestDevice.RecoveryMode
|
getRecoveryMode()
デバイスで現在使用されているリカバリモードを取得します。 |
abstract
String
|
getSerialNumber()
このデバイスのシリアル番号を取得するためのコンビニエンス メソッド。 |
abstract
|
getTombstones()
デバイスから Tombstone のリストを取得して返します。 |
abstract
long
|
getTotalMemory()
物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します。 |
abstract
boolean
|
getUseFastbootErase()
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを確認します。 |
abstract
boolean
|
isAdbRoot()
|
abstract
boolean
|
isAdbTcp()
|
abstract
boolean
|
isAppEnumerationSupported()
デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する |
abstract
boolean
|
isBypassLowTargetSdkBlockSupported()
デバイス上のプラットフォームが、アプリ インストールでの低ターゲット SDK ブロックの回避をサポートしているかどうかを確認する |
abstract
boolean
|
isDebugfsMounted()
debugfs がマウントされているかどうかを確認します。 |
abstract
boolean
|
isDeviceEncrypted()
デバイスが暗号化されているかどうかを返します。 |
abstract
boolean
|
isDirectory(String deviceFilePath)
デバイス上のパスがディレクトリの場合は true を返し、それ以外の場合は false を返します。 |
abstract
boolean
|
isEncryptionSupported()
デバイスが暗号化をサポートしているかどうかを返します。 |
abstract
boolean
|
isExecutable(String fullPath)
デバイス上のファイルパスが実行可能ファイルである場合は true を返し、それ以外の場合は false を返します。 |
abstract
boolean
|
isHeadless()
デバイスがヘッドレス(画面なし)の場合は true を返し、それ以外の場合は false を返します。 |
abstract
boolean
|
isRuntimePermissionSupported()
デバイス上のプラットフォームが実行時の権限の付与をサポートしているかどうかを確認する |
abstract
boolean
|
isStateBootloaderOrFastbootd()
デバイスが |
abstract
boolean
|
logAnrs(ITestLogger logger)
デバイスから ANR を収集してログに記録します。 |
abstract
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
デバイスの logcat にメッセージを記録します。 |
abstract
void
|
mountDebugfs()
debugfs をマウントします。 |
abstract
void
|
nonBlockingReboot()
デバイスを再起動するコマンドを発行し、コマンドが完了してデバイスが adb から表示されなくなると、返されます。 |
abstract
void
|
postBootSetup()
起動のたびにテストするようにデバイスを設定する手順を実施します。 |
default
void
|
postInvocationTearDown()
このメソッドは非推奨です。
代わりに |
abstract
void
|
postInvocationTearDown(Throwable invocationException)
呼び出しの完了後に実行される、デバイス固有のクリーンアップに必要な追加ステップ。 |
default
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
呼び出しフローの前にデバイスで実行される、デバイス固有の必要な設定のための追加ステップ。 |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir)
ディレクトリの内容をデバイスから再帰的に pull する。 |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
ディレクトリの内容をデバイスから再帰的に pull する。 |
abstract
File
|
pullFile(String remoteFilePath, int userId)
デバイスからファイルを取得し、ローカルの一時的な |
abstract
File
|
pullFile(String remoteFilePath)
デバイスからファイルを取得し、ローカルの一時的な |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile)
デバイスからファイルを取得します。 |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
デバイスからファイルを取得します。 |
abstract
String
|
pullFileContents(String remoteFilePath)
デバイスからファイルを取得し、コンテンツを返します。 |
abstract
File
|
pullFileFromExternal(String remoteFilePath)
デバイスの外部ストレージからファイルを取得してローカルの一時的な |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
ディレクトリの内容をデバイスに再帰的にプッシュします。 |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
フィルタリングされた一部のディレクトリを除外しながら、ディレクトリの内容をデバイスに再帰的にプッシュします。 |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
ディレクトリの内容をデバイスに再帰的にプッシュします。 |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
|
abstract
boolean
|
pushFile(File localFile, String deviceFilePath)
ファイルをデバイスにプッシュします。 |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, int userId)
ファイルをデバイスにプッシュします。 |
abstract
boolean
|
pushString(String contents, String deviceFilePath)
文字列から作成したデバイスにファイルをプッシュする |
abstract
void
|
reboot()
デバイスを adb モードで再起動します。 |
abstract
void
|
reboot(String reason)
指定された |
abstract
void
|
rebootIntoBootloader()
デバイスをブートローダー モードで再起動します。 |
abstract
void
|
rebootIntoFastbootd()
デバイスを Fastbootd モードで再起動します。 |
abstract
void
|
rebootIntoRecovery()
デバイスを adb リカバリモードで再起動します。 |
abstract
void
|
rebootIntoSideload(boolean autoReboot)
デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです) デバイスがサイドロード モードになるまでブロックする |
abstract
void
|
rebootIntoSideload()
デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです) デバイスがサイドロード モードになるまでブロックする |
abstract
void
|
rebootUntilOnline()
|
abstract
void
|
rebootUntilOnline(String reason)
|
abstract
void
|
rebootUserspace()
デバイスのユーザー空間部分のみ再起動する。 |
abstract
void
|
rebootUserspaceUntilOnline()
|
abstract
void
|
remountSystemReadOnly()
デバイスの system パーティションを読み取り専用にします。 |
abstract
void
|
remountSystemWritable()
デバイスの system パーティションを書き込み可能にします。 |
abstract
void
|
remountVendorReadOnly()
デバイスのベンダー パーティションを読み取り専用にします。 |
abstract
void
|
remountVendorWritable()
デバイスのベンダー パーティションを書き込み可能にする。 |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
パラメータとして渡される 1 つ以上のリスナーを使用して |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
インストルメンテーション テストを実行し、デバイスを復元します。 |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
|
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
|
abstract
void
|
setDate(Date date)
デバイスの日付を設定します。 注: デバイスで日付を設定するには root が必要です |
abstract
void
|
setOptions(TestDeviceOptions options)
デバイスの |
abstract
boolean
|
setProperty(String propKey, String propValue)
デバイスに指定されたプロパティ値を設定します。 |
abstract
void
|
setRecovery(IDeviceRecovery recovery)
このデバイスで使用する |
abstract
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
デバイスに使用する現在のリカバリモードを設定します。 |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを設定します。 |
abstract
void
|
startLogcat()
バックグラウンドでデバイスからの logcat 出力のキャプチャを開始します。 |
abstract
void
|
stopEmulatorOutput()
エミュレータの出力を閉じて削除します。 |
abstract
void
|
stopLogcat()
デバイスからの logcat 出力のキャプチャを停止し、現在保存されている logcat データを破棄します。 |
abstract
String
|
switchToAdbTcp()
デバイスを adb-over-tcp モードに切り替えます。 |
abstract
boolean
|
switchToAdbUsb()
デバイスを 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」状態にするためのブロック( |
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 ProcessInfo
を比較して、デバイスがソフトリブートしたかどうかを確認するヘルパー メソッド。getProcessByName(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」の場合、メッセージがログに記録され、root を有効にせずに戻ります。
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" 、"on" 、"true" の場合は true 、プロパティの値が "0" 、"n" 、"no" 、"off" 、"false" の場合は false 、それ以外の場合は defaultValue 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。
戻り値 | |
---|---|
|
起動時間(エポックからの秒単位の UTC 時間)と起動理由のマップ |
例外 | |
---|---|
DeviceNotAvailableException |
getBootHistoryBefore
public abstractgetBootHistorySince (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 |
getDeviceDate
public abstract long getDeviceDate ()
デバイスの日付をエポックからのミリ秒単位で返します。
戻り値 | |
---|---|
long |
デバイスの日付(エポック形式)。 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
実際のデバイス オブジェクトを渡すことなく、デバイス情報から DeviceDescriptor
を返してデバイス情報を取得します。
戻り値 | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
実際のデバイス オブジェクトを渡すことなく、デバイス情報から DeviceDescriptor
を返してデバイス情報を取得します。
パラメータ | |
---|---|
shortDescriptor |
boolean : 記述子を必要最小限の情報に制限するかどうか |
戻り値 | |
---|---|
DeviceDescriptor |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
デバイスと指定された ERROR(/Date)
との時間差を取得するヘルパー。内部でエポック時間を使用します。
パラメータ | |
---|---|
date |
Date |
戻り値 | |
---|---|
long |
ミリ秒単位の差 |
例外 | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
エミュレータの stdout と stderr のストリームを取得する
戻り値 | |
---|---|
InputStreamSource |
エミュレータ出力 |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
デバイスの外部ストレージの空き容量を判断するためのヘルパー メソッド。
戻り値 | |
---|---|
long |
空き容量(KB 単位) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、復元できない場合。 |
getFastbootProductType
public abstract String getFastbootProductType ()
デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。
この方法は、デバイスを fastboot モードにする必要がある場合にのみ使用してください。この場合、ITestDevice は、デバイスが正しくない状態または応答しない場合に、デバイスを fastboot に復元することを認識するため、汎用の getProductType()
メソッドよりも少し安全なバリアントです。
戻り値 | |
---|---|
String |
String 商品カテゴリ名、または特定できない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、復元できない場合。 |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。
この方法は、デバイスを fastboot モードにする必要がある場合にのみ使用してください。この場合、ITestDevice は、デバイスが正しくない状態または応答しない場合に、デバイスを 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
への参照を返します。
デバイスが 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()
が返す、Tradefed API が最後に再起動をトリガーした時刻(エポックからのミリ秒数)を返します。
戻り値 | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
デバイスで最初にリリースされた API レベルを取得します。デフォルトは UNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int |
デバイスで最初に起動された API レベルを示す整数 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
logcat データのスナップショット ストリームを取得します。
次の 2 つのモードで動作します。
TestDeviceOptions.getMaxLogcatDataSize()
バイトが返されます
戻り値 | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
キャプチャした logcat データの最後の maxBytes
のスナップショット ストリームを取得します。
これは、getLogcat()
スナップショット全体を取得することによるディスク容量が大きくなる可能性がある状態で、キャプチャされた logcat データのスナップショットを頻繁にキャプチャする場合に便利です。
パラメータ | |
---|---|
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
を返します。パスに何もマウントされていない場合や、/proc/mounts にマウントポイントとして表示されない場合は、null
を返します。
パラメータ | |
---|---|
mountpoint |
String |
戻り値 | |
---|---|
ITestDevice.MountPointInfo |
「/proc/mounts」の情報を含む MountPointInfo の ERROR(/List) |
例外 | |
---|---|
DeviceNotAvailableException |
関連項目:
getMountPointInfo
public abstractgetMountPointInfo ()
デバイスの /proc/mounts にある情報の解析済みバージョンを返します
戻り値 | |
---|---|
|
「/proc/mounts」の情報を含む MountPointInfo の ERROR(/List) |
例外 | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
デバイス パーティションの空き容量を判断するためのヘルパー メソッド。
パラメータ | |
---|---|
partition |
String |
戻り値 | |
---|---|
long |
空き容量(KB 単位) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、復元できない場合。 |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
ヘルパー メソッドは「pidof」コマンドと「stat」コマンドを実行し、指定されたプロセスの PID とプロセス開始時刻を含む ProcessInfo
オブジェクトを返します。
パラメータ | |
---|---|
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 abstractgetTombstones ()
デバイスから Tombstone のリストを取得して返します。root が必要です。
メソッドがベスト エフォート型であるため、なんらかの理由で 1 つの Tombstone を pull できない場合は、リストに表示されません。メソッドを早期に終了できるのは DeviceNotAvailableException
のみです。
戻り値 | |
---|---|
|
Tombstone ファイルのリスト。Tombstone がない場合は空になります。 |
例外 | |
---|---|
DeviceNotAvailableException |
関連項目:
getTotalMemory
public abstract long getTotalMemory ()
物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します
戻り値 | |
---|---|
long |
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 に接続されている場合は true 、そうでない場合は false 。 |
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 の更新コマンドが完了したときなど)です。
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、復元できない場合。 |
postInvocationTearDown
public void postInvocationTearDown ()
このメソッドは非推奨となりました。
代わりに 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)
フィルタリングされた一部のディレクトリを除外しながら、ディレクトリの内容をデバイスに再帰的にプッシュします。
パラメータ | |
---|---|
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」が返されます。テストコマンドは再実行されません。必要に応じて、呼び出し元が再試行します。
テスト実行が完了する前にデバイスとの接続が失われ、復元が失敗した場合、すべてのリスナーに testRunFailed が通知され、DeviceNotAvailableException がスローされます。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner : テストを実行する IRemoteAndroidTestRunner |
listeners |
: テスト結果リスナー |
戻り値 | |
---|---|
boolean |
テストコマンドが完了した場合は true 。false : デバイス通信例外が原因で完了できなかったが、復元は成功した場合 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、復元できない場合(テストコマンドが完了し、復元に失敗した場合など)。 |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
と同じですが、特定のユーザーに対してテストを実行します。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
デバイスの日付を設定します。
注: デバイスで日付を設定するには 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
を設定します。デバイスが最初に割り当てられるときに設定する必要があります。
パラメータ | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
デバイスに使用する現在のリカバリモードを設定します。
デバイスの通信で問題が発生した場合に、どの復旧方法を使用するかを制御するために使用します。この方法は、必要な場合(フレームワークがダウンしている場合など)にのみ使用することをおすすめします。
パラメータ | |
---|---|
mode |
ITestDevice.RecoveryMode : 「オンラインのみ復旧する」モードをオンにするかどうか。 |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを設定します。
パラメータ | |
---|---|
useFastbootErase |
boolean : fastboot の消去を使用する必要がある場合は true 、fastboot 形式を使用する必要がある場合は false 。 |
startLogcat
public abstract void startLogcat ()
バックグラウンドでデバイスからの logcat 出力のキャプチャを開始します。
logcat 出力がすでにキャプチャされている場合、影響はありません。 データは後で getLogcat を使用して取得できます。
デバイスを使用しなくなった場合は、stopLogcat()
を呼び出す必要があります。
TF フレームワークは logcat の開始と停止を行うため、通常、TF 呼び出しコンテキスト内で startLogcat()
と stopLogcat()
を呼び出す必要はありません。
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 : リモート デスティネーションの絶対ファイルパスのルート。そのファイルパス内のすべてのディレクトリが読み取り可能である必要があります。たとえば、adb が root でない場合に /data/local/tmp に push すると失敗します。 |
戻り値 | |
---|---|
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」状態にするためのブロック(これは 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 。 |