Эта страница переведена с помощью Cloud Translation API.

Базедевицеметрикколлектор

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver , IMetricCollector

java.lang.Объект
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Известные прямые подклассы

AtraceCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , GcovCodeCoverageCollector , GcovKernelCodeCoverageCollector , HostStatsdMetricCollector , JavaCodeCoverageCollector , LogcatOnFailureCollector , LogcatTimingMetricCollector , RebootReasonCollector , RuntimeRestartCollector , ScreenshotOnFailureCollector

Атрацеколлектор	`IMetricCollector` , который запускает трассировку во время теста, собирает результаты и регистрирует их при вызове.
BugreportzOnFailureCollector	Собирайте отчеты об ошибках, когда тест-кейс не пройден.
BugreportzOnTestCaseFailureCollector	Собирайте отчеты об ошибках, когда тест-кейс в ходе выполнения терпит неудачу.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия Clang с устройства и регистрировать их как тестовые артефакты.
Коллектор тестовых случаев	Подсчитайте и сообщите количество тестовых случаев для данного `IRemoteTest` .
DebugHostLogOnFailureCollector	Сборщик, который будет собирать и регистрировать журналы на стороне хоста в случае сбоя тестового сценария.
Девицетрацеколлектор	Сборщик, который запускает трассировку perfetto при запуске теста и записывает файл трассировки в конце.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` , который прослушивает ключи метрик, поступающие с устройства, и извлекает их в виде файла с устройства.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет получать измерения покрытия gcov с устройства и регистрировать их как тестовые артефакты.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет извлекать измерения покрытия ядра gcov из debugfs и с устройства, а затем, наконец, регистрировать их как тестовые артефакты.
Хостстатсдметрикколлектор	`IMetricCollector` , который собирает метрики statsd со стороны хоста с помощью команд утилиты statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` , который будет получать измерения покрытия Java с устройства и регистрировать их как тестовые артефакты.
LogcatOnFailureCollector	Сборщик, который будет захватывать и регистрировать логарифмический анализ в случае сбоя тестового примера.
LogcatTimingMetricCollector	Сборщик метрик, который собирает информацию о времени (например, время переключения пользователя) из logcat во время одного или нескольких повторных тестов, используя заданные шаблоны регулярных выражений для анализа сигналов начала и окончания события из строк logcat.
ПерезагрузкаПричинаКоллектор	Сборщик, который собирает данные о перезагрузках устройств во время тестового запуска и сообщает о них по причинам и подсчетам.
Сборщик времени выполненияRestartCollector	Сборщик, который собирает временные метки перезапусков среды выполнения (сбоев системного сервера) во время тестового запуска, если таковые имеются.
Снимок экранаOnFailureCollector	Коллектор, который будет делать снимок экрана и сохранять его в журнале в случае сбоя тестового примера.

Известные косвенные подклассы

AtraceRunMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , FilePullerLogCollector , ModuleLogcatCollector , PerfettoPullerMetricCollector , ShowmapPullerMetricCollector , TraceCmdCollector

AtraceRunMetricCollector	Собирает трассировки из всего тестового каталога в заданном каталоге тестового устройства, регистрирует тестовый каталог, осуществляет постобработку файлов трассировки в тестовом каталоге и агрегирует показатели.
BluetoothConnectionLatencyCollector	Сборщик отправит предварительно определенную конфигурацию метрики длительности statsd на устройства и соберет продолжительность соединения Bluetooth для каждого профиля.
BluetoothConnectionStateколлектор	Этот сборщик будет собирать метрики BluetoothConnectionStateChanged и записывать номер состояния соединения для каждого профиля.
BluetoothHciSnoopLogCollector	Сборщик для включения отслеживания Bluetooth HCI на тестируемом устройстве и сбора журнала для каждого теста.
FilePullerLogCollector	Регистратор файла, о котором сообщает сторона устройства.
МодульLogcatКоллектор	Версия сборщика logcat, но для модуля.
PerfettoPullerМетрикаКоллектор	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы perfetto с устройства и собирать с него метрики.
ShowmapPullerMetricCollector	Базовая реализация `FilePullerDeviceMetricCollector` , которая позволяет извлекать файлы карты отображения с устройства и собирать с него метрики.
Трасскмдколлектор	`IMetricCollector` , который собирает трассировки во время теста с помощью трассировки-cmd и записывает их в журнал при вызове.

Базовая реализация IMetricCollector , которая позволяет запускать и останавливать сбор данных onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) и ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .

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

Поля
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Общественные конструкторы
`BaseDeviceMetricCollector ()`

Публичные методы
`void`	`extraInit ( IInvocationContext context, ITestInvocationListener listener)`
`final`	`getBuildInfos ()` Возвращает список информации о сборке, доступной при вызове.
`final`	`getDevices ()` Возвращает список устройств, доступных при вызове.
`File`	`getFileFromTestArtifacts (String fileName)` Извлеките файл из тестовых артефактов или артефактов модуля и кэшируйте его на карте для последующих вызовов.
`final ITestInvocationListener`	`getInvocationListener ()` Возвращает исходный `ITestInvocationListener` , куда мы пересылаем результаты.
`String`	`getModuleName ()`
`final`	`getRealDevices ()` Возвращает все устройства, не являющиеся заглушками, из списка `getDevices()` .
`String`	`getRunName ()` Возвращает имя тестового запуска `mRunName` , который запускает сборщик.
`final ITestInvocationListener`	`init ( IInvocationContext context, ITestInvocationListener listener)` Инициализация сборщика с текущим контекстом и куда пересылать результаты.
`final void`	`invocationEnded (long elapsedTime)` Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
`final void`	`invocationFailed ( FailureDescription failure)` Сообщает о неполном вызове из-за какой-либо ошибки.
`final void`	`invocationFailed (Throwable cause)` Сообщает о неполном вызове из-за какой-либо ошибки.
`void`	`invocationSkipped ( SkipReason reason)` Сообщает о пропущенном вызове
`final void`	`invocationStarted ( IInvocationContext context)` Слушатели вызовов для пересылки
`final boolean`	`isDisabled ()` Возвращает True, если весь объект отключен (пропускает как установку, так и демонтаж).
`boolean`	`isDisabledReceiver ()` Независимо от того, отключен `IDeviceActionReceiver` или нет.
`final void`	`logAssociation (String dataName, LogFile logFile)` Не используйте внутреннюю реализацию сборщика метрик.
`void`	`onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)` Обратный вызов в случае сбоя тестового примера с ошибкой предположения.
`void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Обратный вызов, когда тестовый пример завершен.
`void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` Обратный вызов, когда тестовый пример завершен.
`void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` Обратный вызов в случае сбоя тестового примера.
`void`	`onTestModuleEnded ()` Позволяет перехватывать событие завершения модуля.
`void`	`onTestModuleStarted ()` Позволяет перехватывать событие запуска модуля.
`void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` Обратный вызов при завершении тестового запуска.
`void`	`onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)` Обратный вызов для событий testRunFailed
`void`	`onTestRunStart ( DeviceMetricData runData)` Обратный вызов при запуске тестового запуска.
`void`	`onTestStart ( DeviceMetricData testData)` Обратный вызов при запуске тестового примера.
`void`	`rebootEnded ( ITestDevice device)` Получает уведомление, когда перезагрузка устройства завершилась.
`void`	`rebootStarted ( ITestDevice device)` Получает уведомление, когда на устройстве началась перезагрузка.
`final void`	`setDisable (boolean isDisabled)` Устанавливает, должен ли объект быть отключен.
`void`	`setDisableReceiver (boolean isDisabled)` Устанавливает, следует ли отключить `IDeviceActionReceiver` .
`final void`	`setLogSaver ( ILogSaver logSaver)` Не используйте внутреннюю реализацию сборщика метрик.
`final void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
`final void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
`final void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Альтернатива `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` где мы можем напрямую указать время окончания.
`final void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Сообщает об окончании выполнения отдельного тестового примера.
`final void`	`testFailed ( TestDescription test, FailureDescription failure)` Сообщает о сбое отдельного тестового примера.
`final void`	`testFailed ( TestDescription test, String trace)` Сообщает о сбое отдельного тестового примера.
`final void`	`testIgnored ( TestDescription test)` Вызывается, когда тест не будет запускаться, обычно потому, что метод теста помечен с помощью org.junit.Ignore.
`final void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Предоставляет связанные данные журнала или отладки из тестового вызова.
`final void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Не используйте внутреннюю реализацию сборщика метрик.
`final void`	`testModuleEnded ()` Сообщает об окончании выполнения модуля.
`final void`	`testModuleStarted ( IInvocationContext moduleContext)` Сообщает о начале работы модуля.
`final void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Сообщает об окончании тестового запуска.
`final void`	`testRunFailed ( FailureDescription failure)` Тестовый запуск отчетов не удалось завершить из-за сбоя, описанного в поле `FailureDescription` .
`final void`	`testRunFailed (String errorMessage)` Тестовый запуск отчетов не удалось завершить из-за фатальной ошибки.
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Сообщает о начале тестового запуска.
`final void`	`testRunStarted (String runName, int testCount)` Обратные вызовы тестового запуска
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Сообщает о начале тестового запуска.
`final void`	`testRunStopped (long elapsedTime)` Тестовый запуск отчетов остановлен до завершения по запросу пользователя.
`final void`	`testSkipped ( TestDescription test, SkipReason reason)` Вызывается, когда тест пропускается и не выполняется по причине, которая обычно не ожидается.
`final void`	`testStarted ( TestDescription test, long startTime)` Альтернатива `testStarted(com.android.tradefed.result.TestDescription)` где мы также указываем, когда тест был запущен, в сочетании с `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` для точного измерения. .
`final void`	`testStarted ( TestDescription test)` Обратные вызовы тестовых случаев

Поля

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Общественные конструкторы

Базедевицеметрикколлектор

public BaseDeviceMetricCollector ()

Публичные методы

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Броски
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildInfos

public final  getBuildInfos ()

Возвращает список информации о сборке, доступной при вызове.

Возврат

ПолучитьУстройства

public final  getDevices ()

Возвращает список устройств, доступных при вызове.

Возврат

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Извлеките файл из тестовых артефактов или артефактов модуля и кэшируйте его на карте для последующих вызовов.

Параметры
`fileName`	`String` : имя файла для поиска в артефактах.

Возврат
`File`	Файл из тестового артефакта или артефакта модуля. Возвращает ноль, если файл не найден.

getInvoctionListener

public final ITestInvocationListener getInvocationListener ()

Возвращает исходный ITestInvocationListener , куда мы пересылаем результаты.

Возврат
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Возврат
`String`

GetRealDevices

public final  getRealDevices ()

Возвращает все устройства, не являющиеся заглушками, из списка getDevices() .

Возврат

getRunName

public String getRunName ()

Возвращает имя тестового запуска mRunName , который запускает сборщик.

Возврат
`String`	mRunName — имя текущего запуска теста.

инициализировать

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Инициализация сборщика с текущим контекстом и куда пересылать результаты. Будет вызываться только один раз для каждого экземпляра, и ожидается, что сборщик обновит свой внутренний контекст и прослушиватель. Init никогда не будет вызываться во время тестового запуска всегда.

Не переопределяйте, если вы не знаете, что делаете.

Параметры
`context`	`IInvocationContext` : `IInvocationContext` для текущего вызова.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` куда помещать результаты.

Возврат
`ITestInvocationListener`	новый слушатель, обертывающий исходный.

Броски
`DeviceNotAvailableException`

вызовЗавершен

public final void invocationEnded (long elapsedTime)

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

Будет автоматически вызываться платформой TradeFederation.

Параметры
`elapsedTime`	`long` : прошедшее время вызова в мс.

вызов не пройден

public final void invocationFailed (FailureDescription failure)

Сообщает о неполном вызове из-за какой-либо ошибки.

Будет автоматически вызываться платформой TradeFederation.

Параметры
`failure`	`FailureDescription` : `FailureDescription` , описывающее причину сбоя.

вызов не пройден

public final void invocationFailed (Throwable cause)

Сообщает о неполном вызове из-за какой-либо ошибки.

Будет автоматически вызываться платформой TradeFederation.

Параметры
`cause`	`Throwable` : `Throwable` причина сбоя

вызовПропущен

public void invocationSkipped (SkipReason reason)

Сообщает о пропущенном вызове

Параметры
`reason`	`SkipReason`

вызовНачало

public final void invocationStarted (IInvocationContext context)

Слушатели вызовов для пересылки

Параметры
`context`	`IInvocationContext` : информация о вызове.

isDisabled

public final boolean isDisabled ()

Возвращает True, если весь объект отключен (пропускает как установку, так и демонтаж). В противном случае неверно.

Возврат
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Независимо от того, отключен IDeviceActionReceiver или нет.

Возврат
`boolean`	верните true, если отключено, и false в противном случае.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Не используйте внутреннюю реализацию сборщика метрик. Это чистая переадресация.

Параметры
`dataName`	`String` : имя данных.
`logFile`	`LogFile` : `LogFile` , который был зарегистрирован ранее и должен быть связан с тестовым примером.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Обратный вызов в случае сбоя тестового примера с ошибкой предположения.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера.
`test`	`TestDescription` : `TestDescription` текущего тестового примера.

Броски
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Обратный вызов, когда тестовый пример завершен. Это должно быть время для уборки.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера. Это будет тот же объект, что и во время `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentTestCaseMetrics`	: текущая карта метрик, переданная в `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` .
`test`	`TestDescription` : `TestDescription` текущего тестового примера.

Броски
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Обратный вызов, когда тестовый пример завершен. Это должно быть время для уборки.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера. Это будет тот же объект, что и во время `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentTestCaseMetrics`	: текущая карта метрик, переданная в `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` .

Броски
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Обратный вызов в случае сбоя тестового примера.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера.
`test`	`TestDescription` : `TestDescription` текущего тестового примера.

Броски
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Позволяет фиксировать событие завершения модуля.

Броски
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Позволяет перехватывать событие запуска модуля.

Броски
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Обратный вызов при завершении тестового запуска. Это должно быть время для уборки.

Параметры
`runData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для запуска. Это будет тот же объект, что и во время `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentRunMetrics`	: текущая карта метрик, переданная в `ERROR(/#testRunEnded(long,Map))` .

Броски
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Обратный вызов для событий testRunFailed

Броски
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Обратный вызов при запуске тестового запуска.

Параметры
`runData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для запуска.

Броски
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Обратный вызов при запуске тестового примера.

Параметры
`testData`	`DeviceMetricData` : `DeviceMetricData` содержащий данные для тестового примера.

Броски
`DeviceNotAvailableException`

перезагрузкаЗакончена

public void rebootEnded (ITestDevice device)

Получает уведомление, когда перезагрузка устройства завершилась.

ПРИМЕЧАНИЕ. Получателям следует избегать перезагрузки во время этого обратного вызова. Любая попытка перезагрузки будет проигнорирована.

Параметры
`device`	`ITestDevice` : `ITestDevice` , на котором закончилась перезагрузка.

Броски
`DeviceNotAvailableException`

перезагрузка началась

public void rebootStarted (ITestDevice device)

Получает уведомление, когда на устройстве началась перезагрузка.

Параметры
`device`	`ITestDevice` : `ITestDevice` , с которого началась перезагрузка.

Броски
`DeviceNotAvailableException`

УстановитьОтключить

public final void setDisable (boolean isDisabled)

Устанавливает, должен ли объект быть отключен. Отключено означает, что шаги установки и демонтажа следует пропустить. Может использоваться для отключения объекта по умолчанию в конструкторе по умолчанию.

Параметры
`isDisabled`	`boolean` : состояние, в которое должен быть переведен объект.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Устанавливает, следует ли отключить IDeviceActionReceiver . Отключение означает, что он не будет зарегистрирован на устройстве для получения событий действий устройства.

Параметры
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Не используйте внутреннюю реализацию сборщика метрик. Это чистая переадресация.

Параметры
`logSaver`	`ILogSaver` : `ILogSaver`

тестПредположениеОтказ

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.

Параметры
`test`	`TestDescription` : идентифицирует тест.
`trace`	`String` : трассировка стека сбоя

тестПредположениеОтказ

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.

Параметры
`test`	`TestDescription` : идентифицирует тест.
`failure`	`FailureDescription` : `FailureDescription` , описывающее сбой и его контекст.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Альтернатива ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) где мы можем напрямую указать время окончания. Объедините его с testStarted(com.android.tradefed.result.TestDescription, long) для точного измерения.

Параметры
`test`	`TestDescription` : идентифицирует тест.
`endTime`	`long` : время окончания теста, измеренное с помощью `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` выданных метрик

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

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

Если testFailed(TestDescription, FailureDescription) не был вызван, этот тест пройден. Также возвращает любые метрики ключ/значение, которые могли быть созданы во время выполнения тестового примера.

Параметры
`test`	`TestDescription` : идентифицирует тест.
`testMetrics`	: `ERROR(/Map)` выданных метрик

тест не пройден

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Сообщает о сбое отдельного тестового примера.

Будет вызываться между testStarted и testEnded.

Параметры
`test`	`TestDescription` : идентифицирует тест.
`failure`	`FailureDescription` : `FailureDescription` , описывающее сбой и его контекст.

тест не пройден

public final void testFailed (TestDescription test, 
                String trace)

Сообщает о сбое отдельного тестового примера.

Будет вызываться между testStarted и testEnded.

Параметры
`test`	`TestDescription` : идентифицирует тест.
`trace`	`String` : трассировка стека сбоя

тестИгнорируется

public final void testIgnored (TestDescription test)

Вызывается, когда тест не будет запускаться, обычно потому, что метод теста помечен с помощью org.junit.Ignore.

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

журнал испытаний

public final 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.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Не используйте внутреннюю реализацию сборщика метрик. Это чистая переадресация.

Параметры
`dataName`	`String` : `String` описательное имя данных. например, «device_logcat». Примечание. dataName не может быть уникальным для каждого вызова. т.е. разработчики должны иметь возможность обрабатывать несколько вызовов с одним и тем же именем данных.
`dataType`	`LogDataType` : `LogDataType` данных.
`dataStream`	`InputStreamSource` : `InputStreamSource` данных. Разработчики должны вызвать createInputStream, чтобы начать чтение данных, и обеспечить закрытие результирующего InputStream после завершения.
`logFile`	`LogFile` : `LogFile` содержащий метаданные сохраненного файла.

testModuleEnded

public final void testModuleEnded ()

Сообщает об окончании выполнения модуля.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Сообщает о начале работы модуля. Этот обратный вызов связан с testModuleEnded() и является необязательным в последовательности. Он используется только во время запуска, в котором используются модули: бегуны на основе пакета.

Параметры
`moduleContext`	`IInvocationContext` : `IInvocationContext` модуля.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Сообщает об окончании тестового запуска. ИСПРАВЛЕНИЕ: мы не можем иметь два интерфейса Map<> разного типа, поэтому здесь нам придется использовать HashMap.

Параметры
`elapsedTime`	`long` : устройство сообщило прошедшее время в миллисекундах.
`runMetrics`	: пары ключ-значение, зарегистрированные в конце тестового запуска с помощью `Metric` .

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

Параметры
`failure`	`FailureDescription` : `FailureDescription` , описывающее сбой и его контекст.

testRunFailed

public final void testRunFailed (String errorMessage)

Тестовый запуск отчетов не удалось завершить из-за фатальной ошибки.

Параметры
`errorMessage`	`String` : `String` , описывающая причину сбоя запуска.

testRunStarted

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

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Обратные вызовы тестового запуска

Параметры
`runName`	`String` : имя запуска теста.
`testCount`	`int` : общее количество тестов в тестовом запуске

testRunStarted

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

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

Параметры
`runName`	`String` : имя запуска теста.
`testCount`	`int` : общее количество тестов в тестовом запуске
`attemptNumber`	`int` : номер заказа, идентифицирующий различные попытки одного и того же имени запуска, которые выполняются несколько раз. Номер попытки имеет индекс 0 и должен увеличиваться каждый раз при новом запуске. например, тест гранулярно повторяется 3 раза, всего должно быть 4 запуска под одним и тем же именем запуска, а номер попытки — от 0 до 3.
`startTime`	`long` : время начала прогона, измеренное с помощью `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Тестовый запуск отчетов остановлен до завершения по запросу пользователя.

TODO: в настоящее время не используется, рассмотрите возможность удаления

Параметры
`elapsedTime`	`long` : устройство сообщило прошедшее время в миллисекундах.

тестПропущен

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Вызывается, когда тест пропускается и не выполняется по причине, которая обычно не ожидается. Эти тесты будут предприняты повторно, чтобы попытаться обеспечить правильное выполнение.

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

тестНачало

public final void testStarted (TestDescription test, 
                long startTime)

Альтернатива testStarted(com.android.tradefed.result.TestDescription) где мы также указываем, когда тест был запущен, в сочетании с ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) для точного измерения. .

Параметры
`test`	`TestDescription` : идентифицирует тест.
`startTime`	`long` : время начала теста, измеренное с помощью `System.currentTimeMillis()`

тестНачало

public final void testStarted (TestDescription test)

Обратные вызовы тестовых случаев

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