ターゲット作成ツールは、ツールが定義されているテストレベルのテストの前に呼び出されます。そのため、テストを実施する任意のデバイスをスムーズに設定できます。
ベース インターフェース
ベース インターフェースは ITargetPreparer
であり、実行する setUp
メソッドを実装できます。基本的な抽象クラスである BaseTargetPreparer
の実装をおすすめします。組み込まれている無効化機能により、作成ツールを簡単に無効化できます。
クリーナー インターフェース
setUp
の自然拡張は tearDown
であり、別のインターフェースの ITargetCleaner
によって提供されます。提供された tearDown
インターフェースによって、setUp
で設定した内容をテスト実施後に削除できます。
BaseTargetPreparer
クラスも ITargetCleaner
を拡張します。
おすすめ
各作成ツールは、APK のインストールやコマンドの実行など、1 つの main 関数のみに限定することをおすすめします。これによって作成ツールを再利用しやすくなります。
また、重複を避けるため、新しい作成ツールを追加する前に利用可能な作成ツールのリストを確認してください。作成ツールは tools/tradefederation/core/src/com/android/tradefed/targetprep/
からご利用いただけます。
XML 設定
オブジェクト タグは target_preparer
です。次に例を示します。
<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
<option name="install-arg" value="-d"/>
</target_preparer>
また、コンテキストについてはスイートを設定するをご覧ください。
トップレベル設定
トップレベル設定で指定したターゲット作成ツールは、各デバイスに対して 1 回のみ実行されます。たとえば、cts-common.xml
は Android 互換性テストスイート(CTS)テスト用のトップレベル設定です。
モジュール レベルの設定
モジュール レベルで指定したターゲット作成ツールは、常にそのモジュールの前に実行されます。たとえば、backup/AndroidTest.xml
は Tradefed が backup
CTS モジュールをどのように実行するかを定義します。
ターゲット作成ツールはモジュールの前に実行されますが、システム ステータス チェッカーの後に実行されることに注意してください。