ModuleResultsAndMetricsForwarder

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

java.lang.Object
↳ com.android.tradefed.result.ResultForwarder
↳ com.android.tradefed.result.ResultAndLogForwarder
↳ com.android.tradefed.result.ModuleResultsAndMetricsForwarder

Расширение класса ResultAndLogForwarder , добавляющее к результатам тестирования дополнительные метрики, связанные с модулем.

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

Государственные строители

ModuleResultsAndMetricsForwarder ( ITestInvocationListener... listeners)

Общедоступные методы

void setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation)

Определяет, следует ли сообщать о попытке как об единичном случае.

void setMarkTestsSkipped (boolean skip)

Следует ли отмечать все пропущенные тестовые случаи.

void setModuleId (String moduleId)
void setTestMappingSources (List<String> testMappingSources)

Задает источники сопоставления тестов, которые будут включены в метрики.

void testEnded ( TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

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

void testEnded ( TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

Альтернатива функции testEnded(TestDescription,Map) позволяющая напрямую указать время окончания.

void testFailed ( TestDescription test, FailureDescription failure)

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

void testFailed ( TestDescription test, String trace)

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

void testRunEnded (long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

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

void testRunEnded (long elapsedTimeMillis, Map<String, String> runMetrics)
void testRunFailed ( FailureDescription failure)

Сообщается, что запуск тестового запуска не завершился из-за ошибки, описанной в FailureDescription .

void testRunFailed (String errorMessage)

Сообщается, что тестовый запуск не завершился из-за критической ошибки.

void testRunStarted (String runName, int testCount, int attemptNumber)

Сообщает о начале тестового запуска.

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

Сообщает о начале тестового запуска.

void testStarted ( TestDescription test, long startTime)

Альтернатива функции testStarted(TestDescription) , где мы также указываем время начала теста, в сочетании с testEnded(TestDescription,long,Map) для более точного измерения.

void testStarted ( TestDescription test)

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

Государственные строители

ModuleResultsAndMetricsForwarder 

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

Параметры
listeners ITestInvocationListener

Общедоступные методы

setAttemptIsolation 

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Определяет, следует ли сообщать о попытке как об единичном случае.

Параметры
isolation CurrentInvocation.IsolationGrade

setMarkTestsSkipped 

public void setMarkTestsSkipped (boolean skip)

Следует ли отмечать все пропущенные тестовые случаи.

Параметры
skip boolean

setModuleId 

public void setModuleId (String moduleId)

Параметры
moduleId String

setTestMappingSources 

public void setTestMappingSources (List<String> testMappingSources)

Задает источники сопоставления тестов, которые будут включены в метрики.

Параметры
testMappingSources List

тест завершен 

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Альтернатива функции testEnded(TestDescription,Map) , позволяющая напрямую указать время окончания. Для более точного измерения можно использовать в сочетании с testStarted(TestDescription,long) .

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

endTime long : время окончания теста, измеренное с помощью System.currentTimeMillis()

testMetrics HashMap : 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 : трассировка стека ошибки

testRunEnded 

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Сообщает об окончании выполнения теста. FIXME: Мы не можем иметь два интерфейса Map<> с разными типами, поэтому здесь необходимо использовать HashMap.

Параметры
elapsedTime 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, 
                int attemptNumber, 
                long startTime)

Сообщает о начале тестового запуска.

Параметры
runName String : название тестового запуска

testCount int : общее количество тестов в тестовом запуске

attemptNumber int : порядковый номер, идентифицирующий различные попытки выполнения одного и того же runName, которые выполняются несколько раз. attemptNumber имеет индексацию от 0 и должен увеличиваться каждый раз при новом запуске. Например, если тест повторяется 3 раза, то всего должно быть 4 запуска под одним и тем же runName, а attemptNumber принимает значения от 0 до 3.

startTime long : время начала выполнения, измеренное с помощью System.currentTimeMillis()

тест начат 

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