ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

信頼性が高くやや上位の API を ddmlib IDevice に提供します。

設定可能な量でデバイス コマンドを再試行し、デバイス復元機能を提供する 応答しないデバイスのインターフェースです。

概要

ネストされたクラス

class ITestDevice.ApexInfo

単一の APEX に関する情報を格納するシンプルな構造体クラス

class ITestDevice.MountPointInfo

1 つのマウント ポイントに関する情報を格納するシンプルな構造体クラス

パブリック メソッド

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

最後に接続した Wi-Fi ネットワークを消去します。

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

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

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

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)

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

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

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

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)

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

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()

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

abstract int getMaxNumberOfRunningUsersSupported()

同時に実行できるユーザーの最大数を取得します。

abstract int getMaxNumberOfUsersSupported()

サポートされているユーザーの最大数を取得します。

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

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

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(String format)

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

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot()

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

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

リクエストされた設定の値を返します。

abstract String getSetting(String namespace, String key)

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

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, int userId, String... extraArgs)

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

abstract String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

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

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールします。

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする ダウンロードされます

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする 割り当てられています

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする 割り当てられています

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする ダウンロードされます

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする ダウンロードされます

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

マルチユーザーに対応しているかどうかを判別します。

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

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

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 で報告されるとおり、デバイスで使用可能なディスプレイ ID のリストを収集します。 SurfaceFlinger」です。

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract listUsers()

デバイス上のユーザーのリストを取得します。

abstract boolean logBugreport(String dataName, ITestLogger listener)

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

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

snapuserd の完了を待つようデバイスに通知します。

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)

指定したユーザーを停止します。

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

特定のユーザーを停止します。

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 パッケージをデバイスからアンインストールします。

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

予想される場合は、snapuserd が完了するまで待ちます。

パブリック メソッド

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

戻り値
boolean

例外
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

戻り値
boolean true: デバイスのネットワーク接続が機能している場合 false が過剰です。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

戻り値
boolean ダイアログが存在しないか、ダイアログが正常に消去された場合は true。 そうでない場合は false。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

ClearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

パラメータ
wifiSsidToPsk : Wi-Fi の SSID とパスワードのマップ。
戻り値
boolean true（Wi-Fi ネットワークに正常に接続された場合）。false

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

パラメータ
wifiSsidToPsk : Wi-Fi の SSID とパスワードのマップ。
scanSsid boolean: このネットワークの非表示 SSID をスキャンするかどうか。
戻り値
boolean true（Wi-Fi ネットワークに正常に接続された場合）。false

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

パラメータ
wifiSsid String: 接続先の Wi-Fi SID
wifiPsk String: PSK パスフレーズ、または暗号化されていない場合は null
戻り値
boolean true（Wi-Fi ネットワークに正常に接続された場合）。false

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

connectToWifiNetwork

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

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

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

パラメータ
wifiSsid String: 接続先の Wi-Fi SID
wifiPsk String: PSK パスフレーズ、または暗号化されていない場合は null
scanSsid boolean: このネットワークの非表示 SSID をスキャンするかどうか。
戻り値
boolean true（Wi-Fi ネットワークに正常に接続された場合）。false

例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

connectToWifiNetworkIfNeeded

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

デバイスの場合にのみ接続する connectToWifiNetwork(String, String) のバリアント ネットワーク接続がありません。

パラメータ
scanSsid boolean: このネットワークの非表示 SSID をスキャンするかどうか
戻り値
boolean true（Wi-Fi ネットワークに正常に接続された場合）。false

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

デバイスの場合にのみ接続する connectToWifiNetwork(String, String) のバリアント ネットワーク接続がありません。

戻り値
boolean true（Wi-Fi ネットワークに正常に接続された場合）。false

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

createUser

public abstract int createUser (String name)

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

パラメータ
name String: デバイスに作成するユーザーの
戻り値
int 作成されたユーザー ID の整数
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

createUser

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

パラメータ
name String: デバイスに作成するユーザーの
戻り値
int 作成されたユーザー ID の整数、またはエラーの場合は -1。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

登録済みの IDeviceActionReceiver を削除します。

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

Keyguard を無効にする

public abstract void disableKeyguard ()

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

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

例外
DeviceNotAvailableException

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

public abstract boolean disableNetworkMonitor ()

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

戻り値
boolean モニタリングが正常に無効になった場合は true。false 表示されます。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

接続解除 FromWifi

public abstract boolean disconnectFromWifi ()

Wi-Fi ネットワークから切断される。

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

戻り値
boolean Wi-Fi ネットワークから正常に切断された場合は true。false 接続解除に失敗した場合
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

doesFileExist

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

EnableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

戻り値
boolean モニタリングが正常に有効になっている場合は true。false 表示されます。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

getActiveApexes

public abstract  getActiveApexes ()

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

戻り値
ApexInfo 個中 ERROR(/Set) 個がデバイスで現在有効です
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

パラメータ
namespace String: {"system"、"secure"、"global"} のいずれかにする必要があります
戻り値
Key-Value ペアのマップです名前空間がサポートされていない場合は null。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

パラメータ
userId int

戻り値
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

バグレポートを取得

public abstract InputStreamSource getBugreport ()

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

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

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

バグレポートの取得

public abstract InputStreamSource getBugreportz ()

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

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

戻り値
InputStreamSource bugreportz を含む zip ファイルの InputStreamSource。null を返します。 見ていきます

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

戻り値
DeviceFoldableState

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

getCurrentUser

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

getIpAddress

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 ()

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

戻り値
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

getOptions

public abstract TestDeviceOptions getOptions ()

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

戻り値
TestDeviceOptions TestDeviceOptions: テスト対象デバイス。

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

戻り値
Integer プライマリ ユーザーが存在する場合は、その userId、プライマリ ユーザーが存在しない場合は null。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException デバイスからの出力が想定どおりでない場合は、
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

パラメータ
format String: サポートされている PNG、JPEG
rescale boolean: 結果の画像のサイズを小さくするためにスクリーンショットのサイズを変更するかどうか
戻り値
InputStreamSource InputStreamSource 形式のスクリーンショットのnull スクリーンショットに失敗しました。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

パラメータ
format String: サポートされている PNG、JPEG
戻り値
InputStreamSource フォーマットのスクリーンショットの InputStreamSource。または、null 失敗しました。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

パラメータ
displayId long: スクリーンショットを取得する画面のディスプレイ ID。
戻り値
InputStreamSource InputStreamSource 形式のスクリーンショットのnull スクリーンショットに失敗しました。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

戻り値
InputStreamSource PNG 形式のスクリーンショットの InputStreamSource。または、null 失敗しました。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

リクエストされた設定の値を返します。 Namespace は、{"system"、"secure"、"global"} のいずれかである必要があります

パラメータ
userId int

namespace String

key String

戻り値
String ユーザーの namespace:key に関連付けられた値。見つからない場合は null。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

パラメータ
namespace String

key String

戻り値
String

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

戻り値
現在: ERROR(/Set) 個のアンインストールできない String パッケージ名が できます。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

パラメータ
userId int

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

getUserInfo

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

hasFeature

public abstract boolean hasFeature (String feature)

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

パラメータ
feature String: 「feature:」の形式または「」直接渡されます。
戻り値
boolean 特徴が見つかった場合は true、そうでない場合は false。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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 デバイスとの接続が失われ、接続が失われても できます。

installPackage

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 実行時の権限がプラットフォームでサポートされていない場合 できます。

installPackageForUser

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 デバイスとの接続が失われ、接続が失われても できます。

installPackageForUser

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 実行時の権限がプラットフォームでサポートされていない場合 できます。

installPackages

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールします。 詳細: https://developer.android.com/studio/build/configure-apk-splitsAPK を分割して 作成します。

パラメータ
packageFiles : ローカル APK ファイル
reinstall boolean: 再インストールを実行する必要がある場合は true
extraArgs String: 渡すオプションの追加引数。「adb shell pm -h」を参照してください。を 。
戻り値
String エラーコードを含む String。成功した場合は null。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。
UnsupportedOperationException 実行時の権限がプラットフォームでサポートされていない場合 できます。

installPackages

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする ダウンロードされます詳しくは、 「https://developer.android.com/studio/build/configure-apk-splits」APK を分割して 作成します。

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

パラメータ
packageFiles : インストールするリモート APK ファイルのパス
reinstall boolean: 再インストールを実行する必要がある場合は true
grantPermissions boolean: インストール時にすべての実行時の権限を付与する必要がある場合
extraArgs String: 渡すオプションの追加引数。「adb shell pm -h」を参照してください。を 。
戻り値
String エラーコードを含む String。成功した場合は null。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。
UnsupportedOperationException 実行時の権限がプラットフォームでサポートされていない場合 できます。

installPackagesForUser

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする 割り当てられています詳細: https://developer.android.com/studio/build/configure-apk-splitsオン apk を複数のファイルに分割する方法

パラメータ
packageFiles : ローカル APK ファイル
reinstall boolean: 再インストールを実行する必要がある場合は true
userId int: インストール対象のユーザー ID（整数）。
extraArgs String: 渡すオプションの追加引数。「adb shell pm -h」を参照してください。を 。
戻り値
String エラーコードを含む String。成功した場合は null。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。
UnsupportedOperationException 実行時の権限がプラットフォームでサポートされていない場合 できます。

installPackagesForUser

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする 割り当てられています詳細: https://developer.android.com/studio/build/configure-apk-splitsオン apk を複数のファイルに分割する方法

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

パラメータ
packageFiles : ローカル APK ファイル
reinstall boolean: 再インストールを実行する必要がある場合は true
grantPermissions boolean: インストール時にすべての実行時の権限を付与する必要がある場合
userId int: インストール対象のユーザー ID（整数）。
extraArgs String: 渡すオプションの追加引数。「adb shell pm -h」を参照してください。を 。
戻り値
String エラーコードを含む String。成功した場合は null。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。
UnsupportedOperationException 実行時の権限がプラットフォームでサポートされていない場合 できます。

installRemotePackages

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする ダウンロードされます詳しくは、 「https://developer.android.com/studio/build/configure-apk-splits」APK を分割して 作成します。

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

複数の APK ファイル（1 つのメイン パッケージと追加の分割パッケージ）で構成された Android アプリをインストールする ダウンロードされます詳しくは、 「https://developer.android.com/studio/build/configure-apk-splits」APK を分割して 作成します。

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

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

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

マルチユーザーに対応しているかどうかを判別します。

戻り値
boolean マルチユーザーがサポートされている場合は true、それ以外の場合は false
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

パラメータ
packageName String: インストールされているかどうかを確認するパッケージ。
userId String: パッケージのインストール対象かどうかを確認するユーザー ID。null の場合、プライマリ ユーザー 使用されます。
戻り値
boolean パッケージがインストール済みとして報告された場合は true。それ以外の場合は False です。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

パラメータ
packageName String

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

isUserRunning

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

isWifiEnabled

public abstract boolean isWifiEnabled ()

Wi-Fi が有効になっているかどうかをテストします。

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

戻り値
boolean Wi-Fi が有効な場合は true。無効の場合は false
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

listDisplayIds

public abstract  listDisplayIds ()

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

戻り値
ディスプレイのリスト。デフォルトでは、常にデフォルトのディスプレイ 0 が返されます。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

戻り値
例外
DeviceNotAvailableException

listUsers

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。

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

snapuserd の完了を待つようデバイスに通知します。

パラメータ
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

デバイスのアクションの前に、登録されているすべての IDeviceActionReceiver に通知されます デバイス アクションが終了した後です。

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

deleteAdmin

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

setSetting

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

setSetting

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

特定のユーザーの名前空間に設定値を追加します。一部の設定は 有効になります。 Namespace は、{"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)

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

パラメータ
userId int: 停止するユーザーの。
戻り値
boolean ユーザーが正常に停止された場合は true を返します。
例外
com.android.tradefed.device.DeviceNotAvailableException
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

switchUser

public abstract boolean switchUser (int userId)

デフォルトのタイムアウトを使用して別の userId に切り替える。switchUser(int, long)。

パラメータ
userId int

戻り値
boolean 新しい userId が userId プロバイダと一致する場合は true。それ以外の場合は False です。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

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.close() で消去する必要があります。

戻り値
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

パラメータ
packageName String: アンインストールする Android パッケージ
戻り値
String エラーコードを含む String。成功した場合は null。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

パラメータ
packageName String: アンインストールする Android パッケージ
userId int: アンインストールするユーザー ID（整数）。
戻り値
String エラーコードを含む String。成功した場合は null。
例外
DeviceNotAvailableException デバイスとの接続が失われ、接続が失われても できます。

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

予想される場合は、snapuserd が完了するまで待ちます。

パラメータ
currentPhase SnapuserdWaitPhase

例外
DeviceNotAvailableException