Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP используйте ветку android-latest-release . Ветка android-latest-release manifest всегда будет ссылаться на самый последний релиз, выпущенный в AOSP. Для получения дополнительной информации см. раздел «Изменения в AOSP» .

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

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

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

AggregatePostProcessor , AndroidBuildResultReporter , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector и еще 89 других.

AggregatePostProcessor	Агрегатор метрик, который выдает минимальное, максимальное, среднее значение, дисперсию, стандартное отклонение, общее количество, числовое значение и, при необходимости, процентили для числовых метрик, собранных во время многократных итераций тестирования, рассматривая их как числа с плавающей запятой (double).
AndroidBuildResultReporter	Передает результаты тестирования в Android Build API.
AtraceCollector	Объект `IMetricCollector` , который запускает трассировку во время теста, собирает результаты и записывает их в лог при выполнении теста.
AtraceRunMetricCollector	Собирает трассировки из всех тестовых каталогов в указанной директории с тестового устройства, регистрирует данные в тестовом каталоге, обрабатывает файлы трассировок в тестовом каталоге и агрегирует метрики.
Средний постпроцессор	Реализация постпроцессора, вычисляющего среднее значение списка метрик.
BaseDeviceMetricCollector	Базовая реализация `IMetricCollector` , позволяющая запускать и останавливать сбор данных в `onTestRunStart(DeviceMetricData)` и `onTestRunEnd(DeviceMetricData,Map)` .
BasePostProcessor	Базовый класс `IPostProcessor` , который должна расширять каждая реализация.
BluetoothConnectionLatencyCollector	Сборщик данных будет отправлять на устройства предварительно заданную конфигурацию метрики statsd duration и собирать данные о продолжительности Bluetooth-соединения для каждого профиля.
BluetoothConnectionStateCollector	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния соединения для каждого профиля.
BluetoothConnectionSuccessRatePostProcessor	Реализация постпроцессора, который вычисляет вероятность успешной установки профиля Bluetooth. Используйте параметр "metric-key-match", чтобы указать метрики, содержащие состояния Bluetooth-соединения в числовом массиве. Пример: [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Сборщик данных для включения функции отслеживания активности Bluetooth HCI на тестируемом устройстве и сбора логов для каждого теста.
BugreportCollector	Объект `ITestInvocationListener` передающий данные об ошибках, который собирает отчеты об ошибках при возникновении настраиваемых событий, а затем вызывает метод `ITestInvocationListener.testLog` для своих дочерних элементов после сбора каждого отчета об ошибке.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках (ugreportz), если какой-либо тестовый случай не пройден.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках (ugreportz), если какой-либо тестовый случай в ходе выполнения не удается.
ClangCodeCoverageCollector	Объект `BaseDeviceMetricCollector` , который будет получать данные о покрытии кода Clang с устройства и записывать их в качестве тестовых артефактов.
CodeCoverageCollector	Объект `BaseDeviceMetricCollector` , который будет собирать данные об уровне покрытия Java и нативных тестов с устройства и записывать их в качестве тестовых артефактов.
CollectingTestListener	Объект `ITestInvocationListener` , который будет собирать все результаты тестов.
CommandStatusHandler	Обработчик помогает отслеживать и обновлять статус вызова.
ConditionFailureMonitor	Отслеживайте любые сбои при вызове.
ConsoleResultReporter	Программа для вывода результатов тестирования на консоль.
CountTestCasesCollector	Подсчитайте и сообщите количество тестовых случаев для заданного `IRemoteTest` .
CoverageMetadataCollector	`ILogSaverListener` , который собирает зарегистрированные измерения покрытия кода и генерирует CoverageMetadataProto для обработки службой Android Code Coverage.
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и записывать логи на стороне хоста при возникновении ошибки в тестовом случае.
DeviceReleaseReporter	Программа для отправки отчетов о выпуске устройств, которая обеспечивает связь с родительским процессом относительно устройств, подлежащих выпуску.
DeviceTraceCollector	Сборщик данных, который запустит трассировку Perfetto при начале выполнения теста и запишет файл трассировки в конце.
DeviceUnavailableMonitor	Данный обработчик пытается зафиксировать ДНК-ошибку только на уровне тестового случая.
EventsLoggerListener	Слушатель, который записывает все полученные события в файл.
FileProtoResultReporter	Прототип репортера, который сохраняет `TestRecord` в файл.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который отслеживает ключи метрик, поступающие от устройства, и извлекает их в файл с устройства.
FilePullerLogCollector	Запись лога файла, предоставленного устройством.
FilteredResultForwarder	Вариант `ResultForwarder` , который позволяет передавать только список разрешенных значений `TestDescription` .
FormattedGeneratorReporter	Программа для создания отчетов, позволяющая генерировать отчеты в определенном формате.
GcovCodeCoverageCollector	Объект `BaseDeviceMetricCollector` , который будет получать данные измерений покрытия gcov с устройства и регистрировать их в качестве тестовых артефактов.
GcovKernelCodeCoverageCollector	Объект `BaseDeviceMetricCollector` , который будет извлекать результаты измерений покрытия ядра gcov из debugfs и с устройства, а затем регистрировать их в виде тестовых артефактов.
GeminiDebuggingPostProcessor	Постпроцессор создает запросы подсказок для отладки ошибок.
GranularRetriableTestWrapper.StartEndCollector	Вспомогательная функция класса для отслеживания пропущенных начального и конечного этапов выполнения.
HostStatsdMetricCollector	`IMetricCollector` , который собирает метрики statsd со стороны хоста, используя команды утилиты statsd.
ICommandScheduler.IScheduledInvoctionListener	Слушатель событий вызова, отслеживающий завершение вызова.
ILogSaverListener	Позволяет слушателям `ITestInvocationListener` отслеживать сохранение файлов журналов.
IMetricCollector	Этот интерфейс будет добавлен в качестве декоратора при формировании отчетов о результатах тестов для сбора соответствующих метрик.
IPostProcessor	Объект Post processors — это компонент торговой федерации, предназначенный для обработки метрик и журналов ПОСЛЕ проведения тестов и ДО формирования отчетов о результатах.
IShardableListener	Объект `ITestInvocationListener` , который можно разделить на сегменты.
ISupportGranularResults	Интерфейс, определяющий, поддерживает ли `ITestInvocationListener` получение детализированных результатов или нет.
ITestInvocationListener	Слушатель для получения результатов тестирования, полученных в ходе выполнения теста.
ITestSummaryListener	Интерфейс, позволяющий `ITestInvocationListener` обмениваться некоторой ограниченной информацией посредством сводных данных.
InvocationProtoResultReporter	Репортеры для хранения информации о кэшировании на уровне вызова и списка соответствующих модулей.
InvocationToJUnitResultForwarder	Класс, который прослушивает события `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	Специальный обработчик событий: при возникновении сбоев (сбой в процессе инструментирования) он попытается извлечь из logcat информацию о сбое и добавить её к сообщению об ошибке, связанному с тестом.
LogcatOnFailureCollector	Сборщик логов, который будет собирать и записывать данные в logcat при сбое тестового случая или выполнения теста.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из logcat во время одного или нескольких повторяющихся тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и конца события из строк logcat.
MetricFilePostProcessor	Используется для загрузки файла журнала метрик, собранных во время тестирования и выполнения.
MetricsXMLResultReporter	MetricsXMLResultReporter записывает метрики теста и метрики выполнения в XML-файл в папку, указанную параметром metrics-folder на этапе invocationEnded теста.
ModuleListener	К каждому `IRemoteTest` каждого модуля подключается слушатель для сбора списка результатов.
ModuleLogcatCollector	Версия сборщика logcat, но для модуля.
ModulePerfettoCollector	Сборщик данных, который будет запускать трассировку Perfetto при запуске и завершении тестового модуля, а также при перезагрузке устройства.
ModuleProtoResultReporter	Программа для формирования отчетов, предназначенная для отображения результатов только на уровне модуля.
ModuleResultsAndMetricsForwarder	Расширение класса `ResultAndLogForwarder` , добавляющее к результатам тестирования дополнительные метрики, связанные с модулем.
NameMangleListener	Прокси-слушатель для преобразования имен тестовых методов, классов и пакетов по мере получения результатов.
PassingTestFileReporter	Слушатель `ITestInvocationListener` , который сохраняет список успешно прошедших тестовых случаев в тестовый файл.
PerfettoFilePullerCollector	Сборщик, который извлекает из устройства файлы трассировки Perfetto, при необходимости сжимает их и добавляет в журналы тестирования.
PerfettoGenericPostProcessor	Постпроцессор, который преобразует текстовый/двоичный метрический файл perfetto proto в пары ключ-значение путем рекурсивного расширения сообщений proto и полей строковыми значениями до тех пор, пока не будет найдено поле с числовым значением.
PerfettoPullerMetricCollector	Этот класс устарел. Используйте `PerfettoFilePullerCollector` и `ERROR(/PerfettoTracePostProcessor)` вместо него.
PerfettoTracePostProcessor	Постпроцессор, который извлекает файлы трассировки Perfetto из журналов тестирования и запускает на них обработчик трассировки для создания прототипа метрики Perfetto.
PrettyTestEventLogger	Логгер сопоставляет события и записывает их в журнал для упрощения отладки.
ProtoResultReporter	Программа для создания отчетов о результатах формирует протобуф-файл `TestRecord` , содержащий все результаты.
PtsBotTest	Запустите тесты PTS-bot.
PythonBinaryHostTest.PythonForwarder	Функция пересылки результатов для замены имени запуска на имя исполняемого файла.
RebootReasonCollector	Сборщик данных, который отслеживает перезагрузки устройств во время тестового запуска и сообщает о них с указанием причины и количества.
RemoteTestTimeOutEnforcer	Слушатели, позволяющие проверить время выполнения заданной конфигурации теста и завершить его с ошибкой, если оно превысит заданный таймаут.
ReportPassedTests	В файле должны быть указаны возможные фильтры для исключения прошедших тесты.
ResultAggregator	Специальный пересыльщик, который агрегирует результаты по мере необходимости, исходя из выбранной стратегии повторных попыток.
ResultAndLogForwarder	Перенаправитель результатов и событий журналов.
ResultDBReporter	Программа для формирования отчетов о результатах, которая загружает результаты тестов в базу данных ResultDB.
ResultForwarder	Объект `ITestInvocationListener` , который пересылает результаты вызова списку других слушателей.
ResultReporter
RetryLogSaverResultForwarder	Программа для пересылки данных, которая также обеспечивает успешную обработку текущей попытки.
RetryResultForwarder	Расширение класса `ResultForwarder` , которое всегда отправляет запрос на заданный номер попытки.
RuntimeRestartCollector	Сборщик, который собирает метки времени перезапусков во время выполнения (сбоев системного сервера) в ходе тестового запуска, если таковые имели место.
ScreenRecordOnFailureCollector	Сборщик данных, который будет записывать и регистрировать видео с экрана в случае сбоя тестового случая.
ScreenshotOnFailureCollector	Сборщик данных, который будет делать снимок экрана и записывать его в журнал при сбое тестового случая.
ShardListener	`ITestInvocationListener` , который собирает результаты из сегмента вызовов (также известного как разделение вызовов для параллельного выполнения на нескольких ресурсах) и пересылает их другому слушателю.
ShardMainResultForwarder	`ResultForwarder` , объединяющий результаты вызовов сегментированного теста.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , позволяющая извлекать файлы showmap с устройства и собирать с них метрики.
SimpleperfProfilePostProcessor	Постпроцессор, который находит данные профилирования simpleperf и генерирует профиль pprof.
StatsdBeforeAfterGaugeMetricPostProcessor	Постпроцессор, обрабатывающий метрики измерительных приборов, собранные в рамках подхода «до/после», т.е.
StatsdEventMetricPostProcessor	Постпроцессор, который преобразует метрики событий в отчетах statsd в пары ключ-значение, используя форматеры, указанные в процессоре.
StatsdGenericPostProcessor	Постпроцессор, который преобразует бинарные отчеты proto statsd в пары ключ-значение, разворачивая отчет в виде древовидной структуры.
StreamProtoResultReporter	Реализация `ProtoResultReporter`
SubprocessResultsReporter	Реализует `ITestInvocationListener` который указывается в качестве result_reporter и пересылает из дочернего процесса результаты тестов, запусков тестов и вызовов тестов.
SuiteResultReporter	Соберите результаты тестирования для всего набора тестов и выведите окончательные результаты.
TestRunResultListener	Слушатель, позволяющий считывать окончательный статус выполнения теста.
TestTimeoutEnforcer	Слушатели, позволяющие проверить время выполнения заданного тестового случая и завершить его с ошибкой, если оно превысит заданный таймаут.
TextResultReporter	Программа для отправки результатов тестирования, которая пересылает результаты на текстовый принтер результатов JUnit.
TraceCmdCollector	Объект `IMetricCollector` , который собирает трассировки во время тестирования с помощью trace-cmd и записывает их в лог при запуске программы.
TradefedSandboxRunner.StubScheduledInvocationListener	Заглушка `IScheduledInvocationListener` которая ничего не делает.
XmlFormattedGeneratorReporter	Реализация компонента `FormattedGeneratorReporter` , который форматирует результаты выполнения набора тестов в формате XML.
XmlResultReporter	Записывает результаты JUnit в XML-файлы в формате, соответствующем XMLJUnitResultFormatter из библиотеки Ant.

Объект, способный осуществлять регистрацию потоков данных различных типов.

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

Общедоступные методы
`default void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Предоставляет соответствующие данные журнала или отладочные данные из вызова теста.

Общедоступные методы

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Предоставляет соответствующие данные журнала или отладочные данные из вызова теста.

Необходимо вызвать перед ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) или ERROR(/ITestInvocationListener#invocationEnded(long))

Фреймворк TradeFederation автоматически вызовет этот метод, предоставив лог хоста и, если применимо, лог устройства.

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