ITestLifeCycleReceiver
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Recebe notificações de eventos durante execuções de teste de instrumentação.
Padronizado após org.junit.runner.notification.RunListener
A sequência de chamadas será:
- testRunStarted
- testStarted
- [teste falhou]
- [testAssumptionFailure]
- [testeIgnorado]
- testeFinalizado
- ....
- [testRunFailed]
- testRunEnded
Resumo
Métodos públicos | |
---|---|
default void | testAssumptionFailure ( TestDescription test, String trace) Chamado quando um teste atômico sinaliza que assume uma condição falsa |
default void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Chamado quando um teste atômico sinaliza que assume uma condição falsa |
default void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa para |
default void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Informa o fim da execução de um caso de teste individual. |
default void | testFailed ( TestDescription test, FailureDescription failure) Relata a falha de um caso de teste individual. |
default void | testFailed ( TestDescription test, String trace) Relata a falha de um caso de teste individual. |
default void | testIgnored ( TestDescription test) Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore. |
default void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Informa o fim da execução do teste. |
default void | testRunFailed ( FailureDescription failure) A execução do teste de relatórios falhou devido a uma falha descrita por |
default void | testRunFailed (String errorMessage) A execução do teste de relatórios não foi concluída devido a um erro fatal. |
default void | testRunStarted (String runName, int testCount, int attemptNumber) Informa o início de uma execução de teste. |
default void | testRunStarted (String runName, int testCount) Informa o início de uma execução de teste. |
default void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Informa o início de uma execução de teste. |
default 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. |
default void | testStarted ( TestDescription test, long startTime) Alternativa para |
default void | testStarted ( TestDescription test) Relata o início de um caso de teste individual. |
Métodos públicos
testAssumptionFailure
public 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 |
testAssumptionFailure
public 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 descrevendo a falha e seu contexto. |
testeFinalizado
public 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 : a hora em que o teste terminou, medido via ERROR(/System#currentTimeMillis()) |
testMetrics | ERROR(/Map) das métricas emitidas |
testeFinalizado
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 chamado, esse 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 | ERROR(/Map) das métricas emitidas |
teste falhou
public 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 descrevendo a falha e seu contexto. |
teste falhou
public 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 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 |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Informa o fim 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 | |
---|---|
elapsedTimeMillis | long : tempo decorrido relatado pelo dispositivo, em milissegundos |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
A execução do teste de relatórios falhou devido a uma falha descrita por FailureDescription
.
Parâmetros | |
---|---|
failure | FailureDescription : FailureDescription descrevendo a falha e seu contexto. |
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 : ERROR(/String) descrevendo o motivo da falha na execução. |
testRunStarted
public 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 do teste |
testCount | int : número total de testes na execução do teste |
attemptNumber | int : número do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Informa o início de uma execução de teste.
Parâmetros | |
---|---|
runName | String : o nome da execução do teste |
testCount | int : número total de testes na execução do teste |
testRunStarted
public 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 do teste |
testCount | int : número total de testes na execução do teste |
attemptNumber | int : número do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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 ERROR(/System#currentTimeMillis()) |
testRunStopped
public 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 |
testStarted
public 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 medição precisa .
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
startTime | long : a hora em que o teste começou, medido via ERROR(/System#currentTimeMillis()) |
testStarted
public void testStarted (TestDescription test)
Relata o início de um caso de teste individual. Interface mais antiga, deve usar testStarted(com.android.tradefed.result.TestDescription)
sempre que possível.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |