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.