Общая структура конфигурации 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-файл, содержащий класс, находится в пути к классам Tradefed Java при запуске, он будет найден и разрешен.

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

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

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