ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Известные косвенные подклассы AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , portzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , ConsoleResultReporter и еще 48. АгрегатПостпроцессор Агрегатор метрик, который выдает минимальное, максимальное, среднее значение, дисперсию, стандартное отклонение, общее количество, количество и, при необходимости, процентили для числовых показателей, собранных во время многократных итераций тестирования, рассматривая их как двойные. Атрацеколлектор 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 с устройства и регистрировать их как тестовые артефакты. Сбор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 Постпроцессоры — это объект Торговой федерации, предназначенный для обработки метрик и журналов ПОСЛЕ тестов и ДО отчета о результатах. 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, но для модуля. PerfettoGenericПостпроцессор Постпроцессор, который обрабатывает прото-файл текстовых/двоичных метрик в пары ключ-значение путем рекурсивного расширения прото-сообщений и полей строковыми значениями до тех пор, пока не встретится поле с числовым значением. PerfettoPullerМетрикаКоллектор Базовая реализация FilePullerDeviceMetricCollector , которая позволяет извлекать файлы perfetto с устройства и собирать с него метрики. Проторезультатрепортер Отчет о результатах создает прототип TestRecord со всеми результатами внутри. ПерезагрузкаПричинаКоллектор Сборщик, который собирает данные о перезагрузках устройств во время тестового запуска и сообщает о них по причинам и подсчетам. ОтчетПройденоТесты Сообщите в файле о возможных фильтрах для исключения пройденного теста. Агрегатор результатов Специальный сервер пересылки, который при необходимости объединяет результаты на основе выбранной стратегии повторных попыток. Результатандлогфорвардер Пересылка результатов и журналов событий. Ретрилогсаверресультфорвардер Переадресатор, который также обрабатывает передачу текущей попытки, в которой мы находимся. Сборщик времени выполненияRestartCollector Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются. Снимок экранаOnFailureCollector Коллектор, который будет делать снимок экрана и сохранять его в журнале в случае сбоя тестового примера. ShardListener ITestInvocationListener , который собирает результаты из сегмента вызова (так называемого разделения вызовов для параллельного выполнения на нескольких ресурсах) и пересылает их другому прослушивателю. ShardMainResultForwarder ResultForwarder , который объединяет результаты вызовов сегментированных тестов. ShowmapPullerMetricCollector Базовая реализация FilePullerDeviceMetricCollector , которая позволяет извлекать файлы карты отображения с устройства и собирать с него метрики. StatsdBeforeAfterGaugeMetricPostProcessor Постпроцессор, который обрабатывает показатели датчиков, собранные методом «до/после», т.е. StatsdEventMetricPostProcessor Постпроцессор, который преобразует метрики событий в отчетах statsd в пары ключ-значение, используя средства форматирования, указанные в процессоре. СтатсддженерикПостпроцессор Постпроцессор, который обрабатывает двоичные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры. StreamProtoResultReporter Реализация ProtoResultReporter SubprocessResultsReporter Реализует ITestInvocationListener , который указывается как result_reporter и пересылает из подпроцесса результаты тестов, запусков тестов и вызовов тестов. SuiteResultReporter Соберите результаты тестирования для всего вызова пакета и выведите окончательные результаты. TextResultReporter Средство создания отчетов о результатах тестирования, которое пересылает результаты на текстовый принтер 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) Вызывается 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 содержащий метаданные сохраненного файла.