Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP мы рекомендуем использовать android-latest-release вместо aosp-main . Ветка манифеста android-latest-release всегда будет ссылаться на самый последний релиз, выпущенный в AOSP. Для получения дополнительной информации см. раздел «Изменения в AOSP» .

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

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

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

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CodeCoverageCollector и 84 других.

АгрегатныйПостПроцессор	Агрегатор метрик, который выдает минимум, максимум, среднее значение, дисперсию, стандартное отклонение, общее количество и, при необходимости, процентили для числовых метрик, собранных в ходе многоитерационных тестовых запусков, рассматривая их как двойные значения.
AtraceCollector	`IMetricCollector` , который запускает atrace во время теста, собирает результаты и регистрирует их при вызове.
AtraceRunMetricCollector	Собирает трассировки из всех тестовых каталогов в указанном каталоге тестового устройства, регистрирует тестовый каталог и выполняет постобработку файлов трассировки в тестовом каталоге и агрегирует метрики.
СреднийПостПроцессор	Реализация постпроцессора, вычисляющего среднее значение списка показателей.
BaseDeviceMetricCollector	Базовая реализация `IMetricCollector` , которая позволяет запускать и останавливать сбор данных при `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` и `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
BasePostProcessor	Базовый `IPostProcessor` , который должна расширять каждая реализация.
Сборщик задержек соединения Bluetooth	Сборщик передаст предварительно определенную конфигурацию метрики длительности statsd на устройства и соберет длительность Bluetooth-соединения для каждого профиля.
BluetoothConnectionStateCollector	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния подключения для каждого профиля.
BluetoothConnectionSuccessRatePostProcessor	Реализация постпроцессора, который рассчитывает вероятность успеха для профиля Bluetooth Используйте «metric-key-match» для указания метрик, содержащих состояния подключения Bluetooth в числовом массиве. Пример [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Сборщик для включения функции отслеживания Bluetooth HCI на проверяемом устройстве и сбора журнала для каждого теста.
BugreportCollector	Сквозной слушатель `ITestInvocationListener` , который собирает отчеты об ошибках при возникновении настраиваемых событий, а затем вызывает `ITestInvocationListener.testLog` для своих дочерних элементов после сбора каждого отчета об ошибках.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках в случае сбоя тестового случая.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках, если тестовый случай в ходе выполнения завершается неудачей.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Clang из устройства и регистрирует их как тестовые артефакты.
CodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает результаты измерений покрытия Java и собственных функций с устройства и регистрирует их как тестовые артефакты.
CollectingTestListener	`ITestInvocationListener` , который будет собирать все результаты тестов.
CommandStatusHandler	Обработчик, помогающий отслеживать и обновлять статус вызова.
СостояниеОтказМонитор	Следите за любыми сбоями при вызове.
ConsoleResultReporter	Отчет о результатах для вывода результатов теста на консоль.
CountTestCasesCollector	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
CountingTestResultListener	`TestResultListener` , который отслеживает общее количество тестов по `TestStatus`
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового случая.
DeviceReleaseReporter	Отчет о выпуске устройств, который управляет связью с родительским процессом об устройствах, которые необходимо освободить.
DeviceTraceCollector	Сборщик, который запустит идеальную трассировку при запуске тестового прогона и запишет файл трассировки в конце.
УстройствоНедоступноМонитор	Этот прослушиватель пытается захватить только уровень DNAE тестового случая.
EventsLoggerListener	Прослушиватель, который записывает все полученные события в файл
FileProtoResultReporter	Proto-репортер, который записывает `TestRecord` в файл.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключевые метрики, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector	Регистратор файла, предоставленного устройством.
FilteredResultForwarder	Вариант `ResultForwarder` , который позволяет сообщать только разрешенный список `TestDescription` .
FormattedGeneratorReporter	Reporter, позволяющий генерировать отчеты в определенном формате.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия gcov из устройства и регистрирует их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия ядра gcov из debugfs и с устройства, а затем, наконец, регистрирует их как тестовые артефакты.
GranularRetriableTestWrapper.StartEndCollector	Вспомогательный класс для обнаружения отсутствующих начала и конца выполнения.
HostStatsdMetricCollector	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
ICommandScheduler.IScheduledInvoctionListener	Прослушиватель событий вызова после завершения вызова.
ILogSaverListener	Позволяет слушателям `ITestInvocationListener` прослушивать момент сохранения файлов журнала.
IMetricCollector	Этот интерфейс будет добавлен в качестве декоратора при представлении результатов тестов с целью сбора соответствующих метрик.
IPostProcessor	Постпроцессоры — это объект Trade Federation, предназначенный для обработки показателей и журналов ПОСЛЕ тестов и ДО предоставления отчетов о результатах.
IShardableListener	`ITestInvocationListener` , который можно сегментировать.
ISupportGranularResults	Интерфейс, определяющий, поддерживает ли `ITestInvocationListener` получение детализированных результатов или нет.
ITestInvocationListener	Прослушиватель результатов теста из тестового вызова.
ITestSummaryListener	Интерфейс, позволяющий `ITestInvocationListener` обмениваться некоторой ограниченной информацией посредством сводок.
InvocationProtoResultReporter	Репортеры сохраняют информацию кэширования уровня вызова и список модулей.
InvocationToJUnitResultForwarder	Класс, который прослушивает события `ITestInvocationListener` и пересылает их `TestListener` .
JarHostTest.HostTestListener	Прослушиватель-оболочка, который пересылает все события, кроме testRunStarted() и testRunEnded(), встроенному прослушивателю.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Java с устройства и регистрирует их как тестовые артефакты.
JsonHttpTestResultReporter	Генератор отчетов о результатах, который кодирует результаты тестовых метрик и информацию об устройствах в формате JSON и отправляет POST-запросы в конечную точку HTTP-сервиса.
LUCIResultReporter	Отчет о результатах, который сохраняет результаты тестов, необходимые для ResultDB и LUCI, в формате JSON (go/result-sink) и регистрирует местоположение файла в консоли.
LastShardDetector	При запуске локального шардинга иногда нам нужно выполнить некоторые действия только тогда, когда последний шард достигает `invocationEnded(long)` .
УстаревшийПодпроцессРезультатыРепортер	Замороженная реализация отчета о результатах подпроцесса, которая должна оставаться совместимой с более ранними версиями TF/CTS (например, 8+), несмотря на изменения в ее суперклассе.
LogSaverResultForwarder	`ResultForwarder` для сохранения журналов с помощью глобального хранителя файлов.
LogcatCrashResultForwarder	Специальный прослушиватель: в случае сбоев (сбоя процесса инструментирования) он попытается извлечь из logcat сбой и добавить его к сообщению об ошибке, связанному с тестом.
LogcatOnFailureCollector	Сборщик, который будет собирать и регистрировать logcat в случае сбоя тестового случая.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из Logcat в ходе одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк Logcat.
MetricFilePostProcessor	Используется для загрузки файла журнала показателей, собранных во время тестирования и выполнения.
MetricsXMLResultReporter	MetricsXMLResultReporter записывает тестовые метрики и метрики запуска в XML-файл в папке, указанной параметром metrics-folder на этапе invocationEnded теста.
ModuleListener	Прослушиватель, прикрепленный к каждому `IRemoteTest` каждого модуля, для сбора списка результатов.
ModuleLogcatCollector	Версия сборщика logcat, но для модуля.
ModuleProtoResultReporter	Отчет о результатах, предназначенный только для отчетов на уровне модуля.
ModuleResultsAndMetricsForwarder	Расширение `ResultAndLogForwarder` , которое добавляет дополнительные метрики, связанные с модулем, к результатам теста.
ИмяMangleListener	Прокси-прослушиватель для перевода названий методов тестирования, классов и пакетов по мере предоставления результатов.
PassingTestFileReporter	`ITestInvocationListener` , который сохраняет список пройденных тестовых случаев в тестовый файл.
PerfettoFilePullerCollector	Сборщик, который извлекает файлы трассировки Perfetto из устройства, при необходимости сжимает их и добавляет в журналы тестирования.
PerfettoGenericPostProcessor	Постпроцессор, который обрабатывает текстовый/двоичный метрический файл proto perfetto в пары ключ-значение, рекурсивно расширяя сообщения proto и поля строковыми значениями до тех пор, пока не встретится поле с числовым значением.
PerfettoPullerMetricCollector	Этот класс устарел. Вместо него используйте `PerfettoFilePullerCollector` и `ERROR(/PerfettoTracePostProcessor)` .
PerfettoTracePostProcessor	Постпроцессор, который извлекает файлы трассировки Perfetto из журналов тестирования и запускает на них процессор трассировки для создания метрического прототипа Perfetto.
PrettyTestEventLogger	Регистратор сопоставляет события и регистрирует их для облегчения отладки.
ProtoResultReporter	Генератор отчетов по результатам создает Protobuf `TestRecord` со всеми результатами внутри.
PythonBinaryHostTest.PythonForwarder	Пересылка результатов для замены имени запуска на двоичное имя.
RebootReasonCollector	Сборщик, который собирает перезагрузки устройств во время тестового прогона и сообщает о них по причине и количеству.
RemoteTestTimeOutEnforcer	Прослушиватели, которые позволяют проверять время выполнения заданной конфигурации теста и завершать его неудачей, если он превышает заданное время ожидания.
Отчет о пройденных тестах	Сообщить в файле возможные фильтры для исключения пройденных тестов.
Агрегатор результатов	Специальный пересылатель, который при необходимости объединяет результаты на основе выбранной стратегии повторных попыток.
ResultAndLogForwarder	Пересылка результатов и журналов событий.
ResultDBReporter	Отчет о результатах, который загружает результаты тестов в ResultDB.
ResultForwarder	`ITestInvocationListener` , который пересылает результаты вызова в список других прослушивателей.
ResultReporter
RetryLogSaverResultForwarder	Экспедитор, который также обрабатывает текущую попытку, в которой мы находимся.
RetryResultForwarder	Расширение `ResultForwarder` , которое всегда возвращает попытку с заданным номером.
RuntimeRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового прогона, если таковые имеются.
ScreenshotOnFailureCollector	Сборщик, который сделает снимок экрана и запишет его в журнал в случае сбоя тестового случая.
ShardListener	`ITestInvocationListener` , который собирает результаты из фрагмента вызова (также известного как разделение вызова для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю.
ShardMainResultForwarder	`ResultForwarder` , который объединяет результаты вызовов разделенного теста.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы showmap из устройства и собирать из него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, который обрабатывает метрики датчиков, собранные по принципу «до/после», т. е.
StatsdEventMetricPostProcessor	Постпроцессор, который обрабатывает метрики событий в отчетах statsd в пары «ключ-значение», используя форматировщики, указанные в процессоре.
StatsdGenericPostProcessor	Постпроцессор, который преобразует двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
ПодпроцессРезультатыРепортер	Реализует `ITestInvocationListener` для указания в качестве result_reporter и пересылки из подпроцесса результатов тестов, тестовых запусков, тестовых вызовов.
SuiteResultReporter	Соберите результаты тестирования для всего набора вызовов и выведите окончательные результаты.
TestResultListener	Упрощенный вариант ITestLifecycleListener для разработчиков, которым важны только результаты отдельных тестов.
TestRunResultListener	Прослушиватель, позволяющий считывать окончательный статус выполнения теста.
TestTimeoutEnforcer	Прослушиватели, которые позволяют проверять время выполнения заданного тестового случая и завершать его неудачей, если время превышает заданное время ожидания.
TextResultReporter	Отчет о результатах теста, который пересылает результаты на текстовый принтер JUnit.
TraceCmdCollector	`IMetricCollector` , который собирает трассировки во время теста с помощью trace-cmd и регистрирует их при вызове.
TradefedSandboxRunner.StubScheduledInvocationListener	Заглушка `IScheduledInvocationListener` которая ничего не делает.
XmlFormattedGeneratorReporter	Реализация `FormattedGeneratorReporter` , которая форматирует результаты набора в формат XML.
XmlResultReporter	Записывает результаты JUnit в XML-файлы в формате, соответствующем Ant XMLJUnitResultFormatter.

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

Создан по образцу org.junit.runner.notification.RunListener

Последовательность вызовов будет следующей:

testRunStarted
тест начат
[тест не пройден]
[testAssumptionFailure]
[тест проигнорирован]
тест завершен
....
[testRunFailed]
testRunEnded

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

Публичные методы
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест сигнализирует, что он предполагает ложное условие.
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Вызывается, когда атомарный тест сигнализирует, что он предполагает ложное условие.
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` Альтернатива `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` где мы можем напрямую указать время окончания.
`default void`	`testEnded ( TestDescription test, testMetrics)` Сообщает об окончании выполнения отдельного тестового случая.
`default void`	`testFailed ( TestDescription test, FailureDescription failure)` Сообщает о неудачном завершении отдельного тестового случая.
`default void`	`testFailed ( TestDescription test, String trace)` Сообщает о неудачном завершении отдельного тестового случая.
`default void`	`testIgnored ( TestDescription test)` Вызывается, когда тест не будет запущен, обычно потому, что метод теста аннотирован org.junit.Ignore.
`default void`	`testRunEnded (long elapsedTimeMillis, runMetrics)` Сообщается об окончании тестового прогона.
`default void`	`testRunFailed ( FailureDescription failure)` Сообщается, что тестовый запуск не был завершен из-за сбоя, описанного `FailureDescription` .
`default void`	`testRunFailed (String errorMessage)` Тестовый запуск отчета не был завершен из-за фатальной ошибки.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Сообщает о начале тестового прогона.
`default void`	`testRunStarted (String runName, int testCount)` Сообщает о начале тестового прогона.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Сообщает о начале тестового прогона.
`default void`	`testRunStopped (long elapsedTime)` Сообщает, что тестовый запуск был остановлен до завершения по запросу пользователя.
`default void`	`testSkipped ( TestDescription test, SkipReason reason)` Вызывается, когда тест пропущен и не выполнен по причине, которая обычно не ожидается.
`default void`	`testStarted ( TestDescription test, long startTime)` Альтернатива `testStarted(com.android.tradefed.result.TestDescription)` , где мы также указываем, когда был запущен тест, в сочетании с `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` для точного измерения.
`default void`	`testStarted ( TestDescription test)` Сообщает о начале отдельного тестового случая.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Параметры
`test`	`TestDescription` : идентифицирует тест
`trace`	`String` : трассировка стека отказа

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Параметры
`test`	`TestDescription` : идентифицирует тест
`failure`	`FailureDescription` : `FailureDescription` , описывающее сбой и его контекст.

тест завершен

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Альтернатива ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) , где можно напрямую указать время окончания. Для точного измерения используйте testStarted(com.android.tradefed.result.TestDescription, long) .

Параметры
`test`	`TestDescription` : идентифицирует тест
`endTime`	`long` : время окончания теста, измеренное с помощью `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` выданных метрик

тест завершен

public void testEnded (TestDescription test, 
                 testMetrics)

Сообщает об окончании выполнения отдельного тестового случая.

Если testFailed(TestDescription, FailureDescription) не был вызван, тест считается пройденным. Также возвращаются все метрики «ключ/значение», которые могли быть получены во время выполнения тестового случая.

Параметры
`test`	`TestDescription` : идентифицирует тест
`testMetrics`	: `ERROR(/Map)` выданных метрик

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Сообщает о неудачном завершении отдельного тестового случая.

Будет вызван между testStarted и testEnded.

Параметры
`test`	`TestDescription` : идентифицирует тест
`failure`	`FailureDescription` : `FailureDescription` , описывающее сбой и его контекст.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Сообщает о неудачном завершении отдельного тестового случая.

Будет вызван между testStarted и testEnded.

Параметры
`test`	`TestDescription` : идентифицирует тест
`trace`	`String` : трассировка стека отказа

тест проигнорирован

public void testIgnored (TestDescription test)

Вызывается, когда тест не будет запущен, обычно потому, что метод теста аннотирован org.junit.Ignore.

Параметры
`test`	`TestDescription` : идентифицирует тест

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Сообщается об окончании тестового прогона.

Параметры
`elapsedTimeMillis`	`long` : устройство сообщило прошедшее время в миллисекундах
`runMetrics`	: пары «ключ-значение», сообщаемые в конце тестового прогона

testRunFailed

public void testRunFailed (FailureDescription failure)

Сообщается, что тестовый запуск не был завершен из-за сбоя, описанного FailureDescription .

Параметры
`failure`	`FailureDescription` : `FailureDescription` , описывающее сбой и его контекст.

testRunFailed

public void testRunFailed (String errorMessage)

Тестовый запуск отчета не был завершен из-за фатальной ошибки.

Параметры
`errorMessage`	`String` : `String` описывающая причину сбоя запуска.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Сообщает о начале тестового прогона.

Параметры
`runName`	`String` : имя тестового запуска
`testCount`	`int` : общее количество тестов в тестовом запуске
`attemptNumber`	`int` : порядковый номер, идентифицирующий различные попытки одного и того же runName, выполняемые несколько раз. Попытка (temptNumber) имеет индекс 0 и должна увеличиваться при каждом новом запуске. Например, тест повторяется 3 раза, всего должно быть 4 запуска с одним и тем же runName, а attemptNumber находится в диапазоне от 0 до 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Сообщает о начале тестового прогона.

Параметры
`runName`	`String` : имя тестового запуска
`testCount`	`int` : общее количество тестов в тестовом запуске

testRunStarted

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

Сообщает о начале тестового прогона.

Параметры
`runName`	`String` : имя тестового запуска
`testCount`	`int` : общее количество тестов в тестовом запуске
`attemptNumber`	`int` : порядковый номер, идентифицирующий различные попытки одного и того же runName, выполняемые несколько раз. Попытка (temptNumber) имеет индекс 0 и должна увеличиваться при каждом новом запуске. Например, тест повторяется 3 раза, всего должно быть 4 запуска с одним и тем же runName, а attemptNumber находится в диапазоне от 0 до 3.
`startTime`	`long` : время начала выполнения, измеренное с помощью `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

Сообщает, что тестовый запуск был остановлен до завершения по запросу пользователя.

TODO: в настоящее время не используется, рассмотрите возможность удаления

Параметры
`elapsedTime`	`long` : устройство сообщило прошедшее время в миллисекундах

тестПропущен

public void testSkipped (TestDescription test, 
                SkipReason reason)

Вызывается, когда тест пропущен и не выполнен по причине, которая обычно не ожидается. Эти тесты будут повторно выполнены, чтобы попытаться добиться корректного выполнения.

Параметры
`test`	`TestDescription` : идентифицирует тест
`reason`	`SkipReason` : `SkipReason`

тест начат

public void testStarted (TestDescription test, 
                long startTime)

Альтернатива testStarted(com.android.tradefed.result.TestDescription) , где мы также указываем, когда был запущен тест, в сочетании с ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) для точного измерения.

Параметры
`test`	`TestDescription` : идентифицирует тест
`startTime`	`long` : время начала теста, измеренное с помощью `System.currentTimeMillis()`

тест начат

public void testStarted (TestDescription test)

Сообщает о начале отдельного тестового случая. В старом интерфейсе следует использовать testStarted(com.android.tradefed.result.TestDescription) везде, где это возможно.

Параметры
`test`	`TestDescription` : идентифицирует тест