ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Известные косвенные подклассы StubTestRunListener , TestRunResult , TestRunToTestIndictionForwarder , XmlTestRunListener StubTestRunListener Заглушка реализации ITestRunListener Результат выполнения теста Сохраняет результаты одного тестового запуска. Теструнтотестинвококфорвардер Переадресация от ddmlib ITestRunListener к ITestLifeCycleReceiver . XmlTestRunListener Записывает результаты JUnit в XML-файлы в формате, соответствующем XMLJUnitResultFormatter из библиотеки Ant.

---

Получает уведомления о событиях во время проведения инструментальных испытаний.

Создано по образцу org.junit.runner.notification.RunListener

Последовательность звонков будет следующей:

• testRunStarted
• тест начат
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• тест завершен
• ....
• [testRunFailed]
• testRunEnded

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

Общедоступные методы
abstract void	testAssumptionFailure ( TestIdentifier test, String trace) Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие.
abstract void	testEnded ( TestIdentifier test, Map<String, String> testMetrics) Сообщает о завершении выполнения отдельного тестового случая.
abstract void	testFailed ( TestIdentifier test, String trace) Сообщает о сбое отдельного тестового случая.
abstract void	testIgnored ( TestIdentifier test) Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore.
abstract void	testRunEnded (long elapsedTime, Map<String, String> runMetrics) Сообщает об окончании тестового запуска.
abstract void	testRunFailed (String errorMessage) Сообщается, что тестовый запуск не завершился из-за критической ошибки.
abstract void	testRunStarted (String runName, int testCount) Сообщает о начале тестового запуска.
abstract void	testRunStopped (long elapsedTime) Этот метод устарел. Этот обратный вызов никогда не будет вызван. Будет удален.
abstract void	testStarted ( TestIdentifier test) Сообщает о начале выполнения отдельного тестового случая.

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

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

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

public abstract void testEnded (TestIdentifier test, 
                Map<String, String> testMetrics)

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

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

Параметры
test	TestIdentifier : идентифицирует тест
testMetrics	Map : Map метрик, генерируемых во время выполнения тестового случая методом android.app.Instrumentation#sendStatus . Порядок добавления сохраняется, если только вы не генерируете один и тот же ключ несколько раз. Обратите внимание, что стандартные ключи, определенные в IInstrumentationResultParser.StatusKeys , исключаются из этой карты. Ddmlib может добавлять дополнительные метрики теста, определенные в IInstrumentationResultParser.StatusKeys .

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

public abstract void testFailed (TestIdentifier test, 
                String trace)

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

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

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

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

public abstract void testIgnored (TestIdentifier test)

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

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

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

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

Параметры
elapsedTime	long : устройство сообщило о прошедшем времени в миллисекундах
runMetrics	Map : Map метрик, генерируемых во время выполнения тестового случая методом android.app.Instrumentation#addResults . Порядок добавления сохраняется, если только вы не генерируете один и тот же ключ несколько раз. Обратите внимание, что стандартные ключи, определенные в IInstrumentationResultParser.StatusKeys , исключаются из этой карты. Ddmlib может добавлять дополнительные метрики теста, определенные в IInstrumentationResultParser.StatusKeys .

testRunFailed

public abstract void testRunFailed (String errorMessage)

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

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

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

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

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

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Этот метод устарел.
Этот обратный вызов никогда не будет вызван. Будет удален.

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

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

тест начат

public abstract void testStarted (TestIdentifier test)

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

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