このページは Cloud Translation API によって翻訳されました。

テストデバイス

public class TestDevice
extends NativeDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

既知の直接サブクラス

ManagedRemoteDevice、NestedRemoteDevice、RemoteAndroidDevice

ManagedRemoteDevice	仮想マシン内で動作し、内部の Tradefed インスタンスを介してリモートで管理するデバイスできます。
NestedRemoteDevice	リモート Cuttlefish VM 内で実行されているデバイスを表しています。
RemoteAndroidDevice	で接続されたフルスタック Android デバイスの `ITestDevice` の実装 adb 接続。

既知の間接的なサブクラス

LocalAndroidVirtualDevice、RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	TradeFed ホストで実行されるローカル仮想デバイスのクラス。
RemoteAndroidVirtualDevice	以下で実行されるフルスタック Android デバイスに対する `RemoteAndroidDevice` の動作を拡張しました。 Google Compute Engine（Gce）。

フルスタック Android デバイスの ITestDevice の実装

概要

ネストされたクラス
`class`	`TestDevice.MicrodroidBuilder` Microdroid TestDevice の作成に使用されるビルダー。

フィールド
`public static final String`	`DISMISS_KEYGUARD_CMD` キーガードを閉じるために使用できるコマンド。

パブリックコンストラクタ
`TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

パブリックメソッド
`boolean`	`canSwitchToHeadlessSystemUser()` ヘッドレス SYSTEM ユーザーへの切り替えが許可されるかどうかを返します。
`boolean`	`clearErrorDialogs()` デバイスの UI に現在表示されているエラーダイアログがあれば、閉じてみる。
`int`	`createUser(String name)` 指定された名前とデフォルトフラグ 0 でユーザーを作成します。
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` 指定の名前とフラグを使用してユーザーを作成する
`int`	`createUser(String name, boolean guest, boolean ephemeral)` 指定の名前とフラグを使用してユーザーを作成する
`int`	`createUserNoThrow(String name)` 指定された名前とデフォルトフラグ 0 でユーザーを作成します。
`void`	`disableKeyguard()` キーガードの無効化を試みます。
`boolean`	`doesFileExist(String deviceFilePath)` デバイス上のファイルが存在するかどうかを判断するためのヘルパーメソッド。
`boolean`	`doesFileExist(String deviceFilePath, int userId)` 特定のユーザーのデバイス上のファイルが存在するかどうかを判断するヘルパーメソッド。
`File`	`dumpHeap(String process, String devicePath)` system_server からのヒープのダンプを試みます。
	`getActiveApexes()` デバイスで有効になっている APEX に関する情報を取得します。
	`getAllSettings(String namespace)` リクエストされた名前空間の Key-Value ペアを返します。
`String`	`getAndroidId(int userId)` userId に関連付けられた android-id を検索して返します。見つからない場合は null を返します。
	`getAndroidIds()` 一致するユーザー ID が見つかった Android ID のマップを作成します。
`PackageInfo`	`getAppPackageInfo(String packageName)` デバイスにインストールされているパッケージに関する情報を取得します。
	`getAppPackageInfos()` デバイスにインストールされているパッケージの情報を取得します。
`InputStreamSource`	`getBugreport()` デバイスからバグレポートを取得します。
`InputStreamSource`	`getBugreportz()` デバイスからバグレポートを取得します。
`DeviceFoldableState`	`getCurrentFoldableState()` デバイスの現在の折りたたみ式状態を返します。なんらかの問題が発生した場合は null を返します。
`int`	`getCurrentUser()` 現在実行中のユーザーの ID を返します。
	`getFoldableStates()` デバイス上の折りたたみ式デバイスの状態のリストを返します。
	`getInstalledPackageNames()` デバイス上にあるアプリのパッケージ名を取得します。
`KeyguardControllerState`	`getKeyguardState()` キーガードの現在の状態を取得するオブジェクトを返します。サポートされていない場合は null を返します。
`Integer`	`getMainUserId()` メインユーザー ID を返します。
	`getMainlineModuleInfo()` デバイスにインストールされている Mainline モジュールに関する情報を取得します。
`int`	`getMaxNumberOfRunningUsersSupported()` 同時に実行できるユーザーの最大数を取得します。
`int`	`getMaxNumberOfUsersSupported()` サポートされているユーザーの最大数を取得します。
`Integer`	`getPrimaryUserId()` プライマリユーザー ID を返します。
`InputStreamSource`	`getScreenshot()` デバイスからスクリーンショットを取得します。
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` デバイスからスクリーンショットを取得します。
`InputStreamSource`	`getScreenshot(String format)` デバイスからスクリーンショットを取得します。
`InputStreamSource`	`getScreenshot(long displayId)` 指定されたディスプレイ ID からスクリーンショットを取得します。
`String`	`getSetting(String namespace, String key)` `getSetting(int, String, String)` を参照し、システムユーザーで実行します。
`String`	`getSetting(int userId, String namespace, String key)` リクエストされた設定の値を返します。
	`getUninstallablePackageNames()` アンインストールできるアプリのパッケージ名を取得します。
`int`	`getUserFlags(int userId)` 指定したユーザーのフラグを検索して返します。
	`getUserInfos()` デバイスの useId の `UserInfo` へのマップを取得します。
`int`	`getUserSerialNumber(int userId)` userId に関連付けられたシリアル番号が見つかった場合は返し、それ以外の場合は -10000 を返します。
`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`	`installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)` デバイスに Android パッケージをインストールします。
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` 特定のユーザーの Android パッケージをデバイスにインストールします。
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` 特定のユーザーの Android パッケージをデバイスにインストールします。
`String`	`installPackages( packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)`
`String`	`installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`boolean`	`isAppEnumerationSupported()` デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する
`boolean`	`isHeadlessSystemUserMode()` デバイスがヘッドレスシステムユーザーモードを使用するかどうかを返します。
`boolean`	`isMainUserPermanentAdmin()` メインユーザーが永続的な管理者であり、削除やダウングレードができないかどうかを返します非管理者ステータスです
`boolean`	`isMultiUserSupported()` マルチユーザーに対応しているかどうかを判別します。
`boolean`	`isPackageInstalled(String packageName)` デバイスに特定のパッケージ名を照会して、現在インストールされているかどうかを確認します。
`boolean`	`isPackageInstalled(String packageName, String userId)` デバイスに特定のパッケージ名とユーザー ID をクエリして、現在パッケージであるかを確認するそのユーザーがインストールしていないか確認できます
`boolean`	`isUserRunning(int userId)` 指定したユーザーが実行中かどうかを確認します。
`boolean`	`isUserSecondary(int userId)` 指定されたユーザーがセカンダリユーザーかどうかをフラグに従って返します。
`boolean`	`isUserVisible(int userId)` 指定したユーザーが表示されているかどうかを確認します。
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` 指定されたディスプレイに特定のユーザーが表示されているかどうかを確認します。
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` でユーザーにバックグラウンドでの表示を許可するかどうかを返します。
`boolean`	`isVisibleBackgroundUsersSupported()` デバイスで、バックグラウンドでの表示をユーザーに許可するかどうかを返します。
	`listDisplayIds()` dumpsys で報告されるとおり、デバイスで使用可能なディスプレイ ID のリストを収集します。 SurfaceFlinger」です。
	`listDisplayIdsForStartingVisibleBackgroundUsers()` `start a user visible in the background` に使用できるディスプレイのリストを取得します。
	`listUsers()` デバイス上のユーザーのリストを取得します。
`boolean`	`logBugreport(String dataName, ITestLogger listener)` バグレポートを取得してレポーターに記録するヘルパーメソッドです。
`void`	`notifySnapuserd(SnapuserdWaitPhase waitPhase)`
`void`	`postInvocationTearDown(Throwable exception)` 呼び出し後に実行される、デバイス固有のクリーンアップに必要な追加の手順完了です。
`boolean`	`removeAdmin(String componentName, int userId)` 指定されたユーザーの特定のデバイス管理を削除し、成功した場合は `true` を返し、成功した場合は `false` を返します。
`void`	`removeOwners()` 既存のデバイスプロファイル所有者をすべて削除します。
`boolean`	`removeUser(int userId)` デバイスから特定のユーザーを削除します。
`boolean`	`setDeviceOwner(String componentName, int userId)` デバイス管理コンポーネントを特定のユーザーのデバイス所有者として設定する
`void`	`setSetting(String namespace, String key, String value)` `setSetting(int, String, String, String)` を参照し、システムユーザーで実行します。
`void`	`setSetting(int userId, String namespace, String key, String value)` 特定のユーザーの名前空間に設定値を追加します。
`void`	`shutdownMicrodroid(ITestDevice microdroidDevice)` マイクロドロイドデバイスが存在する場合は、シャットダウンします。
`boolean`	`startUser(int userId)` 特定のユーザーが現在停止している場合に、バックグラウンドで起動します。
`boolean`	`startUser(int userId, boolean waitFlag)` 特定のユーザーが現在停止している場合に、バックグラウンドで起動します。
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` 特定のディスプレイに可視状態で、バックグラウンドで特定のユーザーを開始します（つまり、そのディスプレイでアクティビティを起動するなど）。
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` 特定のユーザーを停止します。
`boolean`	`stopUser(int userId)` 指定したユーザーを停止します。
`boolean`	`supportsMicrodroid()` microdroid を実行するための前提条件を確認します。
`boolean`	`supportsMicrodroid(boolean protectedVm)` microdroid を実行するための前提条件を確認します。
`boolean`	`switchUser(int userId)` デフォルトのタイムアウトを使用して別の userId に切り替える。
`boolean`	`switchUser(int userId, long timeout)` 期限として指定されたタイムアウトを持つ別の userId に切り替えます。
`Bugreport`	`takeBugreport()` バグレポートを取得し、`Bugreport` オブジェクト内で返します。
`String`	`uninstallPackage(String packageName)` デバイスから Android パッケージをアンインストールします。
`String`	`uninstallPackageForUser(String packageName, int userId)` 特定のユーザーの Android パッケージをデバイスからアンインストールします。
`void`	`waitForSnapuserd(SnapuserdWaitPhase currentPhase)`

保護されたメソッド
`AaptParser`	`createParser(File appFile)`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` adb の再起動を行います。
`InputStreamSource`	`getBugreportInternal()`
`File`	`getBugreportzInternal()` bugreportz zip ファイルを `ERROR(/File)` として取得するための内部ヘルパーメソッド。
`long`	`getCheckNewUserSleep()` テスト用に公開されています。
`long`	`getHostCurrentTime()` テスト用に公開済み
`void`	`prePostBootSetup()` 各デバイスタイプ（AndroidNativeDevice、TestDevice）にこのメソッドをオーバーライドすることを許可します: 設定をカスタマイズしたりできます

フィールド

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

キーガードを閉じるために使用できるコマンド。

パブリックコンストラクタ

テストデバイス

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

パブリックメソッド

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

ヘッドレス SYSTEM ユーザーへの切り替えが許可されるかどうかを返します。

戻り値
`boolean`

例外
`DeviceNotAvailableException`

ClearErrorDialogs

public boolean clearErrorDialogs ()

デバイスの UI に現在表示されているエラーダイアログがあれば、閉じてみる。

戻り値
`boolean`	ダイアログが存在しないか、ダイアログが正常に消去された場合は `true`。そうでない場合は `false`。

例外
`DeviceNotAvailableException`

createUser

public int createUser (String name)

指定された名前とデフォルトフラグ 0 でユーザーを作成します。

パラメータ
`name`	`String`: デバイスに作成するユーザーの

戻り値
`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, 
                boolean guest, 
                boolean ephemeral)

指定の名前とフラグを使用してユーザーを作成する

パラメータ
`name`	`String`: デバイスに作成するユーザーの
`guest`	`boolean`: 作成時にユーザーフラグ --guest を有効にする
`ephemeral`	`boolean`: 作成時にユーザーフラグ --ephemeral を有効にする

戻り値
`int`	作成されたユーザーの ID

例外
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

指定された名前とデフォルトフラグ 0 でユーザーを作成します。

パラメータ
`name`	`String`: デバイスに作成するユーザーの

戻り値
`int`	作成されたユーザー ID の整数、またはエラーの場合は -1。

例外
`DeviceNotAvailableException`

Keyguard を無効にする

public void disableKeyguard ()

キーガードの無効化を試みます。

まず、入力ディスパッチの準備が整うまで待ちます。これは、デバイスが BOOT_COMPLETE をレポートする。現在のフレームワークが競合状態が発生することがあります。その後、キーガードを閉じるためのコマンドが送信されます（保護されていないものに対してのみ使用）

例外
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

例外
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

パラメータ
`deviceFilePath`	`String`: 確認するデバイス上のファイルの絶対パス
`userId`	`int`: ファイルの存在を確認するユーザー ID

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

例外
`DeviceNotAvailableException`

ダンプヒープ

public File dumpHeap (String process, 
                String devicePath)

system_server からのヒープのダンプを試みます。クリーンアップは呼び出し元が行います。表示されます。

パラメータ
`process`	`String`: ダンプヒープのデバイスプロセスの名前。
`devicePath`	`String`: ダンプを配置するデバイス上のパス。ここは、許可します。

戻り値
`File`	レポートを含む `ERROR(/File)`。失敗した場合は null。

例外
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

デバイスで有効になっている APEX に関する情報を取得します。

戻り値
	`ApexInfo` 個中 `ERROR(/Set)` 個がデバイスで現在有効です

例外
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

リクエストされた名前空間の Key-Value ペアを返します。

パラメータ
`namespace`	`String`: {"system"、"secure"、"global"} のいずれかにする必要があります

戻り値
	Key-Value ペアのマップです名前空間がサポートされていない場合は null。

例外
`DeviceNotAvailableException`

getAndroidId

public String getAndroidId (int userId)

userId に関連付けられた android-id を検索して返します。見つからない場合は null を返します。

パラメータ
`userId`	`int`

戻り値
`String`

例外
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

一致するユーザー ID が見つかった Android ID のマップを作成します。ユーザー 1 人あたり 1 人あたりの id がこの関数に関連付けられている Android ID を見つけるため、一部のユーザー ID が null と一致する可能性があります。

戻り値
	一致するユーザー ID が見つかった Android ID のマップ。

例外
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

デバイスにインストールされているパッケージに関する情報を取得します。

パラメータ
`packageName`	`String`

戻り値
`PackageInfo`	情報を取得できなかった場合は `PackageInfo` または `null`

例外
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

デバイスにインストールされているパッケージの情報を取得します。

戻り値
	`PackageInfo` の `ERROR(/List)` がこのデバイスにインストールされています。

例外
`DeviceNotAvailableException`

バグレポートを取得

public InputStreamSource getBugreport ()

デバイスからバグレポートを取得します。

この実装は、SD カードのないデバイスで引き続き動作することが保証されます。（または SD カードがまだマウントされていない場合）。

戻り値
`InputStreamSource`	オンデマンドでバグレポートコンテンツを生成する `InputStreamSource`。イン失敗した場合、`InputStreamSource` は空の `ERROR(/InputStream)` を生成します。

バグレポートの取得

public InputStreamSource getBugreportz ()

デバイスからバグレポートを取得します。ZIP 形式のバグレポートには、メインのバグレポートが含まれています。その他のログファイルも参照できます。

「adb version」でのみサポートされています>1.0.36

戻り値
`InputStreamSource`	bugreportz を含む zip ファイルの `InputStreamSource`。null を返します。作成されます。

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

デバイスの現在の折りたたみ式状態を返します。なんらかの問題が発生した場合は null を返します。

戻り値
`DeviceFoldableState`

例外
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

現在実行中のユーザーの ID を返します。エラーの場合は、-10000 を返します。

戻り値
`int`

例外
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

デバイス上の折りたたみ式デバイスの状態のリストを返します。cmd device_state で取得できます。 print-states" です。

戻り値

例外
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

デバイス上にあるアプリのパッケージ名を取得します。

戻り値
	現在デバイスにインストールされている `String` 個のパッケージ名のうち `ERROR(/Set)` 個。

例外
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

キーガードの現在の状態を取得するオブジェクトを返します。サポートされていない場合は null を返します。

戻り値
`KeyguardControllerState`	キーガードの状態のスナップショットを含む `KeyguardControllerState` キーガードクエリがサポートされていない場合は Null を返します。

例外
`DeviceNotAvailableException`

getMainUserId

public Integer getMainUserId ()

メインユーザー ID を返します。

戻り値
`Integer`	メインユーザーの userId（メインユーザーが存在する場合）と null（メインユーザーが存在しない場合）です。

例外
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

デバイスにインストールされている Mainline モジュールに関する情報を取得します。

戻り値
	`String` 個中 `ERROR(/Set)` 個のメインラインモジュールがデバイスに現在インストールされています。

例外
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

同時に実行できるユーザーの最大数を取得します。デフォルトは 0 です。

戻り値
`int`	同時に実行しているユーザー数を示す整数

例外
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

サポートされているユーザーの最大数を取得します。デフォルトは 0 です。

戻り値
`int`	サポートされるユーザー数を示す整数

例外
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

プライマリユーザー ID を返します。

戻り値
`Integer`	プライマリユーザーが存在する場合は、その userId、プライマリユーザーが存在しない場合は null。

例外
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

デバイスからスクリーンショットを取得します。

戻り値
`InputStreamSource`	PNG 形式のスクリーンショットの `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 (String format)

デバイスからスクリーンショットを取得します。サイズを小さくするには、JPEG エンコードとともに getScreenshot(format) を使用することをおすすめします

パラメータ
`format`	`String`: サポートされている PNG、JPEG

戻り値
`InputStreamSource`	形式のスクリーンショットの `InputStreamSource`。または、`null` 失敗しました。

例外
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

指定されたディスプレイ ID からスクリーンショットを取得します。形式は PNG です。

TODO: 上記の実装を拡張して「format」をサポートする「rescale」と

パラメータ
`displayId`	`long`: スクリーンショットを取得する画面のディスプレイ ID。

戻り値
`InputStreamSource`	`InputStreamSource` 形式のスクリーンショットの`null` スクリーンショットに失敗しました。

例外
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

getSetting(int, String, String) を参照し、システムユーザーで実行します。

パラメータ
`namespace`	`String`
`key`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

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`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

アンインストールできるアプリのパッケージ名を取得します。これは現在、システム以外のパッケージ、更新されたシステムパッケージなど）が含まれます。

戻り値
	現在: `ERROR(/Set)` 個のアンインストールできない `String` パッケージ名がダウンロードします

例外
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

指定したユーザーのフラグを検索して返します。フラグは「android.content.pm.UserInfo」で定義します。クラスです。

パラメータ
`userId`	`int`

戻り値
`int`	指定された userId に関連するフラグ（見つかった場合）。それ以外の場合は -10000。

例外
`DeviceNotAvailableException`

getUserInfo

public  getUserInfos ()

デバイスの useId の UserInfo へのマップを取得します。デバイスからの出力が想定どおりでない場合は DeviceRuntimeException をスローします。

戻り値
	UserInfo オブジェクトのリスト。

例外
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

userId に関連付けられたシリアル番号が見つかった場合は返し、それ以外の場合は -10000 を返します。

パラメータ
`userId`	`int`

戻り値
`int`

例外
`DeviceNotAvailableException`

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`

installPackage

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                String... extraArgs)

デバイスに Android パッケージをインストールします。

注: 実行時に権限の付与を明示的に制御する必要があるユースケースのみを呼び出す必要があります

パラメータ
`packageFile`	`File`: インストールする apk ファイル
`certFile`	`File`: 再インストールを実行する必要がある場合は `true`
`reinstall`	`boolean`: インストール時にすべての実行時の権限を付与する必要がある場合
`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`

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`

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

パラメータ
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

パラメータ
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

パラメータ
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

パラメータ
`packageFiles`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

パラメータ
`remoteApkPaths`
`reinstall`	`boolean`
`extraArgs`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

パラメータ
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

戻り値
`String`

例外
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

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

デバイスに特定のパッケージ名を照会して、現在インストールされているかどうかを確認します。

パラメータ
`packageName`	`String`

戻り値
`boolean`	パッケージがインストール済みとして報告された場合は true。それ以外の場合は False です。

例外
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

デバイスに特定のパッケージ名とユーザー ID をクエリして、現在パッケージであるかを確認するそのユーザーがインストールしていないか確認できます

パラメータ
`packageName`	`String`: インストールされているかどうかを確認するパッケージ。
`userId`	`String`: パッケージのインストール対象かどうかを確認するユーザー ID。null の場合、プライマリユーザー使用されます。

戻り値
`boolean`	パッケージがインストール済みとして報告された場合は true。それ以外の場合は False です。

例外
`DeviceNotAvailableException`

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) でユーザーにバックグラウンドでの表示を許可するかどうかを返します。

その場合は、startVisibleBackgroundUser(int, int, boolean) を呼び出して、 listDisplayIdsForStartingVisibleBackgroundUsers() から返されるディスプレイ（ ERROR(/java.android.view.Display#DEFAULT_DISPLAY) を含める必要があります）。

戻り値
`boolean`

例外
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

デバイスで、バックグラウンドでの表示をユーザーに許可するかどうかを返します。

その場合は、startVisibleBackgroundUser(int, int, boolean) を呼び出して、 listDisplayIdsForStartingVisibleBackgroundUsers() が返すディスプレイ。

戻り値
`boolean`

例外
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

dumpsys で報告されるとおり、デバイスで使用可能なディスプレイ ID のリストを収集します。 SurfaceFlinger」です。

戻り値
	ディスプレイのリスト。デフォルトでは、常にデフォルトのディスプレイ 0 が返されます。

例外
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

start a user visible in the background に使用できるディスプレイのリストを取得します。

戻り値

例外
`DeviceNotAvailableException`

listUsers

public  listUsers ()

デバイス上のユーザーのリストを取得します。出力の場合は DeviceRuntimeException がスローされます予期したとおりに処理されません。

戻り値
	ユーザー ID のリストです。

例外
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

バグレポートを取得してレポーターに記録するヘルパーメソッドです。

パラメータ
`dataName`	`String`: バグレポートを報告する名前。
`listener`	`ITestLogger`: バグレポートをログに記録する `ITestLogger`。

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

パラメータ
`waitPhase`	`SnapuserdWaitPhase`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

パラメータ
`exception`	`Throwable`: 呼び出しの失敗によって発生した最後の例外（存在する場合）。

deleteAdmin

public boolean removeAdmin (String componentName, 
                int userId)

指定されたユーザーの特定のデバイス管理を削除し、成功した場合は true を返し、成功した場合は false を返します。

パラメータ
`componentName`	削除するデバイス管理の `String`。
`userId`	`int`: デバイス管理が存在するユーザーの

戻り値
`boolean`	成功した場合は true、それ以外の場合は false。

例外
`DeviceNotAvailableException`

オーナーを削除

public void removeOwners ()

既存のデバイスプロファイル所有者をすべて削除します。

例外
`DeviceNotAvailableException`

ユーザーを削除

public boolean removeUser (int userId)

デバイスから特定のユーザーを削除します。

パラメータ
`userId`	`int`: 削除するユーザーの

戻り値
`boolean`	ユーザーの削除に成功した場合は true、それ以外の場合は false。

例外
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

デバイス管理コンポーネントを特定のユーザーのデバイス所有者として設定する

パラメータ
`componentName`	`String`: デバイス所有者となるデバイス管理者。
`userId`	`int`: デバイス所有者が存在するユーザーの

戻り値
`boolean`	成功した場合は true、それ以外の場合は false。

例外
`DeviceNotAvailableException`

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 は、{"system"、"secure"、"global"} のいずれかである必要があります

パラメータ
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

例外
`DeviceNotAvailableException`

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

マイクロドロイドデバイスが存在する場合は、シャットダウンします。

パラメータ
`microdroidDevice`	`ITestDevice`

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

開始ユーザー

public boolean startUser (int userId)

特定のユーザーが現在停止している場合に、バックグラウンドで起動します。ユーザーがすでにこのメソッドは NOOP です。

パラメータ
`userId`	`int`: バックグラウンドで開始するユーザーの

戻り値
`boolean`	ユーザーがバックグラウンドで正常に起動した場合は true を返します。

例外
`DeviceNotAvailableException`

開始ユーザー

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`

停止ユーザー

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

特定のユーザーを停止します。オペレーションが有効になるまで待機する追加のフラグを指定できます。ユーザーを強制終了します現在のユーザーとシステムユーザーを停止できません。

パラメータ
`userId`	`int`: 停止するユーザーの。
`waitFlag`	`boolean`: ユーザーが停止するまでコマンドを待機させます。
`forceFlag`	`boolean`: ユーザーを強制停止します。

戻り値
`boolean`	ユーザーが正常に停止された場合は true を返します。

例外
`DeviceNotAvailableException`

停止ユーザー

public boolean stopUser (int userId)

指定したユーザーを停止します。ユーザーがすでに停止している場合、この方法は NOOP です。現在のユーザーとシステムユーザーを停止できません。

パラメータ
`userId`	`int`: 停止するユーザーの。

戻り値
`boolean`	ユーザーが正常に停止された場合は true を返します。

例外
`DeviceNotAvailableException`

サポート Microdroid

public boolean supportsMicrodroid ()

microdroid を実行するための前提条件を確認します。

戻り値
`boolean`	前提条件が満たされていれば true を、そうでない場合は false を返します。

サポート Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

microdroid を実行するための前提条件を確認します。

パラメータ
`protectedVm`	`boolean`: microdroid が保護された VM で実行する場合、true。

戻り値
`boolean`	前提条件が満たされていれば true を、そうでない場合は false を返します。

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`

バグレポートを取得

public Bugreport takeBugreport ()

バグレポートを取得し、Bugreport オブジェクト内で返します。null を返す確認できます。バグレポートオブジェクトで参照されているファイルは、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`

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

パラメータ
`currentPhase`	`SnapuserdWaitPhase`

例外
`DeviceNotAvailableException`

保護されたメソッド

createParser

protected AaptParser createParser (File appFile)

パラメータ
`appFile`	`File`

戻り値
`AaptParser`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

adb の再起動を行います。

パラメータ
`rebootMode`	`NativeDevice.RebootMode`: この再起動のモード。
`reason`	`String`: この再起動用。

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

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

戻り値
`InputStreamSource`

getBugreportzInternal

protected File getBugreportzInternal ()

bugreportz zip ファイルを ERROR(/File) として取得するための内部ヘルパーメソッド。

戻り値
`File`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

テスト用に公開されています。

戻り値
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

テスト用に公開済み

戻り値
`long`

prePostBootSetup セットアップ

protected void prePostBootSetup ()

各デバイスタイプ（AndroidNativeDevice、TestDevice）にこのメソッドをオーバーライドすることを許可します: 設定をカスタマイズしたりできます

例外
`DeviceNotAvailableException`

テストデバイス

概要

ネストされたクラス

フィールド

パブリック コンストラクタ

パブリック メソッド

保護されたメソッド

フィールド

DISMISS_KEYGUARD_CMD

パブリック コンストラクタ

テストデバイス

パブリック メソッド

canSwitchToHeadlessSystemUser

ClearErrorDialogs

createUser

createUser

createUser

createUserNoThrow

Keyguard を無効にする

doesFileExist

doesFileExist

ダンプヒープ

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

バグレポートを取得

バグレポートの取得

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getPrimaryUserId

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfo

getUserSerialNumber

hasFeature

installPackage

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackages

installPackages

installPackagesForUser

installPackagesForUser

installRemotePackages

installRemotePackages

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers

listUsers

logBugreport

notifySnapuserd

postInvocationTearDown

パブリックコンストラクタ

パブリックメソッド

パブリックコンストラクタ

パブリックメソッド