Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в 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 и 81 другой.

АгрегатныйПостПроцессор	Агрегатор метрик, который выдает минимум, максимум, среднее значение, дисперсию, стандартное отклонение, общее количество и, при необходимости, процентили для числовых метрик, собранных во время многоитерационных тестовых запусков, рассматривая их как двойные значения.
AtraceCollector	`IMetricCollector` , который запускает atrace во время теста, собирает результаты и регистрирует их в вызове.
AtraceRunMetricCollector	Собирает трассировки из всех тестовых каталогов в указанном каталоге с тестового устройства, регистрирует тестовый каталог и выполняет постобработку файлов трассировки в тестовом каталоге и агрегирует метрики.
СреднийПостПроцессор	Реализация постпроцессора, вычисляющего среднее значение списка метрик.
BaseDeviceMetricCollector	Базовая реализация `IMetricCollector` , которая позволяет запускать и останавливать сбор данных при `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` и `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
БазовыйПостПроцессор	Базовый `IPostProcessor` , который должна расширять каждая реализация.
BluetoothConnectionLatencyCollector	Сборщик будет отправлять на устройства предварительно заданную конфигурацию метрики длительности statsd и собирать данные о длительности Bluetooth-подключения для каждого профиля.
BluetoothConnectionStateCollector	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и регистрировать номер состояния подключения для каждого профиля.
BluetoothСоединениеУспехСкоростьПостПроцессор	Реализация постпроцессора, который вычисляет вероятность успеха для профиля 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` .
ПодсчетТестРезультатаСлушатель	`TestResultListener` , который отслеживает общее количество тестов по `TestStatus`
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового случая.
DeviceReleaseReporter	Отчет о выпуске устройств, который управляет взаимодействием с родительским процессом относительно устройств, которые необходимо освободить.
DeviceTraceCollector	Коллектор, который запустит идеальную трассировку при запуске тестового прогона и запишет файл трассировки в конце.
УстройствоНедоступноМонитор	Этот прослушиватель пытается захватить только DNAE уровня тестового случая.
EventsLoggerListener	Прослушиватель, который регистрирует все полученные события в файле.
FileProtoResultReporter	Proto-репортер, который сохраняет `TestRecord` в файл.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключевые метрики, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector	Регистратор файла, предоставленного устройством.
ФильтрованныйРезультатПересылка	Вариант `ResultForwarder` , который позволяет сообщать только разрешенный список `TestDescription` .
ФорматированныйГенераторРепортер	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)` .
LegacySubprocessResultsReporter	Замороженная реализация отчета о результатах подпроцесса, которая должна оставаться совместимой с более ранними версиями TF/CTS (например, 8+), несмотря на изменения в его суперклассе.
LogSaverResultForwarder	`ResultForwarder` для сохранения журналов с помощью глобального хранителя файлов.
LogcatCrashResultForwarder	Специальный прослушиватель: в случае сбоев (сбоев процесса инструментирования) он попытается извлечь из logcat информацию о сбое и добавить ее в сообщение об ошибке, связанное с тестом.
LogcatOnFailureCollector	Сборщик, который будет собирать и регистрировать logcat в случае сбоя тестового случая.
LogcatTimingMetricCollector	Сборщик метрик, который собирает временную информацию (например, время переключения пользователя) из Logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк Logcat.
MetricFilePostProcessor	Используется для загрузки файла журнала показателей, собранных во время тестирования и выполнения.
МетрикиXMLResultReporter	MetricsXMLResultReporter записывает тестовые метрики и метрики запуска в XML-файл в папке, указанной параметром metrics-folder на этапе invocationEnded теста.
МодульСлушатель	Прослушиватель, прикрепленный к каждому `IRemoteTest` каждого модуля, для сбора списка результатов.
МодульLogcatCollector	Версия сборщика logcat, но для модуля.
МодульProtoResultReporter	Отчет о результатах, предназначенный только для отчетов на уровне модуля.
ModuleResultsAndMetricsForwarder	Расширение `ResultAndLogForwarder` , которое добавляет дополнительные метрики, связанные с модулем, к результатам теста.
ИмяMangleListener	Прокси-слушатель для перевода названий методов тестирования, классов и пакетов по мере предоставления результатов.
PassingTestFileReporter	`ITestInvocationListener` , который сохраняет список пройденных тестовых случаев в тестовый файл.
PerfettoGenericPostProcessor	Постпроцессор, который преобразует текстовый/двоичный метрический файл proto perfetto в пары ключ-значение, рекурсивно расширяя сообщения proto и поля строковыми значениями до тех пор, пока не будет обнаружено поле с числовым значением.
PerfettoPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы Perfetto из устройства и собирать с него метрики.
PrettyTestEventLogger	Регистратор сопоставляет события и регистрирует их для облегчения отладки.
ProtoResultReporter	Отчет о результатах создает Protobuf `TestRecord` со всеми результатами внутри.
PythonBinaryHostTest.PythonForwarder	Пересылка результатов для замены имени запуска на двоичное имя.
RebootReasonCollector	Сборщик, который собирает перезагрузки устройств во время тестового прогона и сообщает о них по причинам и количеству.
RemoteTestTimeOutEnforcer	Прослушиватели, которые позволяют проверять время выполнения заданной конфигурации теста и завершать его неудачей, если он превышает заданное время ожидания.
ОтчетПройденные тесты	Сообщите в файле возможные фильтры для исключения пройденных тестов.
РезультатАгрегатор	Специальный пересылающий модуль, который при необходимости объединяет результаты на основе выбранной стратегии повторных попыток.
РезультатИЖурналПересылки	Пересылка результатов и событий журналов.
ResultDBReporter
РезультатForwarder	`ITestInvocationListener` , который пересылает результаты вызова в список других слушателей.
RetryLogSaverResultForwarder	Экспедитор, который также обрабатывает текущую попытку, в которой мы находимся.
RetryResultForwarder	Расширение `ResultForwarder` , которое всегда выполняет попытку с заданным номером.
RuntimeRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового прогона, если таковые имеются.
СкриншотOnFailureCollector	Сборщик, который сделает снимок экрана и запишет его в журнал в случае сбоя тестового случая.
ShardListener	`ITestInvocationListener` , который собирает результаты из фрагмента вызова (также известного как разделение вызова для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю.
ShardMainResultForwarder	`ResultForwarder` , который объединяет результаты вызовов фрагментированного теста.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы showmap с устройства и собирать из него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, который обрабатывает метрики датчиков, собранные по принципу «до/после», т.е.
StatsdEventMetricPostProcessor	Постпроцессор, который обрабатывает метрики событий в отчетах statsd в пары ключ-значение, используя форматировщики, указанные в процессоре.
StatsdGenericPostProcessor	Постпроцессор, который преобразует двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
ПодпроцессРезультатыРепортер	Реализует `ITestInvocationListener` для указания в качестве result_reporter и пересылки из подпроцесса результатов тестов, тестовых запусков, тестовых вызовов.
SuiteResultReporter	Соберите результаты тестирования для всего набора вызовов и выведите окончательные результаты.
TestResultListener	Упрощение ITestLifecycleListener для разработчиков, которым важны только результаты отдельных тестов.
TestRunResultListener	Прослушиватель, позволяющий считывать окончательный статус тестового запуска.
TestTimeoutEnforcer	Прослушиватели, которые позволяют проверять время выполнения заданного тестового случая и завершать его неудачей, если он превышает заданное время ожидания.
ТекстРезультатРепортер	Отчет о результатах теста, который пересылает результаты на текстовый принтер результатов JUnit.
TraceCmdCollector	`IMetricCollector` , который собирает трассировки во время теста с помощью trace-cmd и регистрирует их в вызове.
TradefedSandboxRunner.StubScheduledInvocationListener	Заглушка `IScheduledInvocationListener` которая ничего не делает.
XmlFormattedGeneratorReporter	Реализация `FormattedGeneratorReporter` , которая форматирует результаты набора в формате XML.
XmlResultReporter	Записывает результаты JUnit в XML-файлы в формате, соответствующем XMLJUnitResultFormatter Ant.

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

Создан по образцу 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)` Сообщает о начале отдельного тестового случая.

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

тестПредположениеНеудача

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

тестПредположениеНеудача

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)` выданных метрик

тестНе пройден

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

тестНе пройден

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, которые выполняются несколько раз. attemptNumber индексируется 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, которые выполняются несколько раз. attemptNumber индексируется 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` : идентифицирует тест