Отчет об ошибкахКоллектор

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Объект
↳ com.android.tradefed.result.BugreportCollector

Проходной прослушиватель ITestInvocationListener , который собирает отчеты об ошибках при возникновении настраиваемых событий, а затем вызывает ITestInvocationListener#testLog для своих дочерних элементов после сбора каждого отчета об ошибке.

Поведение: (FIXME: закончить это)

  • Захват после каждого, если какие-либо тестовые случаи не удались
  • Захват после каждого теста
  • Захват после каждого неудачного теста
  • Захватывать

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

Вложенные классы

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)

Укажите, должна ли коллекция отчетов об ошибках собирать отчеты об ошибках в другом потоке ( asynchronous = true ) или блокировать вызывающий объект до тех пор, пока отчет об ошибках не будет захвачен ( asynchronous = false ).

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