Ogólna struktura konfiguracji XML Tradefed

Konfiguracje Tradefed są zgodne ze strukturą XML, która opisuje test do wykonania oraz czynności przygotowawcze i konfiguracyjne.

Teoretycznie wszystko można zdefiniować w pliku XML dla jednego polecenia. Ale w praktyk, lepiej jest mieć podstawowe pliki XML szablonu i dostosować używając dodatkowych parametrów wiersza poleceń.

Struktura

<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>

Cały plik XML Tradefed jest rozdzielany tagami <configuration>. Tradefed objects są zdefiniowane w osobnych tagach, np. build_provider, target_preparer, test itp. Indywidualne cele ich działań zostały opisane bardziej w architekturze. .

Każdy obiekt ma powiązaną klasę Java z obiektem zdefiniowanym w class=, który jest rozwiązywany w czasie wykonywania. Oznacza to, że jeśli plik JAR zawierający klasę znajduje się w czasie wykonywania na ścieżce klas Java w Tradefed, zostanie znaleziony i rozwiązany.

Zamówienia obiektów Tradefed

Kolejność różnych tagów nie ma znaczenia. Na przykład nie ma znaczenia, czy po elemencie target_preparer podano element build_provider. Sekwencja wywołania testów jest narzucana przez sam mechanizm, więc zawsze będzie on wywoływać je w prawidłowej kolejności.

Kolejność obiektów z tym samym tagiem ma znaczenie. Na przykład 2 zdefiniowane obiekty target_preparer będą wywoływane w kolejności ich definicji w pliku XML. Trzeba to zrozumieć, bo może to zmienić stan końcowy konfiguracji urządzenia. Na przykład zainstalowanie i zainstalowanie pakietu apk nie powinno jest to samo co instalowanie pakietu apk i flashowanie, ponieważ migracja wyczyści pamięć urządzenia.