IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

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

Resumen

Constantes

String INVOCATION_ID

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

Métodos públicos

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

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

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Agrega un ITestDevice para que los metadatos lo hagan 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 a través de un UniqueMultiMap.

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

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

abstract void addSerialsFromShard(Integer index, List<String> serials)

Agrega un número de serie para hacer un seguimiento de su asignación a uno de los fragmentos que ejecutan algunas pruebas.

default String getAttribute(String key)

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

abstract MultiMap<String, String> getAttributes()

Devuelve 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)

Devuelve el IBuildInfo asociado con el ITestDevice.

abstract String getBuildInfoName(IBuildInfo info)

Devuelve el nombre del conjunto de dispositivos en la configuración XML del IBuildInfo.

abstract List<IBuildInfo> getBuildInfos()

Devuelve todos los IBuildInfo registrados para esta invocación.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Devuelve 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 Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

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

abstract ITestDevice getDeviceBySerial(String serial)

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

abstract List<String> getDeviceConfigNames()

Devuelve la lista de nombres de configuración del dispositivo que se rastreó en esta invocación.

abstract String getDeviceName(ITestDevice device)

Devuelve el nombre del conjunto de dispositivos en la configuración XML del ITestDevice.

abstract List<ITestDevice> getDevices()

Devuelve todos los dispositivos asignados que se rastrearon para esta invocación.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

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

abstract IInvocationContext getModuleInvocationContext()

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

abstract int getNumDevicesAllocated()

Devuelve la cantidad de dispositivos asignados para la invocación.

abstract List<String> getSerials()

Devuelve la lista de números de serie del dispositivo del que se hizo un seguimiento en esta invocación.

abstract Map<Integer, List<String>> getShardsSerials()

Devuelve el mapa de todos los números de serie rastreados y su fragmento involucrado en la fragmentación.

abstract String getTestTag()

Devuelve la etiqueta de prueba de la invocación.

abstract void markReleasedEarly()

Marca que los dispositivos se lanzarán de forma anticipada.

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 conjunto.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Establece el RecoveryMode de todos los dispositivos que forman parte del contexto.

abstract void setTestTag(String testTag)

Establece la etiqueta de prueba de invocación.

abstract InvocationContext.Context toProto()

Serializa la instancia de contexto en un búfer de protocolo.

abstract boolean wasReleasedEarly()

Devuelve si los dispositivos se lanzaron de forma anticipada y ya no se usarán.

Constantes

INVOCATION_ID

public static final String INVOCATION_ID

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

Valor de la constante: "invocation-id"

Métodos públicos

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

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

Parámetros
deviceWithName Map: Es el Map del dispositivo adicional que se debe rastrear.

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

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

Parámetros
deviceName String: Es el nombre de la configuración del dispositivo que se asociará con el 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 la 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 a través de 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, 
                List<String> serials)

Agrega un número de serie para hacer un seguimiento de su asignación a uno de los fragmentos que ejecutan algunas pruebas.

Parámetros
index Integer: Es el índice de la partición que usa los números de serie.
serials List: Es la lista de números de serie que se rastrearán.

getAttribute

public String getAttribute (String key)

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

Parámetros
key String

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

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Devuelve 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. Devuelve nulo si no se puede encontrar una coincidencia para deviceName.

Parámetros
deviceName String

Muestra
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Devuelve el IBuildInfo asociado con el ITestDevice.

Parámetros
testDevice ITestDevice

Muestra
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Devuelve el nombre del conjunto de dispositivos en la configuración XML del IBuildInfo. Devuelve null si no se puede encontrar una coincidencia para IBuildInfo.

Parámetros
info IBuildInfo

Muestra
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Devuelve todos los IBuildInfo registrados para esta invocación.

Muestra
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Devuelve 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 Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

Muestra
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

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

Parámetros
serial String

Muestra
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

Devuelve la lista de nombres de configuración del dispositivo que se rastreó en esta invocación.

Muestra
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Devuelve el nombre del conjunto de dispositivos en la configuración XML del ITestDevice. Devuelve nulo si no se puede encontrar una coincidencia para ITestDevice.

Parámetros
device ITestDevice

Muestra
String

getDevices

public abstract List<ITestDevice> getDevices ()

Devuelve todos los dispositivos asignados que se rastrearon para esta invocación.

Muestra
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

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

Muestra
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Muestra
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Devuelve la cantidad de dispositivos asignados para la invocación.

Muestra
int

getSerials

public abstract List<String> getSerials ()

Devuelve la lista de números de serie del dispositivo del que se hizo un seguimiento en esta invocación.

Muestra
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

Devuelve el mapa de todos los números de serie rastreados y su fragmento involucrado en la fragmentación. Estará vacío si no es una invocación fragmentada.

Muestra
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

Devuelve la etiqueta de prueba de la invocación.

Muestra
String

markReleasedEarly

public abstract void markReleasedEarly ()

Marca que los dispositivos se lanzarán de forma anticipada.

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 conjunto.

Parámetros
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Establece el RecoveryMode de todos los dispositivos que forman 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 la instancia de contexto en un búfer de protocolo.

Muestra
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Devuelve si los dispositivos se lanzaron de forma anticipada y ya no se usarán.

Muestra
boolean