IInvoctionContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Известные косвенные подклассы Контекст вызова Контекст вызова Общая реализация IInvocationContext .

---

Содержит информацию о вызове, к которой тесты могут получить доступ в случае необходимости. Тесты не должны изменять содержащийся здесь контекст, поэтому будут доступны только геттеры, за исключением атрибутов контекста для целей отчетности.

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

Константы
String	INVOCATION_ID Ключ, используемый для хранения связанного идентификатора вызова.

Публичные методы
abstract void	addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) Отслеживайте карту имени устройства конфигурации, связанного с ITestDevice .
abstract void	addAllocatedDevice (String deviceName, ITestDevice testDevice) Добавьте ITestDevice, который будет отслеживаться по метаданным при выделении устройства.
abstract void	addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) Добавьте IBuildInfo , который будет отслеживаться по имени конфигурации устройства.
abstract void	addInvocationAttribute (String attributeName, String attributeValue) Добавьте атрибут вызова.
abstract void	addInvocationAttributes ( MultiMap <String, String> attributesMap) Добавьте сразу несколько атрибутов вызова через UniqueMultiMap .
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) Верните IBuildInfo , связанный с предоставленным именем конфигурации устройства.
abstract IBuildInfo	getBuildInfo ( ITestDevice testDevice) Верните IBuildInfo , связанный с ITestDevice
abstract String	getBuildInfoName ( IBuildInfo info) Возвращает имя устройства, установленное в конфигурации XML из IBuildInfo .
abstract	getBuildInfos () Верните все IBuildInfo отслеживаемые для этого вызова.
abstract ConfigurationDescriptor	getConfigurationDescriptor () Возвращает дескриптор, связанный с тестовой конфигурацией, запустившей вызов.
abstract ITestDevice	getDevice (String deviceName) Верните ITestDevice связанный с предоставленным именем конфигурации устройства.
abstract	getDeviceBuildMap () Вернуть карту ассоциации информации об устройстве/сборке.
abstract ITestDevice	getDeviceBySerial (String serial) Возвращает ITestDevice , связанный с предоставленным серийным номером.
abstract	getDeviceConfigNames () Вернуть список имен конфигурации устройства, отслеживаемого в этом вызове.
abstract String	getDeviceName ( ITestDevice device) Возвращает имя устройства, заданное в конфигурации xml из ITestDevice .
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) Устанавливает RecoveryMode для всех устройств, входящих в контекст.
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 abstract  getBuildInfos ()

Верните все IBuildInfo отслеживаемые для этого вызова.

Возврат

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

Возврат
ConfigurationDescriptor

получитьустройство

public abstract ITestDevice getDevice (String deviceName)

Верните ITestDevice связанный с предоставленным именем конфигурации устройства.

Параметры
deviceName	String

Возврат
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Вернуть карту ассоциации информации об устройстве/сборке.

Возврат

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Возвращает ITestDevice , связанный с предоставленным серийным номером. Не используйте слишком много значений, поскольку это не самый быстрый поиск.

Параметры
serial	String

Возврат
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Вернуть список имен конфигурации устройства, отслеживаемого в этом вызове.

Возврат

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Возвращает имя устройства, заданное в конфигурации xml из ITestDevice . Возвращает значение NULL, если соответствие ITestDevice невозможно.

Параметры
device	ITestDevice

Возврат
String

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

public abstract  getDevices ()

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

Возврат

получитьинвокацииид

public abstract String getInvocationId ()

Возврат
String	связанный идентификатор вызова или null , если он не связан с вызовом

getInvoctionTimingMetrics

public  getInvocationTimingMetrics ()

Возвращает карту, содержащую метрики времени вызова.

Возврат

getModuleInvoctionContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Возврат
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

Возврат
int

getSerials

public abstract  getSerials ()

Вернуть список серийных номеров устройства, отслеживаемого в этом вызове.

Возврат

getShardsSerials

public abstract  getShardsSerials ()

Возвращает карту всех отслеживаемых сериалов и их шардов, участвующих в шардинге. Пустой, если это не сегментированный вызов.

Возврат

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