Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável 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, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a 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.

LogcatOnFailureCollector

public class LogcatOnFailureCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.LogcatOnFailureCollector

Subclasses diretas conhecidas

ModuleLogcatCollector

ModuleLogcatCollector Versão do coletor logcat, mas para o módulo.

Coletor que captura e registra um logcat quando um caso de teste ou uma execução de teste falha. Se a coleta padrão estiver ativada, ela vai coletar registros do host nos níveis especificados.

Resumo

Construtores públicos
`LogcatOnFailureCollector()`

Métodos públicos
`boolean`	`captureModuleLevel()`
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback quando um caso de teste é encerrado.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback quando um caso de teste falha.
`void`	`onTestModuleEnded()` Permite capturar o evento de término do módulo.
`void`	`onTestModuleStarted()` Permite capturar o evento de início do módulo.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback quando a execução de um teste é encerrada.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Callback para eventos testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando a execução de um teste é iniciada.
`void`	`onTestRunStartBlocking()`
`void`	`onTestStart(DeviceMetricData testData)` Callback quando um caso de teste é iniciado.

Métodos protegidos
`void`	`collectAndLog(String testName, int size, IMetricCollector.MetricCollectionLevel level)`

Construtores públicos

LogcatOnFailureCollector

public LogcatOnFailureCollector ()

Métodos públicos

captureModuleLevel

public boolean captureModuleLevel ()

Retorna
`boolean`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Callback quando um caso de teste é encerrado. Esse é o momento de fazer a limpeza.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste. Será o mesmo objeto em `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: o mapa atual de métricas transmitidas para `testEnded(TestDescription,Map)`.

Gera
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback quando um caso de teste falha.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

Gera
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Permite capturar o evento de término do módulo.

Gera
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar o evento de início do módulo.

Gera
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Callback quando a execução de um teste é encerrada. Esse é o momento de fazer a limpeza.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados da execução. Será o mesmo objeto em `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: o mapa atual de métricas transmitidas para `testRunEnded(long,Map)`.

Gera
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback para eventos testRunFailed

Gera
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback quando a execução de um teste é iniciada.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados da execução.

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Gera
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback quando um caso de teste é iniciado.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste.

Métodos protegidos

collectAndLog

protected void collectAndLog (String testName, 
                int size, 
                IMetricCollector.MetricCollectionLevel level)

Parâmetros
`testName`	`String`
`size`	`int`
`level`	`IMetricCollector.MetricCollectionLevel`

Gera
`DeviceNotAvailableException`