Membuat satu konfigurasi XML monolitik untuk mendefinisikan pengujian tidak selalu praktis. Jika Anda ingin menggunakan kembali bagian dari pengaturan untuk menjalankan tes serupa, Anda akan dipaksa untuk menyalin dan memelihara dua file XML raksasa.
Di sinilah template dan tag include dalam definisi Konfigurasi XML Tradefed berguna. Mereka memungkinkan Anda menyetel placeholder di beberapa konfigurasi XML untuk menambahkan bagian dari konfigurasi XML lainnya.
Contoh definisi untuk templat
<configuration description="Common base configuration for local runs with minimum overhead">
<build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />
<template-include name="preparers" default="empty" />
<template-include name="test" default="empty" />
<template-include name="reporters" default="empty" />
</configuration>
Templat adalah tempat penampung dengan name untuk mereferensikannya, dan bidang default opsional. Bidang default mendefinisikan XML pengganti default yang harus digunakan.
Untuk mengganti templat untuk konfigurasi tertentu, parameter perintah berikut perlu ditambahkan ke baris perintah:
--template:map <name of template>=<replacement XML config path>
--template:map preparers=empty
Misalnya:
<template-include name="preparers" default="empty" />
Referensi empty dalam hal ini mengacu pada konfigurasi empty.xml yang tidak berisi apa pun; kami menggunakannya sebagai referensi kami untuk mengganti dengan apa pun .
Jalur konfigurasi XML bisa absolut atau relatif terhadap folder res/config di dalam sumber daya JAR Tradefed. Berikut beberapa lokasinya:
- alat/federasi dagang/inti/res/config
- alat/federasi dagang/inti/tes/res/config
- tools/tradedeferation/kontribusi/res/config
Contoh definisi termasuk
<configuration description="Common base configuration for local runs with minimum overhead">
<build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />
<include name="empty"/>
</configuration>
Penyertaan lebih sederhana daripada Templat karena tidak memerlukan argumen baris perintah; mereka secara langsung memperluas XML yang direferensikan di tag name . Mirip dengan templat, jalur ke konfigurasi bisa bersifat absolut atau relatif. Namun, untuk includes , kami merekomendasikan hanya menggunakan jalur relatif karena lebih portabel di Tradefed. Jalur absolut tidak akan valid jika Tradefed dipindahkan ke komputer lain.
Kesalahan konfigurasi
Jika terjadi kesalahan konfigurasi, seperti ketika XML pengganti tidak dapat ditemukan, Tradefed akan memunculkan ConfigurationException dengan deskripsi tentang apa yang tampaknya hilang atau salah dikonfigurasi.