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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

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

Subclasses diretas conhecidas

BugreportzOnFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, ScreenshotOnFailureCollector

BugreportzOnFailureCollector	Coletar um relatório de bug quando um caso de teste falhar.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Clang do dispositivo e as registra como artefatos de teste.
CountTestCasesCollector	Contar e informar o número de casos de teste para um determinado `IRemoteTest`.
DebugHostLogOnFailureCollector	Coletor que vai coletar e registrar os registros do host quando ocorrer uma falha no caso de teste.
FilePullerDeviceMetricCollector	Um `BaseDeviceMetricCollector` que detecta a chave de métricas vinda do dispositivo e as extrai como um arquivo do dispositivo.
GcovCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do gcov do dispositivo e as registra como artefatos de teste.
JavaCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Java do dispositivo e as registra como artefatos de teste.
LogcatOnFailureCollector	Coletor que vai capturar e registrar um logcat quando um caso de teste falhar.
ScreenshotOnFailureCollector	Coletor que vai capturar e registrar uma captura de tela quando um caso de teste falhar.

Subclasses indiretas conhecidas

FilePullerLogCollector

FilePullerLogCollector Gerenciou o arquivo informado pelo dispositivo.

Implementação básica de IMetricCollector que permite iniciar e interromper a coleta em onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) e ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).

Resumo

Campos
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Construtores públicos
`BaseDeviceMetricCollector()`

Métodos públicos
`final`	`getBuildInfos()` Retorna a lista de informações de build disponíveis na invocação.
`final`	`getDevices()` Retorna a lista de dispositivos disponíveis na invocação.
`File`	`getFileFromTestArtifacts(String fileName)` Extraia o arquivo dos artefatos de teste ou do módulo e armazene-o em cache em um mapa para as chamadas subsequentes.
`final ITestInvocationListener`	`getInvocationListener()` Retorna o `ITestInvocationListener` original para onde os resultados estão sendo encaminhados.
`final`	`getRealDevices()` Retorna todos os dispositivos não-stubs da lista `getDevices()`.
`String`	`getRunName()` Retorna o nome da execução de teste `mRunName` que aciona o coletor.
`ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicialização do coletor com o contexto atual e onde encaminhar os resultados.
`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)` Não use dentro da implementação do coletor de métricas.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando um caso de teste falha com falha de suposição.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Chamada de retorno quando um caso de teste é encerrado.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Chamada de retorno quando um caso de teste é encerrado.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Chamada de retorno quando um caso de teste falha.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Chamada de retorno quando uma execução de teste é encerrada.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)`
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando uma execução de teste é iniciada.
`void`	`onTestStart(DeviceMetricData testData)` Callback quando um caso de teste é iniciado.
`final void`	`setDisable(boolean isDisabled)` Define se o objeto precisa ser desativado.
`final void`	`setLogSaver(ILogSaver logSaver)` Não use dentro da implementação do coletor de métricas.
`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)`
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Não use dentro da implementação do coletor de métricas.
`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`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)`
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` Callbacks de casos de teste

Campos

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Construtores públicos

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Métodos públicos

getBuildInfos

public final  getBuildInfos ()

Retorna a lista de informações de build disponíveis na invocação.

Retorna

getDevices

public final  getDevices ()

Retorna a lista de dispositivos disponíveis na invocação.

Retorna

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Extraia o arquivo dos artefatos de teste ou do módulo e armazene-o em cache em um mapa para as chamadas subsequentes.

Parâmetros
`fileName`	`String`: nome do arquivo a ser procurado nos artefatos.

Retorna
`File`	Arquivo do artefato de teste ou do artefato do módulo. Retorna nulo se o arquivo não for encontrado.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Retorna o ITestInvocationListener original para onde os resultados estão sendo encaminhados.

Retorna
`ITestInvocationListener`

getRealDevices

public final  getRealDevices ()

Retorna todos os dispositivos não-stubs da lista getDevices().

Retorna

getRunName

public String getRunName ()

Retorna o nome da execução de teste mRunName que aciona o coletor.

Retorna
`String`	mRunName, o nome da execução de teste atual.

init

public ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialização do coletor com o contexto atual e onde encaminhar os resultados. Será chamado apenas uma vez por instância, e o coletor precisa atualizar o contexto e o listener interno. O método de inicialização nunca será chamado durante uma execução de teste.

Não substitua, a menos que você saiba o que está fazendo.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` para a invocação em andamento.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` em que os resultados serão colocados.

Retorna
`ITestInvocationListener`	o novo listener que envolve o original.

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)

Não use dentro da implementação do coletor de métricas. Isso é encaminhamento puro.

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

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback quando um caso de teste falha com falha de suposição.

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

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Chamada de retorno quando um caso de teste é encerrado. É hora de limpar.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados do caso de teste. Será o mesmo objeto que durante `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: o mapa atual de métricas transmitidas para `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Chamada de retorno quando um caso de teste é encerrado. É hora de limpar.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados do caso de teste. Será o mesmo objeto que durante `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: o mapa atual de métricas transmitidas para `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Chamada de retorno quando um caso de teste falha.

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

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Chamada de retorno quando uma execução de teste é encerrada. É hora de limpar.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados da execução. Será o mesmo objeto que durante `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: o mapa atual de métricas transmitidas para `ITestLifeCycleReceiver.testRunEnded(long, Map)`.

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Parâmetros
`testData`	`DeviceMetricData`
`failure`	`FailureDescription`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback quando uma execução de teste é iniciada.

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

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback quando um caso de teste é iniciado.

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

setDisable

public final void setDisable (boolean isDisabled)

Define se o objeto precisa ser desativado. "Desativado" significa que as etapas de configuração e desmontagem precisam ser ignoradas. Pode ser usado para desativar um objeto por padrão no construtor padrão.

Parâmetros
`isDisabled`	`boolean`: o estado em que o objeto precisa ser colocado.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Não use dentro da implementação do coletor de métricas. Isso é encaminhamento puro.

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)

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

testLogSaved

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

Não use dentro da implementação do coletor de métricas. Isso é encaminhamento puro.

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`

testRunStarted

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

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

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`