Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

IMetricCollector

public interface IMetricCollector
implements IDisableable , ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Известные косвенные подклассы

AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector и еще 13.

Атрацеколлектор	`IMetricCollector` , который запускает трассировку во время теста, собирает результаты и регистрирует их при вызове.
AtraceRunMetricCollector	Собирает трассировки из всего тестового каталога в заданном каталоге тестового устройства, регистрирует тестовый каталог, осуществляет постобработку файлов трассировки в тестовом каталоге и агрегирует показатели.
Базедевицеметрикколлектор	Базовая реализация `IMetricCollector` , которая позволяет запускать и останавливать сбор данных `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` и `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
BluetoothConnectionLatencyCollector	Сборщик отправит предварительно определенную конфигурацию метрики длительности statsd на устройства и соберет продолжительность соединения Bluetooth для каждого профиля.
BluetoothConnectionStateКоллектор	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния соединения для каждого профиля.
BluetoothHciSnoopLogCollector	Сборщик для включения отслеживания Bluetooth HCI на тестируемом устройстве и сбора журнала для каждого теста.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках, когда тест-кейс не пройден.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках, когда тест-кейс в ходе выполнения терпит неудачу.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия Clang с устройства и регистрировать их как тестовые артефакты.
Коллектор CodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения Java и собственного покрытия с устройства и регистрировать их как тестовые артефакты.
Коллектор тестовых случаев	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового сценария.
Девицетрацеколлектор	Сборщик, который запускает трассировку perfetto при запуске теста и записывает файл трассировки в конце.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключи метрик, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector	Регистратор файла, о котором сообщает сторона устройства.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет получать измерения покрытия gcov с устройства и регистрировать их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия ядра gcov из debugfs и с устройства, а затем, наконец, регистрировать их как тестовые артефакты.
Хостстатсдметрикколлектор	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет получать измерения покрытия Java с устройства и регистрировать их как тестовые артефакты.
LogcatOnFailureCollector	Коллектор, который будет захватывать и регистрировать логарифмический анализ в случае сбоя тестового примера.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк logcat.
МодульLogcatКоллектор	Версия сборщика logcat, но для модуля.
PerfettoPullerМетрикаКоллектор	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы perfetto с устройства и собирать с него метрики.
ПерезагрузкаПричинаКоллектор	Сборщик, который собирает данные о перезагрузках устройств во время тестового запуска и сообщает о них по причинам и подсчетам.
Сборщик времени выполненияRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются.
Снимок экранаOnFailureCollector	Сборщик, который будет делать снимок экрана и сохранять его в журнале в случае сбоя тестового примера.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы карты отображения с устройства и собирать с него метрики.
Трацекмдколлектор	`IMetricCollector` , который собирает трассировки во время теста с помощью трассировки-cmd и записывает их в журнал при вызове.

Этот интерфейс будет добавлен в качестве декоратора при сообщении о результатах тестов для сбора соответствующих метрик.

Этот интерфейс нельзя использовать в качестве даже он расширяет ITestInvocationListener . Проверка конфигурации отклонит его. Его необходимо использовать как «metrics_collector».

Не ожидается, что коллекторы сохранят внутреннее состояние, поскольку их можно повторно использовать в нескольких местах. Если действительно необходимо использовать внутреннее состояние, его следует очистить в init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) .

Краткое содержание

Публичные методы
`default boolean`	`captureModuleLevel ()` Применим ли сборщик для захвата уровня модуля и должен ли он быть init.
`abstract`	`getBuildInfos ()` Возвращает список информации о сборке, доступной при вызове.
`abstract`	`getDevices ()` Возвращает список устройств, доступных при вызове.
`abstract ITestInvocationListener`	`getInvocationListener ()` Возвращает исходный `ITestInvocationListener` , куда мы пересылаем результаты.
`abstract ITestInvocationListener`	`init ( IInvocationContext context, ITestInvocationListener listener)` Инициализация сборщика с текущим контекстом и куда пересылать результаты.
`abstract void`	`onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)` Обратный вызов в случае сбоя тестового примера с ошибкой предположения.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Обратный вызов, когда тестовый пример завершен.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` Обратный вызов, когда тестовый пример завершен.
`abstract void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` Обратный вызов в случае сбоя тестового примера.
`default void`	`onTestModuleEnded ()` Позволяет перехватывать событие завершения модуля.
`default void`	`onTestModuleStarted ()` Позволяет перехватывать событие запуска модуля.
`abstract void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` Обратный вызов при завершении тестового запуска.
`abstract void`	`onTestRunStart ( DeviceMetricData runData)` Обратный вызов при запуске тестового запуска.
`default void`	`onTestRunStart ( DeviceMetricData runData, int testCount)` Обратный вызов при запуске тестового запуска.
`abstract void`	`onTestStart ( DeviceMetricData testData)` Обратный вызов при запуске тестового примера.

Публичные методы

захватМодульУровень

public boolean captureModuleLevel ()

Применим ли сборщик для захвата уровня модуля и должен ли он быть init.

Возврат
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Возвращает список информации о сборке, доступной при вызове.

Возврат

ПолучитьУстройства

public abstract  getDevices ()

Возвращает список устройств, доступных при вызове.

Возврат

getInvoctionListener

public abstract ITestInvocationListener getInvocationListener ()

Возвращает исходный ITestInvocationListener , куда мы пересылаем результаты.

Возврат
`ITestInvocationListener`

инициализировать

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Инициализация сборщика с текущим контекстом и куда пересылать результаты. Будет вызываться только один раз для каждого экземпляра, и ожидается, что сборщик обновит свой внутренний контекст и прослушиватель. Init никогда не будет вызываться во время тестового запуска всегда.

Не переопределяйте, если вы не знаете, что делаете.

Параметры
`context`	`IInvocationContext` : `IInvocationContext` для текущего вызова.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` куда помещать результаты.

Возврат
`ITestInvocationListener`	новый слушатель, обертывающий исходный.

Броски
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Обратный вызов в случае сбоя тестового примера с ошибкой предположения.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера.
`test`	`TestDescription` : `TestDescription` текущего тестового примера.

Броски
`DeviceNotAvailableException`

onTestEnd

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

Обратный вызов, когда тестовый пример завершен. Это должно быть время для уборки.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера. Будет тот же объект, что и во время `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentTestCaseMetrics`	: текущая карта метрик, переданная в `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` .
`test`	`TestDescription` : `TestDescription` текущего тестового примера.

Броски
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Обратный вызов, когда тестовый пример завершен. Это должно быть время для уборки.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера. Будет тот же объект, что и во время `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentTestCaseMetrics`	: текущая карта метрик, переданная в `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` .

Броски
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Обратный вызов в случае сбоя тестового примера.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера.
`test`	`TestDescription` : `TestDescription` текущего тестового примера.

Броски
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Позволяет перехватывать событие завершения модуля.

Броски
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Позволяет перехватывать событие запуска модуля.

Броски
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Обратный вызов при завершении тестового запуска. Это должно быть время для уборки.

Параметры
`runData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для запуска. Это будет тот же объект, что и во время `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentRunMetrics`	: текущая карта метрик, переданная в `ERROR(/#testRunEnded(long,Map))` .

Броски
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Обратный вызов при запуске тестового запуска.

Параметры
`runData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для запуска.

Броски
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Обратный вызов при запуске тестового запуска.

Параметры
`runData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для запуска.
`testCount`	`int` : количество тестовых случаев в этом тестовом запуске.

Броски
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Обратный вызов при запуске тестового примера.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера.

Броски
`DeviceNotAvailableException`