ITestLifeCycleReceiver
public interface ITestLifeCycleReceiver
| com.android.tradefed.result.ITestLifeCycleReceiver |
Получает уведомления о событиях во время проведения инструментальных испытаний.
Создано по образцу org.junit.runner.notification.RunListener
Последовательность звонков будет следующей:
- testRunStarted
- тест начат
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- тест завершен
- ....
- [testRunFailed]
- testRunEnded
Краткое содержание
Общедоступные методы | |
|---|---|
default void | testAssumptionFailure ( TestDescription test, String trace)Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие. |
default void | testAssumptionFailure ( TestDescription test, FailureDescription failure)Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие. |
default void | testEnded ( TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)Сообщает о завершении выполнения отдельного тестового случая. |
default void | testEnded ( TestDescription test, long endTime, Map<String, String> testMetrics) Альтернатива функции |
default void | testEnded ( TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) Альтернатива функции |
default void | testEnded ( TestDescription test, Map<String, String> testMetrics)Сообщает о завершении выполнения отдельного тестового случая. |
default void | testFailed ( TestDescription test, FailureDescription failure)Сообщает о сбое отдельного тестового случая. |
default void | testFailed ( TestDescription test, String trace)Сообщает о сбое отдельного тестового случая. |
default void | testIgnored ( TestDescription test)Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore. |
default void | testRunEnded (long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)Сообщает об окончании тестового запуска. |
default void | testRunEnded (long elapsedTimeMillis, Map<String, String> runMetrics)Сообщает об окончании тестового запуска. |
default void | testRunFailed ( FailureDescription failure) Сообщается, что запуск тестового запуска не завершился из-за ошибки, описанной в |
default void | testRunFailed (String errorMessage)Сообщается, что тестовый запуск не завершился из-за критической ошибки. |
default void | testRunStarted (String runName, int testCount, int attemptNumber)Сообщает о начале тестового запуска. |
default void | testRunStarted (String runName, int testCount)Сообщает о начале тестового запуска. |
default void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime)Сообщает о начале тестового запуска. |
default void | testRunStopped (long elapsedTime)Тестирование отчетов было прервано до завершения по запросу пользователя. |
default void | testSkipped ( TestDescription test, SkipReason reason)Вызывается, когда тест пропущен и не выполнен по причине, которая обычно не ожидается. |
default void | testStarted ( TestDescription test, long startTime) Альтернатива функции |
default void | testStarted ( TestDescription test)Сообщает о начале выполнения отдельного тестового случая. |
Общедоступные методы
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
trace | String : трассировка стека ошибки |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
failure | FailureDescription : Описание ошибки и контекст её FailureDescription . |
тест завершен
public void testEnded (TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
Сообщает о завершении выполнения отдельного тестового случая.
Если testFailed(TestDescription, FailureDescription) не был вызван, тест пройден успешно. Также возвращает любые метрики ключ/значение, которые могли быть получены во время выполнения тестового случая.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
testMetrics | HashMap : Map сгенерированных метрик |
тест завершен
public void testEnded (TestDescription test, long endTime, Map<String, String> testMetrics)
Альтернатива функции testEnded(TestDescription,Map) , позволяющая напрямую указать время окончания. Для более точного измерения можно использовать в сочетании с testStarted(TestDescription,long) .
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
endTime | long : время окончания теста, измеренное с помощью System.currentTimeMillis() |
testMetrics | Map : Map генерируемых метрик |
тест завершен
public void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Альтернатива функции testEnded(TestDescription,Map) , позволяющая напрямую указать время окончания. Для более точного измерения можно использовать в сочетании с testStarted(TestDescription,long) .
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
endTime | long : время окончания теста, измеренное с помощью System.currentTimeMillis() |
testMetrics | HashMap : Map сгенерированных метрик |
тест завершен
public void testEnded (TestDescription test, Map<String, String> testMetrics)
Сообщает о завершении выполнения отдельного тестового случая.
Если testFailed(TestDescription, FailureDescription) не был вызван, тест пройден успешно. Также возвращает любые метрики ключ/значение, которые могли быть получены во время выполнения тестового случая.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
testMetrics | Map : Map генерируемых метрик |
тест не пройден
public void testFailed (TestDescription test, FailureDescription failure)
Сообщает о сбое отдельного тестового случая.
Эта функция будет вызвана в промежутке между testStarted и testEnded.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
failure | FailureDescription : Описание ошибки и контекст её FailureDescription . |
тест не пройден
public void testFailed (TestDescription test, String trace)
Сообщает о сбое отдельного тестового случая.
Эта функция будет вызвана в промежутке между testStarted и testEnded.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
trace | String : трассировка стека ошибки |
тест проигнорирован
public void testIgnored (TestDescription test)
Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
HashMap<String, MetricMeasurement.Metric> runMetrics)Сообщает об окончании выполнения теста. FIXME: Мы не можем иметь два интерфейса Map<> с разными типами, поэтому здесь необходимо использовать HashMap.
| Параметры | |
|---|---|
elapsedTimeMillis | long : устройство сообщило о прошедшем времени в миллисекундах |
runMetrics | HashMap : пары ключ-значение, отображаемые в конце выполнения теста с помощью Metric . |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
Map<String, String> runMetrics)Сообщает об окончании тестового запуска.
| Параметры | |
|---|---|
elapsedTimeMillis | long : устройство сообщило о прошедшем времени в миллисекундах |
runMetrics | Map : пары ключ-значение, отображаемые по завершении тестового запуска. |
testRunFailed
public void testRunFailed (FailureDescription failure)
Сообщается, что запуск тестового запуска не завершился из-за ошибки, описанной в FailureDescription .
| Параметры | |
|---|---|
failure | FailureDescription : Описание ошибки и контекст её FailureDescription . |
testRunFailed
public void testRunFailed (String errorMessage)
Сообщается, что тестовый запуск не завершился из-за критической ошибки.
| Параметры | |
|---|---|
errorMessage | String : String описывающая причину сбоя выполнения. |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber)Сообщает о начале тестового запуска.
| Параметры | |
|---|---|
runName | String : название тестового запуска |
testCount | int : общее количество тестов в тестовом запуске |
attemptNumber | int : порядковый номер, идентифицирующий различные попытки выполнения одного и того же runName, которые выполняются несколько раз. attemptNumber имеет индексацию от 0 и должен увеличиваться каждый раз при новом запуске. Например, если тест повторяется 3 раза, то всего должно быть 4 запуска под одним и тем же runName, а attemptNumber принимает значения от 0 до 3. |
testRunStarted
public void testRunStarted (String runName,
int testCount)Сообщает о начале тестового запуска.
| Параметры | |
|---|---|
runName | String : название тестового запуска |
testCount | int : общее количество тестов в тестовом запуске |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber,
long startTime)Сообщает о начале тестового запуска.
| Параметры | |
|---|---|
runName | String : название тестового запуска |
testCount | int : общее количество тестов в тестовом запуске |
attemptNumber | int : порядковый номер, идентифицирующий различные попытки выполнения одного и того же runName, которые выполняются несколько раз. attemptNumber имеет индексацию от 0 и должен увеличиваться каждый раз при новом запуске. Например, если тест повторяется 3 раза, то всего должно быть 4 запуска под одним и тем же runName, а attemptNumber принимает значения от 0 до 3. |
startTime | long : время начала выполнения, измеренное с помощью System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Тестирование отчетов было прервано до завершения по запросу пользователя.
TODO: в настоящее время не используется, рассмотрите возможность удаления.
| Параметры | |
|---|---|
elapsedTime | long : устройство сообщило о прошедшем времени в миллисекундах |
тест пропущен
public void testSkipped (TestDescription test, SkipReason reason)
Вызывается, когда тест пропущен и не выполнен по нетипичной причине. Будет предпринята попытка повторного выполнения таких тестов для обеспечения их корректного выполнения.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
reason | SkipReason : SkipReason |
тест начат
public void testStarted (TestDescription test, long startTime)
Альтернатива функции testStarted(TestDescription) , где мы также указываем время начала теста, в сочетании с testEnded(TestDescription,long,Map) для более точного измерения.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |
startTime | long : время начала теста, измеренное с помощью System.currentTimeMillis() |
тест начат
public void testStarted (TestDescription test)
Сообщает о начале отдельного тестового случая. Более старый интерфейс, следует использовать testStarted(TestDescription) везде, где это возможно.
| Параметры | |
|---|---|
test | TestDescription : идентифицирует тест |