IInvocationContext

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

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

Постоянное значение: "идентификатор вызова"

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

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 abstract  getBuildInfos ()

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

Возвращает

получитьконфигуратиондескриптор

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

getDevices

public abstract  getDevices ()

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

Возвращает

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

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

Возвращает

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Возвращает
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

Возвращает
int

получитьсериалы

public abstract  getSerials ()

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

Возвращает

getShardsSerials

public abstract  getShardsSerials ()

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

Возвращает

получитьтесттег

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