ITテストデバイス

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.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 に関する情報を取得します。

戻り値
現在デバイス上で有効化されているApexInfoERROR(/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 ()

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

戻り値
デバイスにインストールされているPackageInfoERROR(/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デバイスとの接続が失われ、回復できない場合。