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.

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

Listener anexado a cada IRemoteTest de cada módulo para coletar a lista de resultados.

Resumo

Construtores públicos
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Construtor.

Métodos públicos
`boolean`	`hasLastAttemptFailed()` Retorna se a última sessão de nova tentativa do listener falhou ou não.
`void`	`logAssociation(String dataName, LogFile logFile)` Em alguns casos, o registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` direto.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Define se a tentativa precisa ser informada como isolada.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Define se estamos coletando apenas os testes.
`void`	`setMarkTestsSkipped(boolean skip)` Define se todos os casos de teste serão marcados como pulados.
`void`	`setTestMappingSources( testMappingSources)` Define as origens de mapeamento de teste que serão inseridas nas métricas.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`void`	`testAssumptionFailure(TestDescription test, String trace)` Chamada quando um teste atômico sinaliza que assume uma condição falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chamada quando um teste atômico sinaliza que assume uma condição falsa
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, em que podemos especificar o horário de término diretamente.
`void`	`testEnded(TestDescription test, testMetrics)` Informa o fim da execução de um caso de teste individual.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Informa a falha de um caso de teste individual.
`void`	`testFailed(TestDescription test, String trace)` Informa a falha de um caso de teste individual.
`void`	`testIgnored(TestDescription test)` É chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, runMetrics)` Informa o fim da execução do teste.
`void`	`testRunFailed(FailureDescription failure)` A execução do teste não foi concluída devido a uma falha descrita por `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` A execução do teste de relatórios não foi concluída devido a um erro fatal.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` Informa o início de uma execução de teste.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Informa o início de uma execução de teste.
`void`	`testSkipped(TestDescription test, SkipReason reason)` É chamado quando um teste é pulado e não é executado por um motivo que não é esperado.
`void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)`, em que também especificamos quando o teste foi iniciado, combinado com `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para uma medida precisa.

Construtores públicos

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Construtor.

Parâmetros
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

Métodos públicos

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Retorna se a última sessão de nova tentativa do listener falhou ou não.

Retorna
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto. Assim, esse callback permite fornecer uma associação forte explicitamente.

Parâmetros
`dataName`	`String`: o nome dos dados
`logFile`	`LogFile`: o `LogFile` que foi registrado antes e precisa ser associado ao caso de teste.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Define se a tentativa precisa ser informada como isolada.

Parâmetros
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Define se estamos coletando apenas os testes.

Parâmetros
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Define se todos os casos de teste serão marcados como pulados.

Parâmetros
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Define as origens de mapeamento de teste que serão inseridas nas métricas.

Parâmetros
`testMappingSources`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parâmetros
`useModuleResultsForwarder`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamada 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 o contexto dela.

testEnded

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

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

Parâmetros
`test`	`TestDescription`: identifica o teste
`endTime`	`long`: o tempo em que o teste foi encerrado, medido por `System.currentTimeMillis()`
`testMetrics`	: uma `ERROR(/Map)` das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Informa o fim da execução de um caso de teste individual.

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

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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Informa 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 o contexto dela.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

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

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

testLog

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

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

testLogSaved

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros
`elapsedTime`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos
`runMetrics`	: pares de chave-valor informados no final de uma execução de teste

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public 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` descrevendo o motivo da falha na execução.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

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

Parâmetros
`name`	`String`: o nome da execução do teste
`numTests`	`int`: número total de testes na execução do teste
`attemptNumber`	`int`: número de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado granularmente três vezes, precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia de 0 a 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

Parâmetros
`name`	`String`: o nome da execução do teste
`numTests`	`int`: número total de testes na execução do teste
`attemptNumber`	`int`: número de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado três vezes, então precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia de 0 a 3.
`startTime`	`long`: o horário em que a execução começou, medido por `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

É chamado quando um teste é pulado e não é executado por um motivo que não é esperado. Esses testes serão tentados novamente para tentar uma execução adequada.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), em que 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`: o momento em que o teste começou, medido por `System.currentTimeMillis()`