IInvocationContext
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Содержит информацию о вызове для доступа тестов при необходимости. Тесты не должны изменять контекст, содержащийся здесь, поэтому будут доступны только геттеры, за исключением атрибутов контекста для целей отчетности.
Краткое содержание
Константы | |
---|---|
String | INVOCATION_ID Ключ, используемый для хранения связанного идентификатора вызова. |
Публичные методы | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) Отслеживайте карту имени устройства конфигурации, связанного с |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) Добавьте ITestDevice для отслеживания по метаданным при выделении устройства. |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) Добавьте |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) Добавьте атрибут вызова. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) Добавьте сразу несколько атрибутов вызова через |
default void | addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis) Добавьте метрику времени вызова. |
abstract void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) Добавьте серийный номер для отслеживания, назначенный одному из сегментов, выполняющих некоторые тесты. |
default String | getAttribute (String key) Удобный метод получения атрибута контекста вызова в виде одной пары ключ-значение. |
abstract MultiMap <String, String> | getAttributes () Возвращает копию карты, содержащую все атрибуты вызова. |
abstract IBuildInfo | getBuildInfo (String deviceName) Возвратите |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Вернуть |
abstract String | getBuildInfoName ( IBuildInfo info) Возвращает имя набора устройств в конфигурации xml из |
abstract | getBuildInfos () Возвратите все |
abstract ConfigurationDescriptor | getConfigurationDescriptor () Возвращает дескриптор, связанный с тестовой конфигурацией, запустившей вызов. |
abstract ITestDevice | getDevice (String deviceName) Верните |
abstract | getDeviceBuildMap () Вернуть карту ассоциации информации об устройстве/сборке |
abstract ITestDevice | getDeviceBySerial (String serial) Возвращает |
abstract | getDeviceConfigNames () Вернуть список имен конфигураций устройства, отслеживаемого в этом вызове. |
abstract String | getDeviceName ( ITestDevice device) Возвращает имя устройства, установленное в конфигурации xml из |
abstract | getDevices () Вернуть все выделенные устройства, отслеживаемые для этого вызова. |
abstract String | getInvocationId () |
default | getInvocationTimingMetrics () Возвращает карту, содержащую метрики времени вызова. |
abstract IInvocationContext | getModuleInvocationContext () Возвращает контекст вызова модуля при его выполнении как части пакета. |
abstract int | getNumDevicesAllocated () Возвращает количество устройств, выделенных для вызова. |
abstract | getSerials () Вернуть список серийных номеров устройства, отслеживаемого в этом вызове. |
abstract | getShardsSerials () Возвращает карту всех отслеживаемых сериалов и их шардов, участвующих в шардинге. |
abstract String | getTestTag () Возвращает тестовый тег вызова. |
abstract void | markReleasedEarly () Отметьте, что устройства выпускаются рано. |
abstract void | setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor) Задает дескриптор, связанный с тестовой конфигурацией, запустившей вызов |
abstract void | setModuleInvocationContext ( IInvocationContext invocationContext) Задает контекст вызова модуля при его выполнении как части пакета. |
abstract void | setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) Устанавливает |
abstract void | setTestTag (String testTag) Устанавливает тестовый тег вызова. |
abstract InvocationContext.Context | toProto () Сериализация экземпляра контекста в protobuf. |
abstract boolean | wasReleasedEarly () Возвращает информацию о том, были ли устройства выпущены раньше и больше не будут использоваться. |
Константы
INVOCATION_ID
public static final String INVOCATION_ID
Ключ, используемый для хранения связанного идентификатора вызова.
Постоянное значение: "идентификатор вызова"
Публичные методы
addAllocatedDevice
public abstract void addAllocatedDevice (deviceWithName)
Отслеживайте карту имени устройства конфигурации, связанного с ITestDevice
. Не очищает предыдущее отслеживание перед добавлением.
Параметры | |
---|---|
deviceWithName | ERROR(/Map) дополнительного устройства для отслеживания |
addAllocatedDevice
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Добавьте ITestDevice для отслеживания по метаданным при выделении устройства. установит для информации о сборке значение null на карте.
Параметры | |
---|---|
deviceName | String : имя конфигурации устройства для связи с ITestDevice |
testDevice | ITestDevice : для добавления к выделенным устройствам. |
addDeviceBuildInfo
public abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)
Добавьте IBuildInfo
для отслеживания с именем конфигурации устройства.
Параметры | |
---|---|
deviceName | String : имя конфигурации устройства. |
buildinfo | IBuildInfo : IBuildInfo , связанный с именем конфигурации устройства. |
addInvocationAttribute
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Добавьте атрибут вызова.
Параметры | |
---|---|
attributeName | String |
attributeValue | String |
addInvocationAttributes
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Добавьте сразу несколько атрибутов вызова через UniqueMultiMap
.
Параметры | |
---|---|
attributesMap | MultiMap |
addInvocationTimingMetric
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Добавьте метрику времени вызова.
Параметры | |
---|---|
timingEvent | IInvocationContext.TimingEvent |
durationMillis | Long |
аддсериалсфромшард
public abstract void addSerialsFromShard (Integer index,serials)
Добавьте серийный номер для отслеживания, назначенный одному из сегментов, выполняющих некоторые тесты.
Параметры | |
---|---|
index | Integer : индекс осколка с использованием серийных номеров. |
serials |
получить атрибут
public String getAttribute (String key)
Удобный метод получения атрибута контекста вызова в виде одной пары ключ-значение. Никогда не возвращайте ноль.
Параметры | |
---|---|
key | String |
Возвращает | |
---|---|
String | пустая строка, если ключ не существует, в противном случае значение. |
получить атрибуты
public abstract MultiMap<String, String> getAttributes ()
Возвращает копию карты, содержащую все атрибуты вызова.
Возвращает | |
---|---|
MultiMap <String, String> |
getBuildInfo
public abstract IBuildInfo getBuildInfo (String deviceName)
Возвратите IBuildInfo
, связанный с предоставленным именем конфигурации устройства. Возвращает значение null, если имя устройства не может быть сопоставлено.
Параметры | |
---|---|
deviceName | String |
Возвращает | |
---|---|
IBuildInfo |
getBuildInfo
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
Вернуть IBuildInfo
связанный с ITestDevice
Параметры | |
---|---|
testDevice | ITestDevice |
Возвращает | |
---|---|
IBuildInfo |
getBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Возвращает имя набора устройств в конфигурации xml из IBuildInfo
. Возвращает null, если IBuildInfo не может быть сопоставлен
Параметры | |
---|---|
info | IBuildInfo |
Возвращает | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Возвратите все IBuildInfo
, отслеженные для этого вызова.
Возвращает | |
---|---|
получитьконфигуратиондескриптор
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Возвращает дескриптор, связанный с тестовой конфигурацией, запустившей вызов.
Возвращает | |
---|---|
ConfigurationDescriptor |
получитьустройство
public abstract ITestDevice getDevice (String deviceName)
Верните ITestDevice
, связанный с предоставленным именем конфигурации устройства.
Параметры | |
---|---|
deviceName | String |
Возвращает | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Вернуть карту ассоциации информации об устройстве/сборке
Возвращает | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Возвращает ITestDevice
, связанный с предоставленным серийным номером. Не используйте слишком много, так как это не самый быстрый поиск.
Параметры | |
---|---|
serial | String |
Возвращает | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Вернуть список имен конфигураций устройства, отслеживаемого в этом вызове.
Возвращает | |
---|---|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Возвращает имя устройства, установленное в конфигурации xml из ITestDevice
. Возвращает значение null, если ITestDevice не может быть сопоставлен.
Параметры | |
---|---|
device | ITestDevice |
Возвращает | |
---|---|
String |
getDevices
public abstractgetDevices ()
Вернуть все выделенные устройства, отслеживаемые для этого вызова.
Возвращает | |
---|---|
getInvocationId
public abstract String getInvocationId ()
Возвращает | |
---|---|
String | связанный идентификатор вызова или null , если он не связан с вызовом |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Возвращает карту, содержащую метрики времени вызова.
Возвращает | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
Возвращает контекст вызова модуля при его выполнении как части пакета.
Возвращает | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Возвращает количество устройств, выделенных для вызова.
Возвращает | |
---|---|
int |
получитьсериалы
public abstractgetSerials ()
Вернуть список серийных номеров устройства, отслеживаемого в этом вызове.
Возвращает | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Возвращает карту всех отслеживаемых сериалов и их шардов, участвующих в шардинге. Пустой, если не сегментированный вызов.
Возвращает | |
---|---|
получитьтесттег
public abstract String getTestTag ()
Возвращает тестовый тег вызова.
Возвращает | |
---|---|
String |
отметкаReleasedEarly
public abstract void markReleasedEarly ()
Отметьте, что устройства выпускаются рано.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Задает дескриптор, связанный с тестовой конфигурацией, запустившей вызов
Параметры | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
setModuleInvocationContext
public abstract void setModuleInvocationContext (IInvocationContext invocationContext)
Задает контекст вызова модуля при его выполнении как части пакета.
Параметры | |
---|---|
invocationContext | IInvocationContext |
setRecoveryModeForAllDevices
public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)
Устанавливает RecoveryMode
для всех устройств, входящих в контекст.
Параметры | |
---|---|
mode | ITestDevice.RecoveryMode |
setTestTag
public abstract void setTestTag (String testTag)
Устанавливает тестовый тег вызова.
Параметры | |
---|---|
testTag | String |
toProto
public abstract InvocationContext.Context toProto ()
Сериализация экземпляра контекста в protobuf.
Возвращает | |
---|---|
InvocationContext.Context |
был выпущен рано
public abstract boolean wasReleasedEarly ()
Возвращает информацию о том, были ли устройства выпущены раньше и больше не будут использоваться.
Возвращает | |
---|---|
boolean |