Ogólna struktura konfiguracji XML Tradefed

Konfiguracje Tradefed mają strukturę XML, która opisuje test do uruchomienia oraz czynności przygotowawcze i konfiguracyjne do wykonania.

Teoretycznie wszystko można zdefiniować w pliku XML dla jednego polecenia. W praktyce wygodniej jest jednak mieć podstawowe pliki XML szablonu i dostosowywać je za pomocą 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>

Ogólny plik XML Tradefed jest rozdzielony tagami <configuration>. Tradefed objects są zdefiniowane w osobnych tagach, np. build_provider, target_preparer, test itp. Ich poszczególne zastosowania są bardziej szczegółowo opisane w sekcji Architektura.

Każdy obiekt ma powiązaną z nim klasę Java zdefiniowaną w class=, która jest rozpoznawana w czasie działania. Jeśli więc plik JAR zawierający klasę znajduje się w ścieżce klas Java Tradefed podczas działania, zostanie znaleziony i rozpoznany.

Kolejność obiektów Tradefed

Kolejność poszczególnych tagów nie ma znaczenia. Nie ma na przykład znaczenia, czy build_provider jest określony po target_preparer. Kolejność wywoływania testu jest wymuszana przez samą platformę, więc zawsze wywołuje ona funkcje w odpowiedniej 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. Jest to ważne, ponieważ może zmienić stan końcowy konfiguracji urządzenia. Na przykład wgranie, a potem zainstalowanie pliku APK nie jest tym samym co zainstalowanie pliku APK, a potem wgranie, ponieważ wgranie spowoduje wyczyszczenie urządzenia.