ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


ddmlib IDeviceに、信頼性の高い、わずかに高レベルの API を提供します。

構成可能な量のデバイス コマンドを再試行し、応答しないデバイスにデバイス リカバリ インターフェイスを提供します。

まとめ

ネストされたクラス

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

戻り値
boolean WiFi ネットワークに正常に接続されている場合はtrue 。それ以外の場合はfalse

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

戻り値
boolean WiFi ネットワークに正常に接続されている場合はtrue 。それ以外の場合はfalse

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

パラメーター
wifiSsid String : 接続先の wifi ssid

wifiPsk String : PSK パスフレーズ、または暗号化されていない場合は null

戻り値
boolean WiFi ネットワークに正常に接続されている場合はtrue 。それ以外の場合はfalse

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

connectToWifiNetwork

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

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

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

パラメーター
wifiSsid String : 接続先の wifi ssid

wifiPsk String : PSK パスフレーズ、または暗号化されていない場合は null

scanSsid boolean : このネットワークの隠し SSID をスキャンするかどうか。

戻り値
boolean WiFi ネットワークに正常に接続されている場合はtrue 。それ以外の場合はfalse

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

connectToWifiNetworkIfNeeded

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

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

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

戻り値
boolean WiFi ネットワークに正常に接続されている場合はtrue 。それ以外の場合はfalse

スロー
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

戻り値
boolean WiFi ネットワークに正常に接続されている場合は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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

キーガードを無効にする

public abstract void disableKeyguard ()

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

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

スロー
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

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

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

wifiから切断

public abstract boolean disconnectFromWifi ()

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

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

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

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

dosFileExist

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

getActiveApex

public abstract  getActiveApexes ()

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

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

スロー
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

戻り値
キーと値のペアのマップ。名前空間がサポートされていない場合は 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 のマップを作成します。各ユーザー 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 ()

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

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

スロー
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

戻り値
デバイスに現在インストールされているERROR(/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 Keyguard の状態のスナップショットを含むKeyguardControllerState 。Keyguard クエリがサポートされていない場合は Null を返します。

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

getMainUserId

public abstract Integer getMainUserId ()

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

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

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

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

スロー
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

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

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

パラメーター
namespace String

key String

戻り値
String

スロー
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

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

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

getUserInfos

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

インストールパッケージ

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム権限がサポートされていない場合。

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム権限がサポートされていない場合。

インストールパッケージ

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム権限がサポートされていない場合。

installPackagesForUser

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム権限がサポートされていない場合。

installPackagesForUser

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム権限がサポートされていない場合。

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム権限がサポートされていない場合。

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

スロー
DeviceNotAvailableExceptionデバイスとの接続が失われ、回復できない場合。
デバイスのプラットフォームでランタイム許可がサポートされていない場合。

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)

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

パラメーター
packageName String

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

スロー
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

パラメーター
packageName String : インストールされているかどうかを確認するパッケージ。

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

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

スロー
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 が有効になっているかどうかを確認します。モバイル データ テストなど、wifi で実行してはならないテストの前に wifi ステータスをアサートするのに役立ちます。

戻り値
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を登録します。

All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

パラメーター
deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove given device admin in given user and return true if it is successful, false otherwise.

パラメーター
componentName String : of device admin to be removed.

userId int : of user that the device admin lives in.

戻り値
boolean True if it is successful, false otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Remove all existing device profile owners with the best effort.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remove a given user from the device.

パラメーター
userId int : of the user to remove

戻り値
boolean true if we were successful in removing the user, false otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Set a device admin component as device owner in given user.

パラメーター
componentName String : of device admin to be device owner.

userId int : of the user that the device owner lives in.

戻り値
boolean True if it is successful, false otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

See setSetting(int, String, String, String) and performed on system user.

パラメーター
namespace String

key String

value String

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

パラメーター
userId int

namespace String

key String

value String

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

パラメーター
userId int : of the user to start in the background

戻り値
boolean true if the user was successfully started in the background.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

パラメーター
userId int : of the user to start in the background

waitFlag boolean : will make the command wait until user is started and unlocked.

戻り値
boolean true if the user was successfully started in the background.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

パラメーター
userId int : of the user to start in the background

displayId int : display to start user visible on

waitFlag boolean : will make the command wait until user is started and unlocked.

戻り値
boolean true if the user was successfully started visible in the background.

Throws
DeviceNotAvailableException

stopUser

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

Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

パラメーター
userId int : of the user to stop.

waitFlag boolean : will make the command wait until user is stopped.

forceFlag boolean : will force stop the user.

戻り値
boolean true if the user was successfully stopped.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

パラメーター
userId int : of the user to stop.

戻り値
boolean true if the user was successfully stopped.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Switch to another userId with a default timeout. switchUser(int, long) .

パラメーター
userId int

戻り値
boolean True if the new userId matches the userId provider. False otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

パラメーター
userId int

timeout long : to wait before returning false for switch-user failed.

戻り値
boolean True if the new userId matches the userId provider. False otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

戻り値
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

パラメーター
packageName String : the Android package to uninstall

戻り値
String a ERROR(/String) with an error code, or null if success.

Throws
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

パラメーター
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

戻り値
String a ERROR(/String) with an error code, or null if success.

Throws
DeviceNotAvailableException if connection with device is lost and cannot be recovered.