Начиная с 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 и 53 других.

АгрегатныйПостПроцессор	Агрегатор метрик, который выдает минимум, максимум, среднее значение, дисперсию, стандартное отклонение, общее количество и, при необходимости, процентили для числовых метрик, собранных во время многоитерационных тестовых запусков, рассматривая их как двойные значения.
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 на тестируемом устройстве и сбора журнала для каждого теста.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках в случае сбоя тестового случая.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках, если тестовый случай в ходе выполнения не пройден.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Clang из устройства и регистрирует их как тестовые артефакты.
CodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает данные об измерениях покрытия Java и нативных приложений с устройства и регистрирует их как тестовые артефакты.
CollectingTestListener	`ITestInvocationListener` , который будет собирать все результаты тестов.
ConsoleResultReporter	Отчет о результатах для вывода результатов теста на консоль.
CountTestCasesCollector	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового случая.
DeviceTraceCollector	Коллектор, который запустит идеальную трассировку при запуске тестового прогона и запишет файл трассировки в конце.
EventsLoggerListener	Прослушиватель, который регистрирует все полученные события в файле.
FileProtoResultReporter	Proto-репортер, который сохраняет `TestRecord` в файл.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключевые метрики, поступающие с устройства, и извлекает их в виде файла с устройства.
FilePullerLogCollector	Регистратор файла, предоставленного устройством.
ФорматированныйГенераторРепортер	Reporter, позволяющий генерировать отчеты в определенном формате.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия gcov из устройства и регистрирует их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия ядра gcov из debugfs и из устройства, а затем регистрирует их как тестовые артефакты.
GranularRetriableTestWrapper.StartEndCollector	Вспомогательный класс для обнаружения пропущенных начала и конца запуска.
HostStatsdMetricCollector	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
IMetricCollector	Этот интерфейс будет добавлен в качестве декоратора при представлении результатов тестов для сбора соответствующих метрик.
IPostProcessor	Постпроцессоры — это объект Trade Federation, предназначенный для обработки показателей и журналов ПОСЛЕ тестов и ДО предоставления отчетов о результатах.
InvocationProtoResultReporter	Репортеры для хранения информации кэширования уровня вызова и списка ее модулей
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который извлекает измерения покрытия Java с устройства и регистрирует их как тестовые артефакты.
JsonHttpTestResultReporter	Отчет о результатах, который кодирует результаты тестовых метрик и ветвей, информацию об устройстве в JSON и POST в конечную точку HTTP-сервиса
LUCIResultReporter	Отчет о результатах, который сохраняет результаты тестов, необходимые для ResultDB и LUCI, в формате JSON (go/result-sink) и регистрирует местоположение файла в консоли.
LegacySubprocessResultsReporter	Замороженная реализация отчета о результатах подпроцесса, которая должна оставаться совместимой с более ранними версиями TF/CTS (например, 8+), несмотря на изменения в его суперклассе.
LogSaverResultForwarder	`ResultForwarder` для сохранения журналов с помощью глобального хранителя файлов.
LogcatOnFailureCollector	Сборщик, который будет собирать и регистрировать logcat в случае сбоя тестового случая.
LogcatTimingMetricCollector	Сборщик метрик, который собирает временную информацию (например, время переключения пользователя) из Logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк Logcat.
MetricFilePostProcessor	Используется для загрузки файла журнала показателей, собранных во время тестирования и выполнения.
МетрикиXMLResultReporter	MetricsXMLResultReporter записывает тестовые метрики и метрики запуска в XML-файл в папке, указанной параметром metrics-folder на этапе invocationEnded теста.
МодульСлушатель	Прослушиватель, прикрепленный к каждому `IRemoteTest` каждого модуля, для сбора списка результатов.
МодульLogcatCollector	Версия сборщика logcat, но для модуля.
МодульProtoResultReporter	Отчет о результатах, предназначенный только для отчетов на уровне модуля.
ModuleResultsAndMetricsForwarder	Расширение `ResultAndLogForwarder` , которое добавляет дополнительные метрики, связанные с модулем, к результатам теста.
PerfettoGenericPostProcessor	Постпроцессор, который преобразует текстовый/двоичный метрический файл proto perfetto в пары ключ-значение, рекурсивно расширяя сообщения proto и поля строковыми значениями до тех пор, пока не будет обнаружено поле с числовым значением.
PerfettoPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы Perfetto из устройства и собирать с него метрики.
ProtoResultReporter	Отчет о результатах создает Protobuf `TestRecord` со всеми результатами внутри.
RebootReasonCollector	Сборщик, который собирает перезагрузки устройств во время тестового прогона и сообщает о них по причинам и количеству.
ОтчетПройденные тесты	Сообщите в файле возможные фильтры для исключения пройденных тестов.
РезультатАгрегатор	Специальный пересылающий модуль, который при необходимости объединяет результаты на основе выбранной стратегии повторных попыток.
РезультатИЖурналПересылки	Пересылка результатов и событий журналов.
ResultDBReporter
RetryLogSaverResultForwarder	Экспедитор, который также обрабатывает текущую попытку, в которой мы находимся.
RuntimeRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового прогона, если таковые имеются.
СкриншотOnFailureCollector	Сборщик, который сделает снимок экрана и запишет его в журнал в случае сбоя тестового случая.
ShardListener	`ITestInvocationListener` , который собирает результаты из фрагмента вызова (также известного как разделение вызова для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю.
ShardMainResultForwarder	`ResultForwarder` , который объединяет результаты вызовов фрагментированного теста.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы showmap с устройства и собирать из него метрики.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, который обрабатывает метрики датчиков, собранные по принципу «до/после», т.е.
StatsdEventMetricPostProcessor	Постпроцессор, который обрабатывает метрики событий в отчетах statsd в пары ключ-значение, используя форматировщики, указанные в процессоре.
StatsdGenericPostProcessor	Постпроцессор, который преобразует двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
ПодпроцессРезультатыРепортер	Реализует `ITestInvocationListener` для указания в качестве result_reporter и пересылки из подпроцесса результатов тестов, тестовых запусков, тестовых вызовов.
SuiteResultReporter	Соберите результаты тестирования для всего набора вызовов и выведите окончательные результаты.
ТекстРезультатРепортер	Отчет о результатах теста, который пересылает результаты на текстовый принтер результатов JUnit.
TraceCmdCollector	`IMetricCollector` , который собирает трассировки во время теста с помощью trace-cmd и регистрирует их в вызове.
XmlFormattedGeneratorReporter	Реализация `FormattedGeneratorReporter` , которая форматирует результаты набора в формате XML.
XmlResultReporter	Записывает результаты JUnit в XML-файлы в формате, соответствующем XMLJUnitResultFormatter Ant.

Позволяет 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`

testLogСохранено

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

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

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

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