Contexto de invocación
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Contiene información sobre la Invocación para que las pruebas accedan 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 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) Rastree 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 rastrear asignada a uno de los fragmentos que ejecuta 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 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 de dispositivos 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 todo el dispositivo asignado rastreado 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 seriales del dispositivo rastreado en esta invocación |
abstract | getShardsSerials () Devuelve el mapa de todas las publicaciones seriadas rastreadas y su fragmento involucrado en la fragmentación. |
abstract String | getTestTag () Devuelve la etiqueta de prueba de invocación. |
abstract void | markReleasedEarly () Marque los dispositivos que se lanzarán antes. |
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 () Serialice una instancia de contexto en un protobuf. |
abstract boolean | wasReleasedEarly () Devuelve si los dispositivos se lanzaron antes o no y si ya no se usarán. |
constantes
INVOCACIÓN_ID
public static final String INVOCATION_ID
Clave utilizada para almacenar el ID de invocación asociado.
Valor constante: "invocación-id"
Métodos públicos
agregarDispositivoAsignado
public abstract void addAllocatedDevice (deviceWithName)
Rastree un mapa del nombre del dispositivo de configuración asociado a un ITestDevice
. No borra el seguimiento anterior antes de agregar.
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 nulo en el mapa.
Parámetros | |
---|---|
deviceName | String : el nombre de configuración del dispositivo para asociar con ITestDevice |
testDevice | ITestDevice : para agregar a los dispositivos asignados. |
addDeviceBuildInfo
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 rastrear asignada a uno de los fragmentos que ejecuta algunas pruebas.
Parámetros | |
---|---|
index | Integer : el índice del fragmento usando las publicaciones seriadas |
serials |
getAttribute
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 devuelva nulo.
Parámetros | |
---|---|
key | String |
Devoluciones | |
---|---|
String | cadena vacía cuando la clave no existe, el valor de lo 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> |
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 hacer coincidir el nombre del dispositivo.
Parámetros | |
---|---|
deviceName | String |
Devoluciones | |
---|---|
IBuildInfo |
getBuildInfo
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
Devuelve el IBuildInfo
asociado con el 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 no se puede hacer coincidir IBuildInfo
Parámetros | |
---|---|
info | IBuildInfo |
Devoluciones | |
---|---|
String |
getBuildInfos
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 |
obtenerDispositivo
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 |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Devolver el mapa de asociación de información de dispositivo/compilación
Devoluciones | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Devuelve el ITestDevice
asociado al serial proporcionado. Absténgase 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 de dispositivos del dispositivo rastreado en esta invocación
Devoluciones | |
---|---|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Devuelve el nombre del dispositivo establecido en la configuración xml de ITestDevice
. Devuelve nulo, si no se puede hacer coincidir ITestDevice.
Parámetros | |
---|---|
device | ITestDevice |
Devoluciones | |
---|---|
String |
obtener dispositivos
public abstractgetDevices ()
Devuelve todo el dispositivo asignado rastreado para esta invocación.
Devoluciones | |
---|---|
obtenerIdInvocación
public abstract String getInvocationId ()
Devoluciones | |
---|---|
String | ID de invocación asociado 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 |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Devuelve el número de dispositivos asignados para la invocación.
Devoluciones | |
---|---|
int |
getSerials
public abstractgetSerials ()
Devuelve la lista de seriales del dispositivo rastreado en esta invocación
Devoluciones | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Devuelve el mapa de todas las publicaciones seriadas rastreadas y su fragmento involucrado 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 |
marcaReleasedEarly
public abstract void markReleasedEarly ()
Marque 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 lanzó la invocación
Parámetros | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
establecerModuloInvocaciónContexto
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 |
establecer etiqueta de prueba
public abstract void setTestTag (String testTag)
Establece la etiqueta de prueba de invocación.
Parámetros | |
---|---|
testTag | String |
aProto
public abstract InvocationContext.Context toProto ()
Serialice una instancia de contexto en un protobuf.
Devoluciones | |
---|---|
InvocationContext.Context |
fue liberado temprano
public abstract boolean wasReleasedEarly ()
Devuelve si los dispositivos se lanzaron antes o no y si ya no se usarán.
Devoluciones | |
---|---|
boolean |