Criar um relatório de resultados

Nesta página, descrevemos os conceitos básicos de como implementar um novo gerador de relatórios de resultados e configurá-lo para um teste.

Interface principal

Para definir um novo gerador de relatórios de resultados no Tradefed, uma classe precisa implementar a interface ITestInvocationListener que permite receber e processar diferentes estágios da invocação:

• invocationStarted
• invocationEnded
• invocationFailed

Os geradores de relatórios de resultados também processam as diferentes etapas de cada execução de teste:

• testRunStarted
• testStarted
• testFailed ou testIgnored
• testEnded
• testRunFailed
• testRunEnded

Considerando todos esses eventos, há dois tipos principais de criadores de relatórios de resultados:

• Só se preocupe em informar os resultados finais completos.
• Realizar ações com base nos resultados parciais.

Informante de resultados que informa os resultados finais completos.

Esse tipo é o caso mais comum quando se trata de interagir com um serviço externo que recebe os resultados. O reporter simplesmente recebe e acumula os resultados e os envia todos em invocationEnded para o endpoint de resultado.

Recomendamos que esses repórteres estendam CollectingTestListener em vez da interface básica para evitar a reimplementação do salvamento e do armazenamento dos resultados até invocationEnded.

Gerador de relatórios de resultados parciais.

Esse tipo geralmente é usado para uma abordagem de streaming dos resultados, quando eles são recebidos e enviados para outros lugares imediatamente. Por exemplo, um reporter que registra os resultados no console seria desse tipo.

Esse tipo é específico para o tipo de processamento necessário nos eventos. Por isso, a implementação da interface de base geralmente é a maneira recomendada.

Configuração de XML

A tag do objeto é result_reporter. Exemplo:

<result_reporter class="com.android.tradefed.result.ConsoleResultReporter">
    <option name="suppress-passed-tests" value="true"/>
</result_reporter>