Высокоуровневая структура конфигурации Tradefed XML

Конфигурации Tradefed используют XML-структуру для описания запускаемого теста и необходимых подготовительных/настроечных действий.

Теоретически, все параметры можно определить в XML-файле для одной команды. Но на практике удобнее иметь базовые шаблоны XML-файлов и настраивать их с помощью дополнительных параметров командной строки.

Структура

<configuration description="<description of the configuration>">
    <!-- A build provider that takes local device information -->
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <!-- Some target preparation, disabled by default -->
    <target_preparer class="com.android.tradefed.targetprep.PreloadedClassesPreparer">
        <option name="disable" value="true" />
    </target_preparer>

    <!-- One test running some unit tests -->
    <test class="com.android.tradefed.testtype.HostTest">
        <option name="class" value="com.android.tradefed.build.BuildInfoTest" />
    </test>

    <!-- [OPTIONAL] -->
    <logger class="com.android.tradefed.log.FileLogger">
        <option name="log-level" value="VERBOSE" />
        <option name="log-level-display" value="VERBOSE" />
    </logger>

    <!-- [OPTIONAL] -->
    <log_saver class="com.android.tradefed.result.FileSystemLogSaver" />

    <!-- As many reporters as we want -->
    <result_reporter class="com.android.tradefed.result.ConsoleResultReporter" />
    <result_reporter class="com.android.tradefed.result.suite.SuiteResultReporter" />
    <result_reporter class="com.android.tradefed.result.MetricsXMLResultReporter"/>
</configuration>

Общий XML-код Tradefed ограничен тегами <configuration> . Tradefed objects определены в собственных тегах, например: build_provider , target_preparer , test и т. д. Их индивидуальное назначение более подробно описано в разделе «Архитектура» .

Каждый объект имеет связанный с ним Java-класс, определенный в class= , который разрешается во время выполнения; поэтому, если JAR-файл, содержащий класс, находится в пути поиска Java-классов Tradefed во время выполнения, он будет найден и разрешен.

Заказы объектов Tradefed

Порядок различных тегов не имеет значения. Например, не имеет значения, указан ли build_provider после target_preparer . Последовательность вызова тестов обеспечивается самим тестовым модулем, поэтому он всегда будет вызывать их в правильном порядке.

Порядок объектов с одинаковым тегом имеет значение . Например, два определенных объекта target_preparer будут вызываться в порядке их определения в XML. Важно понимать это, поскольку это может изменить конечное состояние настройки устройства. Например, прошивка, а затем установка APK-файла не будут тем же самым, что установка APK-файла и прошивка, поскольку прошивка приведет к удалению данных с устройства.