Эта страница переведена с помощью 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 , CollectingTestListener и 75 других.

AggregatePostProcessor	Агрегатор метрик, который дает минимальное, максимальное, среднее значение, дисперсию, стандартное отклонение, общее количество, количество и, при необходимости, процентили для числовых метрик, собранных во время многократных итераций тестов, рассматривая их как двойные.
AtraceКоллектор	`IMetricCollector` , который запускается во время теста, собирает результаты и регистрирует их в вызове.
AtraceRunMetricCollector	Собирает трассировки из всего тестового каталога в заданном каталоге с тестового устройства, регистрирует тестовый каталог и выполняет постобработку файлов трассировки в тестовом каталоге и агрегирует метрики.
СреднийПостпроцессор	Реализация постпроцессора, вычисляющего среднее значение списка метрик.
BaseDeviceMetricCollector	Базовая реализация `IMetricCollector` , позволяющая запускать и останавливать сбор `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` и `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
BasePostProcessor	Базовый `IPostProcessor` , который должна расширять каждая реализация.
BluetoothConnectionLatencyCollector	Сборщик отправит предварительно определенную конфигурацию метрики длительности statsd на устройства и соберет продолжительность соединения Bluetooth для каждого профиля.
BluetoothConnectionStateКоллектор	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния подключения для каждого профиля.
BluetoothConnectionSuccessRatePostProcessor	Реализация постпроцессора, который вычисляет вероятность успеха для профиля Bluetooth. Используйте «метрика-ключ-соответствие», чтобы указать метрики, которые содержат состояния подключения Bluetooth в числовом массиве Пример [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Collector, чтобы включить ведение журнала Bluetooth HCI snoop на тестируемом устройстве и собирать журнал для каждого теста.
Отчет об ошибкахКоллектор	Проходной прослушиватель `ITestInvocationListener` , который собирает отчеты об ошибках при возникновении настраиваемых событий, а затем вызывает `ITestInvocationListener#testLog` для своих дочерних элементов после сбора каждого отчета об ошибке.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках при сбое тестового примера.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках при сбое тестового набора.
ClangCodeCoverageКоллектор	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия Clang с устройства и регистрировать их как тестовые артефакты.
Сбор тестового прослушивателя	`ITestInvocationListener` , который будет собирать все результаты тестирования.
CommandStatusHandler	Обработчик, помогающий отслеживать и обновлять статус вызова.
ConditionFailureMonitor	Отслеживайте любые сбои при вызове.
ConsoleResultReporter	Result Reporter для вывода результатов теста на консоль.
CountTestCasesCollector	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
Прослушиватель подсчета результатов теста	`TestResultListener` , который отслеживает общее количество тестов по `TestStatus`
DebugHostLogOnFailureCollector	Коллектор, который будет собирать и регистрировать журналы на стороне хоста при возникновении сбоя тестового примера.
Девайсрелизерепортер	Средство создания отчетов о выпуске устройств, которое обрабатывает связь с родительским процессом устройств, подлежащих освобождению.
DeviceTraceКоллектор	Сборщик, который запустит трассировку perfetto при запуске тестового прогона и файл трассировки журнала в конце.
УстройствоНедоступныйМонитор	Этот прослушиватель пытается захватить только DNAE уровня тестового примера.
EventsLoggerListener	Слушатель, который записывает все полученные события в файл
FileProtoResultReporter	Proto Reporter, который выгружает `TestRecord` в файл.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключ метрик, поступающий с устройства, и извлекает их в виде файла с устройства.
FilePullerLogКоллектор	Регистратор файла, о котором сообщило устройство.
Фильтредрезультатфорвардер	Вариант `ResultForwarder` , который позволяет сообщать только белый список `TestDescription` .
ФорматтедГенераторРепортер	Reporter, который позволяет генерировать отчеты в определенном формате.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлечет измерения покрытия gcov с устройства и зарегистрирует их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлечет измерения покрытия ядра gcov из отладочных файлов и с устройства, а затем, наконец, зарегистрирует их как тестовые артефакты.
GranularRetriableTestWrapper.StartEndCollector	Помощник класса, чтобы поймать пропущенное начало и конец запуска.
HostStatsdMetricCollector	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью служебных команд statsd.
ICommandScheduler.IScheduledInvocationListener	Прослушиватель событий вызова после завершения вызова.
ILogSaverListener	Позволяет `ITestInvocationListener` прослушивать при сохранении файлов журнала.
IMetricКоллектор	Этот интерфейс будет добавлен в качестве декоратора при составлении отчетов о результатах тестов для сбора соответствующих метрик.
IPostProcessor	Постпроцессоры — это объект Trade Federation, предназначенный для обработки метрик и журналов ПОСЛЕ тестов и ДО отчета о результатах.
IShardableListener	Слушатель `ITestInvocationListener` , который можно сегментировать.
ISupportGranularResults	Интерфейс, указывающий, поддерживает ли `ITestInvocationListener` получение детализированных результатов.
ITestInvocationListener	Прослушиватель результатов теста из вызова теста.
ITestSummaryListener	Интерфейс, который позволяет `ITestInvocationListener` обмениваться некоторой ограниченной информацией через сводки.
InvocationToJUnitResultForwarder	Класс, который прослушивает события `ITestInvocationListener` и перенаправляет их в `TestListener` .
JarHostTest.HostTestListener	Слушатель-оболочка, который перенаправляет все события, кроме testRunStarted() и testRunEnded(), встроенному слушателю.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Java с устройства и регистрирует их как тестовые артефакты.
JsonHttpTestResultReporter	Отчет о результатах, который кодирует результаты тестовых метрик и ветки, информацию об устройстве в JSON и POST в конечную точку службы HTTP.
Ластшарддетектор	При запуске локального сегментирования иногда мы хотим выполнить некоторые действия только тогда, когда последний сегмент достигает `invocationEnded(long)` .
LegacySubprocessResultsReporter	Замороженная реализация генератора отчетов о результатах подпроцесса, который должен оставаться совместимым с более ранними версиями TF/CTS (например, 8+), несмотря на изменения в его суперклассе.
Логсаверресултфорвардер	`ResultForwarder` для сохранения журналов с помощью глобальной файловой заставки.
LogcatCrashResultForwarder	Специальный слушатель: при сбоях (сбой процесса инструментирования) он попытается извлечь из logcat сбой и добавить его в сообщение об ошибке, связанное с тестом.
LogcatOnFailureCollector	Коллектор, который будет захватывать и регистрировать logcat в случае сбоя тестового примера.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа начальных и конечных сигналов события из строк logcat.
МетрикаФайлПостпроцессор	Используется для загрузки файла журнала метрик, собранного во время уровня тестирования и выполнения.
МетриксXMLResultReporter	MetricsXMLResultReporter записывает метрики теста и запускает метрики в XML-файл в папке, указанной параметром metrics-folder на этапе invocationEnded теста.
Слушатель модуля	Слушатель, прикрепленный к каждому `IRemoteTest` каждого модуля, чтобы собрать список результатов.
МодульLogcatКоллектор	Версия сборщика logcat, но для модуля.
ИмяMangleListener	Прокси-слушатель для преобразования имен тестовых методов, классов и пакетов по мере получения результатов.
PassingTestFileReporter	`ITestInvocationListener` , который сохраняет список пройденных тестовых случаев в тестовый файл.
PerfettoGenericPostProcessor	Постпроцессор, который преобразует текстовый/двоичный метрический прото-файл в пары ключ-значение, рекурсивно расширяя прото-сообщения и поля со строковыми значениями до тех пор, пока не встретится поле с числовым значением.
PerfettoPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , позволяющая извлекать файлы перфетто с устройства и собирать с него метрики.
PrettyTestEventLogger	Регистратор сопоставляет события и регистрирует их, чтобы упростить отладку.
ProtoResultReporter	Отчет о результатах создает протобуфер `TestRecord` со всеми результатами внутри.
PythonBinaryHostTest.PythonForwarder	Пересылка результатов для замены имени запуска двоичным именем.
RebootReasonКоллектор	Коллектор, который собирает перезагрузки устройства во время тестового запуска и сообщает о них по причинам и подсчетам.
удаленный тесттимеаутенфорсер	Слушатели, которые позволяют проверять время выполнения заданной тестовой конфигурации и завершаться ошибкой, если она превышает заданный тайм-аут.
Отчет о пройденных тестах	Сообщите в файл возможные фильтры для исключения пройденного теста.
Агрегатор результатов	Специальный сервер пересылки, который при необходимости агрегирует результаты на основе принятой стратегии повторных попыток.
Результатандлогфорвардер	Пересылка для результатов и журналов событий.
ResultForwarder	`ITestInvocationListener` , который перенаправляет результаты вызова в список других прослушивателей.
Ретрилогсаверресултфорвардер	Переадресатор, который также обрабатывает текущую попытку, в которой мы находимся.
Ретриресултфорвардер	Расширение `ResultForwarder` , которое всегда нажимает на заданный номер попытки.
Коллектор среды выполненияRestart	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются.
СкриншотOnFailureCollector	Сборщик, который сделает снимок экрана и зарегистрирует его в случае сбоя тестового примера.
ShardListener	Прослушиватель `ITestInvocationListener` , который собирает результаты из сегмента вызова (так называемого разделения вызова для параллельного выполнения на нескольких ресурсах) и перенаправляет их другому прослушивателю.
ShardMainResultForwarder	Объект `ResultForwarder` , объединяющий результаты вызовов сегментированного теста.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы карты шоу с устройства и собирать с него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, который обрабатывает метрики датчика, собранные в подходе «до/после», т.е.
StatsdEventMetricPostProcessor	Постпроцессор, который обрабатывает метрики событий в отчетах statsd в пары ключ-значение, используя средства форматирования, указанные в процессоре.
StatsdGenericPostProcessor	Постпроцессор, который обрабатывает двоичные отчеты proto statsd в пары ключ-значение, расширяя отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
Репортер подпроцессрезультатов	Реализует `ITestInvocationListener` для указания в качестве result_reporter и пересылки из подпроцесса результатов тестов, тестовых прогонов, тестовых вызовов.
SuiteResultReporter	Соберите результаты тестирования для всего вызова пакета и выведите окончательные результаты.
TestFailureListener	Слушатель, используемый для выполнения таких действий, как снимок экрана, отчет об ошибке, сбор logcat при сбое теста по запросу.
Прослушиватель ТестРезультат	Упрощение ITestLifecycleListener для разработчиков, которым важны только результаты отдельных тестов.
ТестТимеаутЭнфорсер	Слушатели, которые позволяют проверить время выполнения данного тестового примера и завершить его, если он превышает заданный тайм-аут.
TextResultReporter	Средство создания отчетов о результатах тестов, которое пересылает результаты на текстовый принтер результатов JUnit.
TraceCmdКоллектор	`IMetricCollector` , который собирает трассировки во время теста с помощью команды trace-cmd и регистрирует их при вызове.
TradefedSandboxRunner.StubScheduledInvocationListener	Заглушка `IScheduledInvocationListener` , которая ничего не делает.
XmlFormattedGeneratorReporter	Реализация `FormattedGeneratorReporter` , которая форматирует набор, приводит к формату xml.
XmlResultReporter	Записывает результаты JUnit в XML-файлы в формате, совместимом с XMLJUnitResultFormatter Ant.

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

По образцу org.junit.runner.notification.RunListener

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

testRunStarted
testStarted
[тест не пройден]
[тестУспенская ошибка]
[тест игнорируется]
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`	`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)` Сообщает о начале отдельного тестового случая.

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

testAssummentFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssummentFailure

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

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)

Сообщает об окончании тестового прогона. ИСПРАВЛЕНИЕ: У нас не может быть двух интерфейсов 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` : номер заказа, идентифицирующий различные попытки одного и того же runName, которые выполняются несколько раз. ПопыткаNumber имеет индекс 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` : номер заказа, идентифицирующий различные попытки одного и того же runName, которые выполняются несколько раз. ПопыткаNumber имеет индекс 0 и должна увеличиваться каждый раз, когда происходит новый запуск. Например, тест гранулированно повторяется 3 раза, он должен иметь 4 полных запуска под одним и тем же именем запуска, а число попыток — от 0 до 3.
`startTime`	`long` : время запуска, измеренное с помощью `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

testStarted

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()`

testStarted

public void testStarted (TestDescription test)

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

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