Criar uma configuração XML monolítica para definir um teste nem sempre é prático. Se você quiser reutilizar parte da configuração para executar testes semelhantes, será forçado a copiar e manter dois arquivos XML gigantes.
É aqui que as tags template e include na definição de configuração XML do Tradefed
são úteis. Eles permitem definir marcadores de posição em algumas configurações
XML para adicionar parte de outra configuração XML.
Exemplo de definição de modelos
<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>
Os modelos são marcadores de posição com um name para referenciá-los e um campo default opcional. O campo padrão define o XML de substituição padrão que
deve ser usado.
Para substituir um modelo de uma determinada configuração, o seguinte parâmetro de comando precisa ser adicionado à linha de comando:
--template:map <name of template>=<replacement XML config path>
--template:map preparers=empty
Exemplo:
<template-include name="preparers" default="empty" />
A referência empty, nesse caso, se refere à configuração empty.xml que
não contém nada. Usamos essa referência para substituir por nada.
O caminho das configurações XML pode ser absoluto ou relativo à pasta res/config
dentro dos recursos JAR do Tradefed. Confira alguns locais:
- tools/tradefederation/core/res/config
- tools/tradefederation/core/tests/res/config
- tools/tradedeferation/contrib/res/config
Exemplo de definição de inclui
<configuration description="Common base configuration for local runs with minimum overhead">
<build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />
<include name="empty"/>
</configuration>
Os includes são mais simples que os modelos, porque não exigem argumentos de linha de comando.
Eles expandem diretamente o XML referenciado na tag name. Assim como os modelos,
o caminho para a configuração pode ser absoluto ou relativo. Ainda assim, para includes, recomendamos
usar apenas caminhos relativos, porque eles são mais portáteis no Tradefed.
Os caminhos absolutos não seriam válidos se o Tradefed fosse movido para outra máquina.
Configuração incorreta
Em caso de configuração incorreta, como quando o XML de substituição não pode ser encontrado,
o Tradefed gera um ConfigurationException com a descrição do que parece
estar ausente ou configurado incorretamente.