Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP мы рекомендуем использовать android-latest-release вместо aosp-main . Ветка манифеста android-latest-release всегда будет ссылаться на самый последний релиз, выпущенный в 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 и 14 других.

AtraceCollector	`IMetricCollector` , который запускает atrace во время теста, собирает результаты и регистрирует их при вызове.
AtraceRunMetricCollector	Собирает трассировки из всех тестовых каталогов в указанном каталоге тестового устройства, регистрирует тестовый каталог и выполняет постобработку файлов трассировки в тестовом каталоге и агрегирует метрики.
BaseDeviceMetricCollector	Базовая реализация `IMetricCollector` , которая позволяет запускать и останавливать сбор данных при `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` и `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
Сборщик задержек соединения Bluetooth	Сборщик передаст предварительно определенную конфигурацию метрики длительности statsd на устройства и соберет длительность Bluetooth-соединения для каждого профиля.
BluetoothConnectionStateCollector	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния подключения для каждого профиля.
BluetoothHciSnoopLogCollector	Сборщик для включения функции отслеживания Bluetooth HCI на проверяемом устройстве и сбора журнала для каждого теста.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках в случае сбоя тестового случая.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках, если тестовый случай в ходе выполнения завершается неудачей.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Clang из устройства и регистрирует их как тестовые артефакты.
CodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает результаты измерений покрытия Java и собственных функций с устройства и регистрирует их как тестовые артефакты.
CountTestCasesCollector	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового случая.
DeviceTraceCollector	Сборщик, который запустит идеальную трассировку при запуске тестового прогона и запишет файл трассировки в конце.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключевые метрики, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector	Регистратор файла, предоставленного устройством.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия gcov из устройства и регистрирует их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия ядра gcov из debugfs и с устройства, а затем, наконец, регистрирует их как тестовые артефакты.
HostStatsdMetricCollector	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Java с устройства и регистрирует их как тестовые артефакты.
LogcatOnFailureCollector	Сборщик, который будет собирать и регистрировать logcat в случае сбоя тестового случая.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из Logcat в ходе одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк Logcat.
ModuleLogcatCollector	Версия сборщика logcat, но для модуля.
PerfettoFilePullerCollector	Сборщик, который извлекает файлы трассировки Perfetto из устройства, при необходимости сжимает их и добавляет в журналы тестирования.
PerfettoPullerMetricCollector	Этот класс устарел. Вместо него используйте `PerfettoFilePullerCollector` и `ERROR(/PerfettoTracePostProcessor)` .
RebootReasonCollector	Сборщик, который собирает перезагрузки устройств во время тестового прогона и сообщает о них по причине и количеству.
RuntimeRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового прогона, если таковые имеются.
ScreenshotOnFailureCollector	Сборщик, который сделает снимок экрана и запишет его в журнал в случае сбоя тестового случая.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы showmap из устройства и собирать из него метрики.
TraceCmdCollector	`IMetricCollector` , который собирает трассировки во время теста с помощью trace-cmd и регистрирует их при вызове.

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

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

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

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

Публичные методы
`default boolean`	`captureModuleLevel ()` Применим ли сборщик к захвату на уровне модуля и должен ли он быть инициализирован.
`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)` Обратный вызов при запуске тестового случая.

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

captureModuleLevel

public boolean captureModuleLevel ()

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

Возврат
`boolean`

получитьBuildInfos

public abstract  getBuildInfos ()

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

Возврат

получитьДевайсы

public abstract  getDevices ()

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

Возврат

getInvocationListener

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`