Contexto de invocación

public interface IInvocationContext

com.android.tradefed.engager.IInvocationContext

Contiene información sobre la invocación para que las pruebas puedan acceder a ella si es necesario. Las pruebas no deben modificar el contexto que se incluye aquí, de modo que solo los métodos get estarán disponibles, excepto los atributos de contexto con fines de generación de informes.

Resumen

Constantes

String INVOCATION_ID

La clave que se usa para almacenar el ID de invocación asociado.

Métodos públicos

abstract void addAllocatedDevice( deviceWithName)

Realiza un seguimiento de un mapa del nombre de dispositivo de configuración asociado a un ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Agrega un ITestDevice para que los metadatos realicen un seguimiento cuando se asigne el dispositivo.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Agrega un IBuildInfo para hacer un seguimiento con el nombre de configuración del dispositivo.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Agrega un atributo de invocación.

abstract void addInvocationAttributes(MultiMap<String, String> attributesMap)

Agrega varios atributos de invocación a la vez mediante un UniqueMultiMap.

default void addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)

Agrega una métrica de tiempo de invocación.

abstract void addSerialsFromShard(Integer index, serials)

Agrega una serie para hacer un seguimiento como asignada a uno de los fragmentos que ejecuta algunas pruebas.

default String getAttribute(String key)

Un método conveniente para recuperar el atributo del contexto de invocación como un solo par clave-valor.

abstract MultiMap<String, String> getAttributes()

Muestra una copia del mapa que contiene todos los atributos de invocación.

abstract IBuildInfo getBuildInfo(String deviceName)

Devuelve el IBuildInfo asociado con el nombre de configuración del dispositivo proporcionado.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Muestra el IBuildInfo asociado con el ITestDevice.

abstract String getBuildInfoName(IBuildInfo info)

Devuelve el nombre del dispositivo establecido en la configuración XML de IBuildInfo.

abstract getBuildInfos()

Muestra todos los IBuildInfo registrados para esta invocación.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Muestra el descriptor asociado con la configuración de prueba que inició la invocación

abstract ITestDevice getDevice(String deviceName)

Devuelve el ITestDevice asociado con el nombre de configuración del dispositivo proporcionado.

abstract getDeviceBuildMap()

Devuelve el mapa de la asociación de información de la compilación y el dispositivo

abstract ITestDevice getDeviceBySerial(String serial)

Devuelve el ITestDevice asociado con el número de serie proporcionado.

abstract getDeviceConfigNames()

Devuelve la lista de nombres de configuración de dispositivos del dispositivo registrado en esta invocación

abstract String getDeviceName(ITestDevice device)

Devuelve el nombre del dispositivo establecido en la configuración XML de ITestDevice.

abstract getDevices()

Muestra todos los dispositivos asignados que se registraron para esta invocación.

abstract String getInvocationId()
default getInvocationTimingMetrics()

Muestra el mapa que contiene las métricas de tiempo de invocación.

abstract IInvocationContext getModuleInvocationContext()

Muestra el contexto de invocación del módulo mientras se ejecuta como parte de un paquete.

abstract int getNumDevicesAllocated()

Muestra la cantidad de dispositivos asignados a la invocación.

abstract getSerials()

Devuelve la lista de series del dispositivo rastreado en esta invocación

abstract getShardsSerials()

Muestra el mapa de todas las series con seguimiento y su fragmento involucrado en la fragmentación.

abstract String getTestTag()

Muestra la etiqueta de prueba de invocación.

abstract void markReleasedEarly()

Indica si los dispositivos se lanzarán antes.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Establece el descriptor asociado con la configuración de prueba que inició la invocación

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Establece el contexto de invocación del módulo mientras se ejecuta como parte de un paquete.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Establece el RecoveryMode de todos los dispositivos en la parte del contexto.

abstract void setTestTag(String testTag)

Establece la etiqueta de prueba de invocación.

abstract InvocationContext.Context toProto()

Serializa una instancia de contexto en un protobuf.

abstract boolean wasReleasedEarly()

Devuelve si los dispositivos se lanzaron antes y si ya no se usarán.

Constantes

ID_INVOCACIÓN

public static final String INVOCATION_ID

La clave que se usa para almacenar el ID de invocación asociado.

Valor constante: “id-invocación”

Métodos públicos

agregarDispositivoasignado

public abstract void addAllocatedDevice ( deviceWithName)

Realiza un seguimiento de un mapa del nombre de dispositivo de configuración asociado a un ITestDevice. No se borra el seguimiento anterior antes de agregarlas.

Parámetros
deviceWithName : El ERROR(/Map) del dispositivo adicional del que se hará un seguimiento

agregarDispositivoasignado

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Agrega un ITestDevice para que los metadatos realicen un seguimiento cuando se asigne el dispositivo. establecerá la información de compilación en null en el mapa.

Parámetros
deviceName String: Es el nombre de la configuración del dispositivo que se asociará con ITestDevice.
testDevice ITestDevice: Se agregará a los dispositivos asignados.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Agrega un IBuildInfo para hacer un seguimiento con el nombre de configuración del dispositivo.

Parámetros
deviceName String: Es el nombre de la configuración del dispositivo.
buildinfo IBuildInfo: Es un IBuildInfo asociado al nombre de configuración del dispositivo.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Agrega un atributo de invocación.

Parámetros
attributeName String

attributeValue String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

Agrega varios atributos de invocación a la vez mediante un UniqueMultiMap.

Parámetros
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Agrega una métrica de tiempo de invocación.

Parámetros
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Agrega una serie para hacer un seguimiento como asignada a uno de los fragmentos que ejecuta algunas pruebas.

Parámetros
index Integer: El índice del fragmento que usa las series
serials : Es la lista de series de las que se hará un seguimiento.

getAttribute.

public String getAttribute (String key)

Un método conveniente para recuperar el atributo del contexto de invocación como un solo par clave-valor. Nunca devuelve un valor nulo.

Parámetros
key String

Muestra
String string vacía cuando la clave no existe; de lo contrario, el valor.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Muestra una copia del mapa que contiene todos los atributos de invocación.

Muestra
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Devuelve el IBuildInfo asociado con el nombre de configuración del dispositivo proporcionado. Resultado que se muestra null si no se puede establecer una coincidencia con deviceName.

Parámetros
deviceName String

Muestra
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Muestra el IBuildInfo asociado con el ITestDevice.

Parámetros
testDevice ITestDevice

Muestra
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Devuelve el nombre del dispositivo establecido en la configuración XML de IBuildInfo. Resultado que se muestra null si no se puede hacer coincidir IBuildInfo

Parámetros
info IBuildInfo

Muestra
String

getBuildInfos

public abstract  getBuildInfos ()

Muestra todos los IBuildInfo registrados para esta invocación.

Muestra

getConfigurationDescriptor.

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Muestra el descriptor asociado con la configuración de prueba que inició la invocación

Muestra
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Devuelve el ITestDevice asociado con el nombre de configuración del dispositivo proporcionado.

Parámetros
deviceName String

Muestra
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Devuelve el mapa de la asociación de información de la compilación y el dispositivo

Muestra

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Devuelve el ITestDevice asociado con el número de serie proporcionado. Evita usar demasiadas opciones, ya que no es la búsqueda más rápida.

Parámetros
serial String

Muestra
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Devuelve la lista de nombres de configuración de dispositivos del dispositivo registrado en esta invocación

Muestra

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Devuelve el nombre del dispositivo establecido en la configuración XML de ITestDevice. Muestra null si no se puede establecer una coincidencia con ITestDevice.

Parámetros
device ITestDevice

Muestra
String

getDevices

public abstract  getDevices ()

Muestra todos los dispositivos asignados que se registraron para esta invocación.

Muestra

ID getInvocation

public abstract String getInvocationId ()

Muestra
String ID de invocación asociado o null si no está vinculado a una invocación

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Muestra el mapa que contiene las métricas de tiempo de invocación.

Muestra

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Muestra el contexto de invocación del módulo mientras se ejecuta como parte de un paquete.

Muestra
IInvocationContext

getNumDevicesAllocated.

public abstract int getNumDevicesAllocated ()

Muestra la cantidad de dispositivos asignados a la invocación.

Muestra
int

getSerial

public abstract  getSerials ()

Devuelve la lista de series del dispositivo rastreado en esta invocación

Muestra

getShardsSerials

public abstract  getShardsSerials ()

Muestra el mapa de todas las series con seguimiento y su fragmento involucrado en la fragmentación. Está vacío si no es invocación fragmentada.

Muestra

getTestTag

public abstract String getTestTag ()

Muestra la etiqueta de prueba de invocación.

Muestra
String

markReleasedEarly

public abstract void markReleasedEarly ()

Indica si los dispositivos se lanzarán antes.

setConfigurationDescriptor.

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Establece el descriptor asociado con la configuración de prueba que inició la invocación

Parámetros
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Establece el contexto de invocación del módulo mientras se ejecuta como parte de un paquete.

Parámetros
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Establece el RecoveryMode de todos los dispositivos en la parte del contexto.

Parámetros
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Establece la etiqueta de prueba de invocación.

Parámetros
testTag String

ToProto

public abstract InvocationContext.Context toProto ()

Serializa una instancia de contexto en un protobuf.

Muestra
InvocationContext.Context

Se lanzó anticipada

public abstract boolean wasReleasedEarly ()

Devuelve si los dispositivos se lanzaron antes y si ya no se usarán.

Muestra
boolean