NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
ITestDevice
のフルスタックではない Android デバイスのデフォルト実装。
概要
ネストされたクラス | |
---|---|
class |
NativeDevice.AdbAction
OS の「adb ....」コマンドを実行するための |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
定数 | |
---|---|
int |
INVALID_USER_ID
無効なユーザー ID または見つからないユーザー ID に対して返される値: UserHandle は -10000 の値を定義しています |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
実行するコマンドのデフォルトの再試行回数 |
フィールド | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
パブリック コンストラクタ | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
|
パブリック メソッド | |
---|---|
void
|
batchPrefetchStartupBuildProps()
各プロパティに対して「adb getprop」を呼び出すのではなく、必要なすべてのプロパティをプリフェッチすることで、微調整(約 400 ミリ秒)を実施。 |
boolean
|
canSwitchToHeadlessSystemUser()
ヘッドレス SYSTEM ユーザーへの切り替えが許可されるかどうかを返します。 |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
サポートされている最小レベルで、機能が現在サポートされているかどうかを確認します。 |
boolean
|
checkConnectivity()
デバイスがネットワークに接続されていることを確認します。 |
boolean
|
clearErrorDialogs()
デバイスの UI に現在表示されているエラー ダイアログを閉じようとします。 |
void
|
clearLastConnectedWifiNetwork()
最後に接続した Wi-Fi ネットワークを消去します。 |
void
|
clearLogcat()
蓄積された logcat データを削除します。 |
boolean
|
connectToWifiNetwork(
Wi-Fi ネットワークに接続します。 |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Wi-Fi ネットワークに接続します。 |
boolean
|
connectToWifiNetwork(
Wi-Fi ネットワークに接続します。 |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Wi-Fi ネットワークに接続します。 |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
|
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
デバイスが現在ネットワークに接続していない場合にのみ接続する |
int
|
createUser(String name, boolean guest, boolean ephemeral)
指定された名前と指定されたフラグを持つユーザーを作成します。 |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
指定された名前と指定されたフラグを持つユーザーを作成します。 |
int
|
createUser(String name)
指定された名前とデフォルトのフラグ 0 を持つユーザーを作成します。 |
int
|
createUserNoThrow(String name)
指定された名前とデフォルトのフラグ 0 を持つユーザーを作成します。 |
void
|
deleteFile(String deviceFilePath, int userId)
デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。 |
void
|
deleteFile(String deviceFilePath)
デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。 |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
登録済みの |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
現在の system_server と以前の system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
デバイスのエポックからの UTC 時刻とその |
boolean
|
disableAdbRoot()
adb root をオフにします。 |
void
|
disableKeyguard()
キーガードを無効にしようとします。 |
boolean
|
disableNetworkMonitor()
デバイス上のネットワーク監視を無効にします。 |
boolean
|
disconnectFromWifi()
Wi-Fi ネットワークから切断される。 |
boolean
|
doesFileExist(String deviceFilePath, int userId)
特定のユーザーのデバイスにファイルが存在するかどうかを判断するヘルパー メソッド。 |
boolean
|
doesFileExist(String deviceFilePath)
デバイス上のファイルが存在するかどうかを判断するヘルパー メソッド。 |
File
|
dumpHeap(String process, String devicePath)
system_server からヒープダンプを試みます。 |
boolean
|
enableAdbRoot()
adb ルートを有効にします。 |
boolean
|
enableNetworkMonitor()
デバイスでネットワーク モニタリングを有効にします。 |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
String
|
executeAdbCommand(long timeout,
指定されたタイムアウトで adb コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
String
|
executeAdbCommand(String... cmdArgs)
adb コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
デフォルトのタイムアウトが 2 分間のシステム コマンドとして fastboot コマンドを実行するヘルパー メソッド。 |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。 |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッドです。 |
CommandResult
|
executeLongFastbootCommand(
長時間実行される fastboot コマンドを、システム環境変数を使用してシステム コマンドとして実行するヘルパー メソッド。 |
String
|
executeShellCommand(String command)
adb シェルコマンドを実行し、出力を |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。 |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。 |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
指定された adb シェルコマンドを実行し、コマンドが失敗した場合は複数回再試行します。 |
CommandResult
|
executeShellV2Command(String cmd)
adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が適切に入力された |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
adb シェルコマンドを実行し、コマンド ステータス出力と stderr が適切に入力された |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が適切に入力された |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。 |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。 |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。 |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。 |
CommandResult
|
fastbootWipePartition(String partition)
デバイスのパーティションをワイプするヘルパー メソッド。 |
|
getActiveApexes()
デバイスで有効になっている APEX に関する情報を取得します。 |
|
getAllSettings(String namespace)
リクエストされた名前空間の Key-Value ペアを返します。 |
DeviceAllocationState
|
getAllocationState()
デバイスの現在の割り当て状態を返します。 |
String
|
getAndroidId(int userId)
userId に関連付けられている android-id を検索して返します。見つからない場合は null を返します。 |
|
getAndroidIds()
ユーザー ID と一致する Android ID のマップを作成します。 |
int
|
getApiLevel()
デバイスの API レベルを取得します。 |
PackageInfo
|
getAppPackageInfo(String packageName)
デバイスにインストールされているパッケージに関する情報を取得します。 |
|
getAppPackageInfos()
デバイスにインストールされているパッケージの情報を取得します。 |
String
|
getBasebandVersion()
このデバイスのベースバンド(無線)バージョンを取得する便利なメソッド。 |
Integer
|
getBattery()
デバイスの現在のバッテリー残量を返します。バッテリー残量が取得できない場合は null を返します。 |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
指定されたプロパティのブール値を返します。 |
|
getBootHistory()
ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。 |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
ヘルパー メソッドは、デバイスから指定されたエポックからの時刻と指定された時間単位以降の起動時間と起動理由を含む起動履歴マップを収集します。 |
String
|
getBootloaderVersion()
このデバイスのブートローダーのバージョンを取得する便利なメソッドです。 |
InputStreamSource
|
getBugreport()
デバイスからバグレポートを取得します。 |
InputStreamSource
|
getBugreportz()
デバイスからバグレポートを取得します。 |
String
|
getBuildAlias()
デバイスで現在実行されているビルドのエイリアスを取得します。 |
String
|
getBuildFlavor()
デバイスのビルド フレーバーを取得します。 |
String
|
getBuildId()
デバイスで現在実行されているビルドを取得します。 |
String
|
getBuildSigningKeys()
デバイス イメージの署名に使用される鍵の種類を返します。 通常、Android デバイスはテストキー(AOSP など)またはリリースキー(個々のデバイス メーカーが制御)で署名されます。 |
DeviceDescriptor
|
getCachedDeviceDescriptor()
デバイスが割り当てられている場合はキャッシュに保存された |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
デバイスが割り当てられている場合はキャッシュに保存された |
String[]
|
getChildren(String path)
|
AbstractConnection
|
getConnection()
デバイスに関連付けられている現在の接続。 |
ContentProviderHandler
|
getContentProvider(int userId)
|
DeviceFoldableState
|
getCurrentFoldableState()
デバイスの現在の折りたたみ状態を返します。問題が発生した場合は null を返します。 |
int
|
getCurrentUser()
現在実行中のユーザーの ID を返します。 |
String
|
getDeviceClass()
デバイスクラスを取得します。 |
long
|
getDeviceDate()
デバイスの日付をエポックからのミリ秒単位で返します。 |
DeviceDescriptor
|
getDeviceDescriptor()
デバイス情報から |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
デバイス情報から |
TestDeviceState
|
getDeviceState()
デバイスの状態を取得します。 |
long
|
getDeviceTimeOffset(Date date)
デバイスと特定の |
InputStreamSource
|
getEmulatorOutput()
エミュレータの stdout と stderr のストリームを取得する |
Process
|
getEmulatorProcess()
このエミュレータに対応する |
final
File
|
getExecuteShellCommandLog()
すべての |
long
|
getExternalStoreFreeSpace()
デバイスの外部ストレージの空き容量を判断するヘルパー メソッド。 |
String
|
getFastbootPath()
使用されている fastboot バイナリのパスを返します。 |
String
|
getFastbootProductType()
デバイスが Fastboot モードのときにデバイスの製品タイプを取得するためのコンビニエンス メソッド。 |
String
|
getFastbootProductVariant()
Fastboot モードでこのデバイスのプロダクト タイプを取得する便利なメソッドです。 |
String
|
getFastbootSerialNumber()
Fastboot モードのシリアル番号を返します。 |
String
|
getFastbootVariable(String variableName)
デバイスから指定された fastboot 変数の値を取得します。 |
String
|
getFastbootVersion()
使用されている fastboot バイナリのバージョン文字列を返します。 |
IFileEntry
|
getFileEntry(String path)
デバイス上のリモート ファイルへの参照を取得します。 |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
ルート以外のパスから |
|
getFoldableStates()
デバイス上の折りたたみ式デバイスの状態のリストを返します。 |
IDevice
|
getIDevice()
関連する ddmlib |
|
getInstalledPackageNames()
デバイスに存在するアプリのパッケージ名を取得します。 |
long
|
getIntProperty(String name, long defaultValue)
デバイスから指定されたプロパティの整数値を返します。 |
String
|
getIpAddress()
デバイスの IP アドレスを取得します。 |
KeyguardControllerState
|
getKeyguardState()
キーガードの現在の状態を取得するオブジェクトを返します。サポートされていない場合は null を返します。 |
long
|
getLastExpectedRebootTimeMillis()
|
int
|
getLaunchApiLevel()
デバイスで最初にリリースされた API レベルを取得します。 |
InputStreamSource
|
getLogcat()
logcat データのスナップショット ストリームを取得します。 |
InputStreamSource
|
getLogcat(int maxBytes)
キャプチャした logcat データの最後の |
InputStreamSource
|
getLogcatDump()
デバイスの現在の logcat ダンプを取得します。 |
InputStreamSource
|
getLogcatSince(long date)
指定された日付からキャプチャされた logcat データのスナップショット ストリームを取得します。 |
String
|
getMacAddress()
デバイスの MAC アドレスを返します。デバイスからのクエリに失敗した場合は null を返します。 |
Integer
|
getMainUserId()
メインのユーザー ID を返します。 |
|
getMainlineModuleInfo()
デバイスにインストールされている Mainline モジュールに関する情報を取得します。 |
int
|
getMaxNumberOfRunningUsersSupported()
同時に実行できるユーザーの最大数を取得します。 |
int
|
getMaxNumberOfUsersSupported()
サポートされている最大ユーザー数を取得します。 |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
デバイスに関連付けられている |
String
|
getMountPoint(String mountName)
マウント ポイントを返します。 |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
指定されたマウントポイント パスに対応する |
|
getMountPointInfo()
デバイスの /proc/mounts にある情報を解析したバージョンを返します。 |
TestDeviceOptions
|
getOptions()
デバイスのテストオプションを取得します。 |
long
|
getPartitionFreeSpace(String partition)
デバイス パーティションの空き容量を判断するヘルパー メソッド。 |
Integer
|
getPrimaryUserId()
プライマリ ユーザー ID を返します。 |
ProcessInfo
|
getProcessByName(String processName)
ヘルパー メソッドは「pidof」コマンドと「stat」コマンドを実行し、指定されたプロセスの PID とプロセス開始時刻を含む |
String
|
getProcessPid(String process)
サービスの pid を返します。エラーが発生した場合は null を返します。 |
String
|
getProductType()
このデバイスのプロダクト タイプを取得する便利なメソッド。 |
String
|
getProductVariant()
このデバイスの商品バリエーションを取得するための便利なメソッド。 |
String
|
getProperty(String name)
デバイスから指定されたプロパティ値を取得します。 |
ITestDevice.RecoveryMode
|
getRecoveryMode()
デバイスで現在使用されているリカバリモードを取得します。 |
InputStreamSource
|
getScreenshot(long displayId)
指定されたディスプレイ ID からスクリーンショットを取得します。 |
InputStreamSource
|
getScreenshot(String format)
デバイスのスクリーンショットを取得します。 |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
デバイスからスクリーンショットを取得します。 |
InputStreamSource
|
getScreenshot()
デバイスのスクリーンショットを取得します。 |
String
|
getSerialNumber()
このデバイスのシリアル番号を取得する便利なメソッド。 |
String
|
getSetting(int userId, String namespace, String key)
リクエストされた設定の値を返します。 |
String
|
getSetting(String namespace, String key)
|
String
|
getSimOperator()
SIM カード事業者を返します。利用できない場合は null を返します。デバイスが利用できない場合は null を返します。 |
String
|
getSimState()
SIM カードの状態を返します。利用できない場合は null を返します。デバイスが利用できない場合は null を返します。 |
|
getTombstones()
デバイスから墓石のリストを取得して返します。 |
long
|
getTotalMemory()
物理メモリの合計サイズ(バイト単位、内部エラーの場合は -1)を返します。 |
String
|
getTrackingSerial()
デバイス管理の目的で、デバイスの追跡に使用されるシリアル番号を取得します。 |
|
getUninstallablePackageNames()
アンインストール可能なアプリのパッケージ名を取得します。 |
boolean
|
getUseFastbootErase()
fastboot erase と fastboot format のどちらを使用してデバイスのパーティションをワイプするかを取得します。 |
int
|
getUserFlags(int userId)
指定したユーザーのフラグを検索して返します。 |
|
getUserInfos()
デバイス上の useId と |
int
|
getUserSerialNumber(int userId)
userId に関連付けられているシリアル番号が見つかった場合はその番号を、それ以外の場合は -10000 を返します。 |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
指定された DeviceEvent を処理します。 DeviceEvent を処理します。この処理により、このデバイスが新しい割り当て状態に移行することもあります。 |
boolean
|
hasFeature(String feature)
デバイスで利用できる機能を確認します。 |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
デバイスに Android パッケージをインストールします。 |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
デバイスに Android パッケージをインストールします。 |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
特定のユーザーのデバイスに Android パッケージをインストールします。 |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
特定のユーザーのデバイスに Android パッケージをインストールします。 |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認します。 |
boolean
|
isBypassLowTargetSdkBlockSupported()
デバイス上のプラットフォームが、アプリ インストールでの低ターゲット SDK ブロックの回避をサポートしているかどうかを確認する |
boolean
|
isDebugfsMounted()
debugfs がマウントされているかどうかを確認します。 |
boolean
|
isDeviceEncrypted()
デバイスが暗号化されているかどうかを返します。 |
boolean
|
isDirectory(String path)
デバイス上のパスがディレクトリである場合は true を返し、それ以外の場合は false を返します。 |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
デバイスで暗号化がサポートされているかどうかを返します。 |
boolean
|
isExecutable(String fullPath)
デバイス上のファイルパスが実行可能ファイルである場合は true を返し、そうでない場合は false を返します。 |
boolean
|
isFastbootEnabled()
デバイスで Fastboot を使用できるかどうかを返します。 |
boolean
|
isHeadless()
デバイスがヘッドレス(画面なし)の場合は true、それ以外の場合は false を返します。 |
boolean
|
isHeadlessSystemUserMode()
デバイスがヘッドレス システム ユーザー モードを使用しているかどうかを返します。 |
boolean
|
isMainUserPermanentAdmin()
メインのユーザーが永続的な管理者であり、削除または管理者以外のステータスにダウングレードできないかどうかを返します。 |
boolean
|
isMultiUserSupported()
マルチユーザーに対応しているかどうかを判別します。 |
boolean
|
isPackageInstalled(String packageName, String userId)
特定のパッケージ名とユーザー ID についてデバイスにクエリを実行し、そのユーザーに対して現在インストールされているかどうかを確認します。 |
boolean
|
isPackageInstalled(String packageName)
特定のパッケージ名についてデバイスにクエリを実行し、現在インストールされているかどうかを確認します。 |
boolean
|
isRuntimePermissionSupported()
デバイス上のプラットフォームがランタイム権限の付与をサポートしているかどうかを確認します。 |
boolean
|
isStateBootloaderOrFastbootd()
デバイスが |
boolean
|
isUserRunning(int userId)
特定のユーザーが実行中かどうかを確認します。 |
boolean
|
isUserSecondary(int userId)
指定されたユーザーがフラグに基づいてセカンダリ ユーザーかどうかを返します。 |
boolean
|
isUserVisible(int userId)
指定したユーザーが表示されているかどうかを確認します。 |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
指定されたディスプレイに特定のユーザーが表示されているかどうかを確認します。 |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
デバイスでユーザーが |
boolean
|
isVisibleBackgroundUsersSupported()
デバイスでユーザーがバックグラウンドで開始されたときに表示されるかどうかを返します。 |
boolean
|
isWifiEnabled()
Wi-Fi が有効になっているかどうかをテストします。 |
|
listDisplayIds()
「dumpsys SurfaceFlinger」によって報告された、デバイスで使用可能なディスプレイ ID のリストを収集します。 |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
|
|
listUsers()
デバイス上のユーザーのリストを取得します。 |
boolean
|
logAnrs(ITestLogger logger)
デバイスから ANR を収集してログに記録します。 |
boolean
|
logBugreport(String dataName, ITestLogger listener)
バグレポートを取得してレポーターにログに記録するヘルパー メソッド。 |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
デバイスの logcat にメッセージを記録します。 |
void
|
mountDebugfs()
debugfs をマウントします。 |
void
|
nonBlockingReboot()
デバイスを再起動するためのコマンドを送信し、コマンドが完了したとき、またはデバイスが adb に表示されなくなったときに返します。 |
void
|
postAdbRootAction()
adb root の後、デバイスがオンラインに戻る前に、デバイスで特定のアクションを実行する必要がある場合はオーバーライドします。 |
void
|
postAdbUnrootAction()
adb unroot の後、デバイスがオンラインに戻る前に、デバイスで特定のアクションを実行する必要がある場合はオーバーライドします。 |
void
|
postBootSetup()
起動後にテストを行うようにデバイスを構成する手順を実施します。 |
void
|
postInvocationTearDown(Throwable exception)
呼び出しが完了した後に実行される、デバイス固有の必要なクリーンアップの追加手順。 |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
呼び出しフローの前にデバイスで実行される、デバイス固有の必要な設定の追加手順。 |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
デバイスからディレクトリ コンテンツを再帰的に pull します。 |
boolean
|
pullDir(String deviceFilePath, File localDir)
デバイスからディレクトリ コンテンツを再帰的に pull します。 |
boolean
|
pullFile(String remoteFilePath, File localFile)
デバイスからファイルを取得します。 |
File
|
pullFile(String remoteFilePath, int userId)
デバイスからファイルを取得し、ローカルの一時的な |
File
|
pullFile(String remoteFilePath)
デバイスからファイルを取得し、ローカルの一時的な |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
デバイスからファイルを取得します。 |
String
|
pullFileContents(String remoteFilePath)
デバイスからファイルを取得し、内容を返します。 |
File
|
pullFileFromExternal(String remoteFilePath)
デバイスの外部ストレージからファイルを取得し、ローカルの一時 |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
フィルタされた一部のディレクトリを除外しながら、ディレクトリの内容をデバイスに再帰的にプッシュします。 |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
ディレクトリの内容をデバイスに再帰的に push します。 |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
ディレクトリの内容をデバイスに再帰的に push します。 |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
|
boolean
|
pushFile(File localFile, String remoteFilePath)
ファイルをデバイスにプッシュします。 |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
ファイルをデバイスにプッシュします。 |
boolean
|
pushString(String contents, String remoteFilePath)
文字列から作成されたファイルをデバイスにプッシュする |
void
|
reboot(String reason)
指定された |
void
|
reboot()
デバイスを再起動して adb モードに入ります。 |
void
|
rebootIntoBootloader()
デバイスを再起動してブートローダー モードに入ります。 |
void
|
rebootIntoFastbootd()
デバイスを再起動して fastbootd モードに入ります。 |
void
|
rebootIntoRecovery()
デバイスを再起動して adb リカバリ モードに入ります。 |
void
|
rebootIntoSideload()
デバイスを adb サイドロード モードに再起動します(これはリカバリの特別なモードです)。 デバイスがサイドロード モードに入るまでブロックします |
void
|
rebootIntoSideload(boolean autoReboot)
デバイスを adb サイドロード モードに再起動します(これはリカバリの特別なモードです)。 デバイスがサイドロード モードに入るまでブロックします |
void
|
rebootUntilOnline()
|
void
|
rebootUntilOnline(String reason)
|
void
|
rebootUserspace()
デバイスのユーザー空間部分のみ再起動する。 |
void
|
rebootUserspaceUntilOnline()
|
boolean
|
recoverDevice()
デバイスの通信の回復を試みます。 |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
このデバイスの |
void
|
remountSystemReadOnly()
デバイスのシステム パーティションを読み取り専用にします。 |
void
|
remountSystemWritable()
デバイス上のシステム パーティションを書き込み可能にします。 |
void
|
remountVendorReadOnly()
デバイス上のベンダー パーティションを読み取り専用にします。 |
void
|
remountVendorWritable()
デバイスのベンダー パーティションを書き込み可能にする。 |
boolean
|
removeAdmin(String componentName, int userId)
指定されたユーザーの特定のデバイス管理を削除し、成功した場合は |
void
|
removeOwners()
既存のデバイス プロファイルのオーナーをすべて削除します。 |
boolean
|
removeUser(int userId)
特定のユーザーをデバイスから削除します。 |
void
|
resetContentProviderSetup()
再度トリガーするには、コンテンツ プロバイダ設定用のフラグをリセットしてください。 |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
1 つ以上のリスナーをパラメータとして渡して |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
インストルメンテーション テストを実行し、デバイスの復元を提供します。 |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
|
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
|
void
|
setConfiguration(IConfiguration configuration)
使用中の |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
デバイスの日付を設定します。 注: デバイスの日付を設定するには、root 権限が必要です。 |
boolean
|
setDeviceOwner(String componentName, int userId)
デバイス管理コンポーネントを特定のユーザーのデバイス所有者として設定する。 |
void
|
setDeviceState(TestDeviceState deviceState)
デバイスの状態を更新します。 |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
エミュレータの場合は、 |
void
|
setEmulatorProcess(Process p)
このデバイスがエミュレータの場合、 |
void
|
setFastbootEnabled(boolean fastbootEnabled)
デバイスの fastboot オプションを設定します。 |
void
|
setFastbootPath(String fastbootPath)
使用する fastboot バイナリへのパスを設定します。 |
void
|
setIDevice(IDevice newDevice)
この ITestDevice に関連付けられている IDevice を更新します。 |
void
|
setLogStartDelay(int delay)
オンライン デバイスの logcat キャプチャを開始する前に待機する時間をミリ秒単位で設定します。 |
void
|
setOptions(TestDeviceOptions options)
デバイスの |
boolean
|
setProperty(String propKey, String propValue)
デバイスで指定されたプロパティ値を設定します。 |
void
|
setRecovery(IDeviceRecovery recovery)
このデバイスに使用する |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
デバイスに使用する現在のリカバリモードを設定します。 |
void
|
setSetting(String namespace, String key, String value)
|
void
|
setSetting(int userId, String namespace, String key, String value)
特定のユーザーの Namespace に設定値を追加します。 |
void
|
setTestLogger(ITestLogger testLogger)
|
void
|
setTrackingSerial(String trackingSerial)
デバイス管理の目的で、デバイスの参照に使用するシリアル番号を追跡します。 |
void
|
setUseFastbootErase(boolean useFastbootErase)
fastboot erase と fastboot format のどちらを使用してデバイスのパーティションをワイプするかを設定します。 |
void
|
startLogcat()
バックグラウンドでデバイスからの logcat 出力の取得を開始します。 |
boolean
|
startUser(int userId)
指定したユーザーが現在停止している場合は、バックグラウンドでそのユーザーを開始します。 |
boolean
|
startUser(int userId, boolean waitFlag)
特定のユーザーが現在停止している場合に、バックグラウンドで起動します。 |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
特定のユーザーをバックグラウンドで開始し、特定のディスプレイに表示します(つまり、ユーザーはそのディスプレイでアクティビティを起動できます)。 |
void
|
stopEmulatorOutput()
エミュレータの出力を閉じて削除します。 |
void
|
stopLogcat()
デバイスからの logcat 出力の取得を停止し、現在保存されている logcat データを破棄します。 |
boolean
|
stopUser(int userId)
指定したユーザーを停止します。 |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
特定のユーザーを停止します。 |
String
|
switchToAdbTcp()
デバイスを adb-over-tcp モードに切り替えます。 |
boolean
|
switchToAdbUsb()
デバイスを USB 経由で adb モードに切り替えます。 |
boolean
|
switchUser(int userId)
デフォルトのタイムアウトで別の userId に切り替えます。 |
boolean
|
switchUser(int userId, long timeout)
指定されたタイムアウトを期限として別の userId に切り替える。 |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
ローカル ファイル ディレクトリの内容をデバイスに増分同期します。 |
Bugreport
|
takeBugreport()
バグレポートを受け取り、 |
String
|
uninstallPackage(String packageName)
デバイスから Android パッケージをアンインストールします。 |
String
|
uninstallPackageForUser(String packageName, int userId)
特定のユーザーのデバイスから Android パッケージをアンインストールします。 |
boolean
|
unlockDevice()
デバイスが暗号化された状態の場合、デバイスのロックを解除します。 |
void
|
unmountDebugfs()
debugfs のマウントを解除します。 |
boolean
|
waitForBootComplete(long timeOut)
デバイスの起動完了フラグが設定されるまでブロックします。 |
boolean
|
waitForDeviceAvailable()
デバイスが応答し、テストの準備が整うまで待ちます。 |
boolean
|
waitForDeviceAvailable(long waitTime)
デバイスが応答し、テストの準備が整うまで待ちます。 |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
復元パスを検討せずに、デバイスが応答して使用可能になるまで待ちます。 |
void
|
waitForDeviceBootloader()
fastboot でデバイスが検出されるまでブロックします。 |
boolean
|
waitForDeviceInRecovery(long waitTime)
デバイスが「adb recovery」状態になるのをブロックします(これは |
boolean
|
waitForDeviceInSideload(long waitTime)
デバイスが「adb sideload」状態になるのをブロックします |
boolean
|
waitForDeviceNotAvailable(long waitTime)
デバイスを使用できないブロック(adb に欠落している) |
void
|
waitForDeviceOnline()
adb 経由でデバイスが検出されるまでブロックします。 |
void
|
waitForDeviceOnline(long waitTime)
adb 経由でデバイスが検出されるまでブロックします。 |
boolean
|
waitForDeviceShell(long waitTime)
デバイスが基本的な adb shell コマンドに応答するまで待ちます。 |
保護されたメソッド | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
指定された adb シェルコマンド セッションと引数用の OS コマンドをビルドします。 |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
再起動アクションの実行時に使用する |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
adb で再起動します。 |
void
|
ensureRuntimePermissionSupported()
ランタイム権限がサポートされていない場合に例外をスローするヘルパー メソッド |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
使用する |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
デフォルトでは ddmlib キャッシュからデバイス プロパティを取得し、デバイスが Fastboot モードかどうかに応じて「adb shell getprop」または「fastboot getvar」にフォールバックします。 |
boolean
|
isInRebootCallback()
再起動コールバックが現在実行されているかどうかを返します。 |
boolean
|
isNewer(File localFile, IFileEntry entry)
ローカル ファイルがリモート ファイルより新しい場合は |
void
|
notifyRebootEnded()
再起動終了イベントをすべての |
void
|
notifyRebootStarted()
再起動開始イベントについてすべての |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
このデバイスでアクションを実行します。 |
void
|
postAdbReboot()
再起動後に行うことができる追加の操作。 |
void
|
prePostBootSetup()
各デバイスタイプ(AndroidNativeDevice、TestDevice)が、起動後の特定の設定のためにこのメソッドをオーバーライドできるようにします。 |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
使用する Clock インスタンスを設定します。 |
void
|
setMicrodroidProcess(Process process)
TestDevice を microdroid としてマークし、その CID を設定します。 |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
環境変数を使用して単純な fastboot コマンドを実行し、コマンドのステータスを報告します。 |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
シンプルな fastboot コマンドを実行し、コマンドのステータスを報告します。 |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
デバイスが使用できなくなるまで待ちます(adb への報告を停止します)。 |
定数
INVALID_USER_ID
public static final int INVALID_USER_ID
無効なユーザー ID または見つからないユーザー ID に対して返される値: UserHandle で -10000 値が定義されている
定数値: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
定数値: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS 回
protected static final int MAX_RETRY_ATTEMPTS
コマンドの再試行のデフォルト回数
定数値: 2 (0x00000002)
フィールド
DEBUGFS_PATH
public static final String DEBUGFS_PATH
SD_CARD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
パブリック コンストラクタ
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
TestDevice
を作成します。
パラメータ | |
---|---|
device |
IDevice : 関連する IDevice |
stateMonitor |
IDeviceStateMonitor : 使用する IDeviceStateMonitor メカニズム |
allocationMonitor |
IDeviceMonitor : 割り当て状態の変更を通知する IDeviceMonitor 。null の場合もあります |
パブリック メソッド
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
各プロパティに対して「adb getprop」を呼び出すのではなく、必要なすべてのプロパティをプリフェッチすることで、マイクロ最適化(約 400 ミリ秒)を実現。つまり、すべてのプロパティをフェッチするのにかかる時間は、1 つのプロパティをフェッチするのにかかる時間と同じです。device.getApiLevel()、checkApiLevelAgainstNextRelease、getBuildAlias などの関数は、内部ですべて「adb getprop」を呼び出します。これらを 1 回の呼び出しで取得し、NativeDevice.setProperty を呼び出します。この処理を行わなくても、NativeDevice 自体が setProperty を呼び出し、今後の呼び出しのために結果をキャッシュに保存します。これは少し前に行っただけです。デバイスが復元中の場合や、プロパティの取得中に他のエラーが発生した場合は、無視されます。
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
ヘッドレス システム ユーザーに切り替えることができるかどうかを返します。
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
最低限のサポートレベルに基づき、機能が現在サポートされているかどうかを確認します。このメソッドでは、API レベルが上がる前に、まだリリースされていない機能が考慮されます。
パラメータ | |
---|---|
strictMinLevel |
int : 機能をサポートする厳密な最小レベル。 |
戻り値 | |
---|---|
boolean |
レベルがサポートされている場合は true です。それ以外の場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
デバイスがネットワークに接続されていることを確認します。
戻り値 | |
---|---|
boolean |
true : デバイスがネットワークに接続されている場合。false : それ以外の場合。 |
例外 | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
デバイスの UI に現在表示されているエラー ダイアログがあれば、閉じてみる。
戻り値 | |
---|---|
boolean |
true : ダイアログが存在しなかった場合、またはダイアログが正常に消去された場合。
それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
最後に接続した Wi-Fi ネットワークを消去します。デバイスの再起動後に、前回のテストで使用した Wi-Fi ネットワークに接続しないように、新しい呼び出しを開始するときに呼び出す必要があります。
clearLogcat
public void clearLogcat ()
蓄積された logcat データを削除します。
これは、ITestDevice#getLogcat()
が特定の時点の後に生成されたログデータのみを返すようにする場合に便利です(新しいデバイスビルドをフラッシュした後など)。
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Wi-Fi ネットワークに接続します。
Wi-Fi をオンにして、wifiSsidToPsk マップにある Wi-Fi ネットワークのいずれかに正常に接続されるまでブロックします。接続が確立されると、ITestDevice#disconnectFromWifi()
または ITestDevice#clearLastConnectedWifiNetwork()
が呼び出されるまで、インスタンスは再起動後に接続を復元しようとします。
パラメータ | |
---|---|
wifiSsidToPsk |
: Wi-Fi の SSID とパスワードのマップ。 |
scanSsid |
boolean : このネットワークの非表示 SSID をスキャンするかどうか。 |
戻り値 | |
---|---|
boolean |
true (Wi-Fi ネットワークに正常に接続された場合)。false
それ以外の場合 |
例外 | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Wi-Fi ネットワークに接続します。
Wi-Fi をオンにして、指定した Wi-Fi ネットワークに正常に接続されるまでブロックします。接続が確立されると、ITestDevice#disconnectFromWifi()
または ITestDevice#clearLastConnectedWifiNetwork()
が呼び出されるまで、インスタンスは再起動後に接続を復元しようとします。
パラメータ | |
---|---|
wifiSsid |
String : 接続する Wi-Fi の SSID |
wifiPsk |
String : PSK パスフレーズ。暗号化されていない場合は null |
戻り値 | |
---|---|
boolean |
true : Wi-Fi ネットワークに正常に接続した場合。それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Wi-Fi ネットワークに接続します。
Wi-Fi をオンにして、wifiSsidToPsk マップにある Wi-Fi ネットワークのいずれかに正常に接続されるまでブロックします。接続が確立されると、インスタンスは ITestDevice#disconnectFromWifi()
または ITestDevice#clearLastConnectedWifiNetwork()
が呼び出されるまで、再起動のたびに接続の復元を試みます。
パラメータ | |
---|---|
wifiSsidToPsk |
: Wi-Fi の SSID とパスワードのマップ。 |
戻り値 | |
---|---|
boolean |
true (Wi-Fi ネットワークに正常に接続された場合)。false
それ以外の場合 |
例外 | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Wi-Fi ネットワークに接続します。
Wi-Fi をオンにして、指定した Wi-Fi ネットワークに正常に接続されるまでブロックします。接続が確立されると、インスタンスは ITestDevice#disconnectFromWifi()
または ITestDevice#clearLastConnectedWifiNetwork()
が呼び出されるまで、再起動のたびに接続の復元を試みます。
パラメータ | |
---|---|
wifiSsid |
String : 接続する Wi-Fi の SSID |
wifiPsk |
String : PSK パスフレーズ。暗号化されていない場合は null |
scanSsid |
boolean : このネットワークの非公開 SSID をスキャンするかどうか。 |
戻り値 | |
---|---|
boolean |
true : Wi-Fi ネットワークに正常に接続した場合。それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
デバイスが現在ネットワークに接続していない場合にのみ接続する connectToWifiNetwork(String, String)
のバリアント。
パラメータ | |
---|---|
scanSsid |
boolean : このネットワークの非表示の SSID をスキャンするかどうか |
戻り値 | |
---|---|
boolean |
true : Wi-Fi ネットワークに正常に接続した場合。それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
デバイスに現在ネットワーク接続がない場合にのみ接続する connectToWifiNetwork(String, String)
のバリエーション。
戻り値 | |
---|---|
boolean |
true : Wi-Fi ネットワークに正常に接続した場合。それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral)
指定された名前と指定されたフラグを持つユーザーを作成する
パラメータ | |
---|---|
name |
String : デバイスに作成するユーザーの |
guest |
boolean : 作成時にユーザーフラグ --guest を有効にする |
ephemeral |
boolean : 作成時にユーザーフラグ --ephemeral を有効にする |
戻り値 | |
---|---|
int |
作成されたユーザーの ID |
例外 | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
指定された名前と指定されたフラグを持つユーザーを作成する
パラメータ | |
---|---|
name |
String : デバイスに作成するユーザーの |
guest |
boolean : 作成時にユーザーフラグ --guest を有効にする |
ephemeral |
boolean : 作成時にユーザーフラグ --ephemeral を有効にする |
forTesting |
boolean : 作成時にテストフラグ --for-testing を有効にする |
戻り値 | |
---|---|
int |
作成されたユーザーの ID |
例外 | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name)
指定された名前とデフォルトのフラグ 0 を持つユーザーを作成します。
パラメータ | |
---|---|
name |
String : デバイスに作成するユーザーの |
戻り値 | |
---|---|
int |
作成されたユーザー ID の整数 |
例外 | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
指定された名前とデフォルトのフラグ 0 を持つユーザーを作成します。
パラメータ | |
---|---|
name |
String : デバイスに作成するユーザーの |
戻り値 | |
---|---|
int |
作成されたユーザー ID の整数値、またはエラーの場合は -1。 |
例外 | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath, int userId)
デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。
パラメータ | |
---|---|
deviceFilePath |
String : デバイス上のファイルの絶対パス。 |
userId |
int : 削除するユーザー ID |
例外 | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath)
デバイス上のファイルまたはディレクトリを削除するヘルパー メソッド。
パラメータ | |
---|---|
deviceFilePath |
String : デバイス上のファイルの絶対パス。 |
例外 | |
---|---|
DeviceNotAvailableException |
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
登録済みの IDeviceActionReceiver
を削除します。
パラメータ | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : 削除される IDeviceActionReceiver 。 |
deviceSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
現在の system_server と以前の system_server ProcessInfo
を比較して、デバイスがソフトリブートされたかどうかを確認するヘルパー メソッド。getProcessByName(String)
を使用して ProcessInfo
を取得します。
パラメータ | |
---|---|
prevSystemServerProcess |
ProcessInfo : 以前の system_server プロセス ProcessInfo 。 |
戻り値 | |
---|---|
boolean |
true : デバイスがソフトリブートした場合 |
例外 | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
デバイスのエポックからの UTC 時刻とその ERROR(/TimeUnit)
以降にデバイスがソフトリブートされたかどうかを確認するヘルパー メソッド。ソフトリブートとは、デバイスのハードリブート(リクエストされた再起動など)以外で再起動された system_server を指します。現在のデバイスの utcEpochTime(ミリ秒単位)は、メソッド getDeviceDate()
で取得できます。
パラメータ | |
---|---|
utcEpochTime |
long : エポックからのデバイス時間(秒単位)。 |
timeUnit |
TimeUnit : 指定された utcEpochTime の時間単位 TimeUnit 。 |
戻り値 | |
---|---|
boolean |
true : デバイスがソフトリブートした場合 |
例外 | |
---|---|
DeviceNotAvailableException |
disableAdbRoot
public boolean disableAdbRoot ()
adb root をオフにします。
adb root を無効にすると、デバイスが adb から切断されることがあります。この方法では、デバイスが使用可能になるまでブロックされます。
戻り値 | |
---|---|
boolean |
成功した場合は true 。 |
例外 | |
---|---|
DeviceNotAvailableException |
Keyguard を無効にする
public void disableKeyguard ()
キーガードを無効にしようとします。
まず、入力ディスパッチの準備が整うまで待機します。これは、現在のフレームワークの実装で時折競合状態が発生するため、デバイスが BOOT_COMPLETE を報告する頃に非同期で発生します。その後、キーガードを閉じるコマンドが送信されます(安全でないキーガードにのみ機能します)
例外 | |
---|---|
DeviceNotAvailableException |
disableNetworkMonitor
public boolean disableNetworkMonitor ()
デバイス上のネットワーク監視が無効になります。
戻り値 | |
---|---|
boolean |
モニタリングが無効にされた場合は true 。false
(失敗した場合)。 |
例外 | |
---|---|
DeviceNotAvailableException |
disconnectFromWifi
public boolean disconnectFromWifi ()
Wi-Fi ネットワークから切断されます。
既知のネットワークのリストからすべてのネットワークを削除し、Wi-Fi を無効にします。
戻り値 | |
---|---|
boolean |
Wi-Fi ネットワークから正常に切断された場合は true 。false
(接続解除に失敗した場合)。 |
例外 | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
特定のユーザーのデバイスにファイルが存在するかどうかを判断するヘルパー メソッド。
パラメータ | |
---|---|
deviceFilePath |
String : 確認するデバイス上のファイルの絶対パス |
userId |
int : ファイルの存在を確認するユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが存在する場合は true 、存在しない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
デバイス上のファイルが存在するかどうかを判断するためのヘルパー メソッド。
パラメータ | |
---|---|
deviceFilePath |
String : 確認するデバイス上のファイルの絶対パス |
戻り値 | |
---|---|
boolean |
ファイルが存在する場合は true 、存在しない場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
system_server からヒープダンプを試みます。ダンプされたファイルをクリーンアップするのは呼び出し元の責任です。
パラメータ | |
---|---|
process |
String : ダンプヒープを行うデバイス プロセスの名前。 |
devicePath |
String : ダンプを作成するデバイス上のパス。権限が許可されている場所にする必要があります。 |
戻り値 | |
---|---|
File |
レポートを含む ERROR(/File) 。エラーが発生した場合は null。 |
例外 | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public boolean enableAdbRoot ()
adb root をオンにします。「enable-root」設定が「false」の場合、メッセージをログに記録し、root を有効にせずに返します。
adb root を有効にすると、デバイスが adb から切断されることがあります。この方法では、デバイスが使用可能になるまでブロックされます。
戻り値 | |
---|---|
boolean |
成功した場合は true 。 |
例外 | |
---|---|
DeviceNotAvailableException |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
デバイスでネットワーク モニタリングを有効にします。
戻り値 | |
---|---|
boolean |
モニタリングが正常に有効になっている場合は true 。false
(失敗した場合)。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
指定したタイムアウトを設定して adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
可能な限り、障害の検出とパフォーマンスを向上させるため、executeShellCommand(String)
を使用することをおすすめします。
パラメータ | |
---|---|
timeout |
long : デバイスが応答していないと見なされるまでの時間(ミリ秒単位)。タイムアウトなしの場合は 0L |
cmdArgs |
String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String |
コマンドの stdout。コマンドが実行されなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
指定されたタイムアウトで adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
executeShellCommand(String)
は、障害の検出とパフォーマンスが向上するため、可能な限り代わりに使用する必要があります。
パラメータ | |
---|---|
timeout |
long : デバイスが応答していないと見なされるまでの時間(ミリ秒単位)。タイムアウトなしの場合は 0L |
envMap |
: コマンドに設定する環境 |
cmdArgs |
String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String |
コマンドの stdout。コマンドが実行されなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
adb コマンドをシステム コマンドとして実行するヘルパー メソッド。
executeShellCommand(String)
は、障害の検出とパフォーマンスが向上するため、可能な限り代わりに使用する必要があります。
パラメータ | |
---|---|
cmdArgs |
String : 実行する adb コマンドと引数 |
戻り値 | |
---|---|
String |
コマンドの stdout。コマンドが実行されなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
デフォルトのタイムアウトが 2 分間のシステム コマンドとして fastboot コマンドを実行するヘルパー メソッド。
デバイスがすでに fastboot モードになっている場合に使用されることが想定されています。
パラメータ | |
---|---|
cmdArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。
デバイスがすでに Fastboot モードの場合に使用することが想定されています。
パラメータ | |
---|---|
timeout |
long : コマンドが期限切れになるまでの時間(ミリ秒単位) |
cmdArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
runLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
長時間実行される fastboot コマンドをシステム コマンドとして実行するヘルパー メソッド。
executeFastbootCommand(String)
と同じですが、タイムアウトが長くなります。
パラメータ | |
---|---|
cmdArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
長時間実行される fastboot コマンドを、システム環境変数を使用してシステム コマンドとして実行するヘルパー メソッド。
executeFastbootCommand(String)
と同じですが、タイムアウトが長くなります。
パラメータ | |
---|---|
envVarMap |
: fastboot コマンドが実行されるシステム環境変数 |
cmdArgs |
String : 実行する fastboot コマンドと引数 |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public String executeShellCommand (String command)
adb シェルコマンドを実行し、出力を String
として返すヘルパー メソッド。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
戻り値 | |
---|---|
String |
シェルの出力 |
例外 | |
---|---|
DeviceNotAvailableException |
runShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
receiver |
IShellOutputReceiver : シェルの出力を転送する IShellOutputReceiver 。 |
maxTimeToOutputShellResponse |
long : コマンドが応答を出力しなくてもよい最大時間(timeUnit で指定された単位)。 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : 例外が原因で失敗した場合にコマンドを再試行する最大回数。retryAttempts が正常に実行されなかった場合、DeviceNotResponsiveException がスローされます。 |
例外 | |
---|---|
DeviceNotAvailableException |
runShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
receiver |
IShellOutputReceiver : シェル出力の転送先の IShellOutputReceiver 。 |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト(timeUnit で指定された単位) |
maxTimeToOutputShellResponse |
long : コマンドが応答を出力しなくてもよい最大時間(timeUnit で指定された単位)。 |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : 例外が原因で失敗した場合にコマンドを再試行する最大回数。retryAttempts が正常に実行されなかった場合、DeviceNotResponsiveException がスローされます。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
指定された adb シェルコマンドを実行し、コマンドが失敗した場合は複数回再試行します。
デフォルト値を持つ executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
の簡素な形式。
パラメータ | |
---|---|
command |
String : 実行する adb シェルコマンド |
receiver |
IShellOutputReceiver : シェルの出力を転送する IShellOutputReceiver 。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が適切に入力された CommandResult
として結果を返すヘルパー メソッド。
パラメータ | |
---|---|
cmd |
String : 実行するコマンド。 |
戻り値 | |
---|---|
CommandResult |
結果は CommandResult になります。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
adb シェルコマンドを実行し、コマンド ステータス出力と stderr が適切に入力された CommandResult
として結果を返すヘルパー メソッド。stdout は指定されたストリームに転送されます。
パラメータ | |
---|---|
cmd |
String : 実行するコマンド。 |
pipeToOutput |
OutputStream : 標準出力がリダイレクトされる ERROR(/OutputStream) 、または null。 |
戻り値 | |
---|---|
CommandResult |
結果は CommandResult になります。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
adb シェルコマンドを実行し、コマンド ステータス出力、stdout、stderr が正しく入力された CommandResult
として結果を返すヘルパー メソッド。
パラメータ | |
---|---|
cmd |
String : 実行するコマンド。 |
pipeAsInput |
File : コマンドへの入力としてパイプされる ERROR(/File) 、または null。 |
戻り値 | |
---|---|
CommandResult |
結果は CommandResult になります。 |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
cmd |
String : 実行する adb シェルコマンド |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト(timeUnit で指定された単位) |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : 例外によりコマンドが失敗した場合に再試行する最大回数。retryAttempts が成功せずに実行された場合は、DeviceNotRespondException がスローされます。 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
cmd |
String : 実行する adb シェルコマンド |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト(timeUnit で指定された単位) |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
cmd |
String : 実行する adb シェルコマンド |
pipeAsInput |
File : コマンドへの入力としてパイプされる ERROR(/File) 、または null。 |
pipeToOutput |
OutputStream : 標準出力がリダイレクトされる ERROR(/OutputStream) 、または null。 |
maxTimeoutForCommand |
long : コマンドが完了するまでの最大タイムアウト(timeUnit で指定された単位) |
timeUnit |
TimeUnit : maxTimeToOutputShellResponse の単位 |
retryAttempts |
int : 例外によりコマンドが失敗した場合に再試行する最大回数。retryAttempts が成功せずに実行された場合は、DeviceNotRespondException がスローされます。 |
戻り値 | |
---|---|
CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
コマンドの動作を制御するための追加のパラメータを使用して、adb シェルコマンドを実行します。
パラメータ | |
---|---|
cmd |
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 CommandResult fastbootWipePartition (String partition)
デバイスのパーティションをワイプするヘルパー メソッド。
getUseFastbootErase()
が true
の場合、fastboot erase を使用してパーティションがワイプされます。次回デバイスが起動したときに、デバイスがファイルシステムを作成する必要があります。それ以外の場合は、fastboot 形式を使用してデバイスに新しいファイル システムが作成されます。
デバイスがすでに Fastboot モードの場合に使用することが想定されています。
パラメータ | |
---|---|
partition |
String : ワイプするパーティション |
戻り値 | |
---|---|
CommandResult |
コマンドの出力を含む CommandResult |
例外 | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
デバイスで有効になっている APEX に関する情報を取得します。
戻り値 | |
---|---|
|
デバイスで現在有効になっているプロモーション コード: ERROR(/Set) / ApexInfo |
例外 | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
リクエストされた名前空間の Key-Value ペアを返します。
パラメータ | |
---|---|
namespace |
String : {"system"、"secure"、"global"} のいずれか |
戻り値 | |
---|---|
|
Key-Value ペアのマップですNamespace がサポートされていない場合は null。 |
例外 | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
デバイスの現在の割り当て状態を返す
戻り値 | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
userId に関連付けられた android-id を検索して返します。見つからない場合は null を返します。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
String |
例外 | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
ユーザー ID と一致する Android ID のマップを作成します。各ユーザー ID にこの関数で関連付けられた Android ID が見つかる保証はありません。そのため、一部のユーザー ID は null と一致する可能性があります。
戻り値 | |
---|---|
|
一致するユーザー ID が見つかった Android ID のマップ。 |
例外 | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
デバイスの API レベルを取得します。デフォルトは UNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int |
デバイスの API レベルを示す整数 |
例外 | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
デバイスにインストールされているパッケージに関する情報を取得します。
パラメータ | |
---|---|
packageName |
String |
戻り値 | |
---|---|
PackageInfo |
PackageInfo (情報を取得できなかった場合)または null |
例外 | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
デバイスにインストールされているパッケージの情報を取得します。
戻り値 | |
---|---|
|
PackageInfo の ERROR(/List) がこのデバイスにインストールされています。 |
例外 | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
このデバイスのベースバンド(無線)バージョンを取得するためのコンビニエンス メソッド。無線バージョンの取得はデバイス固有であるため、すべてのデバイスで正しい情報が返されない場合があります。このメソッドは、gsm.version.baseband プロパティを使用して正しいバージョン情報を返します。これは一部の CDMA デバイスでは正確ではありません。ここで返されるバージョンは、fastboot から報告されたバージョンと一致せず、CDMA 無線通信のバージョンを返さない可能性があります。要約すると、このメソッドは、gsm.version.baseband プロパティが fastboot getvar version-baseband
によって返されたバージョンと同じである場合にのみ、正確なバージョンを報告します。
戻り値 | |
---|---|
String |
String ベースバンド バージョン、または判別できない場合(デバイスに無線がない、またはバージョン文字列を読み取れない)は null |
例外 | |
---|---|
DeviceNotAvailableException |
getBattery
public Integer getBattery ()
デバイスの現在のバッテリー残量を返します。バッテリー残量が取得できない場合は null を返します。
戻り値 | |
---|---|
Integer |
getBooleanProperty
public 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
publicgetBootHistory ()
ヘルパー メソッドは、起動時間と起動理由を含む起動履歴マップを収集します。
戻り値 | |
---|---|
|
起動時間(エポックからの秒単位の UTC 時間)と起動理由のマップ |
例外 | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
ヘルパー メソッドは、指定されたエポックからの時刻と指定された時間単位に基づいて、デバイスから起動時間と起動理由を含む起動履歴マップを収集します。現在のデバイスの utcEpochTime(ミリ秒単位)は、メソッド getDeviceDate()
で取得できます。
パラメータ | |
---|---|
utcEpochTime |
long : エポックからのデバイス時間。 |
timeUnit |
TimeUnit : 時間単位 TimeUnit 。 |
戻り値 | |
---|---|
|
起動時間(エポックからの秒単位の UTC 時間)と起動理由のマップ |
例外 | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
このデバイスのブートローダーのバージョンを取得する便利なメソッドです。
デバイスの現在の状態からブートローダのバージョンを取得しようとします。(デバイスが Fastboot モードの場合、Fastboot からバージョンの取得を試みます)。
戻り値 | |
---|---|
String |
String ブートローダーのバージョン、または見つからない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
デバイスからバグレポートを取得します。
この実装は、sdcard のないデバイス(または sdcard がまだマウントされていないデバイス)でも引き続き機能することが保証されています。
戻り値 | |
---|---|
InputStreamSource |
オンデマンドでバグレポート コンテンツを生成する InputStreamSource 。エラーが発生した場合、InputStreamSource は空の ERROR(/InputStream) を生成します。 |
getBugreportz
public InputStreamSource getBugreportz ()
デバイスからバグレポートを取得します。ZIP 形式のバグレポートには、メインのバグレポートと、デバッグに役立つその他のログファイルが含まれています。
「adb version」が 1.0.36 より大きい場合にのみサポートされます。
戻り値 | |
---|---|
InputStreamSource |
bugreportz を含む ZIP ファイルの InputStreamSource 。失敗した場合は null を返します。 |
getBuildAlias
public String getBuildAlias ()
デバイスが現在実行しているビルドのエイリアスを取得します。
ビルド エイリアスは通常、ビルド ID よりも読みやすい文字列(Nexus ビルドの場合は通常は数字)です。たとえば、Android 4.2 の最終リリースのビルド エイリアスは JDQ39、ビルド ID は 573038 です。
戻り値 | |
---|---|
String |
ビルド エイリアスを使用するか、ビルド ID を取得できなかった場合はビルド ID にフォールバックします。 |
例外 | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
デバイスのビルドフレーバーを取得します。
戻り値 | |
---|---|
String |
ビルド フレーバー、または取得できなかった場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
デバイスで現在実行されているビルドを取得します。
戻り値 | |
---|---|
String |
ビルド ID、または取得できなかった場合は IBuildInfo#UNKNOWN_BUILD_ID |
例外 | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
デバイス イメージの署名に使用される鍵の種類を返します。
通常、Android デバイスはテストキー(AOSP など)またはリリースキー(個々のデバイス メーカーが管理)で署名されます。
戻り値 | |
---|---|
String |
署名鍵(見つかった場合)。見つからない場合は null。 |
例外 | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
デバイスが割り当てられている場合は、キャッシュに保存された DeviceDescriptor
を返します。割り当てられていない場合は、現在の DeviceDescriptor
を返します。
戻り値 | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
デバイスが割り当てられている場合は、キャッシュに保存された DeviceDescriptor
を返します。割り当てられていない場合は、現在の DeviceDescriptor
を返します。
パラメータ | |
---|---|
shortDescriptor |
boolean : 記述子を最小限の情報に制限するかどうか |
戻り値 | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
権限が原因で機能しないことがある IFileEntry
の使用に代わるものです。
パラメータ | |
---|---|
path |
String : デバイス上で検索を行うパス |
戻り値 | |
---|---|
String[] |
デバイス上のパス内のすべてのファイルを含む文字列の配列。 |
例外 | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
デバイスに関連付けられている現在の接続。
戻り値 | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
ContentProviderHandler
を返します。利用できない場合は null を返します。
コンテンツ プロバイダは、同じ userId
で以前に作成されたものであれば再利用できます。
パラメータ | |
---|---|
userId |
int : コンテンツ プロバイダの初期化に使用するユーザー ID。 |
戻り値 | |
---|---|
ContentProviderHandler |
例外 | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
デバイスの現在の折りたたみ状態を返します。問題が発生した場合は null を返します。
戻り値 | |
---|---|
DeviceFoldableState |
例外 | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
現在実行中のユーザーの ID を返します。エラーの場合は -10000 を返します。
戻り値 | |
---|---|
int |
例外 | |
---|---|
DeviceNotAvailableException |
getDeviceDate
public long getDeviceDate ()
デバイスの日付をエポックからのミリ秒単位で返します。
戻り値 | |
---|---|
long |
デバイスの日付(エポック形式)。 |
例外 | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
実際のデバイス オブジェクトを渡すことなく、デバイス情報から DeviceDescriptor
を返してデバイス情報を取得します。
戻り値 | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
実際のデバイス オブジェクトを渡すことなく、デバイス情報から DeviceDescriptor
を返してデバイス情報を取得します。
パラメータ | |
---|---|
shortDescriptor |
boolean : 記述子を最小限の情報に制限するかどうか |
戻り値 | |
---|---|
DeviceDescriptor |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
デバイスと特定の ERROR(/Date)
との時間差を取得するヘルパー。内部でエポック時間を使用します。
パラメータ | |
---|---|
date |
Date |
戻り値 | |
---|---|
long |
ミリ秒単位の差 |
例外 | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
エミュレータの stdout と stderr のストリームを取得する
戻り値 | |
---|---|
InputStreamSource |
エミュレータの出力 |
getEmulatorProcess
public Process getEmulatorProcess ()
このエミュレータに対応する Process
を返します。
戻り値 | |
---|---|
Process |
Process または null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
すべての executeShellCommand(String)
ログを含むログ。
戻り値 | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
デバイスの外部ストレージの空き容量を判断するヘルパー メソッド。
戻り値 | |
---|---|
long |
空き容量(KB 単位) |
例外 | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
使用されている fastboot バイナリのパスを返します。fastboot 機能を有効にするには、isFastbootEnabled()
を true にする必要があります。
戻り値 | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
Fastboot モードでこのデバイスのプロダクト タイプを取得する便利なメソッドです。
この方法は、デバイスを Fastboot モードにする必要がある場合にのみ使用してください。この場合、ITestDevice はデバイスが正しくない状態であるか、応答しない場合、デバイスを fastboot に復元することを認識するため、汎用の getProductType()
メソッドよりも安全なバリエーションです。
戻り値 | |
---|---|
String |
String プロダクト タイプ名(特定できない場合は null ) |
例外 | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
Fastboot モードでこのデバイスのプロダクト タイプを取得する便利なメソッドです。
この方法は、デバイスを Fastboot モードにする必要がある場合にのみ使用してください。この場合、ITestDevice はデバイスが正しくない状態であるか、応答しない場合、デバイスを fastboot に復元することを認識するため、汎用の getProductType()
メソッドよりも安全なバリエーションです。
戻り値 | |
---|---|
String |
String プロダクト タイプ名(特定できない場合は null ) |
例外 | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Fastboot モードのシリアル番号を返します。
戻り値 | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
デバイスから指定された fastboot 変数の値を取得します。
パラメータ | |
---|---|
variableName |
String : 変数名 |
戻り値 | |
---|---|
String |
プロパティ値、または存在しない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
使用されている fastboot バイナリのバージョン文字列を返します。問題が発生した場合は null です。
戻り値 | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
デバイス上のリモート ファイルへの参照を取得します。
パラメータ | |
---|---|
path |
String : 取得するファイルパス。絶対パスまたは「/」を基準とする相対パスを指定できます(つまり、「/system」と「system」の両方の構文がサポートされています)。 |
戻り値 | |
---|---|
IFileEntry |
指定された path のファイルが見つからない場合は、IFileEntry または null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
ルート以外のパスから FileEntry
を取得する非公式のヘルパー。FIXME: 任意のパスから使用できるように FileEntry システムをリファクタリングします。(root でなくても)。
パラメータ | |
---|---|
entry |
FileListingService.FileEntry : Ddmlib で必要とされる root とは限らない FileEntry 。 |
戻り値 | |
---|---|
IFileEntry |
FileEntry を表す FileEntryWrapper。 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
デバイス上の折りたたみ式デバイスの状態のリストを返します。「cmd device_state print-states」で取得できます。
戻り値 | |
---|---|
|
例外 | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
関連する ddmlib IDevice
への参照を返します。
デバイスが adb から切断、再接続するたびに、DDMS によって新しい IDevice
が割り当てられることがあります。したがって、呼び出し元は IDevice
への参照を保持すべきではありません。参照が古くなる可能性があるためです。
戻り値 | |
---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
デバイスに存在するアプリのパッケージ名を取得します。
戻り値 | |
---|---|
|
現在デバイスにインストールされている String 個のパッケージ名のうち ERROR(/Set) 個。 |
例外 | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
デバイスから指定されたプロパティの整数値を返します。
パラメータ | |
---|---|
name |
String : プロパティ名 |
defaultValue |
long : プロパティが空または存在しない場合に返されるデフォルト値。 |
戻り値 | |
---|---|
long |
プロパティの値。プロパティが空、存在しない、または整数値でない場合は defaultValue 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
デバイスの IP アドレスを取得します。
戻り値 | |
---|---|
String |
デバイスの IP アドレス(デバイスに IP アドレスがない場合は null ) |
例外 | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
キーガードの現在の状態を取得するオブジェクトを返します。サポートされていない場合は null を返します。
戻り値 | |
---|---|
KeyguardControllerState |
キーガードの状態のスナップショットを含む KeyguardControllerState 。キーガード クエリがサポートされていない場合は Null を返します。 |
例外 | |
---|---|
DeviceNotAvailableException |
getLastExpectRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Tradefed API が最後に再起動をトリガーした時刻(System.currentTimeMillis()
によって返されるエポックからのミリ秒単位)を返します。
戻り値 | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
デバイスが最初にリリースされた API レベルを取得します。デフォルトは UNKNOWN_API_LEVEL
です。
戻り値 | |
---|---|
int |
デバイスで最初に起動された API レベルを示す整数 |
例外 | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
logcat データのスナップショット ストリームを取得します。
次の 2 つのモードで動作します。
TestDeviceOptions.getMaxLogcatDataSize()
バイト返します。戻り値 | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
キャプチャされた logcat データの最後の maxBytes
のスナップショット ストリームを取得します。
これは、getLogcat()
スナップショット全体を取得することによるディスク容量の低下を招くことなく、キャプチャされた logcat データのスナップショットを頻繁にキャプチャする場合に便利です。
パラメータ | |
---|---|
maxBytes |
int : 返されるデータの最大量。メモリに余裕を持って収まる量にする必要があります。 |
戻り値 | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
デバイスの現在の logcat ダンプを取得します。getLogcat()
とは異なり、このメソッドは常に logcat の静的ダンプを返します。
デバイスにアクセスできない場合は何も返されないというデメリットがあります。
戻り値 | |
---|---|
InputStreamSource |
logcat データの InputStreamSource 。logcat データをキャプチャできない場合は、空のストリームが返されます。 |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
指定された日付以降にキャプチャされた logcat データのスナップショット ストリームを取得します。デバイスの時刻は getDeviceDate()
を使用する必要があります。
パラメータ | |
---|---|
date |
long : スナップショットの開始時間から現在までのエポックからのミリ秒数。(「date +%s」を使用して取得できます) |
戻り値 | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
デバイスの MAC アドレスを返します。デバイスからのクエリに失敗した場合は null を返します。
戻り値 | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
メインのユーザー ID を返します。
戻り値 | |
---|---|
Integer |
メインユーザーの userId(存在する場合)。メインユーザーが存在しない場合は null。 |
例外 | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
デバイスにインストールされている Mainline モジュールに関する情報を取得します。
戻り値 | |
---|---|
|
デバイスに現在インストールされている String Mainline モジュールの ERROR(/Set) 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
同時に実行できるユーザーの最大数を取得します。デフォルトは 0 です。
戻り値 | |
---|---|
int |
同時に実行しているユーザー数を示す整数 |
例外 | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
サポートされている最大ユーザー数を取得します。デフォルトは 0 です。
戻り値 | |
---|---|
int |
サポートされているユーザー数を示す整数 |
例外 | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
戻り値 | |
---|---|
Process |
Microdroid VM のプロセスを返します。TestDevice が Microdroid でない場合、null を返します。 |
getMonitor
public IDeviceStateMonitor getMonitor ()
デバイスに関連付けられている IDeviceStateMonitor
を返します。
戻り値 | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
マウント ポイントを返します。
IDevice
のキャッシュに保存された情報が利用できない場合は、デバイスに直接クエリを実行します。
TODO: この動作を IDevice#getMountPoint(String)
に移動
パラメータ | |
---|---|
mountName |
String : マウント ポイントの名前 |
戻り値 | |
---|---|
String |
マウント ポイントまたは null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
指定されたマウントポイント パスに対応する MountPointInfo
を返します。パスに何もマウントされていない場合や、/proc/mounts にマウントポイントとして表示されない場合は、null
を返します。
パラメータ | |
---|---|
mountpoint |
String |
戻り値 | |
---|---|
ITestDevice.MountPointInfo |
「/proc/mounts」の情報を含む MountPointInfo の ERROR(/List) |
例外 | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
デバイスの /proc/mounts にある情報を解析して返します。
戻り値 | |
---|---|
|
「/proc/mounts」の情報を含む MountPointInfo の ERROR(/List) |
例外 | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
デバイスのテスト オプションを取得します。
戻り値 | |
---|---|
TestDeviceOptions |
TestDeviceOptions : テスト対象デバイス。 |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
デバイス パーティションの空き容量を判断するヘルパー メソッド。
パラメータ | |
---|---|
partition |
String |
戻り値 | |
---|---|
long |
空き容量(KB 単位) |
例外 | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
プライマリ ユーザー ID を返します。
戻り値 | |
---|---|
Integer |
プライマリ ユーザーが存在する場合は、その userId、プライマリ ユーザーが存在しない場合は null。 |
例外 | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
ヘルパー メソッドは、「pidof」コマンドと「stat」コマンドを実行し、指定されたプロセスの PID とプロセス開始時間を示す ProcessInfo
オブジェクトを返します。
パラメータ | |
---|---|
processName |
String : プロシージャ名の文字列。 |
戻り値 | |
---|---|
ProcessInfo |
指定された processName の ProcessInfo |
例外 | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
サービスの pid を返します。エラーが発生した場合は null を返します。
パラメータ | |
---|---|
process |
String : プロシージャ名の文字列。 |
戻り値 | |
---|---|
String |
例外 | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
このデバイスのプロダクト タイプを取得する便利なメソッド。
この方法は、デバイスが adb モードまたは fastboot モードの場合に利用できます。
戻り値 | |
---|---|
String |
String 商品タイプ名。null にならない |
例外 | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
このデバイスの商品バリエーションを取得する便利なメソッド。
この方法は、デバイスが adb モードまたは fastboot モードの場合に機能します。
戻り値 | |
---|---|
String |
String バリエーション商品名、または特定できない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
デバイスから指定されたプロパティ値を取得します。
パラメータ | |
---|---|
name |
String : プロパティ名 |
戻り値 | |
---|---|
String |
プロパティ値、または存在しない場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
デバイスで使用されている現在のリカバリモードを取得します。
戻り値 | |
---|---|
ITestDevice.RecoveryMode |
デバイスで使用されている現在のリカバリモード。 |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
指定されたディスプレイ ID のデバイスからスクリーンショットを取得します。形式は PNG です。
TODO: 上記の実装を拡張して、「format」と「rescale」をサポートする
パラメータ | |
---|---|
displayId |
long : スクリーンショットを取得する画面のディスプレイ ID。 |
戻り値 | |
---|---|
InputStreamSource |
スクリーンショットの InputStreamSource (形式)、またはスクリーンショットが成功しなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format)
デバイスからスクリーンショットを取得します。 サイズを小さくするには、JPEG エンコードとともに getScreenshot(format) を使用することをおすすめします
パラメータ | |
---|---|
format |
String : サポートされている PNG、JPEG |
戻り値 | |
---|---|
InputStreamSource |
スクリーンショットの InputStreamSource (形式)、またはスクリーンショットが成功しなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
デバイスのスクリーンショットを取得します。サイズを小さくするには、代わりに getScreenshot(String)
を使用して JPEG エンコードすることをおすすめします。
パラメータ | |
---|---|
format |
String : サポートされている PNG、JPEG |
rescale |
boolean : 結果の画像のサイズを小さくするためにスクリーンショットのサイズを変更するかどうか |
戻り値 | |
---|---|
InputStreamSource |
形式で指定したスクリーンショットの InputStreamSource 。スクリーンショットが成功しなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
デバイスからスクリーンショットを取得します。
戻り値 | |
---|---|
InputStreamSource |
スクリーンショットの InputStreamSource (PNG 形式)。スクリーンショットが正常に取得されなかった場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
このデバイスのシリアル番号を取得する便利なメソッド。
戻り値 | |
---|---|
String |
String シリアル番号 |
getSetting
public String getSetting (int userId, String namespace, String key)
リクエストされた設定の値を返します。namespace は {"system"、"secure"、"global"} のいずれかにする必要があります。
パラメータ | |
---|---|
userId |
int |
namespace |
String |
key |
String |
戻り値 | |
---|---|
String |
ユーザーの namespace:key に関連付けられた値。見つからない場合は null。 |
例外 | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
getSetting(int, String, String)
を参照し、システム ユーザーで実行します。
パラメータ | |
---|---|
namespace |
String |
key |
String |
戻り値 | |
---|---|
String |
例外 | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
SIM カード事業者を返します。利用できない場合は null を返します。デバイスが利用できない場合は null を返します。
戻り値 | |
---|---|
String |
getSimState
public String getSimState ()
SIM カードの状態を返します。利用できない場合は null を返します。デバイスが利用できない場合は null を返します。
戻り値 | |
---|---|
String |
getTombstones
publicgetTombstones ()
デバイスから墓石のリストを取得して返します。root が必要です。
メソッドはベスト エフォートであるため、なんらかの理由で 1 つの墓石が pull に失敗すると、リストから除外されます。メソッドを早期に終了できるのは DeviceNotAvailableException
のみです。
戻り値 | |
---|---|
|
墓石ファイルのリスト。墓石がない場合、空になります。 |
例外 | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
物理メモリの合計サイズをバイト単位で返します。内部エラーの場合は -1 を返します。
戻り値 | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
デバイス管理のため、デバイスのトラッキングに使用されたシリアル番号を入手します。
戻り値 | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
アンインストール可能なアプリのパッケージ名を取得します。現在、これはシステム以外のパッケージと更新されたシステム パッケージとして定義されています。
戻り値 | |
---|---|
|
デバイスに現在インストールされている、アンインストール不可の String パッケージ名の ERROR(/Set) 。 |
例外 | |
---|---|
DeviceNotAvailableException |
getUseFastbootErase
public boolean getUseFastbootErase ()
デバイスのパーティションのワイプに fastboot の消去形式と fastboot 形式のどちらを使用するかを確認します。
戻り値 | |
---|---|
boolean |
fastboot erase を使用する場合は true 、fastboot format を使用する場合は false 。 |
getUserFlags
public int getUserFlags (int userId)
指定したユーザーのフラグを検索して返します。フラグは、Android オープンソース プロジェクトの「android.content.pm.UserInfo」クラスで定義されています。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
int |
指定された userId に関連するフラグ(見つかった場合)。それ以外の場合は -10000。 |
例外 | |
---|---|
DeviceNotAvailableException |
getUserInfo
publicgetUserInfos ()
デバイスの useId の UserInfo
へのマップを取得します。デバイスからの出力が想定どおりでない場合は DeviceRuntimeException
をスローします。
戻り値 | |
---|---|
|
UserInfo オブジェクトのリスト。 |
例外 | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
userId に関連付けられたシリアル番号が見つかった場合は返し、それ以外の場合は -10000 を返します。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
int |
例外 | |
---|---|
DeviceNotAvailableException |
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
指定された DeviceEvent を処理します。デバイスを新しい状態に移行する場合があります。状態遷移を IDeviceMonitor
に通知します。
DeviceEvent を処理します。このデバイスを新しい割り当て状態に移行する場合もあれば、移行しないこともあります。
パラメータ | |
---|---|
event |
DeviceEvent |
戻り値 | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
デバイスで利用できる機能を確認する。
パラメータ | |
---|---|
feature |
String : 「feature: |
戻り値 | |
---|---|
boolean |
特徴が見つかった場合は true、見つからなかった場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
デバイスに Android パッケージをインストールします。
パラメータ | |
---|---|
packageFile |
File : インストールする apk ファイル |
reinstall |
boolean : 再インストールが必要な場合は true |
extraArgs |
String : 渡す追加の引数(省略可)。使用可能なオプションについては、「adb shell pm -h」をご覧ください。 |
戻り値 | |
---|---|
String |
エラーコードを含む String 、または成功した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
デバイスに Android パッケージをインストールします。
注: この関数を呼び出す必要があるのは、インストール時に実行時の権限の付与を明示的に制御する必要がある場合のみです。
パラメータ | |
---|---|
packageFile |
File : インストールする apk ファイル |
reinstall |
boolean : 再インストールが必要な場合は true |
grantPermissions |
boolean : すべてのランタイム パーミッションをインストール時に付与する必要があるかどうか |
extraArgs |
String : 渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm -h」をご覧ください。 |
戻り値 | |
---|---|
String |
エラーコードを含む String 、または成功した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
特定のユーザーのデバイスに Android パッケージをインストールします。
パラメータ | |
---|---|
packageFile |
File : インストールする apk ファイル |
reinstall |
boolean : 再インストールを実行する必要がある場合は true |
userId |
int : インストールするユーザー ID(整数)。 |
extraArgs |
String : 渡す追加の引数(省略可)。使用可能なオプションについては、「adb shell pm -h」をご覧ください。 |
戻り値 | |
---|---|
String |
エラーコードを含む String 、または成功した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
特定のユーザーのデバイスに Android パッケージをインストールします。
注: この関数を呼び出すのは、インストール時に実行時の権限の付与を明示的に制御する必要があるユースケースに限られます。
パラメータ | |
---|---|
packageFile |
File : インストールする apk ファイル |
reinstall |
boolean : 再インストールが必要な場合は true |
grantPermissions |
boolean : すべてのランタイム パーミッションをインストール時に付与する必要があるかどうか |
userId |
int : インストールするユーザー ID(整数)。 |
extraArgs |
String : 渡す追加の引数(省略可)。使用可能なオプションについては、「adb shell pm -h」をご覧ください。 |
戻り値 | |
---|---|
String |
エラーコードを含む String 。成功した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
戻り値 | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する
戻り値 | |
---|---|
boolean |
アプリの列挙がサポートされている場合は true、それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
デバイス上のプラットフォームが、アプリのインストール時に低いターゲット SDK のブロックをバイパスすることをサポートしているかどうかを確認する
戻り値 | |
---|---|
boolean |
低ターゲット SDK ブロックのバイパスがサポートされている場合は true、それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
debugfs がマウントされているかどうかを確認します。
戻り値 | |
---|---|
boolean |
debugfs がマウントされている場合: true |
例外 | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
デバイスが暗号化されているかどうかを返します。
戻り値 | |
---|---|
boolean |
true (デバイスが暗号化されている場合)。 |
例外 | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
デバイス上のパスがディレクトリである場合は true を返し、それ以外の場合は false を返します。
パラメータ | |
---|---|
path |
String |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
戻り値 | |
---|---|
boolean |
true : デバイスで adb ルートを有効にする必要があるかどうか |
isEncryptionSupported
public boolean isEncryptionSupported ()
デバイスで暗号化がサポートされているかどうかを返します。
戻り値 | |
---|---|
boolean |
true : デバイスが暗号化をサポートしている場合。 |
例外 | |
---|---|
DeviceNotAvailableException |
isExecutable
public boolean isExecutable (String fullPath)
デバイス上のファイルパスが実行可能ファイルの場合は true を返し、それ以外の場合は false を返します。
パラメータ | |
---|---|
fullPath |
String |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
デバイスで fastboot を使用できる場合に返されます。
戻り値 | |
---|---|
boolean |
isHeadless
public boolean isHeadless ()
デバイスがヘッドレス(画面なし)の場合は true、それ以外の場合は false を返します。
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
デバイスがヘッドレス システム ユーザー モードを使用しているかどうかを返します。
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
メインユーザーが永続的な管理者で、削除したり管理者以外のステータスにダウングレードしたりできないかどうかを返します。
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
マルチユーザーに対応しているかどうかを判別します。
戻り値 | |
---|---|
boolean |
マルチユーザーがサポートされている場合は true、それ以外の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
isPackageInstalled
public boolean isPackageInstalled (String packageName, String userId)
特定のパッケージ名とユーザー ID についてデバイスにクエリを実行し、そのユーザーに対して現在インストールされているかどうかを確認します。
パラメータ | |
---|---|
packageName |
String : インストールされているかどうかを確認するパッケージ。 |
userId |
String : パッケージがインストールされているユーザー ID。null の場合、プライマリ ユーザー 0 が使用されます。 |
戻り値 | |
---|---|
boolean |
パッケージがインストール済みとして報告された場合は true。それ以外の場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
特定のパッケージ名についてデバイスにクエリを実行し、現在インストールされているかどうかを確認します。
パラメータ | |
---|---|
packageName |
String |
戻り値 | |
---|---|
boolean |
パッケージがインストール済みとして報告された場合は true。それ以外の場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
デバイス上のプラットフォームがランタイム権限の付与をサポートしているかどうかを確認する
戻り値 | |
---|---|
boolean |
実行時の権限がサポートされている場合は true、それ以外の場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
デバイスが TestDeviceState#FASTBOOT
または TestDeviceState.FASTBOOTD
にある場合、true を返します。
戻り値 | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
特定のユーザーが実行されているかどうかを確認します。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
boolean |
ユーザーが実行中の場合は true、それ以外の場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
isUserSecondary
public boolean isUserSecondary (int userId)
指定されたユーザーがフラグに基づいてセカンダリ ユーザーかどうかを返します。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
boolean |
ユーザーがセカンダリである場合は true、そうでない場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
指定されたユーザーが公開されているかどうかを確認します。
「可視」ユーザーとは、「人間」ユーザーとやり取りしているユーザーであり、そのため(通常はデフォルトのディスプレイで)起動アクティビティを起動できます。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
指定されたディスプレイに特定のユーザーが表示されているかどうかを確認します。
「可視」ユーザーとは、「人間」ユーザーとやり取りしているユーザーであり、そのディスプレイでアクティビティを起動できます。
パラメータ | |
---|---|
userId |
int |
displayId |
int |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
デバイスでユーザーが ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
でバックグラウンドで開始され、表示されるかどうかを返します。
存在する場合は、listDisplayIdsForStartingVisibleBackgroundUsers()
から返されたディスプレイ(ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
を含む)を渡して startVisibleBackgroundUser(int, int, boolean)
を呼び出すことができます。
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
デバイスでユーザーがバックグラウンドで開始されたことを表示できるかどうかを返します。
存在する場合は、listDisplayIdsForStartingVisibleBackgroundUsers()
によって返されたディスプレイを渡して startVisibleBackgroundUser(int, int, boolean)
を呼び出すことができます。
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Wi-Fi が有効になっているかどうかをテストします。
デバイスで Wi-Fi が有効になっているかどうかを確認します。Wi-Fi で実行すべきでないテスト(モバイルデータ テストなど)の前に Wi-Fi ステータスをアサートする場合に便利です。
戻り値 | |
---|---|
boolean |
Wi-Fi が有効になっている場合は true 。無効の場合は false |
例外 | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
「dumpsys SurfaceFlinger」によって報告された、デバイスで使用可能なディスプレイ ID のリストを収集します。
戻り値 | |
---|---|
|
ディスプレイのリスト。デフォルトでは、常にデフォルトの表示 0 が返されます。 |
例外 | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
start a user visible in the background
で使用できるディスプレイのリストを取得します。
戻り値 | |
---|---|
|
例外 | |
---|---|
DeviceNotAvailableException |
listUsers
publiclistUsers ()
デバイス上のユーザーのリストを取得します。デバイスからの出力が想定どおりでない場合、DeviceRuntimeException
をスローします。
戻り値 | |
---|---|
|
ユーザー ID のリスト。 |
例外 | |
---|---|
DeviceNotAvailableException |
logAnrs
public boolean logAnrs (ITestLogger logger)
デバイスから ANR を収集してログに記録します。
パラメータ | |
---|---|
logger |
ITestLogger : ANR をログに記録する ITestLogger 。 |
戻り値 | |
---|---|
boolean |
ロギングが成功した場合は true、それ以外の場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
ログバグレポート
public boolean logBugreport (String dataName, ITestLogger listener)
バグレポートを取得してレポーターにログを記録するヘルパー メソッド。
パラメータ | |
---|---|
dataName |
String : バグレポートが報告される名前。 |
listener |
ITestLogger : バグレポートをログに記録する ITestLogger 。 |
戻り値 | |
---|---|
boolean |
ロギングが成功した場合は true、それ以外の場合は false。 |
logOnDevice
public 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() で置換される引数。 |
nonBlockingReboot
public void nonBlockingReboot ()
デバイスを再起動するコマンドを発行し、コマンドの完了時と、デバイスが adb に表示されなくなったときに返されます。
例外 | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
adb root の後、デバイスがオンラインに戻る前に、デバイスで特定のアクションを実行する必要がある場合は、オーバーライドします。デフォルトの実装には追加アクションは含まれません。この段階で adb root が有効になっているとは限りません。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
adb のルート解除後、デバイスがオンラインに戻る前に、デバイスで特定のアクションを実行する必要がある場合は、オーバーライドします。デフォルトの実装には追加のアクションは含まれていません。この段階で adb root が無効になるとは限りません。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public void postBootSetup ()
手順に沿ってデバイスを構成し、起動後にテストします。
デバイスの起動が完了した後、またはデバイスが使用可能になった後に呼び出す必要があります。
通常、このメソッドを明示的に呼び出す必要はありません。実装では、再起動時にこれらの手順が自動的に実行されるためです。
呼び出す必要があるのは、他のイベント(fastboot update コマンドが完了したときなど)によってデバイスが再起動された場合です。
例外 | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
呼び出しが完了した後に実行される、デバイス固有の必要なクリーンアップの追加手順。
パラメータ | |
---|---|
exception |
Throwable : 呼び出しの失敗によってスローされた最終的な例外(存在する場合)。 |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
呼び出しフローの前にデバイス上で実行される、デバイス固有の必要な設定の追加手順。
パラメータ | |
---|---|
info |
IBuildInfo : デバイスの IBuildInfo 。 |
attributes |
MultiMap : 呼び出しコンテキストに格納されている属性 |
例外 | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
デバイスからディレクトリ コンテンツを再帰的に pull します。
パラメータ | |
---|---|
deviceFilePath |
String : リモートソースの絶対ファイルパス |
localDir |
File : ファイルを pull するローカル ディレクトリ |
userId |
int : プル元のユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが正常に pull された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
デバイスからディレクトリ コンテンツを再帰的に pull します。
パラメータ | |
---|---|
deviceFilePath |
String : リモートソースの絶対ファイルパス |
localDir |
File : ファイルを pull するローカル ディレクトリ |
戻り値 | |
---|---|
boolean |
ファイルが正常に pull された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
デバイスからファイルを取得します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
localFile |
File : コンテンツを保存するローカル ファイル。空でない場合、内容が置き換えられます。 |
戻り値 | |
---|---|
boolean |
ファイルが正常に取得された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
デバイスからファイルを取得し、ローカルの一時的な ERROR(/File)
に格納して、その File
を返します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
userId |
int : プル元のユーザー ID |
戻り値 | |
---|---|
File |
デバイス ファイルの内容を含む ERROR(/File) 。コピーがなんらかの理由(ホスト ファイルシステムの問題など)で失敗した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
デバイスからファイルを取得し、ローカルの一時的な ERROR(/File)
に格納して、その File
を返します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
戻り値 | |
---|---|
File |
デバイス ファイルの内容を含む ERROR(/File) 。コピーがなんらかの理由(ホスト ファイルシステムの問題など)で失敗した場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
デバイスからファイルを取得します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
localFile |
File : コンテンツを保存するローカル ファイル。空でない場合、コンテンツが置き換えられます。 |
userId |
int : プル元のユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが正常に取得された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
デバイスからファイルを取得し、その内容を返します。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルの絶対パス。 |
戻り値 | |
---|---|
String |
デバイス ファイルの内容を含む String 。コピーがなんらかの理由(ホスト ファイルシステムの問題など)で失敗した場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
デバイスの外部ストレージからファイルを取得し、ローカルの一時 ERROR(/File)
に保存し、その File
への参照を返す便利なメソッド。
パラメータ | |
---|---|
remoteFilePath |
String : デバイス上のファイルのパス(デバイスの外部ストレージのマウント ポイントを基準とする相対パス) |
戻り値 | |
---|---|
File |
デバイス ファイルの内容を含む ERROR(/File) 。コピーがなんらかの理由(ホスト ファイルシステムの問題など)で失敗した場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
フィルタリングされた一部のディレクトリを除外しながら、ディレクトリの内容をデバイスに再帰的にプッシュします。
パラメータ | |
---|---|
localFileDir |
File : push するローカル ディレクトリ |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
excludedDirectories |
: プッシュしないディレクトリ名の除外セット。 |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
ディレクトリの内容を再帰的にデバイスに push します。
パラメータ | |
---|---|
localFileDir |
File : push するローカル ディレクトリ |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
ディレクトリの内容を再帰的にデバイスに push します。
パラメータ | |
---|---|
localFileDir |
File : push するローカル ディレクトリ |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパス |
userId |
int : プッシュするユーザー ID |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
pushFile(File, String)
のバリエーション。コンテンツ プロバイダのニーズを評価することもできます。
パラメータ | |
---|---|
localFile |
File : push するローカル ファイル |
remoteFilePath |
String : リモート デスティネーションの絶対ファイルパス |
evaluateContentProviderNeeded |
boolean : コンテンツ プロバイダが必要かどうかをチェックする |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
ファイルをデバイスにプッシュします。デフォルトではコンテンツ プロバイダを使用します。
パラメータ | |
---|---|
localFile |
File : push するローカル ファイル |
remoteFilePath |
String : リモート デスティネーションの絶対ファイルパス |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
ファイルをデバイスにプッシュします。デフォルトではコンテンツ プロバイダを使用します。
パラメータ | |
---|---|
localFile |
File : push するローカル ファイル |
remoteFilePath |
String : リモート デスティネーションの絶対ファイルパス |
userId |
int : プッシュする userId |
戻り値 | |
---|---|
boolean |
ファイルが正常に push された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
文字列から作成されたファイルをデバイスにプッシュする
パラメータ | |
---|---|
contents |
String : push するファイルの内容 |
remoteFilePath |
String : リモート デスティネーションの絶対ファイルパス |
戻り値 | |
---|---|
boolean |
文字列が正常にプッシュされた場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
再起動
public void reboot (String reason)
指定された reason
を使用してデバイスを adb モードで再起動し、再起動しても保持されるようにします。
デバイスが使用可能になるまでブロックします。
前回の再起動の理由は、sys.boot.reason
プロパティをクエリすることで取得できます。
パラメータ | |
---|---|
reason |
String : この再起動の理由。理由が指定されていない場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
再起動
public void reboot ()
デバイスを再起動して adb モードに入ります。
デバイスが利用可能になるまでブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
デバイスをブートローダー モードで再起動します。
デバイスがブートローダー モードになるまでブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
デバイスを再起動して fastbootd モードに入ります。
デバイスが fastbootd モードになるまでブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
restartIntoRecovery
public void rebootIntoRecovery ()
デバイスを再起動して adb リカバリ モードに入ります。
デバイスがリカバリ状態になるまでブロックする
例外 | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
デバイスを adb サイドロード モードに再起動します(これはリカバリの特別なモードです)。
デバイスがサイドロード モードに入るまでブロックする
例外 | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
デバイスを adb サイドロード モードに再起動します(これはリカバリの特別なモードです)。
デバイスがサイドロード モードに移行するまでブロックする
パラメータ | |
---|---|
autoReboot |
boolean : サイドロード後にデバイスを自動的に再起動するかどうか |
例外 | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
reboot()
の代替手段で、デバイスがオンラインになるまで(つまり adb で認識できるまで)ブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline (String reason)
reboot()
の代替手段で、デバイスがオンラインになるまで(つまり adb で認識できるまで)ブロックします。
パラメータ | |
---|---|
reason |
String : この再起動の理由。理由が指定されていない場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
デバイスのユーザー空間部分のみを再起動します。
デバイスが使用可能になるまでブロックします。
警告。ユーザー空間の再起動は現在開発中です。ご自身の責任で使用してください。
例外 | |
---|---|
DeviceNotAvailableException |
restartUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
rebootUserspace()
()} の代替手段。デバイスがオンラインになるまで(つまり、adb に表示される)までのみブロックします。
例外 | |
---|---|
DeviceNotAvailableException |
recoveryDevice
public boolean recoverDevice ()
デバイス通信の回復を試みます。
戻り値 | |
---|---|
boolean |
復元が試行され、成功した場合は true、復元がスキップされた場合は false を返します。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスが利用できなくなった場合 |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
このデバイスの IDeviceActionReceiver
を登録します。
登録されたすべての IDeviceActionReceiver
には、デバイス アクションの開始前とデバイス アクションの終了後に通知されます。
パラメータ | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : 登録される IDeviceActionReceiver 。 |
remountSystemReadOnly
public void remountSystemReadOnly ()
デバイスのシステム パーティションを読み取り専用にします。デバイスが再起動される場合があります。
例外 | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
デバイスのシステム パーティションを書き込み可能にします。デバイスが再起動される場合があります。
例外 | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
デバイス上のベンダー パーティションを読み取り専用にします。デバイスが再起動される場合があります。
例外 | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
デバイスのベンダー パーティションを書き込み可能にします。デバイスが再起動される場合があります。
例外 | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
指定されたユーザーの指定されたデバイス管理者を削除し、成功した場合は true
、失敗した場合は false
を返します。
パラメータ | |
---|---|
componentName |
String : 削除するデバイス管理者の ID。 |
userId |
int : デバイス管理者が存在するユーザーの |
戻り値 | |
---|---|
boolean |
成功した場合は true、それ以外の場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
既存のデバイス プロファイルのオーナーをすべて削除します。
例外 | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
特定のユーザーをデバイスから削除する。
パラメータ | |
---|---|
userId |
int : 削除するユーザーの |
戻り値 | |
---|---|
boolean |
ユーザーの削除に成功した場合は true、失敗した場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
コンテンツ プロバイダの設定を再度トリガーするには、そのフラグをリセットします。
runInstrumentationTests
public 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 boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
インストルメンテーション テストを実行し、デバイスの復元を提供します。
テスト実行が完了する前にデバイスとの接続が切断され、復元に成功した場合、すべてのリスナーに testRunFailed が通知され、「false」が返されます。テストコマンドは再実行されません。必要に応じて、呼び出し元が再試行します。
テスト実行が完了する前にデバイスとの接続が失われ、復元に失敗した場合、すべてのリスナーに testRunFailed が通知され、DeviceNotAvailableException がスローされます。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner : テストを実行する IRemoteAndroidTestRunner |
listeners |
: テスト結果リスナー |
戻り値 | |
---|---|
boolean |
テストコマンドが完了した場合は true 。false : デバイスの通信例外が原因で完了しなかったが、復元に成功した場合 |
例外 | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
と同じですが、特定のユーザーに対してテストを実行します。
パラメータ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
使用中の IConfiguration
を注入します。
パラメータ | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
パラメータ | |
---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
デバイスの日付を設定します。
注: デバイスの日付を設定するには、root 権限が必要です。
パラメータ | |
---|---|
date |
Date : 特定の日付を指定します。null の場合はホスト日付が使用されます。 |
例外 | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
特定のユーザーのデバイス オーナーとしてデバイス管理コンポーネントを設定します。
パラメータ | |
---|---|
componentName |
String : デバイス管理者がデバイスのオーナーである。 |
userId |
int : デバイス所有者が居住する国または地域のユーザー。 |
戻り値 | |
---|---|
boolean |
成功した場合は true、それ以外の場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
デバイスの状態を更新します。
パラメータ | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
エミュレータの場合は、SizeLimitedOutputStream
を設定して出力をログに記録します。
パラメータ | |
---|---|
output |
SizeLimitedOutputStream : 出力をログに記録します。 |
setEmulatorProcess
public void setEmulatorProcess (Process p)
このデバイスがエミュレータの場合に Process
を設定します。
パラメータ | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
デバイスの fastboot オプションを設定します。デバイスが最初に割り振られるときに設定する必要があります。
パラメータ | |
---|---|
fastbootEnabled |
boolean : デバイスで fastboot を使用できるかどうか |
setFastbootPath
public void setFastbootPath (String fastbootPath)
使用する fastboot バイナリへのパスを設定します。fastboot 機能を有効にするには、isFastbootEnabled()
を true にする必要があります。
パラメータ | |
---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
この ITestDevice に関連付けられている IDevice を更新します。
新しい IDevice は、現在の参照と同じ物理デバイスを参照する必要があります。このメソッドは、DDMS が新しい IDevice を割り当てた場合に呼び出されます。
パラメータ | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
オンライン デバイスの logcat キャプチャを開始する前に待機する時間をミリ秒単位で設定します。
パラメータ | |
---|---|
delay |
int : 遅延(ミリ秒) |
setOptions
public void setOptions (TestDeviceOptions options)
デバイスの TestDeviceOptions
を設定する
パラメータ | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
デバイスで指定されたプロパティ値を設定します。adb root が true である必要があります。
パラメータ | |
---|---|
propKey |
String : 設定対象のキー。 |
propValue |
String : 設定するプロパティ値。 |
戻り値 | |
---|---|
boolean |
setprop コマンドが成功した場合は True 、それ以外の場合は False を返します。 |
例外 | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
このデバイスに使用する IDeviceRecovery
を設定します。デバイスが最初に割り当てられるときに設定する必要があります。
パラメータ | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
デバイスに使用する現在のリカバリモードを設定します。
デバイスの通信に関する問題が発生したときに使用する復元方法を制御するために使用されます。この方法は、必要な場合にのみ使用することをおすすめします(フレームワークが停止している場合など)。
パラメータ | |
---|---|
mode |
ITestDevice.RecoveryMode : 「オンラインになるまで復元」モードをオンにするかどうか。 |
setSetting
public void setSetting (String namespace, String key, String value)
setSetting(int, String, String, String)
を参照し、システム ユーザーに対して実行されます。
パラメータ | |
---|---|
namespace |
String |
key |
String |
value |
String |
例外 | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
特定のユーザーの Namespace に設定値を追加します。一部の設定は再起動後にのみ使用できます。 namespace は {"system"、"secure"、"global"} のいずれかにする必要があります。
パラメータ | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
例外 | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
ITestLogger
インスタンスを挿入します。
パラメータ | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
デバイス管理のため、デバイスの参照に使用しているシリアル番号を追跡します。
パラメータ | |
---|---|
trackingSerial |
String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
fastboot erase と fastboot format のどちらを使用してデバイスのパーティションをワイプするかを設定します。
パラメータ | |
---|---|
useFastbootErase |
boolean : fastboot 消去を使用する場合は true 、fastboot フォーマットを使用する場合は false 。 |
startLogcat
public void startLogcat ()
バックグラウンドでデバイスから logcat の出力をキャプチャします。
logcat の出力がすでにキャプチャされている場合、効果はありません。データは後で getLogcat を使用して取得できます。
デバイスが使用されなくなったら、stopLogcat()
を呼び出す必要があります。
TF フレームワークは logcat の開始と停止を行うため、通常、TF 呼び出しコンテキスト内で startLogcat()
と stopLogcat()
を呼び出す必要はありません。
startUser
public boolean startUser (int userId)
指定したユーザーが現在停止している場合は、バックグラウンドでそのユーザーを開始します。ユーザーがすでにバックグラウンドで実行されている場合、このメソッドは NOOP です。
パラメータ | |
---|---|
userId |
int : バックグラウンドで起動するユーザー |
戻り値 | |
---|---|
boolean |
ユーザーがバックグラウンドで正常に開始された場合は true。 |
例外 | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
指定したユーザーが現在停止している場合は、バックグラウンドでそのユーザーを開始します。ユーザーがすでにバックグラウンドで実行されている場合、このメソッドは NOOP です。オペレーションが有効になるまで待機するための追加フラグを指定できます。
パラメータ | |
---|---|
userId |
int : バックグラウンドで起動するユーザー |
waitFlag |
boolean : ユーザーが起動してロックが解除されるまでコマンドを待機します。 |
戻り値 | |
---|---|
boolean |
ユーザーがバックグラウンドで正常に開始された場合は true。 |
例外 | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
特定のユーザーをバックグラウンドで開始し、特定のディスプレイに表示します(つまり、ユーザーはそのディスプレイでアクティビティを起動できます)。
注: このコマンドは、ユーザーが存在するかどうか、ディスプレイが使用可能かどうか、device supports such feature
などを確認しません。
パラメータ | |
---|---|
userId |
int : バックグラウンドで起動するユーザー |
displayId |
int : 最初のユーザーを表示するディスプレイ |
waitFlag |
boolean : ユーザーが起動してロックが解除されるまでコマンドを待機させます。 |
戻り値 | |
---|---|
boolean |
true : ユーザーがバックグラウンドで正常に起動された場合。 |
例外 | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
エミュレータの出力を閉じて削除します。
stopLogcat
public void stopLogcat ()
デバイスからの logcat 出力のキャプチャを停止し、現在保存されている logcat データを破棄します。
logcat の出力がキャプチャされていない場合、効果はありません。
stopUser
public boolean stopUser (int userId)
特定のユーザーを停止します。ユーザーがすでに停止している場合、このメソッドは NOOP です。現在のユーザーとシステム ユーザーを停止することはできません。
パラメータ | |
---|---|
userId |
int : 停止するユーザー。 |
戻り値 | |
---|---|
boolean |
ユーザーが正常に停止された場合は true。 |
例外 | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
特定のユーザーを停止します。追加のフラグを指定して、オペレーションが有効になるまで待機し、ユーザーを強制的に終了できます。現在のユーザーとシステム ユーザーを停止できません。
パラメータ | |
---|---|
userId |
int : 停止するユーザー。 |
waitFlag |
boolean : ユーザーが停止するまでコマンドを待機します。 |
forceFlag |
boolean : ユーザーを強制停止します。 |
戻り値 | |
---|---|
boolean |
ユーザーが正常に停止された場合は true。 |
例外 | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
デバイスを adb-over-tcp モードに切り替えます。
戻り値 | |
---|---|
String |
tcp シリアル番号、またはデバイスを切り替えられなかった場合は null |
例外 | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
デバイスを USB 経由の ADB モードに切り替えます。
戻り値 | |
---|---|
boolean |
切り替えが成功した場合は true 、それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId)
デフォルトのタイムアウトで別の userId に切り替えます。switchUser(int, long)
。
パラメータ | |
---|---|
userId |
int |
戻り値 | |
---|---|
boolean |
新しい userId が userId プロバイダと一致する場合は true。それ以外の場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
指定されたタイムアウトを期限として、別の userId に切り替えます。ユーザーの変更が正常に完了した後にキーガードを無効にしようとします。
パラメータ | |
---|---|
userId |
int |
timeout |
long : ユーザー切り替えに失敗した場合に false を返す前に待機します。 |
戻り値 | |
---|---|
boolean |
新しい userId が userId プロバイダと一致する場合は true。それ以外の場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
ローカル ファイル ディレクトリの内容をデバイスに増分同期します。
ローカル ファイルのタイムスタンプとリモートの同等のタイムスタンプを比較して、プッシュするファイルを決定します。デバイスにプッシュされるのは、「新しい」ファイルまたは存在しないファイルのみです。したがって、デバイス上のファイルセットがすでに最新の状態であれば、オーバーヘッドは比較的小さくなります。
非表示のファイル(名前が「.」で始まるもの)は無視されます。
使用例: syncFiles("/tmp/files", "/sdcard") は、/sdcard/files ディレクトリが存在しない場合、そのディレクトリを作成して、/tmp/files の内容を /sdcard/files に再帰的に push します。
パラメータ | |
---|---|
localFileDir |
File : 再帰的に push するファイルを含むローカル ファイル ディレクトリ。 |
deviceFilePath |
String : リモート デスティネーションの絶対ファイルパスのルート。このファイルパス内のすべてのディレクトリは読み取り可能である必要があります。たとえば、adb が root でない場合、/data/local/tmp に push すると失敗します。 |
戻り値 | |
---|---|
boolean |
ファイルが正常に同期された場合は true 。それ以外の場合は false 。 |
例外 | |
---|---|
DeviceNotAvailableException |
バグレポートを取得
public Bugreport takeBugreport ()
バグレポートを受け取り、Bugreport
オブジェクト内に返して処理します。問題が発生した場合は null を返します。Bugreport オブジェクトで参照されているファイルは、Bugreport.close()
でクリーンアップする必要があります。
戻り値 | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
デバイスから Android パッケージをアンインストールする。
パラメータ | |
---|---|
packageName |
String : アンインストールする Android パッケージ |
戻り値 | |
---|---|
String |
エラーコードを含む String 。成功した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
特定のユーザーのデバイスから Android パッケージをアンインストールします。
パラメータ | |
---|---|
packageName |
String : アンインストールする Android パッケージ |
userId |
int : アンインストールするユーザー ID(整数)。 |
戻り値 | |
---|---|
String |
エラーコードを含む String 、または成功した場合は null 。 |
例外 | |
---|---|
DeviceNotAvailableException |
デバイスのロックを解除
public boolean unlockDevice ()
デバイスが暗号化されている場合は、デバイスのロックを解除します。
このメソッドはフレームワークを再起動する可能性がありますが、postBootSetup()
は呼び出されません。そのため、このメソッドが戻ったときに、デバイスはテストの準備ができていない可能性があります。
戻り値 | |
---|---|
boolean |
成功した場合、またはデバイスが暗号化されていない場合は true 。 |
例外 | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
デバイスの起動完了フラグが設定されるまでブロックします。
パラメータ | |
---|---|
timeOut |
long : フラグの設定を待機する時間(ミリ秒単位) |
戻り値 | |
---|---|
boolean |
タイムアウト内にデバイスの起動完了フラグが設定されている場合は true |
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
デバイスが応答してテストに使用可能になるまで待機します。デフォルトのタイムアウトを使用します。
戻り値 | |
---|---|
boolean |
デバイスが使用可能な場合は true、復元が無効で使用できない場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
デバイスが応答し、テストの準備が整うまで待ちます。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
デバイスが使用可能な場合は true、復元が無効で使用できない場合は false。 |
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
復元パスを検討せずに、デバイスが応答して使用可能になるまで待ちます。
パラメータ | |
---|---|
waitTime |
long |
戻り値 | |
---|---|
boolean |
デバイスが利用可能な場合は true、利用できない場合は False です。 |
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
デバイスが fastboot で認識されるまでブロックします。デフォルトのタイムアウトを使用します。
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
デバイスを「adb recovery」状態にするためのブロック(これは IDeviceRecovery
とは異なります)。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
期限が切れる前にデバイスがリカバリに起動する場合は true 。
それ以外の場合は false |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
デバイスが「adb sideload」状態になるのをブロックします
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
true : 時間切れになる前にデバイスがサイドロードに起動した場合。それ以外の場合は false
|
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
デバイスを利用できないようにするためのブロック(adb に欠落しているなど)
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
true : 期限が切れる前にデバイスが使用できなくなった場合。
それ以外の場合は false |
waitForDeviceOnline
public void waitForDeviceOnline ()
デバイスが adb 経由で検出されるまでブロックします。デフォルトのタイムアウトを使用
ただし、完了後にデバイスがコマンドに応答するとは限りません。代わりに waitForDeviceAvailable()
を使用してください。
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
デバイスが adb 経由で検出されるまでブロックします。
ただし、完了後にデバイスがコマンドに応答するとは限りません。代わりに waitForDeviceAvailable()
を使用してください。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
例外 | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
デバイスが基本的な adb shell コマンドに応答するまで待ちます。
パラメータ | |
---|---|
waitTime |
long : 待機時間(ミリ秒) |
戻り値 | |
---|---|
boolean |
waitTime が経過する前にデバイスが応答した場合は true 。 |
保護されたメソッド
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
パラメータ | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
指定された adb シェルコマンド セッションと引数用の OS コマンドをビルドします。
パラメータ | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
戻り値 | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
パラメータ | |
---|---|
feature |
String |
strictMinLevel |
int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
再起動アクションの実行時に使用する RebootDeviceAction
を作成します。
パラメータ | |
---|---|
rebootMode |
NativeDevice.RebootMode : この再起動のモード。 |
reason |
String : この再起動用。 |
戻り値 | |
---|---|
NativeDevice.RebootDeviceAction |
作成された RebootDeviceAction 。 |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
adb で再起動します。
パラメータ | |
---|---|
rebootMode |
NativeDevice.RebootMode : この再起動のモード。 |
reason |
String : この再起動用。 |
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
実行時の権限がサポートされていない場合に例外をスローするヘルパー メソッド
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
戻り値 | |
---|---|
int |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
パラメータ | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
例外 | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
InternalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
デフォルトで ddmlib キャッシュからデバイスのプロパティを取得し、デバイスが Fastboot を使用しているかどうかに応じて「adb shell getprop」または「fastboot getvar」にフォールバックします。
パラメータ | |
---|---|
propName |
String : 「adb shell getprop」によって返されるデバイス プロパティの名前 |
fastbootVar |
String : クエリする同等の fastboot 変数の名前。null の場合、fastboot クエリは試行されません。 |
description |
String : 変数の簡単な説明。最初の文字は大文字にする必要があります。 |
戻り値 | |
---|---|
String |
指定されたプロパティの値を含む文字列(null または空の場合もあります) |
例外 | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
現在再起動コールバックが実行されているかどうかを返します。true の場合、再起動のすべての公開 API を無効にする必要があります。
戻り値 | |
---|---|
boolean |
isNewer
protected boolean isNewer (File localFile, IFileEntry entry)
ローカル ファイルがリモート ファイルより新しい場合は true
を返します。IFileEntry
は分単位で正確です。複数の時刻が同じ場合、ファイルは新しいファイルとみなされます。
パラメータ | |
---|---|
localFile |
File |
entry |
IFileEntry |
戻り値 | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
再起動終了イベントをすべての IDeviceActionReceiver
に通知します。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notificationRebootStarted
protected void notifyRebootStarted ()
再起動開始イベントをすべての IDeviceActionReceiver
に通知します。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
このデバイスでアクションを実行します。デバイスの復元を試み、アクションが失敗した場合は必要に応じてコマンドを再試行します。
パラメータ | |
---|---|
actionDescription |
String : 実行されるアクションの簡単な説明。ロギング目的でのみ使用されます。 |
action |
NativeDevice.DeviceAction : 実行するアクション |
retryAttempts |
int : 失敗しても復元が成功した場合のアクションの再試行 |
戻り値 | |
---|---|
boolean |
true : アクションが正常に実行された場合 |
例外 | |
---|---|
DeviceNotAvailableException |
復元の試行が失敗した場合、または最大回数の試行を行ったにもかかわらず成功しなかった場合 |
postAdbReboot
protected void postAdbReboot ()
再起動後に実行できる追加のアクション。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
各デバイスタイプ(AndroidNativeDevice、TestDevice)が、起動後の特定の設定のためにこのメソッドをオーバーライドできるようにします。
例外 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
パラメータ | |
---|---|
remoteFilePath |
String |
localFile |
File |
戻り値 | |
---|---|
boolean |
例外 | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
使用する Clock インスタンスを設定します。
パラメータ | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
TestDevice を microdroid としてマークし、その CID を設定します。
パラメータ | |
---|---|
process |
Process : Microdroid VM のプロセス。 |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
パラメータ | |
---|---|
deviceOptions |
|
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
環境変数を指定してシンプルな fastboot コマンドを実行し、コマンドのステータスを報告します。
パラメータ | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
戻り値 | |
---|---|
CommandResult |
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
シンプルな fastboot コマンドを実行し、コマンドのステータスを報告します。
パラメータ | |
---|---|
timeout |
long |
fullCmd |
String |
戻り値 | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
デバイスが使用できなくなるまで待ちます(adb への報告を停止します)。
パラメータ | |
---|---|
operationDesc |
String : 使用不可を待機しているオペレーションの名前。 |
time |
long : 使用不可になるまで待機する時間。 |
戻り値 | |
---|---|
boolean |
デバイスが使用できなくなった場合は true。 |