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 |
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 |
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 |
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 |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Devuelve el |
abstract String | getBuildInfoName ( IBuildInfo info) Devuelve el nombre del dispositivo establecido en la configuración xml de |
abstract | getBuildInfos () Devuelve todo el |
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 |
abstract | getDeviceBuildMap () Devolver el mapa de la asociación de información de dispositivo/compilación |
abstract ITestDevice | getDeviceBySerial (String serial) Devuelve el |
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 |
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 |
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 | 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 |
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 abstractgetBuildInfos ()
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 abstractgetDeviceBuildMap ()
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 abstractgetDeviceConfigNames ()
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 abstractgetDevices ()
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
publicgetInvocationTimingMetrics ()
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 abstractgetSerials ()
Devuelve la lista de números de serie del dispositivo rastreado en esta invocación.
Devoluciones | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
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 |