ITテストデバイス

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

既知の間接サブクラス IManatedTestDevice 、 LocalAndroidVirtualDevice 、 ManagedRemoteDevice 、 NativeDevice 、 NestedRemoteDevice 、 RemoteAndroidDevice 、 RemoteAndroidVirtualDevice 、 TestDevice IManatedTestDevice ライフサイクルが管理される ITestDevice。 ローカルAndroid仮想デバイス TradeFed ホスト上で実行されるローカル仮想デバイスのクラス。 管理対象リモートデバイス 仮想マシン内で実行されるデバイス。VM 内の Tradefed インスタンスを介してリモートで管理されます。 ネイティブデバイス ITestDevice非フルスタック Android デバイスのデフォルト実装。 ネストされたリモートデバイス リモートの Cuttlefish VM 内で実行されているデバイスの表現。 リモートAndroidデバイス adb connect 経由で接続されたフルスタック Android デバイス用のITestDeviceの実装。 リモートAndroid仮想デバイス Google Compute Engine (Gce) で実行されるフルスタック Android デバイスのRemoteAndroidDevice動作を拡張します。 テストデバイス フルスタック Android デバイス用のITestDeviceの実装

---

信頼性が高く、少し高いレベルの API を ddmlib IDeviceに提供します。

設定可能な量だけデバイス コマンドを再試行し、応答しないデバイスにデバイス回復インターフェイスを提供します。

まとめ

入れ子になったクラス
class	ITestDevice.ApexInfo 単一の APEX に関する情報を保存する単純な構造体クラス
class	ITestDevice.MountPointInfo 単一のマウントポイントに関する情報を保存する単純な構造体クラス

パブリックメソッド
abstract boolean	canSwitchToHeadlessSystemUser () ヘッドレス SYSTEM ユーザーへの切り替えが許可されているかどうかを返します。
abstract boolean	checkConnectivity () デバイスがネットワークに接続されていることを確認します。
abstract boolean	clearErrorDialogs () デバイス UI に現在表示されているエラー ダイアログを閉じてみます。
abstract void	clearLastConnectedWifiNetwork () 最後に接続した Wi-Fi ネットワークをクリアします。
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Wi-Fi ネットワークに接続します。
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Wi-Fi ネットワークに接続します。
abstract boolean	connectToWifiNetwork (String wifiSsid, String wifiPsk) Wi-Fi ネットワークに接続します。
abstract boolean	connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Wi-Fi ネットワークに接続します。
abstract boolean	connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) デバイスが現在ネットワークに接続していない場合にのみ接続するconnectToWifiNetwork(String, String)のバリアント。
abstract boolean	connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) デバイスが現在ネットワークに接続していない場合にのみ接続するconnectToWifiNetwork(String, String)のバリアント。
abstract int	createUser (String name) 指定された名前とデフォルトのフラグ 0 を使用してユーザーを作成します。
abstract int	createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) 指定された名前と指定されたフラグを使用してユーザーを作成します
abstract int	createUser (String name, boolean guest, boolean ephemeral) 指定された名前と指定されたフラグを使用してユーザーを作成します
abstract int	createUserNoThrow (String name) 指定された名前とデフォルトのフラグ 0 を使用してユーザーを作成します。
abstract void	deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) 登録されたIDeviceActionReceiverを削除します。
abstract void	disableKeyguard () キーガードを無効にしようとします。
abstract boolean	disableNetworkMonitor () デバイス上のネットワーク監視を無効にします。
abstract boolean	disconnectFromWifi () Wi-Fi ネットワークから切断します。
abstract boolean	doesFileExist (String deviceFilePath, int userId) デバイス上に特定のユーザーのファイルが存在するかどうかを判断するヘルパー メソッド。
abstract File	dumpHeap (String process, String devicePath) system_server からヒープをダンプしてみます。
abstract boolean	enableNetworkMonitor () デバイス上のネットワーク監視を有効にします。
abstract	getActiveApexes () デバイス上でアクティブ化された APEX に関する情報を取得します。
abstract	getAllSettings (String namespace) 要求された名前空間のキーと値のペアを返します。
abstract String	getAndroidId (int userId) userId に関連付けられた android-id を検索して返します。見つからない場合は null を返します。
abstract	getAndroidIds () ユーザー ID に一致する Android ID のマップを作成します。
abstract PackageInfo	getAppPackageInfo (String packageName) デバイスにインストールされているパッケージに関する情報を取得します。
abstract	getAppPackageInfos () デバイスにインストールされているパッケージの情報を取得します。
abstract InputStreamSource	getBugreport () デバイスからバグレポートを取得します。
abstract InputStreamSource	getBugreportz () デバイスからバグレポートを取得します。
abstract DeviceFoldableState	getCurrentFoldableState () デバイスの現在の折りたたみ可能な状態を返すか、何らかの問題が発生した場合は null を返します。
abstract int	getCurrentUser () 現在実行中のユーザーの ID を返します。
abstract	getFoldableStates () デバイス上の折りたたみ可能な状態のリストを返します。
abstract	getInstalledPackageNames () デバイス上に存在するアプリケーション パッケージ名を取得します。
abstract String	getIpAddress () デバイスのIPアドレスを取得します。
abstract KeyguardControllerState	getKeyguardState () キーガードの現在の状態を取得するオブジェクトを返すか、サポートされていない場合は null を返します。
abstract Integer	getMainUserId () メインのユーザー ID を返します。
abstract	getMainlineModuleInfo () デバイスにインストールされているメインライン モジュールに関する情報を取得します。
abstract int	getMaxNumberOfRunningUsersSupported () サポートされている同時実行ユーザーの最大数を取得します。
abstract int	getMaxNumberOfUsersSupported () サポートされているユーザーの最大数を取得します。
abstract TestDeviceOptions	getOptions () デバイスのテスト オプションを取得します。
abstract Integer	getPrimaryUserId () プライマリ ユーザー ID を返します。
abstract InputStreamSource	getScreenshot () デバイスからスクリーンショットを取得します。
abstract InputStreamSource	getScreenshot (String format, boolean rescale) デバイスからスクリーンショットを取得します。
abstract InputStreamSource	getScreenshot (String format) デバイスからスクリーンショットを取得します。
abstract InputStreamSource	getScreenshot (long displayId) 指定されたディスプレイ ID でデバイスからスクリーンショットを取得します。
abstract String	getSetting (String namespace, String key) getSetting(int, String, String)参照し、システム ユーザーに対して実行されます。
abstract String	getSetting (int userId, String namespace, String key) 要求された設定の値を返します。
abstract	getUninstallablePackageNames () アンインストールできるアプリケーションのパッケージ名を取得します。
abstract int	getUserFlags (int userId) 指定されたユーザーのフラグを検索して返します。
abstract	getUserInfos () デバイス上の useId からUserInfoへのマップを取得します。
abstract int	getUserSerialNumber (int userId) userId が見つかった場合はそのシリアル番号を返し、それ以外の場合は -10000 を返します。
abstract boolean	hasFeature (String feature) デバイスで機能が利用できるかどうかを確認します。
abstract String	installPackage (File packageFile, boolean reinstall, String... extraArgs) Android パッケージをデバイスにインストールします。
abstract String	installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Android パッケージをデバイスにインストールします。
abstract String	installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) 特定のユーザーのデバイスに Android パッケージをインストールします。
abstract String	installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) 特定のユーザーのデバイスに Android パッケージをインストールします。
default String	installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) 複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。
default String	installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Android デバイス上にある複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。
default String	installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) 特定のユーザーに対して、複数の APK ファイル (1 つのメインおよび追加の分割パッケージ) で構成される Android アプリケーションをインストールします。
default String	installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) 特定のユーザーに対して、複数の APK ファイル (1 つのメインおよび追加の分割パッケージ) で構成される Android アプリケーションをインストールします。
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Android デバイス上にある複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Android デバイス上にある複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。
abstract boolean	isHeadlessSystemUserMode () デバイスがヘッドレス システム ユーザー モードを使用するかどうかを返します。
abstract boolean	isMainUserPermanentAdmin () メイン ユーザーが永続管理者であり、削除できないか、非管理者ステータスにダウングレードできないかどうかを返します。
abstract boolean	isMultiUserSupported () マルチユーザーがサポートされているかどうかを決定します。
abstract boolean	isPackageInstalled (String packageName) 特定のパッケージ名をデバイスに問い合わせて、そのパッケージが現在インストールされているかどうかを確認します。
abstract boolean	isPackageInstalled (String packageName, String userId) 指定されたパッケージ名と指定されたユーザー ID をデバイスに照会して、そのユーザーに現在インストールされているかどうかを確認します。
abstract boolean	isUserRunning (int userId) 指定されたユーザーが実行されているかどうかを確認します。
abstract boolean	isUserSecondary (int userId) フラグに従って、指定されたユーザーがセカンダリ ユーザーであるかどうかを返します。
abstract boolean	isUserVisible (int userId) 指定されたユーザーが表示されているかどうかを確認します。
abstract boolean	isUserVisibleOnDisplay (int userId, int displayId) 指定されたユーザーが指定されたディスプレイに表示されるかどうかを確認します。
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported () ERROR(/java.android.view.Display#DEFAULT_DISPLAY)で、デバイスがユーザーをバックグラウンドで表示して起動できるかどうかを返します。
abstract boolean	isVisibleBackgroundUsersSupported () デバイスがユーザーをバックグラウンドで表示して起動できるかどうかを返します。
abstract boolean	isWifiEnabled () Wi-Fi が有効かどうかをテストします。
abstract	listDisplayIds () 「dumpsys SurfaceFlinger」によって報告された、デバイス上で使用可能なディスプレイ ID のリストを収集します。
abstract	listDisplayIdsForStartingVisibleBackgroundUsers () start a user visible in the backgroundために使用できるディスプレイのリストを取得します。
abstract	listUsers () デバイス上のユーザーのリストを取得します。
abstract boolean	logBugreport (String dataName, ITestLogger listener) バグレポートを取得して報告者に記録するためのヘルパー メソッド。
abstract void	registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) このデバイスのIDeviceActionReceiverを登録します。
abstract boolean	removeAdmin (String componentName, int userId) 指定されたユーザーの指定されたデバイス管理者を削除し、成功した場合はtrueを返し、そうでない場合はfalse返します。
abstract void	removeOwners () ベスト エフォートで既存のデバイス プロファイル所有者をすべて削除します。
abstract boolean	removeUser (int userId) 特定のユーザーをデバイスから削除します。
abstract boolean	setDeviceOwner (String componentName, int userId) デバイス管理コンポーネントを特定のユーザーのデバイス所有者として設定します。
abstract void	setSetting (String namespace, String key, String value) setSetting(int, String, String, String)参照し、システム ユーザーに対して実行されます。
abstract void	setSetting (int userId, String namespace, String key, String value) 指定されたユーザーの名前空間に設定値を追加します。
abstract boolean	startUser (int userId) 指定されたユーザーが現在停止している場合は、バックグラウンドで開始します。
abstract boolean	startUser (int userId, boolean waitFlag) 指定されたユーザーが現在停止している場合は、バックグラウンドで開始します。
abstract boolean	startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) 指定されたユーザーをバックグラウンドで開始し、指定されたディスプレイに表示されます (つまり、ユーザーがそのディスプレイでアクティビティを起動できるようになります)。
abstract boolean	stopUser (int userId, boolean waitFlag, boolean forceFlag) 特定のユーザーを停止します。
abstract boolean	stopUser (int userId) 指定されたユーザーを停止します。
abstract boolean	switchUser (int userId) デフォルトのタイムアウトを持つ別の userId に切り替えます。
abstract boolean	switchUser (int userId, long timeout) 指定されたタイムアウトを期限として別の userId に切り替えます。
abstract Bugreport	takeBugreport () バグレポートを取得し、バグレポートを処理するためにBugreportオブジェクト内に返します。
abstract String	uninstallPackage (String packageName) デバイスから Android パッケージをアンインストールします。
abstract String	uninstallPackageForUser (String packageName, int userId) 特定のユーザーのデバイスから Android パッケージをアンインストールします。

パブリックメソッド

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

戻り値
boolean

投げる
DeviceNotAvailableException

接続を確認する

public abstract boolean checkConnectivity ()

デバイスがネットワークに接続されていることを確認します。

戻り値
boolean	デバイスに正常なネットワーク接続がある場合はtrue 、それ以外の場合はfalse 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

クリアエラーダイアログ

public abstract boolean clearErrorDialogs ()

デバイス UI に現在表示されているエラー ダイアログを閉じてみます。

戻り値
boolean	ダイアログが存在しないか、ダイアログが正常にクリアされた場合はtrue 。それ以外の場合はfalse 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

ClearLastConnectedWifiネットワーク

public abstract void clearLastConnectedWifiNetwork ()

最後に接続した Wi-Fi ネットワークをクリアします。これは、デバイスの再起動後に前のテストで使用された Wi-Fi ネットワークに接続するのを避けるために、新しい呼び出しを開始するときに呼び出す必要があります。

Wifiネットワークに接続する

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Wi-Fi ネットワークに接続します。

Wi-Fi をオンにし、wifiSsidToPsk マップで指定された Wi-Fi ネットワークの 1 つとの接続が成功するまでブロックします。接続が確立されると、インスタンスはITestDevice#disconnectFromWifi()またはITestDevice#clearLastConnectedWifiNetwork()が呼び出されるまで、再起動のたびに接続の復元を試みます。

パラメーター
wifiSsidToPsk	: Wi-Fi SSID とパスワードのマップ。
scanSsid	boolean : このネットワークの非表示の SSID をスキャンするかどうか。

戻り値
boolean	Wi-Fi ネットワークに正常に接続された場合はtrue 。それ以外の場合はfalse

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

Wifiネットワークに接続する

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Wi-Fi ネットワークに接続します。

Wi-Fi をオンにし、wifiSsidToPsk マップで指定された Wi-Fi ネットワークの 1 つとの接続が成功するまでブロックします。接続が確立されると、インスタンスはITestDevice#disconnectFromWifi()またはITestDevice#clearLastConnectedWifiNetwork()が呼び出されるまで、再起動のたびに接続の復元を試みます。

パラメーター
wifiSsidToPsk	: Wi-Fi SSID とパスワードのマップ。

戻り値
boolean	Wi-Fi ネットワークに正常に接続された場合はtrue 。それ以外の場合はfalse

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

Wifiネットワークに接続する

public abstract 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	Wi-Fi ネットワークに正常に接続された場合はtrue 。それ以外の場合はfalse

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

Wifiネットワークに接続する

public abstract 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	Wi-Fi ネットワークに正常に接続された場合はtrue 。それ以外の場合はfalse

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

必要に応じて Wifi ネットワークに接続します

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

デバイスが現在ネットワークに接続していない場合にのみ接続するconnectToWifiNetwork(String, String)のバリアント。

パラメーター
scanSsid	boolean : このネットワークの非表示の SSID をスキャンするかどうか

戻り値
boolean	Wi-Fi ネットワークに正常に接続された場合はtrue 。それ以外の場合はfalse

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

必要に応じて Wifi ネットワークに接続します

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

デバイスが現在ネットワークに接続していない場合にのみ接続するconnectToWifiNetwork(String, String)のバリアント。

戻り値
boolean	Wi-Fi ネットワークに正常に接続された場合はtrue 。それ以外の場合はfalse

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ユーザーを作成

public abstract int createUser (String name)

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

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ユーザーを作成

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

指定された名前と指定されたフラグを使用してユーザーを作成します

パラメーター
name	String : デバイス上に作成するユーザーの
guest	boolean : 作成時にユーザー フラグ --guest を有効にします
ephemeral	boolean : 作成中にユーザー フラグ --ephemeral を有効にします
forTesting	boolean : 作成時にテスト フラグ --for-testing を有効にします

戻り値
int	作成したユーザーのID

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ユーザーを作成

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

指定された名前と指定されたフラグを使用してユーザーを作成します

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

戻り値
int	作成したユーザーのID

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

DeviceActionReceiver の登録を解除する

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

登録されたIDeviceActionReceiverを削除します。

パラメーター
deviceActionReceiver	IDeviceActionReceiver : 削除されるIDeviceActionReceiver 。

キーガードを無効にする

public abstract void disableKeyguard ()

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

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

投げる
DeviceNotAvailableException

ネットワークモニターを無効にする

public abstract boolean disableNetworkMonitor ()

デバイス上のネットワーク監視を無効にします。

戻り値
boolean	監視が正常に無効化された場合はtrue 。失敗した場合はfalse 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

Wifiから切断する

public abstract boolean disconnectFromWifi ()

Wi-Fi ネットワークから切断します。

既知のネットワークのリストからすべてのネットワークを削除し、Wi-Fi を無効にします。

戻り値
boolean	Wi-Fi ネットワークから正常に切断された場合はtrue 。切断に失敗した場合はfalse 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

ファイルが存在しますか

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

ダンプヒープ

public abstract File dumpHeap (String process, 
                String devicePath)

system_server からヒープをダンプしてみます。ダンプされたファイルをクリーンアップするのは呼び出し側の責任です。

パラメーター
process	String : ダンプヒープを作成するデバイス プロセスの名前。
devicePath	String : ダンプを配置するデバイス上のパス。これは権限で許可されている場所である必要があります。

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ネットワークモニターを有効にする

public abstract boolean enableNetworkMonitor ()

デバイス上のネットワーク監視を有効にします。

戻り値
boolean	監視が正常に有効化された場合はtrue 。失敗した場合はfalse 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

getActiveApexes

public abstract  getActiveApexes ()

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

戻り値
	現在デバイス上で有効化されているApexInfoのERROR(/Set)

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

すべての設定を取得

public abstract  getAllSettings (String namespace)

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

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

戻り値
	キーと値のペアのマップ。ネームスペースがサポートされていない場合は null。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

AndroidIdを取得する

public abstract String getAndroidId (int userId)

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

パラメーター
userId	int

戻り値
String

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

AndroidID を取得する

public abstract  getAndroidIds ()

ユーザー ID に一致する Android ID のマップを作成します。各ユーザー ID がこの関数に関連付けられた Android ID を見つけるという保証はないため、一部のユーザー ID が null に一致する可能性があります。

戻り値
	ユーザー ID と一致する Android ID のマップ。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

パラメーター
packageName	String

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getバグレポート

public abstract InputStreamSource getBugreport ()

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

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

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

getバグレポルツ

public abstract InputStreamSource getBugreportz ()

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

「adb バージョン」 > 1.0.36 でのみサポートされます

戻り値
InputStreamSource	バグレポートを含む zip ファイルのInputStreamSource 。失敗した場合は null を返します。

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

戻り値
DeviceFoldableState

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

現在のユーザーを取得

public abstract int getCurrentUser ()

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

戻り値
int

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

戻り値

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpアドレス

public abstract String getIpAddress ()

デバイスのIPアドレスを取得します。

戻り値
String	デバイスの IP アドレス、またはデバイスに IP アドレスがない場合はnull

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

getMainUserId

public abstract Integer getMainUserId ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	デバイスからの出力が期待どおりでない場合。
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getオプション

public abstract TestDeviceOptions getOptions ()

デバイスのテスト オプションを取得します。

戻り値
TestDeviceOptions	テスト対象のデバイスに関連するTestDeviceOptions 。

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	デバイスからの出力が期待どおりでない場合。
DeviceNotAvailableException

スクリーンショットの取得

public abstract InputStreamSource getScreenshot ()

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

戻り値
InputStreamSource	png 形式のスクリーンショットのInputStreamSource 、またはスクリーンショットが成功しなかった場合はnull 。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スクリーンショットの取得

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

パラメーター
format	String : サポートされている PNG、JPEG
rescale	boolean : 結果の画像のサイズを減らすためにスクリーンショットを再スケールする必要があるかどうか

戻り値
InputStreamSource	形式のスクリーンショットのInputStreamSource 、またはスクリーンショットが成功しなかった場合はnull 。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スクリーンショットの取得

public abstract InputStreamSource getScreenshot (String format)

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

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

戻り値
InputStreamSource	形式のスクリーンショットのInputStreamSource 、またはスクリーンショットが成功しなかった場合はnull 。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スクリーンショットの取得

public abstract InputStreamSource getScreenshot (long displayId)

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

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

パラメーター
displayId	long : スクリーンショットを取得する画面の表示 ID。

戻り値
InputStreamSource	形式のスクリーンショットのInputStreamSource 、またはスクリーンショットが成功しなかった場合はnull 。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

設定の取得

public abstract String getSetting (String namespace, 
                String key)

getSetting(int, String, String)参照し、システム ユーザーに対して実行されます。

パラメーター
namespace	String
key	String

戻り値
String

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

設定の取得

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

要求された設定の値を返します。名前空間は、{"system"、"secure"、"global"} のいずれかである必要があります。

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

パラメーター
userId	int

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ユーザー情報の取得

public abstract  getUserInfos ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

パラメーター
userId	int

戻り値
int

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

機能あり

public abstract boolean hasFeature (String feature)

デバイスで機能が利用できるかどうかを確認します。

パラメーター
feature	String : どの形式にするか「機能: " または " " 直接。

戻り値
boolean	特徴が見つかった場合は true、それ以外の場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

インストールパッケージ

public abstract 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	デバイスとの接続が失われ、回復できない場合。

インストールパッケージ

public abstract 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	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

ユーザー向けのインストールパッケージ

public abstract 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	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

ユーザー向けのインストールパッケージ

public abstract 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	デバイスとの接続が失われ、回復できない場合。

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

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

複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。 APK を複数のファイルに分割する方法については、「https://developer.android.com/studio/build/configure-apk-splits」を参照してください。

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

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

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

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

Android デバイス上にある複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。 APK を複数のファイルに分割する方法については、「https://developer.android.com/studio/build/configure-apk-splits」を参照してください。

注: インストール時に実行時権限の付与を明示的に制御する必要があるユースケースのみが、この関数を呼び出す必要があります。

パラメーター
packageFiles	: インストールするリモート APK ファイルのパス
reinstall	boolean : 再インストールを実行する必要がある場合はtrue
grantPermissions	boolean : インストール時にすべての実行時権限を付与する必要があるかどうか
extraArgs	String : 渡すオプションの追加引数。利用可能なオプションについては、「adb shell pm -h」を参照してください。

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

ユーザー向けのインストールパッケージ

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

特定のユーザーに対して、複数の APK ファイル (1 つのメインおよび追加の分割パッケージ) で構成される Android アプリケーションをインストールします。 APK を複数のファイルに分割する方法については、「https://developer.android.com/studio/build/configure-apk-splits」を参照してください。

注: インストール時に実行時権限の付与を明示的に制御する必要があるユースケースのみが、この関数を呼び出す必要があります。

パラメーター
packageFiles	: ローカルの apk ファイル
reinstall	boolean : 再インストールを実行する必要がある場合はtrue
grantPermissions	boolean : インストール時にすべての実行時権限を付与する必要があるかどうか
userId	int : インストールする整数のユーザー ID。
extraArgs	String : 渡すオプションの追加引数。利用可能なオプションについては、「adb shell pm -h」を参照してください。

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

ユーザー向けのインストールパッケージ

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

特定のユーザーに対して、複数の APK ファイル (1 つのメインおよび追加の分割パッケージ) で構成される Android アプリケーションをインストールします。 APK を複数のファイルに分割する方法については、「https://developer.android.com/studio/build/configure-apk-splits」を参照してください。

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

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

installRemotePackages

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

Android デバイス上にある複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。 APK を複数のファイルに分割する方法については、「https://developer.android.com/studio/build/configure-apk-splits」を参照してください。

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

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

installRemotePackages

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

Android デバイス上にある複数の APK ファイル (1 つのメインと追加の分割パッケージ) で構成される Android アプリケーションをインストールします。 APK を複数のファイルに分割する方法については、「https://developer.android.com/studio/build/configure-apk-splits」を参照してください。

注: インストール時に実行時権限の付与を明示的に制御する必要があるユースケースのみが、この関数を呼び出す必要があります。

パラメーター
remoteApkPaths	: リモート APK ファイルのパス
reinstall	boolean : 再インストールを実行する必要がある場合はtrue
grantPermissions	boolean : インストール時にすべての実行時権限を付与する必要があるかどうか
extraArgs	String : 渡すオプションの追加引数。利用可能なオプションについては、「adb shell pm -h」を参照してください。

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。
UnsupportedOperationException	実行時権限がデバイス上のプラットフォームでサポートされていない場合。

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

デバイスがヘッドレス システム ユーザー モードを使用するかどうかを返します。

戻り値
boolean

投げる
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

メイン ユーザーが永続管理者であり、削除できないか、非管理者ステータスにダウングレードできないかどうかを返します。

戻り値
boolean

投げる
DeviceNotAvailableException

マルチユーザーサポートです

public abstract boolean isMultiUserSupported ()

マルチユーザーがサポートされているかどうかを決定します。

戻り値
boolean	マルチユーザーがサポートされている場合は true、そうでない場合は false

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

パッケージがインストールされています

public abstract boolean isPackageInstalled (String packageName)

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

パラメーター
packageName	String

戻り値
boolean	パッケージがインストールされていると報告される場合は True。それ以外の場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

パッケージがインストールされています

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

戻り値
boolean	パッケージがインストールされていると報告される場合は True。それ以外の場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ユーザーが実行中です

public abstract boolean isUserRunning (int userId)

指定されたユーザーが実行されているかどうかを確認します。

パラメーター
userId	int

戻り値
boolean	ユーザーが実行中の場合は true、それ以外の場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

フラグに従って、指定されたユーザーがセカンダリ ユーザーであるかどうかを返します。

パラメーター
userId	int

戻り値
boolean	ユーザーがセカンダリの場合は true、それ以外の場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

指定されたユーザーが表示されているかどうかを確認します。

「可視」ユーザーは、「人間」ユーザーと対話しているため、起動アクティビティを開始できるユーザーです (通常はデフォルト表示で)。

パラメーター
userId	int

戻り値
boolean

投げる
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

指定されたユーザーが指定されたディスプレイに表示されるかどうかを確認します。

「可視」ユーザーは、「人間」ユーザーと対話しているユーザーであり、そのため、そのディスプレイで起動アクティビティを開始できます。

パラメーター
userId	int
displayId	int

戻り値
boolean

投げる
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract 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 abstract boolean isVisibleBackgroundUsersSupported ()

デバイスがユーザーをバックグラウンドで表示して起動できるかどうかを返します。

存在する場合は、 startVisibleBackgroundUser(int, int, boolean)を呼び出して、 listDisplayIdsForStartingVisibleBackgroundUsers()によって返された表示を渡すことができます。

戻り値
boolean

投げる
DeviceNotAvailableException

Wifiが有効です

public abstract boolean isWifiEnabled ()

Wi-Fi が有効かどうかをテストします。

デバイスで Wi-Fi が有効になっているかどうかを確認します。 Wi-Fi で実行すべきではないテスト (モバイル データ テストなど) の前に Wi-Fi ステータスをアサートするのに役立ちます。

戻り値
boolean	Wi-Fi が有効な場合はtrue 。無効の場合はfalse

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

listDisplayIds

public abstract  listDisplayIds ()

「dumpsys SurfaceFlinger」によって報告された、デバイス上で使用可能なディスプレイ ID のリストを収集します。

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

戻り値

投げる
DeviceNotAvailableException

ユーザーのリスト

public abstract  listUsers ()

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

ログバグレポート

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

このデバイスのIDeviceActionReceiverを登録します。

登録されているすべてのIDeviceActionReceiverは、デバイス アクションの開始前とデバイス アクションの終了後に通知されます。

パラメーター
deviceActionReceiver	IDeviceActionReceiver : 登録されるIDeviceActionReceiver 。

管理者の削除

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

戻り値
boolean	成功した場合は true、そうでない場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

所有者を削除する

public abstract void removeOwners ()

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ユーザーの削除

public abstract boolean removeUser (int userId)

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

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

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

パラメーター
componentName	String : デバイス所有者となるデバイス管理者の文字列。
userId	int : デバイス所有者が住んでいるユーザーの値。

戻り値
boolean	成功した場合は true、そうでない場合は false。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

セット設定

public abstract void setSetting (String namespace, 
                String key, 
                String value)

setSetting(int, String, String, String)参照し、システム ユーザーに対して実行されます。

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

セット設定

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

指定されたユーザーの名前空間に設定値を追加します。一部の設定は再起動後にのみ使用可能になります。名前空間は、{"system"、"secure"、"global"} のいずれかである必要があります。

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スタートユーザー

public abstract boolean startUser (int userId)

指定されたユーザーが現在停止している場合は、バックグラウンドで開始します。ユーザーが既にバックグラウンドで実行している場合、このメソッドは NOOP です。

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

戻り値
boolean	ユーザーがバックグラウンドで正常に起動された場合は true。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スタートユーザー

public abstract boolean startUser (int userId, 
                boolean waitFlag)

指定されたユーザーが現在停止している場合は、バックグラウンドで開始します。ユーザーが既にバックグラウンドで実行している場合、このメソッドは NOOP です。操作が有効になるまで待機する追加のフラグを提供することが可能です。

パラメーター
userId	int : バックグラウンドで開始するユーザーの
waitFlag	boolean : ユーザーが開始されてロックが解除されるまでコマンドを待機させます。

戻り値
boolean	ユーザーがバックグラウンドで正常に起動された場合は true。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

指定されたユーザーをバックグラウンドで開始し、指定されたディスプレイに表示されます (つまり、ユーザーがそのディスプレイでアクティビティを起動できるようになります)。

注:このコマンドは、ユーザーが存在するかどうか、ディスプレイが利用可能かどうか、 device supports such featureどうかなどを確認しません。

パラメーター
userId	int : バックグラウンドで開始するユーザーの
displayId	int : ユーザーに表示される開始位置を表示します。
waitFlag	boolean : ユーザーが開始されてロックが解除されるまでコマンドを待機させます。

戻り値
boolean	ユーザーが正常に開始され、バックグラウンドで表示された場合はtrue 。

投げる
DeviceNotAvailableException

停止ユーザー

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

特定のユーザーを停止します。操作が有効になるまで待機するための追加のフラグを提供し、ユーザーを強制終了することが可能です。現在のユーザーとシステム ユーザーを停止できません。

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

戻り値
boolean	ユーザーが正常に停止された場合は true。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

停止ユーザー

public abstract boolean stopUser (int userId)

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

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

戻り値
boolean	ユーザーが正常に停止された場合は true。

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スイッチユーザー

public abstract boolean switchUser (int userId)

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

パラメーター
userId	int

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

スイッチユーザー

public abstract boolean switchUser (int userId, 
                long timeout)

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

パラメーター
userId	int
timeout	long : ユーザー切り替えに失敗した場合に false を返す前に待機します。

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

投げる
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

テイクバグレポート

public abstract Bugreport takeBugreport ()

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

戻り値
Bugreport

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

public abstract String uninstallPackage (String packageName)

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

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

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。

アンインストールパッケージユーザー用

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

戻り値
String	エラー コードを含むString 。成功した場合はnull 。

投げる
DeviceNotAvailableException	デバイスとの接続が失われ、回復できない場合。