ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

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

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

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

  • testRunStarted
  • тест начат
  • [тест не пройден]
  • [testAssumptionFailure]
  • [тест проигнорирован]
  • тест завершен
  • ....
  • [testRunFailed]
  • testRunEnded

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

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

abstract void testAssumptionFailure ( TestIdentifier test, String trace)

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

abstract void testEnded ( TestIdentifier test, testMetrics)

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

abstract void testFailed ( TestIdentifier test, String trace)

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

abstract void testIgnored ( TestIdentifier test)

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

abstract void testRunEnded (long elapsedTime, 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, 
                 testMetrics)

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

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

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

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

testFailed 

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, 
                 runMetrics)

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

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

runMetrics : ERROR(/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 : идентифицирует тест