Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

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

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

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

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CodeCoverageCollector , CollectingTestListener и еще 52.

АгрегатПостпроцессор	Агрегатор метрик, который выдает минимальное, максимальное, среднее значение, дисперсию, стандартное отклонение, общее количество, количество и, при необходимости, процентили для числовых показателей, собранных во время многократных итераций тестирования, рассматривая их как двойные.
Атрацеколлектор	`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 на тестируемом устройстве и сбора журнала для каждого теста.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках, когда тест-кейс не пройден.
BugreportzOnTestCaseFailureCollector	Соберите отчет об ошибках в случае сбоя тестового примера при выполнении.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия Clang с устройства и регистрировать их как тестовые артефакты.
Коллектор CodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения Java и собственного покрытия с устройства и регистрировать их как тестовые артефакты.
СборTestListener	`ITestInvocationListener` , который будет собирать все результаты тестов.
Консольрезультатрепортер	Средство создания отчетов о результатах для вывода результатов теста на консоль.
Коллектор тестовых случаев	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового сценария.
Девицетрацеколлектор	Сборщик, который запускает трассировку perfetto при запуске теста и записывает файл трассировки в конце.
EventsLoggerListener	Прослушиватель, который записывает все полученные события в файл.
филепроторезультатрепортер	Прото-репортер, который сохраняет `TestRecord` в файл.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключи метрик, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector	Регистратор файла, о котором сообщает сторона устройства.
ФорматированныйГенераторРепортер	Reporter, позволяющий генерировать отчеты в определенном формате.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет получать измерения покрытия gcov с устройства и регистрировать их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия ядра gcov из debugfs и с устройства, а затем, наконец, регистрировать их как тестовые артефакты.
GranularRetriableTestWrapper.StartEndCollector	Помощник класса, позволяющий отловить пропущенное начало и конец прогона.
Хостстатсдметрикколлектор	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
IMetricCollector	Этот интерфейс будет добавлен в качестве декоратора при сообщении о результатах тестов для сбора соответствующих показателей.
IPostProcessor	Постпроцессоры — это объект Торговой федерации, предназначенный для обработки метрик и журналов ПОСЛЕ тестов и ДО отчета о результатах.
ВызовProtoResultReporter	Репортеры для хранения информации о кэшировании уровня вызова и списка модулей.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет получать измерения покрытия Java с устройства и регистрировать их как тестовые артефакты.
JsonHttpTestResultReporter	Отчет о результатах, который кодирует результаты тестовых показателей и разветвляет информацию об устройстве в JSON и POST в конечную точку службы HTTP.
LUCIResultReporter	Средство создания отчетов о результатах, которое сохраняет результаты тестов, необходимые для ResultDB и LUCI, в формате JSON (go/result-sink) и записывает расположение файла в консоли.
LegacySubprocessResultsReporter	Замороженная реализация генератора отчетов о результатах подпроцесса, которая должна оставаться совместимой с более ранними версиями TF/CTS (например, 8+), несмотря на изменения в его суперклассе.
LogSaverResultForwarder	`ResultForwarder` для сохранения журналов с помощью глобальной системы сохранения файлов.
LogcatOnFailureCollector	Коллектор, который будет захватывать и регистрировать логарифмический анализ в случае сбоя тестового примера.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк logcat.
Метрикфилепостпроцессор	Используется для загрузки файла журнала метрик, собранного на уровне тестирования и выполнения.
МетриксXMLResultReporter	MetricsXMLResultReporter записывает метрики теста и запускает метрики в XML-файл в папке, указанной параметром metrics-folder на этапе invoctionEnded теста.
МодульПрослушиватель	Слушатель, прикрепленный к каждому `IRemoteTest` каждого модуля для сбора списка результатов.
МодульLogcatКоллектор	Версия сборщика logcat, но для модуля.
МодульProtoResultReporter	Отчет о результатах предназначен для сообщения только о результатах уровня модуля.
PerfettoGenericПостпроцессор	Постпроцессор, который обрабатывает прото-файл текстовых/двоичных метрик в пары ключ-значение путем рекурсивного расширения прото-сообщений и полей строковыми значениями до тех пор, пока не встретится поле с числовым значением.
PerfettoPullerМетрикаКоллектор	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы perfetto с устройства и собирать с него метрики.
Проторезультатрепортер	Отчет о результатах создает прототип `TestRecord` со всеми результатами внутри.
ПерезагрузкаПричинаКоллектор	Сборщик, который собирает данные о перезагрузках устройств во время тестового запуска и сообщает о них по причинам и подсчетам.
ОтчетПройденоТесты	Сообщите в файле о возможных фильтрах для исключения пройденного теста.
Агрегатор результатов	Специальный сервер пересылки, который при необходимости объединяет результаты на основе выбранной стратегии повтора.
Результатандлогфорвардер	Пересылка результатов и журналов событий.
Результатдбрепортер	Средство создания отчетов о результатах, которое загружает результаты тестов в ResultDB.
Ретрилогсаверресультфорвардер	Переадресатор, который также обрабатывает передачу текущей попытки, в которой мы находимся.
Сборщик времени выполненияRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются.
Снимок экранаOnFailureCollector	Коллектор, который будет делать снимок экрана и сохранять его в журнале в случае сбоя тестового примера.
ShardListener	`ITestInvocationListener` , который собирает результаты из сегмента вызова (так называемого разделения вызовов для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю.
ShardMainResultForwarder	`ResultForwarder` , который объединяет результаты вызовов сегментированных тестов.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы карты отображения с устройства и собирать с него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, который обрабатывает показатели датчиков, собранные методом «до/после», т.е.
StatsdEventMetricPostProcessor	Постпроцессор, который преобразует метрики событий в отчетах statsd в пары ключ-значение, используя средства форматирования, указанные в процессоре.
StatsdGenericПостпроцессор	Постпроцессор, который обрабатывает двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
SubprocessResultsReporter	Реализует `ITestInvocationListener` который указывается как result_reporter и пересылает из подпроцесса результаты тестов, запусков тестов и вызовов тестов.
SuiteResultReporter	Соберите результаты тестирования для всего вызова пакета и выведите окончательные результаты.
Текстрезультатрепортер	Средство создания отчетов о результатах тестирования, которое пересылает результаты на текстовый принтер JUnit.
Трасскмдколлектор	`IMetricCollector` , который собирает трассировки во время теста с помощью трассировки-cmd и записывает их в журнал при вызове.
XmlFormattedGeneratorReporter	Реализация `FormattedGeneratorReporter` , который форматирует набор, приводит к формату xml.
XmlResultReporter	Записывает результаты JUnit в файлы XML в формате, соответствующем Ant XMLJUnitResultFormatter.

Позволяет ITestInvocationListener прослушивать сохранение файлов журналов.

Это позволяет нескольким ITestInvocationListener использовать один и тот же сохраненный файл журнала при создании отчетов и позволяет избежать необходимости сохранения файла каждым прослушивателем индивидуально, когда ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) .

Классы, реализующие этот интерфейс, должны знать, что testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) будет вызываться всякий раз, когда ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) .

Этот класс также передает глобальный экземпляр ILogSaver , чтобы ITestInvocationListener мог сохранять дополнительные файлы в том же месте.

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

Публичные методы
`default void`	`logAssociation (String dataName, LogFile logFile)` В некоторых случаях журнал должен быть тесно связан с тестовыми примерами, но возможность сделать это напрямую `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` обратный вызов невозможен.
`default void`	`setLogSaver ( ILogSaver logSaver)` Установите `ILogSaver` , чтобы позволить разработчику сохранять файлы.
`default void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Вызывается при сохранении журнала испытаний.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

В некоторых случаях журнал должен быть тесно связан с тестовыми примерами, но возможность сделать это напрямую testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) обратный вызов невозможен. Таким образом, этот обратный вызов позволяет явно обеспечить сильную ассоциацию.

Параметры
`dataName`	`String` : имя данных.
`logFile`	`LogFile` : `LogFile` , который был зарегистрирован ранее и должен быть связан с тестовым примером.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Установите ILogSaver , чтобы позволить разработчику сохранять файлы.

Параметры
`logSaver`	`ILogSaver` : `ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Вызывается при сохранении журнала испытаний.

Следует использовать вместо ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) .

Параметры
`dataName`	`String` : `String` описательное имя данных. например, «device_logcat». Примечание. dataName не может быть уникальным для каждого вызова. т.е. разработчики должны иметь возможность обрабатывать несколько вызовов с одним и тем же именем данных.
`dataType`	`LogDataType` : `LogDataType` данных.
`dataStream`	`InputStreamSource` : `InputStreamSource` данных. Разработчики должны вызвать createInputStream, чтобы начать чтение данных, и обеспечить закрытие результирующего InputStream после завершения.
`logFile`	`LogFile` : `LogFile` содержащий метаданные сохраненного файла.