ターゲット作成ツール

ターゲット作成ツールは、ツールが定義されているテストレベルのテストの前に呼び出されます。そのため、テストを実施する任意のデバイスをスムーズに設定できます。

ベース インターフェース

ベース インターフェースは 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 モジュールをどのように実行するかを定義します。

ターゲット作成ツールはモジュールの前に実行されますが、システム ステータス チェッカーの後に実行されることに注意してください。