Struktur tingkat tinggi dari konfigurasi XML Tradefed

Konfigurasi Tradefed mengikuti struktur XML untuk menjelaskan pengujian yang akan dijalankan dan langkah persiapan/penyiapan yang harus dilakukan.

Secara teori, semuanya dapat didefinisikan dalam XML untuk satu perintah. Namun dalam praktiknya, lebih praktis untuk memiliki file XML template dasar dan menyesuaikannya dengan parameter baris perintah tambahan.

Struktur

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

Keseluruhan Tradefed XML dibatasi oleh <configuration> . Tradefed objects yang diperdagangkan didefinisikan dalam tagnya sendiri, misalnya: build_provider , target_preparer , test , dll. Tujuan masing-masing objek dijelaskan secara lebih rinci di bagian Arsitektur .

Setiap objek memiliki kelas Java yang terkait dengan objek yang didefinisikan dalam class= yang diselesaikan saat runtime; jadi selama file JAR yang berisi kelas berada di classpath Java Tradefed saat dijalankan, itu akan ditemukan dan diselesaikan.

Pesanan objek Tradefed

Urutan tag yang berbeda tidak masalah. Misalnya, tidak ada bedanya jika build_provider ditentukan setelah target_preparer . Alur pemanggilan tes ditegakkan oleh harness itu sendiri, sehingga akan selalu memanggilnya dalam urutan yang benar.

Urutan objek dengan tag yang sama memang penting . Misalnya, dua objek target_preparer yang ditentukan akan dipanggil dalam urutan definisinya dalam XML. Penting untuk memahami hal ini karena dapat mengubah status akhir pengaturan perangkat. Misalnya, mem- flash lalu menginstal apk tidak akan sama dengan menginstal apk dan mem-flash karena mem-flash akan menghapus perangkat.