Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る
このページは Cloud Translation API によって翻訳されました。
Switch to English

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

概要

ネストされたクラス

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

単一のマウントポイントに関する情報を格納する単純な構造体クラス

enum ITestDevice.RecoveryMode

パブリックメソッド

abstract boolean checkConnectivity ()

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

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

最後に接続した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 createUserNoThrow (String name)

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

abstract void disableKeyguard ()

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

abstract boolean disableNetworkMonitor ()

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

abstract boolean disconnectFromWifi ()

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

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

現在実行中のユーザーのIDを返します。

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

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

abstract KeyguardControllerState getKeyguardState ()

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

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

指定された表示IDのデバイスからスクリーンショットを取得します。

abstract InputStreamSource getScreenshot (String format)

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

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, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Androidデバイス上にあるいくつかのAPKファイル(1つのメインパッケージと追加の分割パッケージ)で構成されるAndroidアプリケーションをインストールします。

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

Androidデバイス上にあるいくつかのAPKファイル(1つのメインパッケージと追加の分割パッケージ)で構成されるAndroidアプリケーションをインストールします。

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

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

abstract listDisplayIds ()

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

abstract listUsers ()

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

abstract boolean removeAdmin (String componentName, int userId)

特定のユーザーの特定のデバイス管理者を削除し、成功した場合はtrue 、それ以外の場合はfalseを返しtrue

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 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 String uninstallPackage (String packageName)

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

パブリックメソッド

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

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

投げる
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

戻り値
boolean wifiネットワークへの接続に成功した場合はtrue 。そうでなければfalse

投げる
DeviceNotAvailableException

ユーザーを作成

public abstract int createUser (String name)

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

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

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

投げる
DeviceNotAvailableException

ユーザーを作成

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

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

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

guest boolean :作成時にユーザーフラグ--guestを有効にする

ephemeral boolean :作成中にユーザーフラグ--ephemeralを有効にします

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

投げる
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

投げる
DeviceNotAvailableException

disableKeyguard

public abstract void disableKeyguard ()

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

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

投げる
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

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

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

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

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

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

パラメーター
process String :ダンプヒープの対象となるデバイスプロセスの名前。

devicePath String :ダンプを配置するデバイス上のパス。これは、アクセス許可で許可されている場所である必要があります。

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

投げる
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

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

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

getActiveApexes

public abstract  getActiveApexes ()

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

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

投げる
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

投げる
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

パラメーター
userId int

戻り値
String

投げる
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

ユーザーIDと一致するAndroid IDのマップを作成します。各ユーザーIDがこの関数に関連付けられたAndroid IDを検出するという保証はありません。そのため、一部のユーザーIDはnullと一致する場合があります。

戻り値
一致するユーザーIDが見つかったAndroid IDのマップ。

投げる
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

パラメーター
packageName String

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

投げる
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

現在実行中のユーザーのIDを返します。

戻り値
int

投げる
DeviceNotAvailableException
DeviceRuntimeException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

投げる
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

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

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

投げる
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

投げる
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

投げる
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

rescale boolean :結果の画像のサイズを縮小するためにスクリーンショットを再スケーリングする必要がある場合

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

投げる
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (int displayId)

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

TODO:上記の実装を拡張して、「フォーマット」と「再スケール」をサポートする

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

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

投げる
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

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

投げる
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

getSetting(int, String, String)を参照して、システムユーザーに対して実行してください。

パラメーター
namespace String

key String

戻り値
String

投げる
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。

投げる
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

投げる
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

useIdの地図に取得しUserInfoデバイス上で。デバイスからの出力が期待どおりでない場合、 DeviceRuntimeExceptionスローします。

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

パラメーター
userId int

戻り値
int

投げる
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

パラメーター
feature String :「機能:

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

投げる
DeviceNotAvailableException

installPackage

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

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

パラメーター
packageFile File :インストールするapkファイル

reinstall boolean :再インストールを実行する必要がtrue場合はtrue

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

installPackage

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

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

注:この関数を呼び出す必要があるのは、インストール時にランタイム権限を付与する明示的な制御を必要とするユースケースのみです。

パラメーター
packageFile File :インストールするapkファイル

reinstall boolean :再インストールを実行する必要がtrue場合はtrue

grantPermissions boolean :インストール時にすべてのランタイム権限を付与する必要がある場合

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

installPackageForUser

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

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

注:この関数を呼び出す必要があるのは、インストール時にランタイム権限を付与する明示的な制御を必要とするユースケースのみです。

パラメーター
packageFile File :インストールするapkファイル

reinstall boolean :再インストールを実行する必要がtrue場合はtrue

grantPermissions boolean :インストール時にすべてのランタイム権限を付与する必要がある場合

userId int :インストールする整数のユーザーID。

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

戻り値
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場合はtrue

userId int :インストールする整数のユーザーID。

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

installPackages

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場合はtrue

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

installPackages

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場合はtrue

grantPermissions boolean :インストール時にすべてのランタイム権限を付与する必要がある場合

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

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場合はtrue

grantPermissions boolean :インストール時にすべてのランタイム権限を付与する必要がある場合

userId int :インストールする整数のユーザーID。

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

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場合はtrue

userId int :インストールする整数のユーザーID。

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

戻り値
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場合はtrue

grantPermissions boolean :インストール時にすべてのランタイム権限を付与する必要がある場合

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

戻り値
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場合はtrue

extraArgs String :渡すオプションの追加引数。使用可能なオプションについては、「adb shell pm install --help」を参照してください。

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

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

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

投げる
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

パラメーター
packageName String

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

投げる
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

投げる
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

特定のユーザーが実行しているかどうかを確認します。

パラメーター
userId int

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

投げる
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

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

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

listDisplayIds

public abstract  listDisplayIds ()

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

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

投げる
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

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

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

特定のユーザーの特定のデバイス管理者を削除し、成功した場合はtrue 、それ以外の場合はfalseを返しtrue

パラメーター
componentName String :削除するデバイス管理の。

userId int :デバイス管理者が住んでいるユーザーの。

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

投げる
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

既存のデバイスプロファイルの所有者をすべて最善の努力で削除します。

投げる
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

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

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

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

投げる
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

パラメーター
componentName String :デバイスの所有者となるデバイス管理者。

userId int :デバイスの所有者が住んでいるユーザーの。

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

投げる
DeviceNotAvailableException

setSetting

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

setSetting(int, String, String, String)を参照して、システムユーザーに対して実行してください。

パラメーター
namespace String

key String

value String

投げる
DeviceNotAvailableException

setSetting

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

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

パラメーター
userId int

namespace String

key String

value String

投げる
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

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

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

投げる
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

waitFlag boolean :ユーザーが起動してロックが解除されるまでコマンドを待機させます。

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

投げる
DeviceNotAvailableException

stopUser

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

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

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

waitFlag boolean :ユーザーが停止するまでコマンドを待機させます。

forceFlag boolean :ユーザーを強制的に停止します。

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

投げる
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

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

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

投げる
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

パラメーター
userId int

timeout long :ユーザー切り替えにfalseを返す前に待機するのは失敗しました。

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

投げる
DeviceNotAvailableException

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

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