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

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

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

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFail ureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener и еще 75.

АгрегатПостпроцессор	Агрегатор метрик, который выдает минимальное, максимальное, среднее значение, дисперсию, стандартное отклонение, общее количество, количество и, при необходимости, процентили для числовых показателей, собранных во время многократных итераций тестирования, рассматривая их как двойные.
Атрацеколлектор	`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 с устройства и регистрировать их как тестовые артефакты.
СборTestListener	`ITestInvocationListener` , который будет собирать все результаты тестов.
Обработчик статуса команды	Обработчик, помогающий отслеживать и обновлять статус вызова.
СостояниеОтказМонитор	Отслеживайте любые сбои при вызове.
Консольрезультатрепортер	Средство создания отчетов о результатах для вывода результатов теста на консоль.
Коллектор тестовых случаев	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
Слушатель подсчета результатов теста	`TestResultListener` , который отслеживает общее количество тестов по `TestStatus`
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` получение детализированных результатов или нет.
ITestInvoctionListener	Прослушиватель результатов теста при вызове теста.
ITestSummaryListener	Интерфейс, который позволяет `ITestInvocationListener` обмениваться некоторой ограниченной информацией через сводки.
Вызов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, но для модуля.
ИмяMangleListener	Прослушиватель прокси-сервера для перевода имен тестовых методов, классов и пакетов по мере сообщения о результатах.
ПрохождениеTestFileReporter	`ITestInvocationListener` , сохраняющий список пройденных тестовых случаев в тестовый файл.
PerfettoGenericПостпроцессор	Постпроцессор, который обрабатывает прото-файл текстовых/двоичных метрик в пары ключ-значение путем рекурсивного расширения прото-сообщений и полей строковыми значениями до тех пор, пока не встретится поле с числовым значением.
PerfettoPullerМетрикаКоллектор	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы perfetto с устройства и собирать с него метрики.
PrettyTestEventLogger	Регистратор, сопоставляющий события и регистрирующий их, чтобы упростить отладку.
Проторезультатрепортер	Отчет о результатах создает прототип `TestRecord` со всеми результатами внутри.
PythonBinaryHostTest.PythonForwarder	Средство пересылки результатов для замены имени запуска двоичным именем.
ПерезагрузкаПричинаКоллектор	Сборщик, который собирает данные о перезагрузках устройств во время тестового запуска и сообщает о них по причинам и подсчетам.
Ремотетесттимеаутенфорсер	Слушатели, которые позволяют проверить время выполнения заданной тестовой конфигурации и провалить ее, если она превышает заданный таймаут.
ОтчетПройденоТесты	Сообщите в файле о возможных фильтрах для исключения пройденного теста.
Агрегатор результатов	Специальный сервер пересылки, который при необходимости объединяет результаты на основе выбранной стратегии повтора.
Результатандлогфорвардер	Пересылка результатов и журналов событий.
Результатфорвардер	`ITestInvocationListener` , который пересылает результаты вызова списку других прослушивателей.
Ретрилогсаверресультфорвардер	Переадресатор, который также обрабатывает передачу текущей попытки, в которой мы находимся.
Повторить результатпересылки	Расширение `ResultForwarder` , которое всегда передает заданный номер попытки.
Сборщик времени выполненияRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются.
Снимок экранаOnFailureCollector	Сборщик, который будет делать снимок экрана и сохранять его в журнале в случае сбоя тестового примера.
ShardListener	`ITestInvocationListener` , который собирает результаты из сегмента вызова (так называемого разделения вызовов для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю.
ShardMainResultForwarder	`ResultForwarder` , который объединяет результаты вызовов сегментированных тестов.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы карты отображения с устройства и собирать с него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, который обрабатывает показатели датчиков, собранные методом «до/после», т.е.
StatsdEventMetricPostProcessor	Постпроцессор, который преобразует метрики событий в отчетах statsd в пары ключ-значение, используя средства форматирования, указанные в процессоре.
StatsdGenericПостпроцессор	Постпроцессор, который обрабатывает двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
SubprocessResultsReporter	Реализует `ITestInvocationListener` , который указывается как result_reporter и пересылает из подпроцесса результаты тестов, запусков тестов и вызовов тестов.
SuiteResultReporter	Соберите результаты тестирования для всего вызова пакета и выведите окончательные результаты.
Прослушиватель TestResultListener	Упрощение ITestLifecycleListener для разработчиков, которых интересуют только результаты отдельных тестов.
Тесттаймаутэнфорсер	Слушатели, которые позволяют проверить время выполнения данного тестового примера и не выполнить его, если оно превышает заданный таймаут.
TextResultReporter	Средство создания отчетов о результатах тестирования, которое пересылает результаты на текстовый принтер JUnit.
Трацекмдколлектор	`IMetricCollector` , который собирает трассировки во время теста с помощью трассировки-cmd и записывает их в журнал при вызове.
TradefedSandboxRunner.StubScheduledInvoctionListener	Заглушка `IScheduledInvocationListener` , которая ничего не делает.
XmlFormattedGeneratorReporter	Реализация `FormattedGeneratorReporter` , который форматирует набор, приводит к формату xml.
XmlResultReporter	Записывает результаты JUnit в XML-файлы в формате, соответствующем Ant XMLJUnitResultFormatter.

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

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

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

testRunStarted
тестНачало
[тест не пройден]
[testAssumptionFailure]
[тестИгнорируется]
testEnded
....
[testRunFailed]
testRunEnded

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

Публичные методы
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Альтернатива `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` где мы можем напрямую указать время окончания.
`default void`	`testEnded ( TestDescription test, testMetrics)` `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)` `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` описывающая сбой и его контекст.

testEnded

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

testEnded

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)

Сообщает об окончании тестового запуска. ИСПРАВЛЕНИЕ: мы не можем иметь два интерфейса Map<> разного типа, поэтому здесь нам придется использовать HashMap.

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

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` : номер заказа, идентифицирующий различные попытки одного и того же имени запуска, которые выполняются несколько раз. Номер попытки имеет индекс 0 и должен увеличиваться каждый раз, когда происходит новый запуск. например, тест гранулярно повторяется 3 раза, всего должно быть 4 запуска под одним и тем же именем запуска, а номер попытки — от 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` : номер заказа, идентифицирующий различные попытки одного и того же имени запуска, которые выполняются несколько раз. Номер попытки имеет индекс 0 и должен увеличиваться каждый раз при новом запуске. например, тест гранулярно повторяется 3 раза, всего должно быть 4 запуска под одним и тем же именем запуска, а номер попытки — от 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` : идентифицирует тест.