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.

TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.testtype.suite.TestFailureListener

Listener usado para realizar ações como captura de tela, relatório de bug e coleta de logcat após uma falha de teste quando solicitado.

Resumo

Construtores públicos
`TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)`

Métodos públicos
`void`	`applyModuleConfiguration(boolean bugreportOnFailure)` Permite substituir as configurações de invocação de captura em caso de falha pelas configurações específicas do módulo.
`void`	`join()` Junte todas as linhas de execução de captura do Logcat para garantir que elas sejam encerradas.
`void`	`setLogger(ITestLogger logger)` Define onde os registros devem ser salvos.
`void`	`testFailed(TestDescription test, String trace)` Informa a falha de um caso de teste individual.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece os dados de registro ou depuração associados à invocação do teste.
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` Encaminhar o registro para o gerador de registro, não fazer isso dentro do callback #testLog, porque se TestFailureListener fizer parte da cadeia, isso resultará em um loop infinito.

Construtores públicos

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

Parâmetros
`devices`
`bugReportOnFailure`	`boolean`
`rebootOnFailure`	`boolean`

Métodos públicos

applyModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

Permite substituir as configurações de invocação de captura em caso de falha pelas configurações específicas do módulo.

Parâmetros
`bugreportOnFailure`	`boolean`: verdadeiro para capturar um bugreport em falha de teste. Falso em outros casos.

join

public void join ()

Junte todas as linhas de execução de captura do Logcat para garantir que elas sejam encerradas.

setLogger

public void setLogger (ITestLogger logger)

Define onde os registros devem ser salvos.

Parâmetros
`logger`	`ITestLogger`

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

testLog

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

Fornece os dados de registro ou depuração associados à invocação do teste.

Precisa ser chamado antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long)).

O framework TradeFederation vai chamar esse método automaticamente, fornecendo o registro do host e, se aplicável, o logcat do dispositivo.

Parâmetros
`dataName`	`String`: um nome descritivo `String` dos dados, por exemplo, "device_logcat". Observação dataName pode não ser exclusivo por invocação. Ou seja, os implementadores precisam ser capazes de processar várias chamadas com o mesmo dataName.
`dataType`	`LogDataType`: o `LogDataType` dos dados
`dataStream`	`InputStreamSource`: o `InputStreamSource` dos dados. Os implementadores precisam chamar createInputStream para começar a ler os dados e garantir que o InputStream resultante seja fechado quando concluído. Os autores de chamada precisam garantir que a origem dos dados permaneça presente e acessível até que o método testLog seja concluído.

testLogForward

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

Encaminhar o registro para o gerador de registro, não fazer isso dentro do callback #testLog, porque se TestFailureListener fizer parte da cadeia, isso resultará em um loop infinito.

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