IIInvocaciónContexto

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext


Contiene información sobre la invocación para que las pruebas puedan acceder si es necesario. Las pruebas no deben modificar el contexto contenido aquí, por lo que solo estarán disponibles los captadores, excepto los atributos de contexto para fines de generación de informes.

Resumen

Constantes

String INVOCATION_ID

Clave utilizada para almacenar el ID de invocación asociado.

Métodos públicos

abstract void addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName)

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

abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)

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

abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)

Agregue un IBuildInfo para realizar un seguimiento con el nombre de configuración del dispositivo.

abstract void addInvocationAttribute (String attributeName, String attributeValue)

Agregue un atributo de invocación.

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

Agregue varios atributos de invocación a la vez a través de UniqueMultiMap .

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

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

abstract void addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials)

Agregue una serie para realizar un seguimiento como asignada a uno de los fragmentos que ejecutan algunas pruebas.

default String getAttribute (String key)

Un método conveniente para recuperar el atributo de contexto de invocación como un único 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 ITestDevice

abstract String getBuildInfoName ( IBuildInfo info)

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

abstract getBuildInfos ()

Devuelve todo el IBuildInfo rastreado para esta invocación.

abstract ConfigurationDescriptor getConfigurationDescriptor ()

Devuelve el descriptor asociado con la configuración de prueba que lanzó la invocación.

abstract ITestDevice getDevice (String deviceName)

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

abstract getDeviceBuildMap ()

Devolver el mapa de la asociación de información de dispositivo/compilación

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 del dispositivo rastreado en esta invocación

abstract String getDeviceName ( ITestDevice device)

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

abstract getDevices ()

Devuelve todos los dispositivos asignados rastreados 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 ()

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

abstract int getNumDevicesAllocated ()

Devuelve el número de dispositivos asignados para la invocación.

abstract getSerials ()

Devuelve la lista de números de serie del dispositivo rastreado en esta invocación.

abstract getShardsSerials ()

Devuelve el mapa de todas las publicaciones seriadas rastreadas y sus fragmentos involucrados en la fragmentación.

abstract String getTestTag ()

Devuelve la etiqueta de prueba de invocación.

abstract void markReleasedEarly ()

Marque que los dispositivos se lanzarán anticipadamente.

abstract void setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)

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

abstract void setModuleInvocationContext ( IInvocationContext invocationContext)

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

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

Serializar una instancia de contexto en un protobuf.

abstract boolean wasReleasedEarly ()

Devuelve si los dispositivos se lanzaron anticipadamente o no y ya no se utilizarán.

Constantes

INVOCACIÓN_ID

public static final String INVOCATION_ID

Clave utilizada para almacenar el ID de invocación asociado.

Valor constante: "id-invocación"

Métodos públicos

agregarDispositivoAsignado

public abstract void addAllocatedDevice ( deviceWithName)

Realice 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 : el ERROR(/Map) del dispositivo adicional para rastrear

agregarDispositivoAsignado

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

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

Parámetros
deviceName String : el nombre de configuración del dispositivo para asociar con ITestDevice

testDevice ITestDevice : se agregará a los dispositivos asignados.

agregarDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Agregue un IBuildInfo para realizar un seguimiento con el nombre de configuración del dispositivo.

Parámetros
deviceName String : el nombre de configuración del dispositivo

buildinfo IBuildInfo : un IBuildInfo asociado al nombre de configuración del dispositivo.

agregar atributo de invocación

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Agregue un atributo de invocación.

Parámetros
attributeName String

attributeValue String

agregar atributos de invocación

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

Agregue varios atributos de invocación a la vez a través de UniqueMultiMap .

Parámetros
attributesMap MultiMap

agregarInvocaciónTimingMetric

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

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

Parámetros
timingEvent IInvocationContext.TimingEvent

durationMillis Long

agregarSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Agregue una serie para realizar un seguimiento como asignada a uno de los fragmentos que ejecutan algunas pruebas.

Parámetros
index Integer : el índice del fragmento usando las series

serials : La lista de publicaciones seriadas a las que se les dará seguimiento.

obtener atributo

public String getAttribute (String key)

Un método conveniente para recuperar el atributo de contexto de invocación como un único par clave-valor. Nunca devuelvas nulo.

Parámetros
key String

Devoluciones
String cadena vacía cuando la clave no existe, el valor en caso contrario.

obtener atributos

public abstract MultiMap<String, String> getAttributes ()

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

Devoluciones
MultiMap <String, String>

obtener información de compilación

public abstract IBuildInfo getBuildInfo (String deviceName)

Devuelve el IBuildInfo asociado con el nombre de configuración del dispositivo proporcionado. Devuelve nulo, si el nombre del dispositivo no puede coincidir.

Parámetros
deviceName String

Devoluciones
IBuildInfo

obtener información de compilación

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Devuelve el IBuildInfo asociado con ITestDevice

Parámetros
testDevice ITestDevice

Devoluciones
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Devuelve el nombre del dispositivo establecido en la configuración xml de IBuildInfo . Devuelve nulo si IBuildInfo no puede coincidir

Parámetros
info IBuildInfo

Devoluciones
String

obtener información de compilación

public abstract  getBuildInfos ()

Devuelve todo el IBuildInfo rastreado para esta invocación.

Devoluciones

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Devuelve el descriptor asociado con la configuración de prueba que lanzó la invocación.

Devoluciones
ConfigurationDescriptor

obtener dispositivo

public abstract ITestDevice getDevice (String deviceName)

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

Parámetros
deviceName String

Devoluciones
ITestDevice

obtenerDeviceBuildMap

public abstract  getDeviceBuildMap ()

Devolver el mapa de la asociación de información de dispositivo/compilación

Devoluciones

obtener dispositivo por serie

public abstract ITestDevice getDeviceBySerial (String serial)

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

Parámetros
serial String

Devoluciones
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

Devoluciones

obtener nombre del dispositivo

public abstract String getDeviceName (ITestDevice device)

Devuelve el nombre del dispositivo establecido en la configuración xml de ITestDevice . Devuelve nulo, si ITestDevice no puede coincidir.

Parámetros
device ITestDevice

Devoluciones
String

obtener dispositivos

public abstract  getDevices ()

Devuelve todos los dispositivos asignados rastreados para esta invocación.

Devoluciones

obtener Id. De invocación

public abstract String getInvocationId ()

Devoluciones
String ID de invocación asociada 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.

Devoluciones

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Devoluciones
IInvocationContext

getNumDevicesAsignados

public abstract int getNumDevicesAllocated ()

Devuelve el número de dispositivos asignados para la invocación.

Devoluciones
int

obtener seriales

public abstract  getSerials ()

Devuelve la lista de números de serie del dispositivo rastreado en esta invocación.

Devoluciones

getShardsSerials

public abstract  getShardsSerials ()

Devuelve el mapa de todas las publicaciones seriadas rastreadas y sus fragmentos involucrados en la fragmentación. Vacío si no es una invocación fragmentada.

Devoluciones

obtener etiqueta de prueba

public abstract String getTestTag ()

Devuelve la etiqueta de prueba de invocación.

Devoluciones
String

marcaPublicadoEarly

public abstract void markReleasedEarly ()

Marque que los dispositivos se lanzarán anticipadamente.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Establece el descriptor asociado con la configuración de prueba que lanzó 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 una suite.

Parámetros
invocationContext IInvocationContext

establecer modo de recuperación para todos los dispositivos

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

Parámetros
mode ITestDevice.RecoveryMode

estableceretiquetadeprueba

public abstract void setTestTag (String testTag)

Establece la etiqueta de prueba de invocación.

Parámetros
testTag String

aProto

public abstract InvocationContext.Context toProto ()

Serializar una instancia de contexto en un protobuf.

Devoluciones
InvocationContext.Context

fue lanzado temprano

public abstract boolean wasReleasedEarly ()

Devuelve si los dispositivos se lanzaron anticipadamente o no y ya no se utilizarán.

Devoluciones
boolean