Crear una configuración XML monolítica para definir una prueba no siempre es práctico. Si quieres volver a usar parte de la configuración para ejecutar pruebas similares, se vería obligado a copiar y mantener dos archivos XML gigantes.
Aquí es donde las etiquetas template y include en la definición de configuración XML de Tradefed resultan útiles. Te permiten establecer marcadores de posición en algunos archivos
para agregar parte de otra configuración XML.
Ejemplo de definición para plantillas
<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>
Las plantillas son marcadores de posición con un name para hacer referencia a ellas y un elemento
default. El campo predeterminado define el XML de reemplazo predeterminado que se debe usar.
Para reemplazar una plantilla por una configuración determinada, se debe agregar el siguiente parámetro de comando a la línea de comandos:
--template:map <name of template>=<replacement XML config path>
--template:map preparers=empty
Por ejemplo:
<template-include name="preparers" default="empty" />
La referencia empty en este caso hace referencia a la configuración de empty.xml que no contiene nada. La usamos como referencia para reemplazar por nada.
La ruta de acceso de las configuraciones XML puede ser absoluta o relativa a la carpeta res/config dentro de los recursos JAR de Tradefed. Estas son algunas de sus ubicaciones:
- tools/tradefederation/core/res/config
- tools/tradefederation/core/tests/res/config
- tools/tradedeferation/contrib/res/config
Definición de ejemplo de inclusiones
<configuration description="Common base configuration for local runs with minimum overhead">
<build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />
<include name="empty"/>
</configuration>
Las inclusiones son más simples que las plantillas, ya que no requieren argumentos de línea de comandos.
estos expanden directamente el XML al que se hace referencia en la etiqueta name. Al igual que las plantillas,
la ruta de acceso a la configuración puede ser absoluta o relativa. De todos modos, por includes
se recomienda usar solo rutas relativas, ya que son más portátiles en Tradefed.
Las rutas absolutas no serían válidas si Tradefed se trasladara a otra máquina.
Configuración incorrecta
En caso de configuración incorrecta, como cuando no se puede encontrar el XML de reemplazo, Tradefed arrojará un ConfigurationException con la descripción de lo que parece faltar o está mal configurado.