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

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

ИмяMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Объект
↳	com.android.tradefed.result.NameMangleListener

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

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

Общественные конструкторы
`NameMangleListener ( ITestInvocationListener listener)`

Публичные методы
`TestSummary`	`getSummary ()` Позволяет InvokeListener возвращать сводку.
`void`	`invocationEnded (long elapsedTime)` Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
`void`	`invocationFailed (Throwable cause)` Сообщает о неполном вызове из-за какой-либо ошибки.
`void`	`invocationStarted ( IInvocationContext context)` Сообщает о начале тестового вызова.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, 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, runMetrics)` `testRunEnded (long elapsedTime, 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(com.android.tradefed.result.TestDescription)` , `testFailed(com.android.tradefed.result.TestDescription, String)` и `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))` обратные вызовы.
`String`	`mangleTestRunName (String name)` Этот метод запускается для всех имен запуска тестов, которые передаются в обратный вызов `testRunStarted(String, int)` .

Общественные конструкторы

ИмяMangleListener

public NameMangleListener (ITestInvocationListener listener)

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

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

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

public TestSummary getSummary ()

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

Возврат
`TestSummary`	`TestSummary` суммирующий прогон, или нулевой

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

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` : информация о вызове.

тестПредположениеОтказ

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

Параметры
`test`	`TestDescription` : идентифицирует тест.
`testMetrics`	: `ERROR(/Map)` выданных метрик

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

public void testFailed (TestDescription test, 
                String trace)

Сообщает о сбое отдельного тестового примера.

Будет вызываться между testStarted и testEnded.

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

тестИгнорируется

public void testIgnored (TestDescription test)

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

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

журнал испытаний

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

Предоставляет связанные данные журнала или отладки из тестового вызова.

Должен быть вызван перед ERROR(/ITestInvocationListener#invocationFailed(Throwable)) или ERROR(/ITestInvocationListener#invocationEnded(long))

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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(com.android.tradefed.result.TestDescription) .

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

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

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Этот метод запускается для всех TestDescription , которые передаются в testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) и ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) обратные вызовы. Метод должен возвращать возможно другое TestDescription , которое будет передано нижестоящему ITestInvocationListener , указанному во время построения.

Реализация должна быть осторожной, чтобы не изменить исходное TestDescription .

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

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

Возврат
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

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

Реализация должна быть осторожной, чтобы не изменить исходное имя запуска.

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

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

Возврат
`String`