ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

既知の間接的なサブクラス AdbStopServerPreparer adb テストの実行前後にホスト上の adb サーバーを停止するターゲット作成ツール。  AllTestAppsInstallSetup ITargetPreparer: すべてのアプリを IDeviceBuildInfo#getTestsDir() フォルダからデバイスにインストールします。  AoaTargetPreparer ITargetPreparer: Android Open Accessory（AOAv2）プロトコルを使用して一連のアクション（クリックやスワイプなど）を実行します。  AppSetup APK とそのテストをインストールする ITargetPreparer。  ArtChrootPreparer ART テスト用の chroot ディレクトリを作成。  BaseEmulatorPreparer ローカル エミュレータを起動するための一般的な作成ツール。  BaseTargetPreparer オブジェクトを無効にするかどうかを制御できる ITargetPreparer の基本実装クラス。  BuildInfoRecorder ビルド情報メタデータを指定されたファイルに書き込む ITargetPreparer。  CheckPairingPreparer CompanionAwarePreparer: プライマリ デバイスとコンパニオン デバイス間の BT ボンディングを検証する 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。  デバイス クリーナー テスト後にクリーンアップ アクションとして再起動またはフォーマットを実行し、必要に応じて画面をオフにします DeviceFlashPreparer 物理的な Android ハードウェアにイメージを書き込む ITargetPreparer。  DeviceImageZipFlashingTargetPreparer 特定の形式で提供されるデバイス イメージをデバイスに書き込むターゲット作成ツール。  DeviceOwnerTargetPreparer デバイス オーナー コンポーネントを設定する ITargetPreparer。  DeviceSetup 指定された Option に基づいてテスト用のデバイスを設定する ITargetPreparer。  DeviceStorageFiller ストレージを使い切って、一定の空き容量を確保するようにターゲット作成ツールを設定します。  DeviceStringPusher 文字列をファイルに書き込むターゲット作成ツール。  DeviceUpdateTargetPreparer 抽象的な ITargetPreparer。ビルドサービスではなく、外部ソースからデバイス イメージ ファイルを使用してデバイスを更新する際の一般的な手順を処理します。  DeviceWiper ユーザーデータをワイプする ITargetPreparer SELinuxTargetPreparer を無効にする SELinux を無効にするターゲット作成ツール（有効になっている場合）。  DynamicSystemPreparer Dynamic System Update を使用してデバイスビルドの上にシステム イメージを設定する ITargetPreparer。  EraseUserDataPreparer デバイスのユーザーデータをワイプする ITargetPreparer。  FastbootCommandPreparer fastboot をトリガーして fastboot コマンドを送信するターゲット作成ツール。  FastbootUpdateBootstrapPreparer 指定したファイル（ブートローダー、無線通信、デバイス イメージ zip）を IDeviceBuildInfo にステージングして FastbootDeviceFlasher でデバイスをフラッシュし、結果レポート用に起動後のデバイス属性をビルド情報に挿入する ITargetPreparer。  FeatureFlagTargetPreparer DeviceConfig（リモート サービスによって調整された機能フラグ）を更新します。  FoldableModePreparer デバイスの折りたたみ状態を切り替えることができるターゲット作成ツール。  フォルダセーバー ITargetPreparer: ディレクトリをデバイスから pull し、圧縮してロギング バックエンドに保存します。  GkiDeviceFlashPreparer Android 共通カーネルの汎用イメージでデバイスをフラッシュするターゲット作成ツール。  GsiDeviceFlashPreparer デバイスに Android Generic System Image を書き込むターゲット作成ツール。  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 つ以上のファイル/ディレクトリをデバイスにプッシュする ITargetPreparer。  TestSystemAppInstallSetup ITargetPreparer: IDeviceBuildInfo.getTestsDir() フォルダからデバイスの /system パーティションに 1 つ以上のアプリをインストールします。  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	デバイスが応答しなくなった場合