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」など |
abstract
String
|
getProcessPid(String process)
サービスの pid を返します。何か問題が発生した場合は null を返します。 |
abstract
String
|
getProductType()
このデバイスの製品タイプを取得するためのコンビニエンス メソッド。 |
abstract
String
|
getProductVariant()
このデバイスの商品バリエーションを取得するためのコンビニエンス メソッド。 |
abstract
String
|
getProperty(String name)
指定されたプロパティ値をデバイスから取得します。 |
abstract
ITestDevice.RecoveryMode
|
getRecoveryMode()
デバイスで現在使用されているリカバリモードを取得します。 |
abstract
String
|
getSerialNumber()
このデバイスのシリアル番号を取得するためのコンビニエンス メソッド。 |
abstract
|
getTombstones()
デバイスから Tombstone のリストを取得して返します。 |
abstract
long
|
getTotalMemory()
物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します |
default
String
|
getTrackingSerial()
デバイス管理のため、デバイスの追跡に使用されているシリアル番号を入手します。 |
abstract
boolean
|
getUseFastbootErase()
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを確認します。 |
abstract
boolean
|
isAdbRoot()
|
abstract
boolean
|
isAdbTcp()
|
abstract
boolean
|
isAppEnumerationSupported()
デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する |
abstract
boolean
|
isBypassLowTargetSdkBlockSupported()
デバイス上のプラットフォームで、アプリのインストール時のターゲット SDK のブロックの回避がサポートされているかどうかを確認する |
abstract
boolean
|
isDebugfsMounted()
debugfs がマウントされているかどうかを確認します。 |
abstract
boolean
|
isDeviceEncrypted()
デバイスが暗号化されているかどうかを返します。 |
abstract
boolean
|
isDirectory(String deviceFilePath)
デバイス上のパスがディレクトリである場合は true を返し、そうでない場合は false を返します。 |
abstract
boolean
|
isEncryptionSupported()
デバイスが暗号化をサポートしているかどうかを返します。 |
abstract
boolean
|
isExecutable(String fullPath)
デバイス上のファイルパスが実行可能ファイルである場合は true を返し、それ以外の場合は false を返します。 |
abstract
boolean
|
isHeadless()
デバイスがヘッドレス(画面なし)の場合は true を返し、それ以外の場合は false を返します。 |
abstract
boolean
|
isRuntimePermissionSupported()
デバイス上のプラットフォームが実行時の権限の付与をサポートしているかどうかを確認する |
abstract
boolean
|
isStateBootloaderOrFastbootd()
デバイスが |
abstract
boolean
|
logAnrs(ITestLogger logger)
デバイスから ANR を収集してログに記録します。 |
abstract
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
デバイスの logcat にメッセージを記録します。 |
abstract
void
|
mountDebugfs()
debugfs をマウントします。 |
abstract
void
|
nonBlockingReboot()
デバイスを再起動するコマンドを発行し、コマンド完了時とデバイスが「いいえ」の場合に結果を返します。 adb で認識されなくなりました。 |
abstract
void
|
postBootSetup()
起動のたびにテストするためにデバイスを設定する手順を実施します。 |
default
void
|
postInvocationTearDown()
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
代わりに |
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,
ディレクトリの内容を再帰的にデバイスに push する(ただし、一部のディレクトリは除外) フィルタされます。 |
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()
デバイスのシステム パーティションを読み取り専用にします。 |
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
|
setTrackingSerial(String trackingSerial)
デバイス管理のため、デバイスの参照に使用しているシリアル番号を追跡します。 |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを設定します。 |
abstract
void
|
startLogcat()
バックグラウンドでデバイスからの logcat 出力のキャプチャを開始します。 |
abstract
void
|
stopEmulatorOutput()
エミュレータの出力を閉じて削除します。 |
abstract
void
|
stopLogcat()
デバイスからの logcat 出力のキャプチャを停止し、現在保存されている logcat データを破棄します。 |
abstract
String
|
switchToAdbTcp()
デバイスを adb-over-tcp モードに切り替えます。 |
abstract
boolean
|
switchToAdbUsb()
デバイスを USB 経由で adb モードに切り替えます。 |
abstract
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
ローカル ファイル ディレクトリの内容をデバイスに段階的に同期します。 |
abstract
boolean
|
unlockDevice()
デバイスが暗号化された状態の場合、デバイスのロックを解除します。 |
abstract
void
|
unmountDebugfs()
debugfs のマウントを解除します。 |
abstract
boolean
|
waitForBootComplete(long timeOut)
デバイスの起動完了フラグが設定されるまでブロックします。 |
abstract
boolean
|
waitForDeviceAvailable()
デバイスが応答してテストに使用可能になるまで待機します。 |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
デバイスが応答してテストに使用可能になるまで待機します。 |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
リカバリパスを考慮せずに、デバイスが応答して使用可能になるのを待機します。 |
abstract
void
|
waitForDeviceBootloader()
デバイスが fastboot で認識されるまでブロックします。 |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
デバイスを「adb recovery」に含めるためのブロック(これは Pod の
|
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" に設定すると、メッセージがログに記録され、 返すことができます。
adb ルートを有効にすると、デバイスが adb から切断されることがあります。この方法は、 確認しましょう。
戻り値 | |
---|---|
boolean |
成功した場合は true 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
可能な限り、代わりに executeShellCommand(String)
を使用してください。
障害検出とパフォーマンスが向上します。
パラメータ | |
---|---|
timeout |
long : デバイスが応答していないと見なされるまでの時間(ミリ秒単位)。0L
タイムアウトなし |
commandArgs |
String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String |
コマンドから stdout を取得します。コマンドの実行が失敗した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
可能な限り、代わりに executeShellCommand(String)
を使用してください。
障害検出とパフォーマンスが向上します。
パラメータ | |
---|---|
commandArgs |
String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String |
コマンドから stdout を取得します。コマンドの実行が失敗した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
可能な限り、代わりに executeShellCommand(String)
を使用してください。
障害検出とパフォーマンスが向上します。
パラメータ | |
---|---|
timeout |
long : デバイスが応答していないと見なされるまでの時間(ミリ秒単位)。0L
タイムアウトなし |
envMap |
: コマンドに設定する環境 |
commandArgs |
String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String |
コマンドから stdout を取得します。コマンドの実行が失敗した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runFastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
システム コマンドとして fastboot コマンドを実行するヘルパー メソッド。
デバイスがすでに Fastboot モードの場合に使用することが想定されています。
パラメータ | |
---|---|
timeout |
long : コマンドが期限切れになるまでの時間(ミリ秒単位) |
commandArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runFastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
デフォルトのタイムアウトが設定されたシステム コマンドとして fastboot コマンドを実行するヘルパー メソッド 2 分。
デバイスがすでに Fastboot モードの場合に使用することが想定されています。
パラメータ | |
---|---|
commandArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッドです。
executeFastbootCommand(String)
と同じですが、タイムアウトを長くします。
パラメータ | |
---|---|
commandArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
長時間実行の fastboot コマンドを、システム コマンドとして実行するヘルパー メソッドです。 使用します。
executeFastbootCommand(String)
と同じですが、タイムアウトを長くします。
パラメータ | |
---|---|
envVarMap |
: fastboot コマンドが実行されるシステム環境変数 |
commandArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellCommand
public abstract String executeShellCommand (String command)
adb シェルコマンドを実行し、出力を String
として返すヘルパー メソッド。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
戻り値 | |
---|---|
String |
シェルの出力が |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
receiver |
IShellOutputReceiver : シェル出力の転送先の IShellOutputReceiver 。 |
maxTimeToOutputShellResponse |
long : コマンドの最長実行時間
レスポンスを出力できないようにします。timeUnit で指定された単位。 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : コマンドが失敗した場合に再試行する最大回数。
発生します。retryAttempts の場合、DeviceNotRespondException がスローされる
成功しません。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
receiver |
IShellOutputReceiver : シェル出力の転送先の IShellOutputReceiver 。 |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト。単位として
timeUnit で指定 |
maxTimeToOutputShellResponse |
long : コマンドの最長実行時間
レスポンスを出力できないようにします。timeUnit で指定された単位。 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : コマンドが失敗した場合に再試行する最大回数。
発生します。retryAttempts が親の場合、DeviceNotRespondException がスローされます。
表示されます。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
指定された adb シェルコマンドを実行します。コマンドが失敗した場合は再試行が複数回行われます。
より簡単な形式で、
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
と
使用します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
receiver |
IShellOutputReceiver : シェル出力の転送先の IShellOutputReceiver 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command)
adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が正しく入力された CommandResult
として結果を返すヘルパー メソッド。
パラメータ | |
---|---|
command |
String : 実行するコマンド。 |
戻り値 | |
---|---|
CommandResult |
CommandResult での結果。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
adb シェルコマンドを実行し、コマンド ステータス出力と stderr が正しく入力された CommandResult
として結果を返すヘルパー メソッド。stdout は
指定ストリームにルーティングされます
パラメータ | |
---|---|
command |
String : 実行するコマンド。 |
pipeToOutput |
OutputStream : 標準出力がリダイレクトされる ERROR(/OutputStream) 、または null。 |
戻り値 | |
---|---|
CommandResult |
CommandResult での結果。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が正しく入力された CommandResult
として結果を返すヘルパー メソッド。
パラメータ | |
---|---|
command |
String : 実行するコマンド。 |
pipeAsInput |
File : コマンドへの入力としてパイプされる ERROR(/File) 、または null。 |
戻り値 | |
---|---|
CommandResult |
CommandResult での結果。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト。単位として
timeUnit で指定 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : コマンドが失敗した場合に再試行する最大回数。
発生します。retryAttempts が親の場合、DeviceNotRespondException がスローされます。
表示されます。 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト。単位として
timeUnit で指定 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
pipeAsInput |
File : コマンドへの入力としてパイプされる ERROR(/File) 、または null。 |
pipeToOutput |
OutputStream : 標準出力がリダイレクトされる ERROR(/OutputStream) 、または null。 |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト。単位として
timeUnit で指定 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : コマンドが失敗した場合に再試行する最大回数。
発生します。retryAttempts が親の場合、DeviceNotRespondException がスローされます。
表示されます。 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
runShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御する追加のパラメータを指定して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
pipeAsInput |
File : コマンドへの入力としてパイプされる ERROR(/File) 、または null。 |
pipeToOutput |
OutputStream : 標準出力がリダイレクトされる ERROR(/OutputStream) 、または null。 |
pipeToError |
OutputStream : 標準エラーのリダイレクト先の ERROR(/OutputStream) 、または null。 |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト。単位として
timeUnit で指定 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : コマンドが失敗した場合に再試行する最大回数。
発生します。retryAttempts が親の場合、DeviceNotRespondException がスローされます。
表示されます。 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
デバイスのパーティションをワイプするヘルパー メソッド。
getUseFastbootErase()
が true
の場合、fastboot の消去を使用してワイプされます
作成されます。その後、デバイスの次回起動時にファイルシステムを作成する必要があります。
それ以外の場合は、fastboot 形式を使用してデバイスに新しいファイル システムが作成されます。
デバイスがすでに Fastboot モードの場合に使用することが想定されています。
パラメータ | |
---|---|
partition |
String : ワイプするパーティション |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
getApiLevel
public abstract int getApiLevel ()
デバイスの API レベルを取得します。デフォルトは UNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int |
デバイスの API レベルを示す整数 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
このデバイスのベースバンド(無線)バージョンを取得するためのコンビニエンス メソッド。ラジオのバージョンを取得する
はデバイス固有であるため、すべてのデバイスに対して正しい情報が返されるとは限りません。この
メソッドは gsm.version.baseband プロパティに依存して正しいバージョン情報を返します。
これは一部の CDMA デバイスでは正確ではなく、ここで返されるバージョンは一致しない場合があります
fastboot から報告されたバージョンで、CDMA 無線通信のバージョンが返されない場合があります。
要約: gsm.version.baseband プロパティが
fastboot getvar version-baseband
から返されるバージョンと同じです。
戻り値 | |
---|---|
String |
String ベースバンド バージョン、または特定できない場合は null
(デバイスにラジオがないか、バージョン文字列を読み取れません) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても 復元することはできません。 |
getBattery
public abstract Integer getBattery ()
デバイスの現在のバッテリー残量を返します。バッテリー残量が不明な場合は Null を返します。
戻り値 | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
指定されたプロパティのブール値を返します。
パラメータ | |
---|---|
name |
String : プロパティ名 |
defaultValue |
boolean : プロパティが空または存在しない場合に返されるデフォルト値。 |
戻り値 | |
---|---|
boolean |
プロパティの値が "1" 、"y" 、"yes" の場合は true
"on" または "true" (プロパティの値が "0" の場合は false )。
"n" 、"no" 、"off" 、"false" 、defaultValue
できません。 |
例外 | |
---|---|
DeviceNotAvailableException |
getBootHistory
public 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 モードにする必要がある場合にのみ使用してください。より安全性の高いバリエーション
この場合は、汎用の getProductType()
メソッドよりも
は、デバイスの状態が不適切である場合や、デバイスが
応答がありません。
戻り値 | |
---|---|
String |
String 商品カテゴリ名、または特定できない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。
この方法は、デバイスを fastboot モードにする必要がある場合にのみ使用してください。より安全性の高いバリエーション
この場合は、汎用の getProductType()
メソッドよりも
は、デバイスの状態が不適切である場合や、デバイスが
応答がありません。
戻り値 | |
---|---|
String |
String 商品カテゴリ名、または特定できない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
fastboot モードのシリアル番号を返します。
戻り値 | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
指定された fastboot 変数の値をデバイスから取得します。
パラメータ | |
---|---|
variableName |
String : 変数名 |
戻り値 | |
---|---|
String |
プロパティ値、または null (存在しない場合) |
例外 | |
---|---|
|
UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
デバイス上のリモート ファイルへの参照を取得します。
パラメータ | |
---|---|
path |
String : 取得するファイルパス。絶対パスまたは「/」に対する相対パスを指定できます。(
「/system」の両方「system」構文がサポートされています) |
戻り値 | |
---|---|
IFileEntry |
指定された path のファイルができない場合、IFileEntry または null
見つける |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
関連付けられている ddmlib IDevice
への参照を返します。
デバイスの接続が解除されたり、デバイスが切断されたりするたびに、DDMS によって新しい IDevice
が割り当てられることがあります。
接続する必要があります。したがって、呼び出し元は IDevice
への参照を保持しないようにする必要があります。
その参照が古くなる可能性があるためです
戻り値 | |
---|---|
IDevice |
IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
デバイスから指定されたプロパティの整数値を返します。
パラメータ | |
---|---|
name |
String : プロパティ名 |
defaultValue |
long : プロパティが空または存在しない場合に返されるデフォルト値。 |
戻り値 | |
---|---|
long |
プロパティ値、または defaultValue (プロパティが空、存在しない場合)
整数値がない場合などです |
例外 | |
---|---|
DeviceNotAvailableException |
getLastExpectRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Tradefed API が最後に再起動をトリガーした時刻(エポックからのミリ秒数)を返します。
System.currentTimeMillis()
から返されます。
戻り値 | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
デバイスで最初にリリースされた API レベルを取得します。デフォルトは UNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int |
デバイスで最初に起動された API レベルを示す整数 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
logcat データのスナップショット ストリームを取得します。
次の 2 つのモードで動作します。
TestDeviceOptions.getMaxLogcatDataSize()
バイトが返されます
logcat キャプチャ
戻り値 | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
キャプチャされた logcat データの最後の maxBytes
のスナップショット ストリームを取得します。
キャプチャした logcat データのスナップショットを頻繁にキャプチャする場合に便利です
getLogcat()
スナップショット全体を取得することによる、ディスク容量が大きくなる可能性があるという心配もありません。
パラメータ | |
---|---|
maxBytes |
int : 返されるデータの最大量。通信可能な量と
メモリに無理なく収まる |
戻り値 | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
デバイスの現在の logcat のダンプを取得します。getLogcat()
とは異なり、このメソッドは
常に logcat の静的ダンプが返されます。
デバイスにアクセスできない場合は何も返されないというデメリットがあります。
戻り値 | |
---|---|
InputStreamSource |
logcat データの InputStreamSource 。失敗した場合は空のストリームが返されます
logcat データをキャプチャします |
getLogcat since
public abstract InputStreamSource getLogcatSince (long date)
指定された日付以降にキャプチャされた logcat データのスナップショット ストリームを取得します。日時
デバイスは getDeviceDate()
を使用してください。
パラメータ | |
---|---|
date |
long : スナップショットを開始するタイミングをエポック形式で示したミリ秒単位の経過時間。
(「date +%s」を使用して取得できます) |
戻り値 | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
マウント ポイントを返します。
IDevice
のキャッシュに保存された情報を利用できない場合は、デバイスに直接クエリします。
TODO: この動作を IDevice#getMountPoint(String)
に移行する
パラメータ | |
---|---|
mountName |
String : マウント ポイントの名前 |
戻り値 | |
---|---|
String |
マウント ポイントまたは null |
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
指定されたマウントポイント パスに対応する MountPointInfo
を返します。
そのパスに何もマウントされていない場合、またはパスが表示されない場合は null
/proc/mounts をマウント ポイントとして指定します。
パラメータ | |
---|---|
mountpoint |
String |
戻り値 | |
---|---|
ITestDevice.MountPointInfo |
「/proc/mounts」の情報を含む 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」などProcessInfo
オブジェクトを返します。
指定されたプロセスの PID とプロセス開始時刻。
パラメータ | |
---|---|
processName |
String : プロシージャ名の文字列。 |
戻り値 | |
---|---|
ProcessInfo |
指定された processName の ProcessInfo |
例外 | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
サービスの pid を返します。何か問題が発生した場合は null を返します。
パラメータ | |
---|---|
process |
String : プロシージャ名の文字列。 |
戻り値 | |
---|---|
String |
例外 | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
このデバイスの製品タイプを取得するためのコンビニエンス メソッド。
この方法は、デバイスが adb モードまたは fastboot モードの場合に利用できます。
戻り値 | |
---|---|
String |
String 商品カテゴリ名。null にはならない |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても 商品タイプを特定できない場合 |
getProductVariant
public abstract String getProductVariant ()
このデバイスの商品バリエーションを取得するためのコンビニエンス メソッド。
この方法は、デバイスが adb モードまたは fastboot モードの場合に利用できます。
戻り値 | |
---|---|
String |
バリエーション商品の名前 String 、または使用できない場合は null
意思決定 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
getProperty
public abstract String getProperty (String name)
指定されたプロパティ値をデバイスから取得します。
パラメータ | |
---|---|
name |
String : プロパティ名 |
戻り値 | |
---|---|
String |
プロパティ値、または null (存在しない場合) |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
デバイスで現在使用されているリカバリモードを取得します。
戻り値 | |
---|---|
ITestDevice.RecoveryMode |
使用している現在のリカバリモード。 |
getSerialNumber
public abstract String getSerialNumber ()
このデバイスのシリアル番号を取得するためのコンビニエンス メソッド。
戻り値 | |
---|---|
String |
String のシリアル番号 |
getTombstone
public abstractgetTombstones ()
デバイスから Tombstone のリストを取得して返します。root が必要です。
方法であるため、なんらかの理由で 1 つの Tombstone を pull できない場合、
リストにない指標が含まれます。メソッドを終了するのは DeviceNotAvailableException
のみです
早期に発見できます
戻り値 | |
---|---|
|
Tombstone ファイルのリスト。Tombstone がない場合は空になります。 |
例外 | |
---|---|
DeviceNotAvailableException |
関連項目:
getTotalMemory
public abstract long getTotalMemory ()
物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します
戻り値 | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
デバイス管理のため、デバイスの追跡に使用されているシリアル番号を入手します。
戻り値 | |
---|---|
String |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを確認します。
戻り値 | |
---|---|
boolean |
fastboot の消去を使用する場合は true 、fastboot 形式を使用する場合は false
使用できます。 |
isAdbRoot
public abstract boolean isAdbRoot ()
戻り値 | |
---|---|
boolean |
デバイスに現在 adb root がある場合は true 、そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
isAdbTcp
public abstract boolean isAdbTcp ()
戻り値 | |
---|---|
boolean |
デバイスが adb-over-tcp に接続されている場合は 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 update コマンドが完了しました)
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
postInvocationTearDown
public void postInvocationTearDown ()
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
代わりに postInvocationTearDown(Throwable)
を使用してください。
呼び出し後に実行される、デバイス固有のクリーンアップのために追加の手順を実行する 完了です。
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
呼び出し後に実行される、デバイス固有のクリーンアップに必要な追加の手順 完了です。
パラメータ | |
---|---|
invocationException |
Throwable : 呼び出しの失敗によって発生した最後の例外(存在する場合)。 |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
デバイス固有の必要な設定のために、事前にデバイス上で実行される追加の手順 確認します。
パラメータ | |
---|---|
info |
IBuildInfo : デバイスの IBuildInfo 。 |
attributes |
MultiMap : 呼び出しコンテキストに格納されている属性 |
例外 | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
デバイスからディレクトリの内容を再帰的に pull します。
パラメータ | |
---|---|
deviceFilePath |
String : リモートソースの絶対ファイルパス |
localDir |
File : ファイルを pull するローカル ディレクトリ |
戻り値 | |
---|---|
boolean |
ファイルが正常に pull された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir, int userId)
デバイスからディレクトリの内容を再帰的に pull します。
パラメータ | |
---|---|
deviceFilePath |
String : リモートソースの絶対ファイルパス |
localDir |
File : ファイルを pull するローカル ディレクトリ |
userId |
int : pull 元のユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが正常に pull された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pullFile
public abstract File pullFile (String remoteFilePath, int userId)
デバイスからファイルを取得し、ローカルの一時的な ERROR(/File)
に保存して、それを返します。
File
。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
userId |
int : pull 元のユーザー ID |
戻り値 | |
---|---|
File |
デバイス ファイルのコンテンツを含む ERROR(/File) 。または、null
なんらかの理由でコピーが失敗した(ホストのファイルシステムの問題を含む) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pullFile
public abstract File pullFile (String remoteFilePath)
デバイスからファイルを取得し、ローカルの一時的な ERROR(/File)
に保存して、それを返します。
File
。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
戻り値 | |
---|---|
File |
デバイス ファイルのコンテンツを含む ERROR(/File) 。または、null
なんらかの理由でコピーが失敗した(ホストのファイルシステムの問題を含む) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile)
デバイスからファイルを取得します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
localFile |
File : コンテンツを保存するローカル ファイル。空でない場合、コンテンツは
交換されます。 |
戻り値 | |
---|---|
boolean |
ファイルが正常に取得された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
デバイスからファイルを取得します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
localFile |
File : コンテンツを保存するローカル ファイル。空でない場合、コンテンツは
交換されます。 |
userId |
int : pull 元のユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが正常に取得された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
デバイスからファイルを取得し、コンテンツを返します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
戻り値 | |
---|---|
String |
デバイス ファイルのコンテンツを含む String 。または、null
なんらかの理由でコピーが失敗した(ホストのファイルシステムの問題を含む) |
例外 | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
デバイスの外部ストレージからファイルを取得し、
ローカルの一時的な ERROR(/File)
を実行し、その File
への参照を返します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルのパス(デバイスの外部ストレージを基準とする相対パス)
マウント ポイント |
戻り値 | |
---|---|
File |
デバイス ファイルのコンテンツを含む ERROR(/File) 。または、null
なんらかの理由でコピーが失敗した(ホストのファイルシステムの問題を含む) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath, int userId)
ディレクトリの内容をデバイスに再帰的にプッシュします。
パラメータ | |
---|---|
localDir |
File : push するローカル ディレクトリ |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
userId |
int : push 先のユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
ディレクトリの内容を再帰的にデバイスに push する(ただし、一部のディレクトリは除外) フィルタされます。
パラメータ | |
---|---|
localDir |
File : push するローカル ディレクトリ |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
excludedDirectories |
: push 対象外の除外ディレクトリ名のセット。 |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
ディレクトリの内容をデバイスに再帰的にプッシュします。
パラメータ | |
---|---|
localDir |
File : push するローカル ディレクトリ |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
pushFile(File, String)
のバリエーション。必要に応じてニーズの評価を検討できます。
コンテンツプロバイダを指定します
パラメータ | |
---|---|
localFile |
File : push するローカル ファイル |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
evaluateContentProviderNeeded |
boolean : コンテンツ プロバイダが必要かどうかをチェックする |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
ファイルをデバイスにプッシュします。デフォルトではコンテンツ プロバイダを使用します。
パラメータ | |
---|---|
localFile |
File : push するローカル ファイル |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, int userId)
ファイルをデバイスにプッシュします。デフォルトではコンテンツ プロバイダを使用します。
パラメータ | |
---|---|
localFile |
File : push するローカル ファイル |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
userId |
int : push 先の userId |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
pushString
public abstract boolean pushString (String contents, String deviceFilePath)
作成されたファイルを文字列からデバイスにプッシュ
パラメータ | |
---|---|
contents |
String : push するファイルの内容 |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
戻り値 | |
---|---|
boolean |
文字列が正常にプッシュされた場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
再起動
public abstract void reboot ()
デバイスを adb モードで再起動します。
デバイスが利用できるようになるまでブロックされます。
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
再起動
public abstract void reboot (String reason)
指定された reason
を使用してデバイスを adb モードで再起動し、再起動しても保持されるようにします。
デバイスが利用できるようになるまでブロックされます。
最終再起動の理由を取得するには、sys.boot.reason
プロパティをクエリします。
パラメータ | |
---|---|
reason |
String : この再起動の理由。指定されていない場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
rememberIntoBootloader
public abstract void rebootIntoBootloader ()
デバイスをブートローダー モードで再起動します。
デバイスがブートローダー モードになるまでブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
restartIntoFastbootd
public abstract void rebootIntoFastbootd ()
デバイスを Fastbootd モードで再起動します。
デバイスが fastbootd モードになるまでブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
launchIntoRecovery
public abstract void rebootIntoRecovery ()
デバイスを adb リカバリモードで再起動します。
デバイスがリカバリ状態になるまでブロック
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
returnIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです)
デバイスがサイドロード モードになるまでブロック
パラメータ | |
---|---|
autoReboot |
boolean : サイドロード後にデバイスを自動的に再起動するかどうか |
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスがサイドロードされていない場合 |
returnIntoSideload
public abstract void rebootIntoSideload ()
デバイスを adb サイドロード モードで再起動します(これはリカバリ時の特殊なモードです)
デバイスがサイドロード モードになるまでブロック
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスがサイドロードされていない場合 |
restartUntilOnline
public abstract void rebootUntilOnline ()
reboot()
に代わるもので、デバイスがオンライン(adb に認識される)になるまでブロックする。
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
restartUntilOnline
public abstract void rebootUntilOnline (String reason)
reboot()
に代わるもので、デバイスがオンライン(adb に認識される)になるまでブロックする。
パラメータ | |
---|---|
reason |
String : この再起動の理由。指定されていない場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
関連項目:
ユーザー空間を再起動
public abstract void rebootUserspace ()
デバイスのユーザー空間部分のみ再起動します。
デバイスが利用できるようになるまでブロックされます。
警告。ユーザー空間の再起動は現在開発中です。自己責任でご利用ください。
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
returnUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
rebootUserspace()
()} の代替手段。デバイスがオンラインになるまでブロックする
adb で参照できます。
例外 | |
---|---|
DeviceNotAvailableException |
再起動後にデバイスが利用できなくなった場合 |
remountSystemReadOnly
public abstract void remountSystemReadOnly ()
デバイスのシステム パーティションを読み取り専用にします。デバイスを再起動する可能性があります。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountSystemWritable
public abstract void remountSystemWritable ()
デバイスの system パーティションを書き込み可能にします。デバイスを再起動する可能性があります。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorReadOnly
public abstract void remountVendorReadOnly ()
デバイスのベンダー パーティションを読み取り専用にします。デバイスを再起動する可能性があります。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
デバイスのベンダー パーティションを書き込み可能にします。デバイスを再起動する可能性があります。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
パラメータとして渡される 1 つ以上のリスナーを使用して ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
を実行するためのコンビニエンス メソッド。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner : テストを実行する IRemoteAndroidTestRunner |
listeners |
ITestLifeCycleReceiver : テスト結果リスナー |
戻り値 | |
---|---|
boolean |
テストコマンドが完了した場合は true 。失敗した場合は false
完了したが、復元は成功した |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。テストコマンドが完了し、復元に失敗します。 |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
インストルメンテーション テストを実行し、デバイスを復元します。
テスト実行が完了する前にデバイスとの接続が失われ、復元が成功すると、 testRunFailed と "false" がリスナーに通知されるが返されます。test コマンド 再実行されません。必要に応じて、呼び出し元が再試行します。
テスト実行が完了する前にデバイスとの接続が失われ、復元に失敗した場合、 testRunFailed がリスナーに通知され、DeviceNotAvailableException がスローされます。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner : テストを実行する IRemoteAndroidTestRunner |
listeners |
: テスト結果リスナー |
戻り値 | |
---|---|
boolean |
テストコマンドが完了した場合は true 。失敗した場合は false
デバイス通信の例外により完了しましたが、復元は成功しました |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。テストコマンドが完了し、復元に失敗します。 |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
と同じですが、特定のユーザーに対してテストを実行します。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
デバイスに日付を設定します
注: デバイスで日付を設定するには root が必要です
パラメータ | |
---|---|
date |
Date : 特定の日付を指定します。null の場合はホスト日付が使用されます |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
デバイスの TestDeviceOptions
を設定する
パラメータ | |
---|---|
options |
TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
デバイスに指定されたプロパティ値を設定します。adb root が true である必要があります。
パラメータ | |
---|---|
propKey |
String : 設定されるキー。 |
propValue |
String : 設定するプロパティ値。 |
戻り値 | |
---|---|
boolean |
setprop コマンドが成功した場合は True を返し、成功した場合は False を返します。 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
このデバイスに使用する IDeviceRecovery
を設定します。デバイスが 1 番目の場合に設定する必要があります
割り当てられています
パラメータ | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
デバイスに使用する現在のリカバリモードを設定します。
デバイスの通信で問題が発生した場合に、どの復旧方法を使用するかを制御するために使用します。 発生します。この方法は、必要な場合にのみ慎重に使用することをおすすめします(たとえば、 フレームワークが停止している場合など
パラメータ | |
---|---|
mode |
ITestDevice.RecoveryMode : 「オンラインになるまで復元」かどうかオンにする必要があります。 |
setTrackingSerial
public abstract void setTrackingSerial (String trackingSerial)
デバイス管理のため、デバイスの参照に使用しているシリアル番号を追跡します。
パラメータ | |
---|---|
trackingSerial |
String |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを設定します。
パラメータ | |
---|---|
useFastbootErase |
boolean : fastboot の消去を使用する場合は true 、そうでない場合は false
fastboot 形式を使用する必要があります。 |
startLogcat
public abstract void startLogcat ()
バックグラウンドでデバイスからの logcat 出力のキャプチャを開始します。
logcat 出力がすでにキャプチャされている場合、影響はありません。 データは後で getLogcat を使用して取得できます。
デバイスを使用しなくなった場合は、stopLogcat()
を呼び出す必要があります。
通常、次の場合に startLogcat()
と stopLogcat()
を呼び出す必要はありません。
TF フレームワークが logcat の開始と停止を行います。
stopEmulatorOutput
public abstract void stopEmulatorOutput ()
エミュレータの出力を閉じて削除します。
stopLogcat
public abstract void stopLogcat ()
デバイスからの logcat 出力のキャプチャを停止し、現在保存されている logcat データを破棄します。
logcat 出力がキャプチャされていない場合、影響はありません。
switchToAdbTcp
public abstract String switchToAdbTcp ()
デバイスを adb-over-tcp モードに切り替えます。
戻り値 | |
---|---|
String |
TCP シリアル番号または null (デバイスを切り替えられなかった場合) |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
デバイスを USB 経由で adb モードに切り替えます。
戻り値 | |
---|---|
boolean |
切り替えが成功した場合は true 、そうでない場合は false 。 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
ローカル ファイル ディレクトリの内容をデバイスに段階的に同期します。
ローカル ファイルのタイムスタンプとリモート ファイルのタイムスタンプを比較して、プッシュするファイルを決定する 相当します。[新しいメッセージ] のみまたは存在しないファイルがデバイスにプッシュされます。したがって デバイスに設定されたファイルがすでに最新である場合、比較的小さいサイズにする必要があります。
非表示のファイル(名前が「.」で始まるもの)は無視されます。
使用例: syncFiles("/tmp/files", "/sdcard") は、次の場合に /sdcard/files ディレクトリを作成します。 /tmp/files の内容を /sdcard/files に再帰的にプッシュします。
パラメータ | |
---|---|
localFileDir |
File : 再帰的に push するファイルを含むローカル ファイル ディレクトリ。 |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパスのルート。thos のすべてのディレクトリ
ファイルパスは読み取り可能でなければなりません。adb が root でない場合に /data/local/tmp にプッシュする
失敗する |
戻り値 | |
---|---|
boolean |
ファイルが正常に同期された場合は true 。そうでない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
デバイスのロックを解除
public abstract boolean unlockDevice ()
デバイスが暗号化された状態の場合、デバイスのロックを解除します。
このメソッドはフレームワークを再起動できますが、postBootSetup()
は呼び出されません。したがって、
このメソッドが戻ったときに、デバイスはテストの準備ができていない可能性があります。
戻り値 | |
---|---|
boolean |
成功したか、デバイスが暗号化されていない場合は true 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
UnsupportedOperationException |
暗号化がデバイスでサポートされていない場合。 |
DebugFS のマウント解除
public abstract void unmountDebugfs ()
debugfs のマウントを解除します。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
デバイスの起動完了フラグが設定されるまでブロックします。
パラメータ | |
---|---|
timeOut |
long : フラグが設定されるまで待機する時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
デバイスの起動完了フラグがタイムアウト時間内に設定されている場合は true |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
デバイスが応答してテストに使用可能になるまで待機します。デフォルトのタイムアウトを使用します。
戻り値 | |
---|---|
boolean |
デバイスが利用可能な場合は true、リカバリが無効で利用できない場合は False。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable (long waitTime)
デバイスが応答してテストに使用可能になるまで待機します。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
デバイスが利用可能な場合は true、リカバリが無効で利用できない場合は False。 |
例外 | |
---|---|
DeviceNotAvailableException |
waitTime 時間が経過してもデバイスが応答しない場合。 |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
リカバリパスを考慮せずに、デバイスが応答して使用可能になるのを待機します。
パラメータ | |
---|---|
waitTime |
long |
戻り値 | |
---|---|
boolean |
デバイスが利用可能な場合は true、利用できない場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
waitForDeviceBootloader
public abstract void waitForDeviceBootloader ()
デバイスが fastboot で認識されるまでブロックします。デフォルトのタイムアウトを使用します。
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
デバイスを「adb recovery」に含めるためのブロック(これは Pod の
IDeviceRecovery
)。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
時間切れになる前にデバイスがリカバリに起動する場合は true 。
それ以外の場合は false |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
デバイスを「adb sideload」に配置するためのブロック州
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
時間切れになる前にデバイスがサイドロードで起動する場合は true 。それ以外の場合は false
|
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
デバイスを利用できないためのブロック(adb に欠落している)
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
制限時間内にデバイスが利用できなくなった場合は true 。
それ以外の場合は false |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
デバイスが adb を介して公開されるまで、ブロックします。デフォルトのタイムアウトを使用
完了時にデバイスが必ずしもコマンドに反応するとは限りません。使用
代わりに waitForDeviceAvailable()
を使用してください。
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
デバイスが adb を介して公開されるまで、ブロックします。
完了時にデバイスが必ずしもコマンドに反応するとは限りません。使用
代わりに waitForDeviceAvailable()
を使用してください。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスとの接続が失われ、接続が失われても できます。 |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
デバイスが基本的な adb シェルコマンドに応答するまで待機します。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
waitTime が経過する前にデバイスが応答する場合は true 。 |