Подготовители целей вызываются перед тестами на уровне тестирования, на котором они определены. Это позволяет без проблем настроить любое устройство для тестов.
Базовый интерфейс
Базовым интерфейсом является ITargetPreparer , который позволяет реализовать метод setUp , который будет выполняться. Мы рекомендуем реализовать наш базовый абстрактный класс BaseTargetPreparer , который предоставляет встроенную функцию отключения, позволяющую легко отключить средство подготовки.
Более чистый интерфейс
Естественным расширением setUp является tearDown , и оно предоставляется другим интерфейсом ITargetCleaner . Это обеспечивает интерфейс tearDown , который позволяет очистить все, что было сделано в setUp после выполнения теста.
Класс BaseTargetPreparer также расширяет ITargetCleaner .
Рекомендации
Мы рекомендуем, чтобы каждый преобразователь ограничивался одной основной функцией, например, установкой APK или запуском команды. Это позволяет упростить повторное использование препараторов.
Вы также должны проверить список доступных препараторов перед добавлением нового, чтобы избежать дублирования работы. Подготовители доступны в 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>
Также см. Suite Setup для контекста.
Настройка верхнего уровня
Если указано в настройке верхнего уровня, подготовка будет запущена только один раз для каждого устройства. Примером может служить cts-common.xml , который представляет собой настройку верхнего уровня для тестов Android Compatibility Test Suite (CTS).
Настройка на уровне модуля
Если указан на уровне модуля, подготовка всегда будет выполняться перед этим модулем. Примером может служить backup/AndroidTest.xml , который определяет, как Tradefed запускает модуль backup CTS.
Обратите внимание, что хотя программа подготовки запускается перед модулем, она запускается после любых средств проверки состояния системы .