テストデバイス

public class TestDevice
extends NativeDevice

java.lang.オブジェクト
com.android.tradefed.device.NativeDevice
com.android.tradefed.device.TestDevice


フルスタック Android デバイス用のITestDeviceの実装

まとめ

入れ子になったクラス

class TestDevice.MicrodroidBuilder

Microdroid TestDevice の作成に使用されるビルダー。

田畑

public static final String DISMISS_KEYGUARD_CMD

キーガードを解除するために使用できるコマンド。

パブリックコンストラクター

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

パブリックメソッド

boolean canSwitchToHeadlessSystemUser ()

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

boolean clearErrorDialogs ()

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

int createUser (String name)

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

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

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

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

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

int createUserNoThrow (String name)

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

void disableKeyguard ()

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

boolean doesFileExist (String deviceFilePath)

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

boolean doesFileExist (String deviceFilePath, int userId)

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

File dumpHeap (String process, String devicePath)

system_server からヒープをダンプしてみます。

getActiveApexes ()

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

getAllSettings (String namespace)

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

String getAndroidId (int userId)

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

getAndroidIds ()

ユーザー ID に一致する Android ID のマップを作成します。

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

InputStreamSource getBugreport ()

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

InputStreamSource getBugreportz ()

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

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

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

getFoldableStates ()

デバイス上の折りたたみ可能な状態のリストを返します。

getInstalledPackageNames ()

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

KeyguardControllerState getKeyguardState ()

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

Integer getMainUserId ()

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

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Integer getPrimaryUserId ()

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

InputStreamSource getScreenshot ()

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

InputStreamSource getScreenshot (String format, boolean rescale)

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

InputStreamSource getScreenshot (String format)

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

InputStreamSource getScreenshot (long displayId)

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

String getSetting (String namespace, String key)

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

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

要求された設定の値を返します。

getUninstallablePackageNames ()

アンインストールできるアプリケーションのパッケージ名を取得します。

int getUserFlags (int userId)

指定されたユーザーのフラグを検索して返します。

getUserInfos ()

デバイス上の useId からUserInfoへのマップを取得します。

int getUserSerialNumber (int userId)

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

boolean hasFeature (String feature)

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

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

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

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

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

String installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs)

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

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

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

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

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

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

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

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

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

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

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

boolean isAppEnumerationSupported ()

デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する

boolean isHeadlessSystemUserMode ()

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

boolean isMainUserPermanentAdmin ()

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

boolean isMultiUserSupported ()

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

boolean isPackageInstalled (String packageName)

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

boolean isPackageInstalled (String packageName, String userId)

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

boolean isUserRunning (int userId)

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

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

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

boolean isUserVisibleOnDisplay (int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

ERROR(/java.android.view.Display#DEFAULT_DISPLAY)で、デバイスがユーザーをバックグラウンドで表示して起動できるかどうかを返します。

boolean isVisibleBackgroundUsersSupported ()

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

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listUsers ()

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

boolean logBugreport (String dataName, ITestLogger listener)

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

void postInvocationTearDown (Throwable exception)

デバイス固有の必要なクリーンアップの追加手順は、呼び出しの完了後に実行されます。

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

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

boolean removeUser (int userId)

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

boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

指定されたユーザーの名前空間に設定値を追加します。

void shutdownMicrodroid ( ITestDevice microdroidDevice)

microdroid デバイスが存在する場合は、それをシャットダウンします。

boolean startUser (int userId)

指定されたユーザーが現在停止している場合は、バックグラウンドで開始します。

boolean startUser (int userId, boolean waitFlag)

指定されたユーザーが現在停止している場合は、バックグラウンドで開始します。

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

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

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

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

boolean stopUser (int userId)

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

boolean supportsMicrodroid ()

マイクロドロイドを実行するための前提条件を確認します。

boolean supportsMicrodroid (boolean protectedVm)

マイクロドロイドを実行するための前提条件を確認します。

boolean switchUser (int userId)

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

boolean switchUser (int userId, long timeout)

指定されたタイムアウトを期限として別の userId に切り替えます。

Bugreport takeBugreport ()

バグレポートを取得し、バグレポートを処理するためにBugreportオブジェクト内に返します。

String uninstallPackage (String packageName)

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

String uninstallPackageForUser (String packageName, int userId)

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

保護されたメソッド

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

adb の再起動を実行します。

InputStreamSource getBugreportInternal ()
File getBugreportzInternal ()

bugreportz zip ファイルをERROR(/File)として取得する内部ヘルパー メソッド。

long getCheckNewUserSleep ()

テストのために露出しました。

long getHostCurrentTime ()

テストのために暴露された

void prePostBootSetup ()

各デバイス タイプ (AndroidNativeDevice、TestDevice) が特定の起動後のセットアップ用にこのメソッドをオーバーライドできるようにします。

田畑

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

キーガードを解除するために使用できるコマンド。

パブリックコンストラクター

テストデバイス

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

パブリックメソッド

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

戻り値
boolean

投げる
DeviceNotAvailableException

クリアエラーダイアログ

public boolean clearErrorDialogs ()

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

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

投げる
DeviceNotAvailableException

ユーザーを作成

public int createUser (String name)

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

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

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

投げる
DeviceNotAvailableException

ユーザーを作成

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

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

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

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

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

forTesting boolean : 作成時にテスト フラグ --for-testing を有効にします

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

投げる
DeviceNotAvailableException

ユーザーを作成

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

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

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

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

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

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

投げる
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

投げる
DeviceNotAvailableException

キーガードを無効にする

public void disableKeyguard ()

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

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

投げる
DeviceNotAvailableException

ファイルが存在しますか

public boolean doesFileExist (String deviceFilePath)

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

パラメーター
deviceFilePath String : チェックするデバイス上のファイルの絶対パス

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

投げる
DeviceNotAvailableException

ファイルが存在しますか

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

パラメーター
deviceFilePath String : チェックするデバイス上のファイルの絶対パス

userId int : ファイルの存在をチェックするユーザー ID

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

投げる
DeviceNotAvailableException

ダンプヒープ

public File dumpHeap (String process, 
                String devicePath)

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

パラメーター
process String : ダンプヒープを作成するデバイス プロセスの名前。

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

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

投げる
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

投げる
DeviceNotAvailableException

すべての設定を取得

public  getAllSettings (String namespace)

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

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

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

投げる
DeviceNotAvailableException

AndroidIdを取得する

public String getAndroidId (int userId)

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

パラメーター
userId int

戻り値
String

投げる
DeviceNotAvailableException

AndroidID を取得する

public  getAndroidIds ()

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

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

投げる
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

パラメーター
packageName String

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

投げる
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

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

投げる
DeviceNotAvailableException

getバグレポート

public InputStreamSource getBugreport ()

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

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

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

getバグレポルツ

public InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

戻り値
DeviceFoldableState

投げる
DeviceNotAvailableException

現在のユーザーを取得

public int getCurrentUser ()

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

戻り値
int

投げる
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

戻り値

投げる
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

投げる
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

投げる
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

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

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

投げる
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

投げる
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

投げる
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

投げる
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

投げる
DeviceNotAvailableException

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

public InputStreamSource getScreenshot ()

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

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

投げる
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

rescale boolean : 結果の画像のサイズを減らすためにスクリーンショットを再スケールする必要があるかどうか

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

投げる
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (String format)

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

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

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

投げる
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

投げる
DeviceNotAvailableException

設定の取得

public String getSetting (String namespace, 
                String key)

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

パラメーター
namespace String

key String

戻り値
String

投げる
DeviceNotAvailableException

設定の取得

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

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

パラメーター
userId int

namespace String

key String

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

投げる
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

投げる
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

ユーザー情報の取得

public  getUserInfos ()

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

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

投げる
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

パラメーター
userId int

戻り値
int

投げる
DeviceNotAvailableException

機能あり

public boolean hasFeature (String feature)

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

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

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

投げる
DeviceNotAvailableException

インストールパッケージ

public 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 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

インストールパッケージ

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

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

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

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

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

reinstall boolean : インストール時にすべての実行時権限を付与する必要があるかどうか

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

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

投げる
DeviceNotAvailableException

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

public 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

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

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

パラメーター
packageFiles

reinstall boolean

extraArgs String

戻り値
String

投げる
DeviceNotAvailableException

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

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

パラメーター
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

戻り値
String

投げる
DeviceNotAvailableException

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

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

パラメーター
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

戻り値
String

投げる
DeviceNotAvailableException

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

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

パラメーター
packageFiles

reinstall boolean

userId int

extraArgs String

戻り値
String

投げる
DeviceNotAvailableException

installRemotePackages

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

パラメーター
remoteApkPaths

reinstall boolean

extraArgs String

戻り値
String

投げる
DeviceNotAvailableException

installRemotePackages

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

パラメーター
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

戻り値
String

投げる
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

デバイス上のプラットフォームがアプリの列挙をサポートしているかどうかを確認する

戻り値
booleanアプリの列挙がサポートされている場合は true、そうでない場合は false

投げる
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

戻り値
boolean

投げる
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

戻り値
boolean

投げる
DeviceNotAvailableException

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

public boolean isMultiUserSupported ()

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

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

投げる
DeviceNotAvailableException

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

public boolean isPackageInstalled (String packageName)

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

パラメーター
packageName String

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

投げる
DeviceNotAvailableException

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

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

投げる
DeviceNotAvailableException

ユーザーが実行中です

public boolean isUserRunning (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

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

パラメーター
userId int

戻り値
boolean

投げる
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

パラメーター
userId int

displayId int

戻り値
boolean

投げる
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

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

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

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

戻り値
boolean

投げる
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

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

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

投げる
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

戻り値

投げる
DeviceNotAvailableException

ユーザーのリスト

public  listUsers ()

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

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

投げる
DeviceNotAvailableException

ログバグレポート

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

パラメーター
dataName String : バグレポートが報告される名前。

listener ITestLogger : バグレポートを記録するためのITestLogger

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

post呼び出しTearDown

public void postInvocationTearDown (Throwable exception)

デバイス固有の必要なクリーンアップの追加手順は、呼び出しの完了後に実行されます。

パラメーター
exception Throwable : 呼び出し失敗によって発生した最後の例外 (存在する場合)。

管理者の削除

public boolean removeAdmin (String componentName, 
                int userId)

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

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

userId int : デバイス管理者が所属するユーザー。

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

投げる
DeviceNotAvailableException

所有者を削除する

public void removeOwners ()

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

投げる
DeviceNotAvailableException

ユーザーの削除

public boolean removeUser (int userId)

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

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

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

投げる
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

投げる
DeviceNotAvailableException

セット設定

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

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

パラメーター
namespace String

key String

value String

投げる
DeviceNotAvailableException

セット設定

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

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

パラメーター
userId int

namespace String

key String

value String

投げる
DeviceNotAvailableException

シャットダウンマイクロドロイド

public void shutdownMicrodroid (ITestDevice microdroidDevice)

microdroid デバイスが存在する場合は、それをシャットダウンします。

パラメーター
microdroidDevice ITestDevice

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

スタートユーザー

public boolean startUser (int userId)

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

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

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

投げる
DeviceNotAvailableException

スタートユーザー

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

投げる
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

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

displayId int : ユーザーに表示される開始位置を表示します。

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

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

投げる
DeviceNotAvailableException

停止ユーザー

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

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

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

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

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

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

投げる
DeviceNotAvailableException

停止ユーザー

public boolean stopUser (int userId)

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

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

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

投げる
DeviceNotAvailableException

マイクロドロイドをサポート

public boolean supportsMicrodroid ()

マイクロドロイドを実行するための前提条件を確認します。

戻り値
boolean前提条件が満たされている場合は true を返し、そうでない場合は false を返します。

マイクロドロイドをサポート

public boolean supportsMicrodroid (boolean protectedVm)

マイクロドロイドを実行するための前提条件を確認します。

パラメーター
protectedVm boolean : microdroid が保護された VM 上で実行されることを目的としている場合は true。

戻り値
boolean前提条件が満たされている場合は true を返し、そうでない場合は false を返します。

スイッチユーザー

public boolean switchUser (int userId)

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

パラメーター
userId int

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

投げる
DeviceNotAvailableException

スイッチユーザー

public boolean switchUser (int userId, 
                long timeout)

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

パラメーター
userId int

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

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

投げる
DeviceNotAvailableException

テイクバグレポート

public Bugreport takeBugreport ()

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

戻り値
Bugreport

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

public String uninstallPackage (String packageName)

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

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

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

投げる
DeviceNotAvailableException

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

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

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

投げる
DeviceNotAvailableException

保護されたメソッド

パーサーの作成

protected AaptParser createParser (File appFile)

パラメーター
appFile File

戻り値
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

adb の再起動を実行します。

パラメーター
rebootMode NativeDevice.RebootMode : この再起動のモード。

reason String : 今回の再起動用。

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

getバグレポート内部

protected InputStreamSource getBugreportInternal ()

戻り値
InputStreamSource

getBugreportz内部

protected File getBugreportzInternal ()

bugreportz zip ファイルをERROR(/File)として取得する内部ヘルパー メソッド。

戻り値
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

テストのために露出しました。

戻り値
long

getホスト現在時刻

protected long getHostCurrentTime ()

テストのために暴露された

戻り値
long

ブート後のセットアップ

protected void prePostBootSetup ()

各デバイス タイプ (AndroidNativeDevice、TestDevice) が特定の起動後のセットアップ用にこのメソッドをオーバーライドできるようにします。

投げる
DeviceNotAvailableException