Modelos e inclusões na configuração XML Tradefed

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 o template e as tags de include na definição Tradefed XML Configuration são úteis. Eles permitem que você defina espaços reservados em alguma configuração XML para adicionar parte de outra configuração XML.

Definição de exemplo para 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 espaços reservados 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 para 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

Por exemplo:

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

A referência empty neste caso refere-se à configuração empty.xml que não contém nada; nós o usamos como nossa 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. Aqui estão algumas de suas localizações:

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

As inclusões são mais simples que os modelos, pois não requerem argumentos de linha de comando; eles expandem diretamente o XML referenciado na tag de name . Semelhante aos modelos, o caminho para a configuração pode ser absoluto ou relativo. Ainda assim, para includes , recomendamos usar apenas caminhos relativos, pois 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, a Tradefed lançará uma ConfigurationException com a descrição do que parece estar faltando ou configurado incorretamente.