Criar um relatório de resultados

Esta página descreve 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 informante de resultados no Tradefed, uma classe deve implementar as ITestInvocationListener que permite receber e processar diferentes estágios do invocação:

  • invocationStarted
  • invocationEnded
  • invocationFailed

Os acionadores de resultados também lidam com 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 informantes de resultados, os que:

  • Informe apenas os resultados finais completos.
  • Tomar medidas com base em resultados parciais.

Relatório de resultados que informa os resultados finais completos

Esse tipo é o caso mais comum quando se trata de interação com um serviço externo que recebe os resultados. O relatório simplesmente recebe e acumula os resultados e os envia todos em invocationEnded para o ponto final de resultado.

Recomendamos que esses relatórios estendam CollectingTestListener em vez da interface de base para evitar a reimplementação do salvamento e do armazenamento dos resultados até invocationEnded.

Relatório de resultados que informa resultados parciais

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

Esse tipo é específico para o tipo de tratamento que é necessário nos eventos, portanto, a implementação da interface base costuma ser a forma 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>