A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
↳	com.android.tradefed.postprocessor.BasePostProcessor

Subclasses diretas conhecidas

AggregatePostProcessor , AveragePostProcessor , BluetoothConnectionSuccessRatePostProcessor , MetricFilePostProcessor , PerfettoGenericPostProcessor , StatsdGenericPostProcessor

AggregatePostProcessor	Um agregador de métricas que fornece mínimo, máximo, média, variância, desvio padrão, total, contagem e, opcionalmente, percentis para métricas numéricas coletadas durante execuções de teste de múltiplas iterações, tratando-as como duplas.
MédiaPós-Processador	Implementação de pós-processador que calcula a média da lista de métricas.
BluetoothConnectionSuccessRatePostProcessor	Implementação de pós-processador que calcula a taxa de sucesso para um perfil bluetooth Use "metric-key-match" para especificar métricas que contêm estados de conexão bluetooth em uma matriz numérica. Exemplo [0, 1, 2, 3, 0, 1, 2, 3].
MetricFilePostProcessor	Usado para carregar o arquivo de log de métricas coletado durante o nível de teste e execução.
PerfettoGenericPostProcessor	Um pós-processador que processa arquivo proto perfeito de métrica de texto/binária em pares de valores-chave, expandindo recursivamente as mensagens proto e os campos com valores de string até que o campo com valor numérico seja encontrado.
StatsdGenericPostProcessor	Um pós-processador que processa relatórios proto statsd binários em pares de valores-chave, expandindo o relatório como uma estrutura em árvore.

Subclasses indiretas conhecidas

StatsdBeforeAfterGaugeMetricPostProcessor , StatsdEventMetricPostProcessor

StatsdBeforeAfterGaugeMetricPostProcessor	Um pós-processador que processa métricas de medição coletadas em uma abordagem "antes/depois", ou seja,
StatsdEventMetricPostProcessor	Um pós-processador que processa métricas de eventos em relatórios statsd em pares de valores-chave, usando os formatadores especificados no processador.

O IPostProcessor base que toda implementação deve estender. Certifique-se de que os métodos de pós-processamento sejam chamados antes dos relatores do resultado final.

Resumo

Construtores públicos
`BasePostProcessor ()`

Métodos públicos
`final ITestInvocationListener`	`init ( ITestInvocationListener listener)` Etapa de inicialização do pós-processador.
`final void`	`invocationEnded (long elapsedTime)` Informa que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.
`final void`	`invocationFailed ( FailureDescription failure)` Relata uma invocação incompleta devido a alguma condição de erro.
`final void`	`invocationFailed (Throwable cause)` Relata uma invocação incompleta devido a alguma condição de erro.
`void`	`invocationSkipped ( SkipReason reason)` Relata uma invocação como ignorada
`final void`	`invocationStarted ( IInvocationContext context)` Ouvintes de invocação para encaminhamento
`final boolean`	`isDisabled ()` Retorna True se todo o objeto estiver desativado (ignore a configuração e a desmontagem).
`final void`	`logAssociation (String dataName, LogFile logFile)` Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` não é possível. Atualiza a associação log-to-test.
	`processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` `processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` Implemente esse método para agregar métricas e logs em todos os testes.
`abstract`	`processRunMetricsAndLogs ( rawMetrics, runLogs)` `processRunMetricsAndLogs ( rawMetrics, runLogs)` `processRunMetricsAndLogs ( rawMetrics, runLogs)` Implemente este método para gerar um conjunto de novas métricas a partir das métricas e logs existentes.
	`processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)` `processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)` `processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)` Implemente este método para pós-processar métricas e logs de cada teste.
`final void`	`setLogSaver ( ILogSaver logSaver)` Defina o `ILogSaver` para permitir que o implementador salve arquivos.
`void`	`setUp ()` Substitua esse método nos pós-processadores filhos para inicializar antes da execução do teste.
`final void`	`testAssumptionFailure ( TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`final void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`final void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Alternativa para `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` onde podemos especificar o horário de término diretamente.
`final void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Relata o final da execução de um caso de teste individual.
`final void`	`testFailed ( TestDescription test, FailureDescription failure)` Relata a falha de um caso de teste individual.
`final void`	`testFailed ( TestDescription test, String trace)` Relata a falha de um caso de teste individual.
`final void`	`testIgnored ( TestDescription test)` Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`final void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Use este método para registrar um arquivo da implementação do PostProcessor.
`final void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Chamado quando o log de teste é salvo.
`final void`	`testModuleEnded ()` Informa o fim da execução de um módulo.
`final void`	`testModuleStarted ( IInvocationContext moduleContext)` Relata o início de um módulo em execução.
`final void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Informa o final da execução do teste.
`final void`	`testRunFailed ( FailureDescription failure)` A execução do teste de relatórios não foi concluída devido a uma falha descrita por `FailureDescription` .
`final void`	`testRunFailed (String errorMessage)` A execução do teste de relatórios não foi concluída devido a um erro fatal.
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Informa o início de uma execução de teste.
`final void`	`testRunStarted (String runName, int testCount)` Retornos de chamada de execução de teste
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Informa o início de uma execução de teste.
`final void`	`testRunStopped (long elapsedTime)` A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.
`final void`	`testSkipped ( TestDescription test, SkipReason reason)` Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado.
`final void`	`testStarted ( TestDescription test, long startTime)` Alternativa para `testStarted(com.android.tradefed.result.TestDescription)` onde também especificamos quando o teste foi iniciado, combinado com `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para uma medida precisa .
`final void`	`testStarted ( TestDescription test)` Retornos de chamada de casos de teste

Métodos protegidos
`MetricMeasurement.DataType`	`getMetricType ()` Substitua esse método para alterar o tipo de métrica, se necessário.
`String`	`getRunName ()`

Construtores públicos

BasePostProcessor

public BasePostProcessor ()

Métodos públicos

iniciar

public final ITestInvocationListener init (ITestInvocationListener listener)

Etapa de inicialização do pós-processador. Garantido para ser chamado antes de qualquer um dos retornos de chamada de testes.

Parâmetros
`listener`	`ITestInvocationListener`

Devoluções
`ITestInvocationListener`

invocaçãoEnded

public final void invocationEnded (long elapsedTime)

Informa que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`elapsedTime`	`long` : o tempo decorrido da invocação em ms

invocaçãoFailed

public final void invocationFailed (FailureDescription failure)

Relata uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`failure`	`FailureDescription` : a `FailureDescription` que descreve a causa da falha

invocaçãoFailed

public final void invocationFailed (Throwable cause)

Relata uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`cause`	`Throwable` : a causa `Throwable` da falha

invocaçãoSkipped

public void invocationSkipped (SkipReason reason)

Relata uma invocação como ignorada

Parâmetros
`reason`	`SkipReason`

invocaçãoiniciada

public final void invocationStarted (IInvocationContext context)

Ouvintes de invocação para encaminhamento

Parâmetros
`context`	`IInvocationContext` : informações sobre a invocação

está desabilitado

public final boolean isDisabled ()

Retorna True se todo o objeto estiver desativado (ignore a configuração e a desmontagem). Caso contrário, falso.

Devoluções
`boolean`

logAssociação

public final void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, este retorno de chamada permite fornecer explicitamente uma associação forte.

Atualiza a associação log-to-test. Se esse método for chamado durante um teste, o log pertencerá ao teste; caso contrário, será um log de execução.

Parâmetros
`dataName`	`String` : O nome dos dados
`logFile`	`LogFile` : o `LogFile` que foi logado anteriormente e deve ser associado ao caso de teste.

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

Implemente esse método para agregar métricas e logs em todos os testes. As métricas provenientes deste método serão relatadas como métricas de execução. Somente as métricas recém-geradas devem ser retornadas e com nome de chave exclusivo (não é permitida nenhuma colisão com chaves existentes).

Parâmetros
`allTestMetrics`	`ListMultimap` : um HashMultimap que armazena as métricas de cada teste agrupadas por nomes de métricas.
`allTestLogs`	: um mapa que armazena o mapa de arquivos de log de cada teste codificado por seus nomes de dados, usando `TestDescription` de cada teste como chaves.

Devoluções
	O conjunto de métricas recém-geradas de todas as métricas de teste.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

Implemente este método para gerar um conjunto de novas métricas a partir das métricas e logs existentes. Somente as métricas recém-geradas devem ser retornadas e com nome de chave exclusivo (não é permitida nenhuma colisão com chaves existentes).

Parâmetros
`rawMetrics`	: o conjunto de métricas brutas disponíveis para a execução.
`runLogs`	: o conjunto de arquivos de log para a execução de teste.

Devoluções
	O conjunto de métricas recém-geradas a partir das métricas de execução.

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

Implemente este método para pós-processar métricas e logs de cada teste. Somente as métricas recém-geradas devem ser retornadas e com nome de chave exclusivo (não é permitida nenhuma colisão com chaves existentes).

Parâmetros
`testDescription`	`TestDescription` : O objeto TestDescription que descreve o teste.
`testMetrics`	: o conjunto de métricas do teste.
`testLogs`	: O conjunto de arquivos registrados durante o teste.

Devoluções
	O conjunto de métricas recém-geradas a partir das métricas de teste.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Defina o ILogSaver para permitir que o implementador salve arquivos.

Parâmetros
`logSaver`	`ILogSaver` : o `ILogSaver`

configurar

public void setUp ()

Substitua esse método nos pós-processadores filhos para inicializar antes da execução do teste.

testeAssunçãoFalha

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Chamado quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
`test`	`TestDescription` : identifica o teste
`trace`	`String` : rastreamento de pilha de falha

testeAssunçãoFalha

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamado quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
`test`	`TestDescription` : identifica o teste
`failure`	`FailureDescription` : `FailureDescription` que descreve a falha e seu contexto.

teste finalizado

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) onde podemos especificar o horário de término diretamente. Combine com testStarted(com.android.tradefed.result.TestDescription, long) para uma medida precisa.

Parâmetros
`test`	`TestDescription` : identifica o teste
`endTime`	`long` : o horário em que o teste terminou, medido via `System.currentTimeMillis()`
`testMetrics`	: um `ERROR(/Map)` das métricas emitidas

teste finalizado

public final void testEnded (TestDescription test, 
                 testMetrics)

Relata o final da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi invocado, este teste foi aprovado. Também retorna quaisquer métricas de chave/valor que possam ter sido emitidas durante a execução do caso de teste.

Parâmetros
`test`	`TestDescription` : identifica o teste
`testMetrics`	: um `ERROR(/Map)` das métricas emitidas

teste falhou

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Relata a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
`test`	`TestDescription` : identifica o teste
`failure`	`FailureDescription` : `FailureDescription` que descreve a falha e seu contexto.

teste falhou

public final void testFailed (TestDescription test, 
                String trace)

Relata a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
`test`	`TestDescription` : identifica o teste
`trace`	`String` : rastreamento de pilha de falha

testeIgnorado

public final void testIgnored (TestDescription test)

Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

Parâmetros
`test`	`TestDescription` : identifica o teste

testeLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Use este método para registrar um arquivo da implementação do PostProcessor.

Parâmetros
`dataName`	`String` : um nome descritivo da `String` dos dados. por exemplo, "dispositivo_logcat". Nota dataName pode não ser exclusivo por chamada. ou seja, os implementadores devem ser capazes de lidar com várias chamadas com o mesmo dataName
`dataType`	`LogDataType` : o `LogDataType` dos dados
`dataStream`	`InputStreamSource` : o `InputStreamSource` dos dados. Os implementadores devem chamar createInputStream para iniciar a leitura dos dados e garantir o fechamento do InputStream resultante quando concluído. Os chamadores devem garantir que a fonte dos dados permaneça presente e acessível até que o método testLog seja concluído.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Chamado quando o log de teste é salvo.

Deve ser usado no lugar de ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) .

Parâmetros
`dataName`	`String` : um nome descritivo da `String` dos dados. por exemplo, "dispositivo_logcat". Nota dataName pode não ser exclusivo por chamada. ou seja, os implementadores devem ser capazes de lidar com várias chamadas com o mesmo dataName
`dataType`	`LogDataType` : o `LogDataType` dos dados
`dataStream`	`InputStreamSource` : o `InputStreamSource` dos dados. Os implementadores devem chamar createInputStream para iniciar a leitura dos dados e garantir o fechamento do InputStream resultante quando concluído.
`logFile`	`LogFile` : o `LogFile` que contém os metadados do arquivo salvo.

testModuleEnded

public final void testModuleEnded ()

Informa o fim da execução de um módulo.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Relata o início de um módulo em execução. Este retorno de chamada está associado a testModuleEnded() e é opcional na sequência. Ele é usado apenas durante uma execução que usa módulos: executores baseados em suíte.

Parâmetros
`moduleContext`	`IInvocationContext` : o `IInvocationContext` do módulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o final da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então temos que usar HashMap aqui.

Parâmetros
`elapsedTime`	`long` : tempo decorrido relatado pelo dispositivo, em milissegundos
`runMetrics`	: pares de valores-chave relatados no final de uma execução de teste com `Metric` .

testRunFailed

public final void testRunFailed (FailureDescription failure)

A execução do teste de relatórios não foi concluída devido a uma falha descrita por FailureDescription .

Parâmetros
`failure`	`FailureDescription` : `FailureDescription` que descreve a falha e seu contexto.

testRunFailed

public final void testRunFailed (String errorMessage)

A execução do teste de relatórios não foi concluída devido a um erro fatal.

Parâmetros
`errorMessage`	`String` : `String` que descreve o motivo da falha na execução.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Informa o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução de teste
`testCount`	`int` : número total de testes em execução de teste
`attemptNumber`	`int` : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Retornos de chamada de execução de teste

Parâmetros
`runName`	`String` : o nome da execução de teste
`testCount`	`int` : número total de testes em execução de teste

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Informa o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução de teste
`testCount`	`int` : número total de testes em execução de teste
`attemptNumber`	`int` : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.
`startTime`	`long` : a hora em que a execução começou, medida via `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.

TODO: atualmente não utilizado, considere remover

Parâmetros
`elapsedTime`	`long` : tempo decorrido relatado pelo dispositivo, em milissegundos

teste ignorado

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado. Esses testes serão tentados novamente para tentar obter uma execução adequada.

Parâmetros
`test`	`TestDescription` : identifica o teste
`reason`	`SkipReason` : `SkipReason`

teste iniciado

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa para testStarted(com.android.tradefed.result.TestDescription) onde também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para uma medida precisa .

Parâmetros
`test`	`TestDescription` : identifica o teste
`startTime`	`long` : a hora em que o teste começou, medido via `System.currentTimeMillis()`

teste iniciado

public final void testStarted (TestDescription test)

Retornos de chamada de casos de teste

Parâmetros
`test`	`TestDescription` : identifica o teste

Métodos protegidos

getMetricType

protected MetricMeasurement.DataType getMetricType ()

Substitua esse método para alterar o tipo de métrica, se necessário. Por padrão, a métrica é definida como tipo processado.

Devoluções
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

Devoluções
`String`