BugreportКоллектор
public class BugreportCollector
extends Object
implements ITestInvocationListener
java.lang.Объект | |
↳ | com.android.tradefed.result.BugreportCollector |
Сквозной ITestInvocationListener
, который собирает отчеты об ошибках при возникновении настраиваемых событий, а затем вызывает ITestInvocationListener#testLog
для своих дочерних элементов после сбора каждого отчета об ошибках.
- Захват после каждого, если какие-либо тестовые примеры не пройдены
- Захват после каждого тестового примера
- Захват после каждого неудачного тестового примера
- Захватывать
Краткое содержание
Вложенные классы | |
---|---|
class | BugreportCollector.Predicate Полный предикат, описывающий, когда следует захватить отчет об ошибке. |
interface | BugreportCollector.SubPredicate
|
Поля | |
---|---|
public static final BugreportCollector.Predicate | AFTER_FAILED_TESTCASES Предопределенный предикат, который срабатывает после каждого неудачного тестового примера. |
public static final BugreportCollector.Predicate | AT_START Предопределенный предикат, который срабатывает при начале первого вызова. |
Общественные конструкторы | |
---|---|
BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice) |
Публичные методы | |
---|---|
void | addPredicate ( BugreportCollector.Predicate p) |
void | blockUntilIdle () Блокируйте до тех пор, пока сборщик не перестанет собирать отчеты об ошибках. |
TestSummary | getSummary () Позволяет InvokeListener возвращать сводку. |
void | invocationEnded (long elapsedTime) Сообщает, что вызов завершился успешно или из-за какой-либо ошибки. |
void | invocationFailed (Throwable cause) Сообщает о неполном вызове из-за какой-либо ошибки. |
void | invocationStarted ( IInvocationContext context) Сообщает о начале тестового вызова. |
void | setAsynchronous (boolean asynchronous) Установите, должен ли сбор отчетов об ошибках собирать отчет об ошибке в другом потоке ( |
void | setDescriptiveName (String name) Установите описательное имя, которое будет использоваться при записи отчетов об ошибках. |
void | setDeviceWaitTime (int waitTime) Установите время (в секундах) ожидания подключения устройства к сети, прежде чем мы попытаемся записать отчет об ошибке. |
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) Сообщает о начале отдельного тестового примера. |
Поля
AFTER_FAILED_TESTCASES
public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES
Предопределенный предикат, который срабатывает после каждого неудачного тестового примера.
AT_START
public static final BugreportCollector.Predicate AT_START
Предопределенный предикат, который срабатывает при начале первого вызова.
Общественные конструкторы
BugreportКоллектор
public BugreportCollector (ITestInvocationListener listener, ITestDevice testDevice)
Параметры | |
---|---|
listener | ITestInvocationListener |
testDevice | ITestDevice |
Публичные методы
добавитьпредикат
public void addPredicate (BugreportCollector.Predicate p)
Параметры | |
---|---|
p | BugreportCollector.Predicate |
блокироватьUntilIdle
public void blockUntilIdle ()
Блокируйте до тех пор, пока сборщик не перестанет собирать отчеты об ошибках. Если сборщик не собирает отчеты об ошибках активно, вернитесь немедленно.
получитьСводка
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 : информация о вызове. |
setAsynchronous
public void setAsynchronous (boolean asynchronous)
Установите, должен ли сбор отчетов об ошибках собирать отчет об ошибке в другом потоке ( asynchronous = true
) или блокировать вызывающую сторону до тех пор, пока отчет об ошибке не будет захвачен ( asynchronous = false
).
Параметры | |
---|---|
asynchronous | boolean |
setDescriptiveName
public void setDescriptiveName (String name)
Установите описательное имя, которое будет использоваться при записи отчетов об ошибках. Если null
, BugreportCollector
вернется к поведению по умолчанию, сериализуя имя события, вызвавшего сбор отчета об ошибке.
Параметры | |
---|---|
name | String |
SetDeviceWaitTime
public void setDeviceWaitTime (int waitTime)
Установите время (в секундах) ожидания подключения устройства к сети, прежде чем мы попытаемся записать отчет об ошибке. В случае отрицательного результата проверка производиться не будет. Любое DeviceNotAvailableException
обнаруженное во время этой проверки, будет зарегистрировано и проигнорировано.
Параметры | |
---|---|
waitTime | int |
тестПредположениеОтказ
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)
Сообщает об окончании тестового запуска. ИСПРАВЛЕНИЕ: мы не можем иметь два интерфейса Map<> разного типа, поэтому здесь нам придется использовать HashMap.
Параметры | |
---|---|
elapsedTime | long : устройство сообщило прошедшее время в миллисекундах. |
runMetrics | 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(com.android.tradefed.result.TestDescription)
.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест. |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-08-21 UTC.