A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

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

Subclasses diretas conhecidas

AggregatePostProcessor, AveragePostProcessor, MetricFilePostProcessor

AggregatePostProcessor	Um agregador de métricas que fornece o 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 várias iterações, tratando-as como números reais.
AveragePostProcessor	Implementação de um pós-processador que calcula a média da lista de métricas.
MetricFilePostProcessor	Usado para fazer o upload do arquivo de registro de métricas coletado durante o nível de teste e execução.

O IPostProcessor básico que toda implementação precisa estender. Verifique se os métodos de processamento pós-processamento são chamados antes dos acionadores de resultados finais.

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)`
`final void`	`invocationFailed(FailureDescription failure)`
`final void`	`invocationFailed(Throwable cause)`
`final void`	`invocationStarted(IInvocationContext context)` Listeners de invocação para encaminhamento
`final boolean`	`isDisabled()` Retorna "True" se o objeto inteiro estiver desativado (pule a configuração e a desmontagem).
`final void`	`logAssociation(String dataName, LogFile logFile)` Atualiza a associação de registro a ser testada.
	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` Implemente esse método para agregar métricas e registros em todos os testes.
`abstract`	`processRunMetricsAndLogs( rawMetrics, runLogs)` Implemente esse método para gerar um conjunto de novas métricas com base nas métricas e nos registros atuais.
	`processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)` Implemente esse método para processar as métricas e os registros de cada teste.
`final void`	`setLogSaver(ILogSaver logSaver)`
`final void`	`testAssumptionFailure(TestDescription test, String trace)`
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`final void`	`testEnded(TestDescription test, testMetrics)`
`final void`	`testFailed(TestDescription test, FailureDescription failure)`
`final void`	`testFailed(TestDescription test, String trace)`
`final void`	`testIgnored(TestDescription test)`
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Use esse método para registrar um arquivo da implementação do postprocessor.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`final void`	`testModuleEnded()`
`final void`	`testModuleStarted(IInvocationContext moduleContext)`
`final void`	`testRunEnded(long elapsedTime, runMetrics)`
`final void`	`testRunFailed(FailureDescription failure)`
`final void`	`testRunFailed(String errorMessage)`
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)`
`final void`	`testRunStarted(String runName, int testCount)` Testar callbacks de execução
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` Callbacks de casos de teste

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

Construtores públicos

BasePostProcessor

public BasePostProcessor ()

Métodos públicos

init

public final ITestInvocationListener init (ITestInvocationListener listener)

Etapa de inicialização do pós-processador. É chamado antes de qualquer um dos retornos de chamada de teste.

Parâmetros
`listener`	`ITestInvocationListener`

Retorna
`ITestInvocationListener`

invocationEnded

public final void invocationEnded (long elapsedTime)

Parâmetros
`elapsedTime`	`long`

invocationFailed

public final void invocationFailed (FailureDescription failure)

Parâmetros
`failure`	`FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

Parâmetros
`cause`	`Throwable`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listeners de invocação para encaminhamento

Parâmetros
`context`	`IInvocationContext`

isDisabled

public final boolean isDisabled ()

Retorna "True" se o objeto inteiro estiver desativado (pule a configuração e a desmontagem). Falso em outros casos.

Retorna
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Atualiza a associação de registro a ser testada. Se esse método for chamado durante um teste, o registro pertencerá ao teste. Caso contrário, será um registro de execução.

Parâmetros
`dataName`	`String`
`logFile`	`LogFile`

processAllTestMetricsAndLogs

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

Implemente esse método para agregar métricas e registros em todos os testes. As métricas geradas por esse método serão informadas como métricas de execução. Somente as métricas recém-geradas serão retornadas e com nome de chave exclusivo (não é permitido nenhum conflito com chaves existentes).

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

Retorna
	Conjunto de métricas recém-geradas de todas as métricas de teste.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

Implemente esse método para gerar um conjunto de novas métricas com base nas métricas e nos registros atuais. Somente as métricas recém-geradas precisam ser retornadas e com nome de chave exclusivo (não é permitido colisão com chaves existentes).

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

Retorna
	Conjunto de métricas recém-geradas a partir das métricas de execução.

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

Implemente esse método para processar as métricas e os registros de cada teste. Somente as métricas recém-geradas precisam ser retornadas e com um nome de chave exclusivo (não é permitido nenhum conflito 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.

Retorna
	Conjunto de métricas recém-geradas com base nas métricas de teste.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Parâmetros
`logSaver`	`ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Parâmetros
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parâmetros
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

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

Parâmetros
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Parâmetros
`test`	`TestDescription`
`testMetrics`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Parâmetros
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Parâmetros
`test`	`TestDescription`
`trace`	`String`

testIgnored

public final void testIgnored (TestDescription test)

Parâmetros
`test`	`TestDescription`

testLog

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

Use esse método para registrar um arquivo da implementação do postprocessor.

Parâmetros
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

Parâmetros
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Parâmetros
`moduleContext`	`IInvocationContext`

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Parâmetros
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public final void testRunFailed (FailureDescription failure)

Parâmetros
`failure`	`FailureDescription`

testRunFailed

public final void testRunFailed (String errorMessage)

Parâmetros
`errorMessage`	`String`

testRunStarted

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

Parâmetros
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Testar callbacks de execução

Parâmetros
`runName`	`String`
`testCount`	`int`

testRunStopped

public final void testRunStopped (long elapsedTime)

Parâmetros
`elapsedTime`	`long`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Parâmetros
`test`	`TestDescription`
`startTime`	`long`

testStarted

public final void testStarted (TestDescription test)

Callbacks de casos de teste

Parâmetros
`test`	`TestDescription`

Métodos protegidos

getMetricType

protected MetricMeasurement.DataType getMetricType ()

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

Retorna
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

Retorna
`String`