ITestInvoctionListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver , ITestLogger

com.android.tradefed.result.ITestInvocationListener
АгрегатПостпроцессор Агрегатор метрик, который выдает минимальное, максимальное, среднее значение, дисперсию, стандартное отклонение, общее количество, количество и, при необходимости, процентили для числовых показателей, собранных во время многократных итераций тестирования, рассматривая их как двойные.
Атрацеколлектор IMetricCollector , который запускает трассировку во время теста, собирает результаты и регистрирует их при вызове.
AtraceRunMetricCollector Собирает трассировки из всего тестового каталога в заданном каталоге тестового устройства, регистрирует тестовый каталог, осуществляет постобработку файлов трассировки в тестовом каталоге и агрегирует показатели.
СреднийПостпроцессор Реализация постпроцессора, вычисляющего среднее значение списка метрик.
Базедевицеметрикколлектор Базовая реализация IMetricCollector , которая позволяет запускать и останавливать сбор данных onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) и ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .
БазовыйПостпроцессор Базовый IPostProcessor , который должна расширять каждая реализация.
BluetoothConnectionLatencyCollector Сборщик отправит предварительно определенную конфигурацию метрики продолжительности statsd на устройства и соберет продолжительность соединения Bluetooth для каждого профиля.
BluetoothConnectionStateКоллектор Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния соединения для каждого профиля.
BluetoothConnectionSuccessRateПостпроцессор Реализация постпроцессора, который рассчитывает вероятность успеха для профиля Bluetooth.

Используйте «metric-key-match», чтобы указать метрики, которые содержат состояния соединения Bluetooth в числовом массиве. Пример [0, 1, 2, 3, 0, 1, 2, 3].

BluetoothHciSnoopLogCollector Сборщик для включения отслеживания Bluetooth HCI на тестируемом устройстве и сбора журнала для каждого теста.
BugreportКоллектор Сквозной ITestInvocationListener , который собирает отчеты об ошибках при возникновении настраиваемых событий, а затем вызывает ITestInvocationListener.testLog для своих дочерних элементов после сбора каждого отчета об ошибках.
BugreportzOnFailureCollector Собирайте отчеты об ошибках, когда тест-кейс не пройден.
BugreportzOnTestCaseFailureCollector Собирайте отчеты об ошибках, когда тест-кейс в ходе выполнения терпит неудачу.
ClangCodeCoverageCollector BaseDeviceMetricCollector , который будет извлекать измерения покрытия Clang с устройства и регистрировать их как тестовые артефакты.
Коллектор CodeCoverageCollector BaseDeviceMetricCollector , который будет извлекать измерения Java и собственного покрытия с устройства и регистрировать их как тестовые артефакты.
СборTestListener ITestInvocationListener , который будет собирать все результаты тестов.
Обработчик статуса команды Обработчик, помогающий отслеживать и обновлять статус вызова.
СостояниеОтказМонитор Отслеживайте любые сбои при вызове.
Консольрезультатрепортер Средство создания отчетов о результатах для вывода результатов теста на консоль.
Коллектор тестовых случаев Подсчитайте и сообщите количество тестовых случаев для данного IRemoteTest .
DebugHostLogOnFailureCollector Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового сценария.
УстройствоReleaseReporter Создатель отчетов о выпуске устройств, который управляет связью с родительским процессом для выпускаемых устройств.
Девицетрацеколлектор Сборщик, который запускает трассировку perfetto при запуске теста и записывает файл трассировки в конце.
УстройствоНедоступноМонитор Этот прослушиватель пытается захватить только DNAE уровня тестового примера.
EventsLoggerListener Прослушиватель, который записывает все полученные события в файл.
филепроторезультатрепортер Прото-репортер, который сохраняет TestRecord в файл.
FilePullerDeviceMetricCollector BaseDeviceMetricCollector , который прослушивает ключи метрик, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector Регистратор файла, о котором сообщает сторона устройства.
Фильтредрезультатфорвардер Вариант ResultForwarder , который позволяет сообщать только белый список TestDescription .
ФорматированныйГенераторРепортер Reporter, позволяющий генерировать отчеты в определенном формате.
GcovCodeCoverageCollector BaseDeviceMetricCollector , который будет получать измерения покрытия gcov с устройства и регистрировать их как тестовые артефакты.
GcovKernelCodeCoverageCollector BaseDeviceMetricCollector , который будет извлекать измерения покрытия ядра gcov из debugfs и с устройства, а затем, наконец, регистрировать их как тестовые артефакты.
GranularRetriableTestWrapper.StartEndCollector Помощник класса, позволяющий отловить пропущенное начало и конец прогона.
Хостстатсдметрикколлектор IMetricCollector , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
ICommandScheduler.IScheduledInvoctionListener Прослушиватель событий вызова после завершения вызова.
ILogSaverListener Позволяет ITestInvocationListener прослушивать сохранение файлов журналов.
IMetricCollector Этот интерфейс будет добавлен в качестве декоратора при сообщении о результатах тестов для сбора соответствующих показателей.
IPostProcessor Постпроцессоры — это объект Торговой федерации, предназначенный для обработки метрик и журналов ПОСЛЕ тестов и ДО отчета о результатах.
IShardableListener ITestInvocationListener , который можно сегментировать.
ISupportGranularResults Интерфейс, определяющий, поддерживает ли ITestInvocationListener получение детализированных результатов или нет.
ITestSummaryListener Интерфейс, который позволяет ITestInvocationListener обмениваться некоторой ограниченной информацией через сводки.
ВызовProtoResultReporter Репортеры для хранения информации о кэшировании уровня вызова и списка модулей.
ВызовToJUnitResultForwarder Класс, который прослушивает события 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 Специальный прослушиватель: в случае сбоя (сбоя процесса инструментирования) он попытается извлечь из логарифма сбой и добавить его к сообщению об ошибке, связанному с тестом.
LogcatOnFailureCollector Коллектор, который будет захватывать и регистрировать логарифмический анализ в случае сбоя тестового примера.
LogcatTimingMetricCollector Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк logcat.
Метрикфилепостпроцессор Используется для загрузки файла журнала метрик, собранного на уровне тестирования и выполнения.
МетриксXMLResultReporter MetricsXMLResultReporter записывает тестовые метрики и запускает метрики в XML-файл в папке, указанной параметром metrics-folder на этапе invoctionEnded теста.
МодульПрослушиватель Слушатель, прикрепленный к каждому IRemoteTest каждого модуля для сбора списка результатов.
МодульLogcatКоллектор Версия сборщика logcat, но для модуля.
МодульProtoResultReporter Отчет о результатах предназначен для сообщения только о результатах уровня модуля.
ИмяMangleListener Прослушиватель прокси-сервера для перевода имен тестовых методов, классов и пакетов по мере сообщения о результатах.
ПрохождениеTestFileReporter ITestInvocationListener , сохраняющий список пройденных тестовых случаев в тестовый файл.
PerfettoGenericПостпроцессор Постпроцессор, который обрабатывает прото-файл текстовых/двоичных метрик в пары ключ-значение путем рекурсивного расширения прото-сообщений и полей строковыми значениями до тех пор, пока не встретится поле с числовым значением.
PerfettoPullerМетрикаКоллектор Базовая реализация FilePullerDeviceMetricCollector , которая позволяет извлекать файлы perfetto с устройства и собирать с него метрики.
PrettyTestEventLogger Регистратор, сопоставляющий события и регистрирующий их, чтобы упростить отладку.
Проторезультатрепортер Отчет о результатах создает прототип TestRecord со всеми результатами внутри.
PythonBinaryHostTest.PythonForwarder Средство пересылки результатов для замены имени запуска двоичным именем.
ПерезагрузкаПричинаКоллектор Сборщик, который собирает данные о перезагрузках устройств во время тестового запуска и сообщает о них по причинам и подсчетам.
Ремотетесттимеаутенфорсер Слушатели, которые позволяют проверить время выполнения заданной тестовой конфигурации и провалить ее, если она превышает заданный таймаут.
ОтчетПройденоТесты Сообщите в файле о возможных фильтрах для исключения пройденного теста.
Агрегатор результатов Специальный сервер пересылки, который при необходимости объединяет результаты на основе выбранной стратегии повторных попыток.
Результатандлогфорвардер Пересылка результатов и журналов событий.
Результатдбрепортер Средство создания отчетов о результатах, которое загружает результаты тестов в ResultDB.
Результатфорвардер ITestInvocationListener , который пересылает результаты вызова списку других прослушивателей.
Ретрилогсаверресультфорвардер Переадресатор, который также обрабатывает передачу текущей попытки, в которой мы находимся.
Повторить результатпересылки Расширение ResultForwarder , которое всегда передает заданный номер попытки.
Сборщик времени выполненияRestartCollector Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются.
Снимок экранаOnFailureCollector Сборщик, который будет делать снимок экрана и сохранять его в журнале в случае сбоя тестового примера.
ShardListener ITestInvocationListener , который собирает результаты из сегмента вызова (так называемого разделения вызовов для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю.
ShardMainResultForwarder ResultForwarder , который объединяет результаты вызовов сегментированных тестов.
ShowmapPullerMetricCollector Базовая реализация FilePullerDeviceMetricCollector , которая позволяет извлекать файлы карты отображения с устройства и собирать с него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor Постпроцессор, который обрабатывает показатели датчиков, собранные методом «до/после», т.е.
StatsdEventMetricPostProcessor Постпроцессор, который преобразует метрики событий в отчетах statsd в пары ключ-значение, используя средства форматирования, указанные в процессоре.
StatsdGenericПостпроцессор Постпроцессор, который обрабатывает двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter Реализация ProtoResultReporter
SubprocessResultsReporter Реализует ITestInvocationListener который указывается как result_reporter и пересылает из подпроцесса результаты тестов, запусков тестов и вызовов тестов.
SuiteResultReporter Соберите результаты тестирования для всего вызова пакета и выведите окончательные результаты.
Прослушиватель TestRunResultListener Прослушиватель, позволяющий прочитать окончательный статус выполнения теста.
Тесттаймаутэнфорсер Слушатели, которые позволяют проверить время выполнения данного тестового примера и не выполнить его, если оно превышает заданный таймаут.
TextResultReporter Средство создания отчетов о результатах тестирования, которое пересылает результаты на текстовый принтер JUnit.
Трацекмдколлектор IMetricCollector , который собирает трассировки во время теста с помощью трассировки-cmd и записывает их в журнал при вызове.
TradefedSandboxRunner.StubScheduledInvoctionListener Заглушка IScheduledInvocationListener , которая ничего не делает.
XmlFormattedGeneratorReporter Реализация FormattedGeneratorReporter , который форматирует набор, приводит к формату xml.
XmlResultReporter Записывает результаты JUnit в XML-файлы в формате, соответствующем Ant XMLJUnitResultFormatter.


Прослушиватель результатов теста при вызове теста.

Вызов теста сам по себе может включать в себя несколько запусков тестов, поэтому последовательность вызовов будет такой:

  • вызовStarted(BuildInfo)
  • testRunStarted
  • тестНачало
  • [тест не пройден]
  • testEnded
  • ...
  • testRunEnded
  • ...
  • testRunStarted
  • ...
  • testRunEnded
  • [Ошибка вызова]
  • [Журнал тестирования+]
  • вызовЗавершен
  • получитьСводка

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

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

default TestSummary getSummary ()

Позволяет InvokeListener возвращать сводку.

default void invocationEnded (long elapsedTime)

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

default void invocationFailed ( FailureDescription failure)

Сообщает о неполном вызове из-за какой-либо ошибки.

default void invocationFailed (Throwable cause)

Сообщает о неполном вызове из-за какой-либо ошибки.

default void invocationInterrupted ()

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

default void invocationSkipped ( SkipReason reason)

Сообщает о пропущенном вызове

default void invocationStarted ( IInvocationContext context)

Сообщает о начале тестового вызова.

default void testModuleEnded ()

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

default void testModuleStarted ( IInvocationContext moduleContext)

Сообщает о начале работы модуля.

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

получитьСводка

public TestSummary getSummary ()

Позволяет InvokeListener возвращать сводку.

Возврат
TestSummary TestSummary суммирующий прогон, или нулевой

вызовЗавершен

public void invocationEnded (long elapsedTime)

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

Будет автоматически вызываться платформой TradeFederation.

Параметры
elapsedTime long : прошедшее время вызова в мс.

вызов не пройден

public void invocationFailed (FailureDescription failure)

Сообщает о неполном вызове из-за какой-либо ошибки.

Будет автоматически вызываться платформой TradeFederation.

Параметры
failure FailureDescription : « FailureDescription описывающее причину сбоя.

вызов не пройден

public void invocationFailed (Throwable cause)

Сообщает о неполном вызове из-за какой-либо ошибки.

Будет автоматически вызываться платформой TradeFederation.

Параметры
cause Throwable : Throwable причина сбоя

вызовПрерванный

public void invocationInterrupted ()

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

вызовПропущен

public void invocationSkipped (SkipReason reason)

Сообщает о пропущенном вызове

Параметры
reason SkipReason

вызовНачало

public void invocationStarted (IInvocationContext context)

Сообщает о начале тестового вызова.

Будет автоматически вызываться платформой TradeFederation. Создателям отчетов необходимо переопределить этот метод для поддержки отчетов с нескольких устройств.

Параметры
context IInvocationContext : информация о вызове.

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Сообщает о начале работы модуля. Этот обратный вызов связан с testModuleEnded() и является необязательным в последовательности. Он используется только во время запуска, в котором используются модули: бегуны на основе набора.

Параметры
moduleContext IInvocationContext : IInvocationContext модуля.