IInvoctionContext
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
Ключ, используемый для хранения связанного идентификатора вызова.
Постоянное значение: «идентификатор вызова»
Публичные методы
добавитьаллокатедевице
public abstract void addAllocatedDevice (deviceWithName)
Отслеживайте карту имени устройства конфигурации, связанного с ITestDevice
. Не очищает предыдущее отслеживание перед добавлением.
Параметры | |
---|---|
deviceWithName | ERROR(/Map) дополнительного устройства для отслеживания |
добавитьаллокатедевице
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 связанный с именем конфигурации устройства. |
аддинвокаттрибуте
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Добавьте атрибут вызова.
Параметры | |
---|---|
attributeName | String |
attributeValue | String |
аддинвокаттрибутес
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Добавьте сразу несколько атрибутов вызова через UniqueMultiMap
.
Параметры | |
---|---|
attributesMap | MultiMap |
аддинвококтаймингметрик
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Добавьте метрику времени вызова.
Параметры | |
---|---|
timingEvent | IInvocationContext.TimingEvent |
durationMillis | Long |
добавитьсериалсфромшард
public abstract void addSerialsFromShard (Integer index,serials)
Добавьте серийный номер, который будет отслеживаться как присвоенный одному из сегментов, выполняющих некоторые тесты.
Параметры | |
---|---|
index | Integer : индекс шарда с использованием серийных номеров. |
serials |
getAttribute
public String getAttribute (String key)
Удобный метод получения атрибута контекста вызова в виде одной пары ключ-значение. Никогда не возвращайте ноль.
Параметры | |
---|---|
key | String |
Возврат | |
---|---|
String | пустая строка, если ключ не существует, в противном случае значение. |
getAttributes
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
отслеживаемые для этого вызова.
Возврат | |
---|---|
getConfigurationDescriptor
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 |
ПолучитьУстройства
public abstractgetDevices ()
Вернуть все выделенные устройства, отслеживаемые для этого вызова.
Возврат | |
---|---|
получитьинвокацииид
public abstract String getInvocationId ()
Возврат | |
---|---|
String | связанный идентификатор вызова или null , если он не связан с вызовом |
getInvoctionTimingMetrics
publicgetInvocationTimingMetrics ()
Возвращает карту, содержащую метрики времени вызова.
Возврат | |
---|---|
getModuleInvoctionContext
public abstract IInvocationContext getModuleInvocationContext ()
Возвращает контекст вызова модуля при его выполнении как части пакета.
Возврат | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Возвращает количество устройств, выделенных для вызова.
Возврат | |
---|---|
int |
getSerials
public abstractgetSerials ()
Вернуть список серийных номеров устройства, отслеживаемого в этом вызове.
Возврат | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Возвращает карту всех отслеживаемых сериалов и их шардов, участвующих в шардинге. Пустой, если это не сегментированный вызов.
Возврат | |
---|---|
getTestTag
public abstract String getTestTag ()
Возвращает тестовый тег вызова.
Возврат | |
---|---|
String |
МаркВыпущенРанний
public abstract void markReleasedEarly ()
Отметьте, что устройства выпускаются раньше.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Устанавливает дескриптор, связанный с тестовой конфигурацией, которая запустила вызов.
Параметры | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
setModuleInvoctionContext
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 |