IInvoctionContext

public interface IInvocationContext

com.android.tradefed.invoker.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