IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Contiene informazioni sull'invocazione a cui i test possono accedere, se necessario. I test non devono modificare il contesto contenuto qui, pertanto saranno disponibili solo i getter, ad eccezione degli attributi del contesto per la generazione di report.

Riepilogo

Costanti

String INVOCATION_ID

Chiave utilizzata per memorizzare l'ID chiamata associato.

Metodi pubblici

abstract void addAllocatedDevice( deviceWithName)

Monitora una mappa del nome del dispositivo di configurazione associato a un ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Aggiungi un ITestDevice da monitorare dai metadati quando il dispositivo viene allocato.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Aggiungi un IBuildInfo da monitorare con il nome della configurazione del dispositivo.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Aggiungi un attributo Invocation.

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

Aggiungi più attributi di chiamata contemporaneamente tramite un UniqueMultiMap.

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

Aggiungi una metrica relativa ai tempi di chiamata.

abstract void addSerialsFromShard(Integer index, serials)

Aggiungi un numero di serie da monitorare come assegnato a uno dei frammenti che eseguono alcuni test.

default String getAttribute(String key)

Un metodo pratico per recuperare l'attributo del contesto di chiamata come singola coppia chiave-valore.

abstract MultiMap<String, String> getAttributes()

Restituisce una copia della mappa contenente tutti gli attributi di chiamata.

abstract IBuildInfo getBuildInfo(String deviceName)

Restituisce il IBuildInfo associato al nome della configurazione del dispositivo fornito.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Restituisce il IBuildInfo associato al ITestDevice

abstract String getBuildInfoName(IBuildInfo info)

Restituisce il nome del gruppo di dispositivi nella configurazione XML da IBuildInfo.

abstract getBuildInfos()

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Restituisce il descrittore associato alla configurazione del test che ha avviato l'invocazione

abstract ITestDevice getDevice(String deviceName)

Restituisce il ITestDevice associato al nome della configurazione del dispositivo fornito.

abstract getDeviceBuildMap()

Restituisce la mappa dell'associazione delle informazioni del dispositivo/della build

abstract ITestDevice getDeviceBySerial(String serial)

Restituisce il ITestDevice associato al numero di serie fornito.

abstract getDeviceConfigNames()

Restituisce l'elenco dei nomi delle configurazioni del dispositivo monitorato in questa chiamata

abstract String getDeviceName(ITestDevice device)

Restituisce il nome del gruppo di dispositivi impostato nella configurazione XML da ITestDevice.

abstract getDevices()

Restituisce tutti i dispositivi allocati monitorati per questa chiamata.

abstract String getInvocationId()
default getInvocationTimingMetrics()

Restituisce la mappa contenente le metriche relative ai tempi di chiamata.

abstract IInvocationContext getModuleInvocationContext()

Restituisce il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.

abstract int getNumDevicesAllocated()

Restituisce il numero di dispositivi allocati per l'invocazione.

abstract getSerials()

Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata

abstract getShardsSerials()

Restituisce la mappa di tutte le serie monitorate e dei relativi shard coinvolti nello sharding.

abstract String getTestTag()

Restituisce il tag test di chiamata.

abstract void markReleasedEarly()

Contrassegna i dispositivi che verranno rilasciati in anteprima.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Imposta il descrittore associato alla configurazione del test che ha avviato l'invocazione

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Imposta il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Imposta il RecoveryMode di tutti i dispositivi che fanno parte del contesto

abstract void setTestTag(String testTag)

Imposta il tag di test dell'invocazione.

abstract InvocationContext.Context toProto()

Serializza l'istanza di contesto in un protobuf.

abstract boolean wasReleasedEarly()

Restituisce se i dispositivi sono stati rilasciati in anteprima e non verranno più utilizzati.

Costanti

INVOCATION_ID

public static final String INVOCATION_ID

Chiave utilizzata per memorizzare l'ID chiamata associato.

Valore costante: "invocation-id"

Metodi pubblici

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

Monitora una mappa del nome del dispositivo di configurazione associato a un ITestDevice. Non cancella il monitoraggio precedente prima dell'aggiunta.

Parametri
deviceWithName : il ERROR(/Map) del dispositivo aggiuntivo da monitorare

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Aggiungi un ITestDevice da monitorare dai metadati quando il dispositivo viene allocato. imposterà le informazioni sulla compilazione su null nella mappa.

Parametri
deviceName String: il nome della configurazione del dispositivo da associare a ITestDevice
testDevice ITestDevice: da aggiungere ai dispositivi allocati.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Aggiungi un IBuildInfo da monitorare con il nome della configurazione del dispositivo.

Parametri
deviceName String: il nome della configurazione del dispositivo
buildinfo IBuildInfo: un IBuildInfo associato al nome della configurazione del dispositivo.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo Invocation.

Parametri
attributeName String

attributeValue String

addInvocationAttributes

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

Aggiungi più attributi di chiamata contemporaneamente tramite un UniqueMultiMap.

Parametri
attributesMap MultiMap

addInvocationTimingMetric

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

Aggiungi una metrica relativa ai tempi di chiamata.

Parametri
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Aggiungi un numero di serie da monitorare come assegnato a uno dei frammenti che eseguono alcuni test.

Parametri
index Integer: l'indice del frammento che utilizza i seriali
serials : l'elenco dei numeri di serie da monitorare.

getAttribute

public String getAttribute (String key)

Un metodo pratico per recuperare l'attributo del contesto di chiamata come singola coppia chiave-valore. Non restituire mai un valore nullo.

Parametri
key String

Ritorni
String stringa vuota se la chiave non esiste, altrimenti il valore.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Restituisce una copia della mappa contenente tutti gli attributi di chiamata.

Ritorni
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Restituisce il IBuildInfo associato al nome della configurazione del dispositivo fornito. Restituisce null se non è possibile trovare una corrispondenza per deviceName.

Parametri
deviceName String

Ritorni
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisce il IBuildInfo associato al ITestDevice

Parametri
testDevice ITestDevice

Ritorni
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Restituisce il nome del gruppo di dispositivi nella configurazione XML da IBuildInfo. Restituisce null se non è possibile trovare una corrispondenza per IBuildInfo

Parametri
info IBuildInfo

Ritorni
String

getBuildInfos

public abstract  getBuildInfos ()

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

Ritorni

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Restituisce il descrittore associato alla configurazione del test che ha avviato l'invocazione

Ritorni
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Restituisce il ITestDevice associato al nome della configurazione del dispositivo fornito.

Parametri
deviceName String

Ritorni
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Restituisce la mappa dell'associazione delle informazioni del dispositivo/della build

Ritorni

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Restituisce il ITestDevice associato al numero di serie fornito. Evita di utilizzarlo troppo, perché non è la ricerca più rapida.

Parametri
serial String

Ritorni
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Restituisce l'elenco dei nomi delle configurazioni del dispositivo monitorato in questa chiamata

Ritorni

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Restituisce il nome del gruppo di dispositivi impostato nella configurazione XML da ITestDevice. Restituisce null se non è possibile trovare una corrispondenza per ITestDevice.

Parametri
device ITestDevice

Ritorni
String

getDevices

public abstract  getDevices ()

Restituisce tutti i dispositivi allocati monitorati per questa chiamata.

Ritorni

getInvocationId

public abstract String getInvocationId ()

Ritorni
String ID chiamata associato o null se non collegato a una chiamata

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Restituisce la mappa contenente le metriche relative ai tempi di chiamata.

Ritorni

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Restituisce il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.

Ritorni
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

Ritorni
int

getSerials

public abstract  getSerials ()

Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata

Ritorni

getShardsSerials

public abstract  getShardsSerials ()

Restituisce la mappa di tutte le serie monitorate e dei relativi shard coinvolti nello sharding. Vuoto se non si tratta di una chiamata suddivisa in parti.

Ritorni

getTestTag

public abstract String getTestTag ()

Restituisce il tag test di chiamata.

Ritorni
String

markReleasedEarly

public abstract void markReleasedEarly ()

Contrassegna i dispositivi che verranno rilasciati in anteprima.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Imposta il descrittore associato alla configurazione del test che ha avviato l'invocazione

Parametri
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Imposta il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.

Parametri
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Imposta il RecoveryMode di tutti i dispositivi che fanno parte del contesto

Parametri
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Imposta il tag di test dell'invocazione.

Parametri
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Serializza l'istanza di contesto in un protobuf.

Ritorni
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Restituisce se i dispositivi sono stati rilasciati in anteprima e non verranno più utilizzati.

Ritorni
boolean