IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

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

Resumen

Constantes

String INVOCATION_ID

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

Métodos públicos

abstract void addAllocatedDevice( deviceWithName)

Hacer 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 le 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 la 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, serials)

Agrega un número de serie al que se le hará un seguimiento como asignado a uno de los fragmentos que ejecuta 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()

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

abstract IBuildInfo getBuildInfo(String deviceName)

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

Muestra el nombre del dispositivo establecido en la configuración XML desde IBuildInfo.

abstract getBuildInfos()

Muestra todos los IBuildInfo a los que se les hizo un seguimiento 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)

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

abstract getDeviceBuildMap()

Devuelve el mapa de asociación de información del dispositivo o compilación

abstract ITestDevice getDeviceBySerial(String serial)

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

abstract getDeviceConfigNames()

Muestra la lista de nombres de configuración del dispositivo del dispositivo al que se le hizo un seguimiento en esta invocación.

abstract String getDeviceName(ITestDevice device)

Muestra el nombre del dispositivo establecido en la configuración XML desde ITestDevice.

abstract getDevices()

Muestra todos los dispositivos asignados a los que se les hizo un seguimiento para esta invocación.

abstract String getInvocationId()
default getInvocationTimingMetrics()

Devuelve 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 para la invocación.

abstract getSerials()

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

abstract getShardsSerials()

Muestra el mapa de todos los seriales rastreados y su fragmento involucrado en el particionamiento.

abstract String getTestTag()

Devuelve la etiqueta de prueba de invocación.

abstract void markReleasedEarly()

Marca los dispositivos que 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 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 protobuf.

abstract boolean wasReleasedEarly()

Muestra si los dispositivos se lanzaron antes de tiempo y ya no se usarán.

Constantes

INVOCATION_ID

public static final String INVOCATION_ID

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

Valor constante: "invocation-id"

Métodos públicos

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

Hacer un seguimiento de un mapa del nombre del dispositivo de configuración asociado a un ITestDevice No borra el seguimiento anterior antes de agregarlo.

Parámetros
deviceWithName : Es el ERROR(/Map) del dispositivo adicional al que se le hará un seguimiento.

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Agrega un ITestDevice para que los metadatos le 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 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 la 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 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, 
                 serials)

Agrega un número de serie al que se le hará un seguimiento como asignado a uno de los fragmentos que ejecuta algunas pruebas.

Parámetros
index Integer: El índice del fragmento que usa los números de serie
serials : Es la lista de seriales a los que se les hará un seguimiento.

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 devuelvas un valor nulo.

Parámetros
key String

Muestra
String Es una cadena vacía cuando la clave no existe, y el valor en caso contrario.

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)

Muestra el IBuildInfo asociado con el nombre de configuración del dispositivo proporcionado. Muestra un valor nulo si no se puede encontrar una coincidencia para 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)

Muestra el nombre del dispositivo establecido en la configuración XML desde IBuildInfo. Muestra un valor nulo si no se puede hacer coincidir IBuildInfo.

Parámetros
info IBuildInfo

Muestra
String

getBuildInfos

public abstract  getBuildInfos ()

Muestra todos los IBuildInfo a los que se les hizo un seguimiento para esta invocación.

Muestra

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)

Muestra 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 asociación de información del dispositivo o compilación

Muestra

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Muestra el ITestDevice asociado con el número de serie proporcionado. No la uses demasiado, ya que no es la búsqueda más rápida.

Parámetros
serial String

Muestra
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Muestra la lista de nombres de configuración del dispositivo del dispositivo al que se le hizo un seguimiento en esta invocación.

Muestra

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Muestra el nombre del dispositivo establecido en la configuración XML desde ITestDevice. Muestra un valor nulo si no se puede establecer una coincidencia con ITestDevice.

Parámetros
device ITestDevice

Muestra
String

getDevices

public abstract  getDevices ()

Muestra todos los dispositivos asignados a los que se les hizo un seguimiento para esta invocación.

Muestra

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Devuelve 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 para la invocación.

Muestra
int

getSerials

public abstract  getSerials ()

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

Muestra

getShardsSerials

public abstract  getShardsSerials ()

Muestra el mapa de todos los seriales rastreados y su fragmento involucrado en el particionamiento. Está vacío si no es una invocación fragmentada.

Muestra

getTestTag

public abstract String getTestTag ()

Devuelve la etiqueta de prueba de invocación.

Muestra
String

markReleasedEarly

public abstract void markReleasedEarly ()

Marca los dispositivos que 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 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 protobuf.

Muestra
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Muestra si los dispositivos se lanzaron antes de tiempo y ya no se usarán.

Muestra
boolean