Template dan menyertakan dalam konfigurasi XML Tradefed

Membuat satu konfigurasi XML monolitik untuk menentukan pengujian tidak selalu praktis. Jika ingin menggunakan kembali bagian penyiapan untuk menjalankan pengujian serupa, Anda akan terpaksa menyalin dan mengelola dua file XML besar.

Di sinilah tag template dan include dalam definisi Konfigurasi XML Tradefed berguna. Class ini memungkinkan Anda menetapkan placeholder dalam beberapa konfigurasi XML untuk menambahkan bagian dari konfigurasi XML lain.

Contoh definisi untuk template

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

Template adalah placeholder dengan name untuk mereferensikannya, dan kolom default opsional. Kolom default menentukan XML penggantian default yang harus digunakan.

Untuk mengganti template untuk konfigurasi tertentu, parameter perintah berikut harus ditambahkan ke command line:

--template:map <name of template>=<replacement XML config path>

--template:map preparers=empty

Contoh:

<template-include name="preparers" default="empty" />

Referensi empty dalam hal ini mengacu pada konfigurasi empty.xml yang tidak berisi apa pun; kita menggunakannya sebagai referensi untuk mengganti dengan apa pun.

Jalur konfigurasi XML dapat bersifat absolut atau relatif terhadap folder res/config di dalam resource JAR Tradefed. Berikut beberapa lokasinya:

  • tools/tradefederation/core/res/config
  • tools/tradefederation/core/tests/res/config
  • tools/tradedeferation/contrib/res/config

Contoh definisi include

<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 Template karena tidak memerlukan argumen command line; penyertaan langsung memperluas XML yang direferensikan dalam tag name. Serupa dengan template, jalur ke konfigurasi dapat bersifat absolut atau relatif. Namun, untuk includes, sebaiknya hanya gunakan jalur relatif karena lebih portabel di Tradefed. Jalur absolut tidak akan valid jika Tradefed dipindahkan ke mesin lain.

Kesalahan konfigurasi

Jika terjadi kesalahan konfigurasi, seperti saat XML pengganti tidak dapat ditemukan, Tradefed akan menampilkan ConfigurationException dengan deskripsi tentang apa yang tampaknya hilang atau salah dikonfigurasi.