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

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

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.NameMangleListener

Прокси-слушатель для преобразования имен тестовых методов, классов и пакетов по мере получения результатов.

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

Государственные строители
`NameMangleListener ( ITestInvocationListener listener)`

Общедоступные методы
`TestSummary`	`getSummary ()` Позволяет InvocationListener возвращать сводку.
`void`	`invocationEnded (long elapsedTime)` Сообщает о завершении вызова, будь то успешное завершение или возникновение ошибки.
`void`	`invocationFailed (Throwable cause)` Сообщает о неполном вызове из-за какой-либо ошибки.
`void`	`invocationStarted ( IInvocationContext context)` Сообщает о начале выполнения теста.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие.
`void`	`testEnded ( TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Сообщает о завершении выполнения отдельного тестового случая.
`void`	`testFailed ( TestDescription test, String trace)` Сообщает о сбое отдельного тестового случая.
`void`	`testIgnored ( TestDescription test)` Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Предоставляет соответствующие данные журнала или отладочные данные из вызова теста.
`void`	`testRunEnded (long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Сообщает об окончании тестового запуска.
`void`	`testRunFailed (String errorMessage)` Сообщается, что тестовый запуск не завершился из-за критической ошибки.
`void`	`testRunStarted (String runName, int testCount)` Сообщает о начале тестового запуска.
`void`	`testRunStopped (long elapsedTime)` Тестирование отчетов было прервано до завершения по запросу пользователя.
`void`	`testStarted ( TestDescription test)` Сообщает о начале выполнения отдельного тестового случая.

Защищенные методы
`TestDescription`	`mangleTestId ( TestDescription test)` Этот метод выполняется для всех объектов `TestDescription` , переданных в колбэки `testStarted(TestDescription)` , `testFailed(TestDescription,String)` и `testEnded(TestDescription,HashMap)` .
`String`	`mangleTestRunName (String name)` Этот метод выполняется для всех имен тестовых запусков, переданных в функцию обратного вызова `testRunStarted(String,int)` .

Государственные строители

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Параметры
`listener`	`ITestInvocationListener`

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

получитьСводка

public TestSummary getSummary ()

Позволяет InvocationListener возвращать сводку.

Возвраты
`TestSummary`	`TestSummary` суммирующий результаты выполнения, или значение null.

вызов завершен

public void invocationEnded (long elapsedTime)

Сообщает о завершении вызова, будь то успешное завершение или возникновение ошибки.

Будет автоматически вызвана фреймворком TradeFederation.

Параметры
`elapsedTime`	`long` : время выполнения вызова в миллисекундах

вызов не удался

public void invocationFailed (Throwable cause)

Сообщает о неполном вызове из-за какой-либо ошибки.

Будет автоматически вызвана фреймворком TradeFederation.

Параметры
`cause`	`Throwable` : `Throwable` причина отказа.

вызовНачался

public void invocationStarted (IInvocationContext context)

Сообщает о начале выполнения теста.

Этот метод будет автоматически вызываться фреймворком TradeFederation. Для поддержки отправки данных с нескольких устройств разработчикам необходимо переопределить этот метод.

Параметры
`context`	`IInvocationContext` : информация о вызове

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

тест завершен

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Сообщает о завершении выполнения отдельного тестового случая.

Если testFailed(TestDescription, FailureDescription) не был вызван, тест пройден успешно. Также возвращает любые метрики ключ/значение, которые могли быть получены во время выполнения тестового случая.

Параметры
`test`	`TestDescription` : идентифицирует тест
`testMetrics`	`HashMap` : `Map` сгенерированных метрик

тест не пройден

public void testFailed (TestDescription test, 
                String trace)

Сообщает о сбое отдельного тестового случая.

Эта функция будет вызвана в промежутке между testStarted и testEnded.

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

тест проигнорирован

public void testIgnored (TestDescription test)

Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore.

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

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.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Сообщает об окончании выполнения теста. FIXME: Мы не можем иметь два интерфейса Map<> с разными типами, поэтому здесь необходимо использовать HashMap.

Параметры
`elapsedTime`	`long` : устройство сообщило о прошедшем времени в миллисекундах
`runMetrics`	`HashMap` : пары ключ-значение, отображаемые в конце выполнения теста с помощью `Metric` .

testRunFailed

public void testRunFailed (String errorMessage)

Сообщается, что тестовый запуск не завершился из-за критической ошибки.

Параметры
`errorMessage`	`String` : `String` описывающая причину сбоя выполнения.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Сообщает о начале тестового запуска.

Параметры
`runName`	`String` : название тестового запуска
`testCount`	`int` : общее количество тестов в тестовом запуске

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

тест начат

public void testStarted (TestDescription test)

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

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

Защищенные методы

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Этот метод выполняется для всех объектов TestDescription , переданных в колбэки testStarted(TestDescription) , testFailed(TestDescription,String) и testEnded(TestDescription,HashMap) . Метод должен возвращать возможно другой TestDescription , который будет передан в нижестоящий объект ITestInvocationListener , указанный при создании объекта.

При реализации следует проявлять осторожность и не изменять исходное TestDescription ).

В стандартной реализации входящий идентификатор передается без изменений.

Параметры
`test`	`TestDescription`

Возвраты
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Этот метод выполняется для всех имен тестовых запусков, переданных в функцию обратного вызова testRunStarted(String,int) . Метод должен возвращать возможно другое имя тестового запуска, которое будет передано нижестоящему обработчику ITestInvocationListener , указанному при создании объекта.

При реализации следует проявлять осторожность и не изменять исходное имя запуска.

В реализации по умолчанию имя входящего тестового запуска передается без изменений.

Параметры
`name`	`String`

Возвраты
`String`