ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
AdbStopServerPreparer adb テストの実行前後にホストで adb サーバーを停止するようにターゲット準備ツールを変更。 
AllTestAppsInstallSetup IDeviceBuildInfo.getTestsDir() フォルダ内のすべてのアプリをデバイスにインストールする ITargetPreparer。 
AoaTargetPreparer ITargetPreparer: Android Open Accessory(AOAv2)プロトコルを使用して一連のアクション(クリックやスワイプなど)を実行します。 
AppSetup apk とそのテストをインストールする ITargetPreparer。 
ArtChrootPreparer ART テスト用の chroot ディレクトリを作成。 
BaseEmulatorPreparer ローカル エミュレータを起動するための一般的な準備ツール。 
BaseTargetPreparer オブジェクトの無効化の有無を制御できる ITargetPreparer の基本実装クラス。 
BuildInfoRecorder ビルド情報メタデータを指定されたファイルに書き込む ITargetPreparer。 
CheckPairingPreparer プライマリ デバイスとコンパニオン デバイス間の BT ボンディングを確認する CompanionAwarePreparer
CompanionAllocator コンパニオン デバイスの割り当てと解放を行う基本クラス

getCompanionDeviceSelectionOptions() を実装して、コンパニオン デバイスの割り当てに必要な条件を記述する必要があります。

CompanionAwarePreparer すでに割り振られているコンパニオン デバイスを取得するロジックをカプセル化する ITargetPreparer。 
CompanionRunCommandTargetPreparer 割り当てられたコンパニオン デバイスで指定されたコマンドを実行する ITargetPreparer
CompanionTestAppInstallSetup IDeviceBuildInfo.getTestsDir() フォルダから割り当てられたコンパニオン デバイスに 1 つ以上のアプリをインストールする ITargetPreparer。 
CompileBootImageWithSpeedTargetPreparer コンパイラ フィルタ「speed」を使用して、ブート クラスパスとシステム サーバーを再コンパイルします。 
CpuThrottlingWaiter すべてのコアの最大周波数が利用可能な最高レベルに復元されるまで待機する ITargetPreparer
CreateAvdPreparer  
CreateUserPreparer ユーザーの作成と終了時のクリーンアップを行うターゲット作成ツール。 
DeviceActionTargetPreparer デバイス アクションを実行するための ITargetPreparer。 
DeviceBuildInfoBootStrapper ビルド情報フィールドをデバイスから読み取った属性に置き換える ITargetPreparer

これは、外部ソースから生成されたビルドでデバイスをテストする場合に便利です。

DeviceBuildInfoInjector DeviceBuildDescriptor メタデータを IBuildInfo に挿入する ITargetPreparer。 
DeviceCleaner テスト後にクリーンアップ アクションとして再起動またはフォーマットを実行し、必要に応じて画面をオフにします
DeviceFlashPreparer 物理的な Android ハードウェアにイメージを書き込む ITargetPreparer。 
DeviceImageZipFlashingTargetPreparer 特定の形式で提供されたデバイス イメージを使用してデバイスをフラッシュするターゲット作成ツール。 
DeviceOwnerTargetPreparer デバイス オーナー コンポーネントを設定する ITargetPreparer。 
DeviceSetup 指定された Option に基づいてテスト用のデバイスを構成する ITargetPreparer。 
DeviceStorageFiller ストレージを使い切って、一定の空き容量を確保するようにターゲット作成ツールを設定します。 
DeviceStringPusher 文字列をファイルに書き込むターゲット作成ツール。 
DeviceUpdateTargetPreparer 抽象的な ITargetPreparer。ビルドサービスではなく、外部ソースからデバイス イメージ ファイルを使用してデバイスを更新する際の一般的な手順を処理します。 
DeviceWiper ユーザーデータをワイプする ITargetPreparer
DisableSELinuxTargetPreparer SELinux が有効になっている場合は無効にするターゲット プレパレーター。 
DynamicSystemPreparer Dynamic System Update を使用してデバイスビルドの上にシステム イメージを設定する ITargetPreparer。 
EraseUserDataPreparer デバイス上のユーザーデータをワイプする ITargetPreparer。 
FastbootCommandPreparer fastboot をトリガーして fastboot コマンドを送信するターゲット作成ツール。 
FastbootUpdateBootstrapPreparer 指定したファイル(ブートローダー、無線通信、デバイス イメージ zip)を IDeviceBuildInfo にステージングして FastbootDeviceFlasher でデバイスをフラッシュし、結果レポート用に起動後のデバイス属性をビルド情報に挿入する ITargetPreparer。 
FeatureFlagTargetPreparer DeviceConfig(リモート サービスによって調整された機能フラグ)を更新します。 
FoldableModePreparer デバイスの折りたたみ状態を切り替えることができるターゲット作成ツール。 
FolderSaver デバイスからディレクトリを取得し、圧縮してロギング バックエンドに保存する ITargetPreparer。 
GkiDeviceFlashPreparer Android 共通カーネルの汎用イメージでデバイスをフラッシュするターゲット作成ツール。 
GsiDeviceFlashPreparer Android 汎用システム イメージを使用してデバイスに書き込むターゲット作成ツール。 
ILabPreparer ラボ準備担当者向けのマーカー インターフェース

これらのインターフェースの目的については、ITargetPreparer をご覧ください。 

ITargetCleaner このインターフェースは非推奨になりました。 tearDown がベースの ITargetPreparer インターフェースに移動されました。 
InstallAllTestZipAppsSetup テスト ZIP 内のすべてのアプリをインストールする ITargetPreparer。 
InstallApexModuleTargetPreparer  
InstallApkSetup ファイル システムにある 1 つ以上の APK をインストールする ITargetPreparer。 
InstallBuildEnvApkSetup Android プラットフォームのビルド環境から 1 つ以上のテスト APK をインストールする ITargetPreparer。 
InstallKernelModulePreparer カーネル モジュールをインストールするターゲット作成ツール。 
InstrumentationPreparer 計測を実行する ITargetPreparer
KillExistingEmulatorPreparer 実行中のエミュレータをシャットダウンする ITargetPreparer。 
KnownFailurePreparer 既知の障害の再試行をスキップするようにターゲット準備ツールを設定。 
LocalEmulatorLaunch Android ビルド環境からローカルでエミュレータを起動する TargetPreparer。 
LocalEmulatorSnapshot Android のビルド環境または開発環境からクリーンなエミュレータ スナップショットを生成するための TargetPreparer です。
MixKernelTargetPreparer カーネル イメージとデバイス イメージを混在させることができる ITargetPreparer。 
ModuleOemTargetPreparer  
NativeLeakCollector 「dumpsys meminfo --unreachable -a」を実行して、各プロセスが現在保持している到達不能なネイティブ メモリを特定する ITargetPreparer。 
NoApkTestSkipper テストする APK がない場合に、呼び出し(準備とテスト)を完全にスキップできる特別な準備ツール。 
PerfettoPreparer Perfetto 準備ツールは、Perfetto がアクセスできる標準の場所にあるデバイスに構成ファイルを push します。 
ProfileTargetPreparer 任意のプロファイル ユーザー android.os.usertype.profile.XXX のターゲット準備ツールを設定するベースクラス。 
PushFileInvoker このクラスは非推奨になりました。 代わりに PushFilePreparer を使用してください
PushFilePreparer 任意のホストパスから任意のデバイスパスに任意の数のファイルを push しようとする ITargetPreparer。 
PythonVirtualenvPreparer ホストに Python virtualenv を設定し、パッケージをインストールします。 
RebootTargetPreparer デバイスを再起動するターゲット プレパレーター。 
RecoveryLogPreparer リカバリ前にログを収集するために使用されるターゲット準備ツール。 
RemoveSystemAppPreparer テスト実行前にシステム パーティションから APK を削除するための ITargetPreparer。 
RestartSystemServerTargetPreparer デバイスを再起動せずにシステム サーバーを再起動するターゲット プレパレーター。 
RootTargetPreparer オプション「force-root」に基づいて「adb root」または「adb unroot」を実行するターゲット プレパレーター。 
RootcanalForwarderPreparer  
RunCommandTargetPreparer  
RunHostCommandTargetPreparer テストの実行前後に任意のホストコマンドを実行するターゲット準備ツール。 
RunHostScriptTargetPreparer テストの実行前にスクリプトを実行するターゲット作成ツール。 
RunOnCloneProfileTargetPreparer  
RunOnPrivateProfileTargetPreparer  
RunOnSdkSandboxTargetPreparer テストを SDK サンドボックスで実行する必要があることを示す ITargetPreparer。 
RunOnSecondaryUserTargetPreparer テストがセカンダリ ユーザーとして実行されるようにする ITargetPreparer。 
RunOnSystemUserTargetPreparer テストを(現在のユーザーではなく)ユーザーに対して実行する必要があることを示す ITargetPreparer。 
RunOnWorkProfileTargetPreparer セットアップで仕事用プロファイルを作成し、そのユーザーでテストを実行する必要があることをマークする ITargetPreparer。 
SemaphoreTokenTargetPreparer これは、トークンを使用して Tradefed ホストでテスト実行をシリアル化するのに使用される準備ツールです。 
SideloadOtaTargetPreparer 指定された OTA パッケージのサイドロードを実行し、パッケージを適用し、デバイスの起動を待機し、ビルド情報として使用するデバイスのビルド プロパティを挿入するターゲット プレパレーター。

このターゲット作成ツールは、起動時にデバイスが通常の adb モードにあることを前提としており、新しいビルドが適用された状態で、デバイスが同じモードで終了するようにします。 

StopServicesSetup デバイスでサービスを停止する ITargetPreparer。 
StubTargetPreparer ITargetPreparer の空のプレースホルダ実装。 
SuiteApkInstaller スイート構成に指定された APK をインストールします。$ANDROID_TARGET_OUT_TESTCASES 変数またはビルド情報の ROOT_DIR からインストールします。
SwitchUserTargetPreparer setUp で指定されたユーザーの種類に切り替える ITargetPreparer。 
TearDownPassThroughPreparer 構成にオブジェクトとして含まれている準備ツールで tearDown を実行できます。 
TemperatureThrottlingWaiter デバイスの温度が目標温度まで下がるまで待機する ITargetPreparer
TestAppInstallSetup IDeviceBuildInfo.getTestsDir() フォルダからデバイスに 1 つ以上のアプリをインストールする ITargetPreparer。 
TestFilePushSetup IDeviceBuildInfo.getTestsDir() フォルダからデバイスに 1 つ以上のファイルまたはディレクトリを push する ITargetPreparer。 
TestSystemAppInstallSetup IDeviceBuildInfo.getTestsDir() フォルダからデバイスの /system パーティションに 1 つ以上のアプリをインストールする ITargetPreparer。 
TimeWaster 時間の浪費やデバイスの再起動につながる可能性がある単純なターゲット作成ツール。 
UserCleaner テイクダウン時にセカンダリ ユーザーを削除する ITargetPreparer。 
VisibleBackgroundUserPreparer バックグラウンドで可視状態で開始されたユーザーでテストを実行するためのターゲット プレパレーター。 
WaitForDeviceDatetimePreparer デバイスで日時が設定されるのを待機する ITargetPreparer

必要に応じて、この準備ツールは、タイムアウト内に日時が設定されていない場合に TargetSetupError を強制的に設定できます。 

WifiPreparer 必要に応じてデバイスで Wi-Fi を構成する ITargetPreparer。 


テスト実行用のテスト環境を準備します。

たとえば、ソフトウェアのインストール、テスト用の環境設定の調整、ターゲットの起動などです。

1 つの構成で複数の ITargetPreparer を指定できます。各 ITargetPreparer は、セットアップ前とセットアップ後の想定される環境を明確に文書化することをおすすめします。たとえば、テスト用のデバイスを構成する ITargetPreparer は、ソフトウェアをインストールする ITargetPreparer の後に実行する必要があります。

概要

パブリック メソッド

default void setUp(ITestDevice device, IBuildInfo buildInfo)

このメソッドは非推奨です。 代わりに setUp(com.android.tradefed.invoker.TestInformation) を使用してください

default void setUp(TestInformation testInformation)

テスト用にターゲットのセットアップを行います。

default void tearDown(TestInformation testInformation, Throwable e)

テスト後にターゲットのクリーンアップ/テイクダウンを実行します。

default void tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)

このメソッドは非推奨です。 代わりに tearDown(com.android.tradefed.invoker.TestInformation, Throwable) を使用してください

パブリック メソッド

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

このメソッドは非推奨です。
代わりに setUp(com.android.tradefed.invoker.TestInformation) を使用してください

テスト用にターゲットのセットアップを行います。

パラメータ
device ITestDevice: 準備する ITestDevice

buildInfo IBuildInfo: テスト対象のビルドに関するデータ。

例外
TargetSetupError 環境の設定中に致命的なエラーが発生した場合
BuildError BuildInfo に関連するエラーが発生した場合
DeviceNotAvailableException デバイスが応答しなくなった場合

setUp

public void setUp (TestInformation testInformation)

テスト用にターゲットのセットアップを行います。

パラメータ
testInformation TestInformation: 呼び出しの TestInformation

例外
TargetSetupError 環境の設定中に致命的なエラーが発生した場合
BuildError ビルドの準備中にエラーが発生した場合
DeviceNotAvailableException デバイスが応答しなくなった場合

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

テスト後にターゲットのクリーンアップ/テイクダウンを実行します。

パラメータ
testInformation TestInformation: 呼び出しの TestInformation

e Throwable: 呼び出しが例外で終了した場合、これは呼び出しレベルでキャッチされた例外です。それ以外の場合は null になります。

例外
DeviceNotAvailableException デバイスが応答しなくなった場合

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

このメソッドは非推奨です。
代わりに tearDown(com.android.tradefed.invoker.TestInformation, Throwable) を使用してください

テスト後にターゲットのクリーンアップ/テイクダウンを実行します。

パラメータ
device ITestDevice: 準備する ITestDevice

buildInfo IBuildInfo: テスト対象のビルドに関するデータ。

e Throwable: 呼び出しが例外で終了した場合、これは呼び出しレベルでキャッチされた例外です。それ以外の場合は null になります。

例外
DeviceNotAvailableException デバイスが応答しなくなった場合