Целевые средства подготовки вызываются перед тестами на том уровне тестирования , на котором они определены. Это позволяет без проблем настроить любое устройство для проведения тестов.
Базовый интерфейс
Базовый интерфейс — 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>
Также обратитесь к разделу «Настройка наборов» для получения контекста.
Настройка верхнего уровня
Если это указано в настройке верхнего уровня, средство подготовки запускается только один раз для каждого устройства. Примером может служить cts-common.xml
, который представляет собой настройку верхнего уровня для тестов пакета тестов совместимости Android (CTS).
Настройка на уровне модуля
Если указано на уровне модуля, средство подготовки всегда запускается перед этим модулем. Примером является backup/AndroidTest.xml
, который определяет, как Tradefed запускает backup
модуль CTS.
Обратите внимание: хотя программа подготовки запускается до модуля, она запускается после всех проверок состояния системы .