Отчет об ошибкахКоллектор
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 () Позволяет InvocationListener возвращать сводку. |
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
Предопределенный предикат, который срабатывает при первом вызове.
Публичные конструкторы
Отчет об ошибкахКоллектор
public BugreportCollector (ITestInvocationListener listener, ITestDevice testDevice)
Параметры | |
---|---|
listener | ITestInvocationListener |
testDevice | ITestDevice |
Публичные методы
addPredicate
public void addPredicate (BugreportCollector.Predicate p)
Параметры | |
---|---|
p | BugreportCollector.Predicate |
blockUntilIdle
public void blockUntilIdle ()
Блокируйте до тех пор, пока сборщик не перестанет собирать отчеты об ошибках. Если сборщик активно не собирает отчет об ошибке, немедленно вернитесь
getSummary
public TestSummary getSummary ()
Позволяет InvocationListener возвращать сводку.
Возвращает | |
---|---|
TestSummary | TestSummary обобщающий прогон, или null |
вызов завершен
public void invocationEnded (long elapsedTime)
Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
Будет автоматически вызываться фреймворком TradeFederation.Параметры | |
---|---|
elapsedTime | long : прошедшее время вызова в мс |
invocationFailed
public void invocationFailed (Throwable cause)
Сообщает о незавершенном вызове из-за некоторого состояния ошибки.
Будет автоматически вызываться фреймворком TradeFederation.Параметры | |
---|---|
cause | Throwable : ERROR(/Throwable) причина сбоя |
вызов запущен
public void invocationStarted (IInvocationContext context)
Сообщает о начале вызова теста.
Будет автоматически вызываться фреймворком TradeFederation. Журналистам необходимо переопределить этот метод, чтобы поддерживать отчеты с нескольких устройств.
Параметры | |
---|---|
context | IInvocationContext : информация о вызове |
setАсинхронный
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 |
testAssummentFailure
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) выдаваемых метрик |
testFailed
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 : описательное имя данных ERROR(/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 : ERROR(/String) , описывающая причину сбоя выполнения. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Сообщает о начале тестового прогона.
Параметры | |
---|---|
runName | String : имя запуска теста. |
testCount | int : общее количество тестов в тестовом прогоне |
testRunStopped
public void testRunStopped (long elapsedTime)
Тестовый запуск отчетов остановлен до завершения по запросу пользователя.
TODO: в настоящее время не используется, рассмотрите возможность удаления
Параметры | |
---|---|
elapsedTime | long : устройство сообщило о прошедшем времени в миллисекундах |
testStarted
public void testStarted (TestDescription test)
Сообщает о начале отдельного тестового примера. Старый интерфейс, по возможности следует использовать testStarted(com.android.tradefed.result.TestDescription)
.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-03-30 UTC.