テストデバイス

public class TestDevice
extends NativeDevice

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

既知の直接サブクラス ManagedRemoteDevice 、 NestedRemoteDevice 、 RemoteAndroidDevice ManagedRemoteDevice VM 内の Tradefed インスタンスを介してリモートで管理する、仮想マシン内で実行されるデバイス。 NestedRemoteDevice リモートの Cuttlefish VM 内で実行されているデバイスの表現。 リモート Android デバイス adb connect 経由で接続されたフルスタック android デバイス用のITestDeviceの実装。

既知の間接サブクラス LocalAndroidVirtualDevice 、 RemoteAndroidVirtualDevice LocalAndroidVirtualDevice TradeFed ホストで実行されているローカル仮想デバイスのクラス。 RemoteAndroidVirtualDevice Google Compute Engine (Gce) で実行されているフルスタック Android デバイスのRemoteAndroidDevice動作を拡張します。

---

フルスタック 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) 要求された名前空間のキーと値のペアを返します。
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 () デバイスにインストールされているメインライン モジュールに関する情報を取得します。
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) installPackages ( packageFiles, boolean reinstall, String... extraArgs)
String	installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
String	installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)
String	installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)
String	installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) 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 SurfaceFlinger」によって報告された、デバイスで使用可能なディスプレイ ID のリストを収集します。
	listDisplayIdsForStartingVisibleBackgroundUsers () start a user visible in the backgroundために使用できるディスプレイのリストを取得します。
	listUsers () デバイス上のユーザーのリストを取得します。
boolean	logBugreport (String dataName, ITestLogger listener) バグレポートを取得してレポーターに記録するためのヘルパー メソッド。
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 () マイクロドロイドを実行するための前提条件を確認します。
boolean	supportsMicrodroid (boolean protectedVm) マイクロドロイドを実行するための前提条件を確認します。
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 パッケージをアンインストールします。

保護されたメソッド
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

ユーザーを作成

public int createUser (String name)

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

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

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

スロー
DeviceNotAvailableException

ユーザーを作成

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

ユーザーを作成

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

キーガードを無効にする

public void disableKeyguard ()

キーガードを無効にしようとします。

最初に、入力ディスパッチの準備が整うのを待ちます。これは、デバイスが BOOT_COMPLETE を報告するのとほぼ同時に発生します。これは、現在のフレームワークの実装では競合状態が発生することがあるため、明らかに非同期です。次に、キーガードを解除するコマンドが送信されます (安全でないものでのみ機能します)。

スロー
DeviceNotAvailableException

dosFileExist

public boolean doesFileExist (String deviceFilePath)

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

パラメーター
deviceFilePath	String : チェックするデバイス上のファイルの絶対パス

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

スロー
DeviceNotAvailableException

dosFileExist

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

getActiveApex

public  getActiveApexes ()

デバイスでアクティブ化された APEX に関する情報を取得します。

戻り値
	デバイスで現在アクティブ化されているApexInfoのERROR(/Set)

スロー
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

要求された名前空間のキーと値のペアを返します。

パラメーター
namespace	String : {"system"、"secure"、"global"} のいずれかでなければなりません

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

スロー
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

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

パラメーター
userId	int

戻り値
String

スロー
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

一致するユーザー ID が見つかった Android ID のマップを作成します。各ユーザー 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

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

デバイスからバグレポートを取得します。 zip 形式のバグレポートには、メインのバグレポートと、デバッグに役立つその他のログ ファイルが含まれています。

「adb バージョン」 > 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 ()

デバイスに存在するアプリケーション パッケージ名を取得します。

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

スロー
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

スロー
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

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

戻り値
Integer	メイン ユーザーが存在する場合はメイン ユーザーの userId、メイン ユーザーが存在しない場合は null。

スロー
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

戻り値
	デバイスに現在インストールされているERROR(/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)

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

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

要求された設定の値を返します。名前空間は次のいずれかでなければなりません: {"system"、"secure"、"global"}

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

戻り値
String	ユーザーの namespace:key に関連付けられた値。見つからない場合は null。

スロー
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

アンインストールできるアプリケーション パッケージ名を取得します。これは現在、非システム パッケージおよび更新されたシステム パッケージとして定義されています。

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

スロー
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

特定のユーザーのフラグを見つけて返します。フラグは、Android オープン ソース プロジェクトの「android.content.pm.UserInfo」クラスで定義されています。

パラメーター
userId	int

戻り値
int	見つかった場合は提供された userId に関連付けられたフラグ、それ以外の場合は -10000。

スロー
DeviceNotAvailableException

getUserInfos

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

インストールパッケージ

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

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

パラメーター
packageFile	File : インストールする apk ファイル
reinstall	boolean : 再インストールを実行する必要がある場合はtrue
extraArgs	String : 渡すオプションの追加引数。利用可能なオプションについては、「adb shell pm -h」を参照してください。

戻り値
String	エラー コードを含むERROR(/String) 、または成功した場合はnull 。

スロー
DeviceNotAvailableException

インストールパッケージ

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	エラー コードを含むERROR(/String) 、または成功した場合はnull 。

スロー
DeviceNotAvailableException

インストールパッケージ

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	エラー コードを含むERROR(/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	エラー コードを含むERROR(/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	エラー コードを含むERROR(/String) 、または成功した場合はnull 。

スロー
DeviceNotAvailableException

インストールパッケージ

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

パラメーター
packageFiles
reinstall	boolean
extraArgs	String

戻り値
String

スロー
DeviceNotAvailableException

インストールパッケージ

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。それ以外の場合は偽。

スロー
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

特定のパッケージ名と特定のユーザー ID についてデバイスにクエリを実行し、そのユーザーに対して現在インストールされているかどうかを確認します。

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

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

スロー
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 SurfaceFlinger」によって報告された、デバイスで使用可能なディスプレイ ID のリストを収集します。

戻り値
	ディスプレイのリスト。 Default は常にデフォルトの表示 0 を返します。

スロー
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

戻り値

スロー
DeviceNotAvailableException

リストユーザー

public  listUsers ()

デバイス上のユーザーのリストを取得します。デバイスからの出力が期待どおりでない場合、 DeviceRuntimeExceptionをスローします。

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

スロー
DeviceNotAvailableException

ログバグレポート

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

パラメーター
dataName	String : バグレポートが報告される名前。
listener	ITestLogger : バグレポートをログに記録するためのITestLogger 。

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

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

パラメーター
exception	Throwable : 呼び出しの失敗によって発生した最終的な例外 (存在する場合)。

削除管理者

public boolean removeAdmin (String componentName, 
                int userId)

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

パラメーター
componentName	String : 削除するデバイス管理者。
userId	int : デバイス管理者が住んでいるユーザーの。

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

スロー
DeviceNotAvailableException

removeOwners

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)

特定のユーザーの名前空間に設定値を追加します。一部の設定は、再起動後にのみ使用できます。名前空間は次のいずれかでなければなりません: {"system"、"secure"、"global"}

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

スロー
DeviceNotAvailableException

shutdownマイクロドロイド

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

マイクロドロイドをサポート

public boolean supportsMicrodroid ()

マイクロドロイドを実行するための前提条件を確認します。

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

マイクロドロイドをサポート

public boolean supportsMicrodroid (boolean protectedVm)

マイクロドロイドを実行するための前提条件を確認します。

パラメーター
protectedVm	boolean : microdroid が保護された VM で実行されることを意図している場合は true。

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

スイッチユーザー

public boolean switchUser (int userId)

デフォルトのタイムアウトで別の userId に切り替えます。 switchUser(int, long) .

パラメーター
userId	int

戻り値
boolean	新しい userId が userId プロバイダーと一致する場合は true。それ以外の場合は偽。

スロー
DeviceNotAvailableException

スイッチユーザー

public boolean switchUser (int userId, 
                long timeout)

指定されたタイムアウトを期限として別の userId に切り替えます。ユーザーの変更が成功した後、キーガードの無効化を試みます。

パラメーター
userId	int
timeout	long : switch-user が失敗した場合に false を返す前に待機します。

戻り値
boolean	新しい userId が userId プロバイダーと一致する場合は true。それ以外の場合は偽。

スロー
DeviceNotAvailableException

バグレポートを取る

public Bugreport takeBugreport ()

バグレポートを取得し、それを処理するためにBugreportオブジェクト内に返します。問題が発生した場合は null を返します。 Bugreport オブジェクトで参照されているファイルは、 Bugreport.close()で消去する必要があります。

戻り値
Bugreport

アンインストールパッケージ

public String uninstallPackage (String packageName)

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

パラメーター
packageName	String : アンインストールする Android パッケージ

戻り値
String	エラー コードを含むERROR(/String) 、または成功した場合はnull 。

スロー
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

特定のユーザーのデバイスから Android パッケージをアンインストールします。

パラメーター
packageName	String : アンインストールする Android パッケージ
userId	int : アンインストールする整数のユーザー ID。

戻り値
String	エラー コードを含むERROR(/String) 、または成功した場合はnull 。

スロー
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