A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
↳	com.android.tradefed.invoker.InvocationContext

Implementazione generica di un IInvocationContext.

Riepilogo

Costruttori pubblici
`InvocationContext()` Crea un `BuildInfo` utilizzando i valori predefiniti degli attributi.

Metodi pubblici
`void`	`addAllocatedDevice( deviceWithName)` Monitora una mappa del nome del dispositivo di configurazione associato a un `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Aggiungi un ITestDevice da monitorare dai metadati quando il dispositivo viene allocato.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Aggiungi un `IBuildInfo` da monitorare con il nome della configurazione del dispositivo.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Aggiungi un attributo Invocation.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Aggiungi più attributi di chiamata contemporaneamente tramite un `UniqueMultiMap`.
`void`	`addSerialsFromShard(Integer index, serials)` Aggiungi un numero di serie da monitorare come assegnato a uno dei frammenti che eseguono alcuni test.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Esegui l'operazione inversa a `InvocationContext.toProto()` per recuperare l'istanza.
`MultiMap<String, String>`	`getAttributes()` Restituisce una copia della mappa contenente tutti gli attributi di chiamata.
`IBuildInfo`	`getBuildInfo(String deviceName)` Restituisce il `IBuildInfo` associato al nome della configurazione del dispositivo fornito.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Restituisce il `IBuildInfo` associato al `ITestDevice`
`String`	`getBuildInfoName(IBuildInfo info)` Restituisce il nome del gruppo di dispositivi nella configurazione XML da `IBuildInfo`.
	`getBuildInfos()` Restituisce tutti i `IBuildInfo` monitorati per questa chiamata.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Restituisce il descrittore associato alla configurazione del test che ha avviato l'invocazione
`ITestDevice`	`getDevice(String deviceName)` Restituisce il `ITestDevice` associato al nome della configurazione del dispositivo fornito.
	`getDeviceBuildMap()` Restituisce la mappa dell'associazione delle informazioni del dispositivo/della build
`ITestDevice`	`getDeviceBySerial(String serial)` Restituisce il `ITestDevice` associato al numero di serie fornito.
	`getDeviceConfigNames()` Restituisce l'elenco dei nomi delle configurazioni del dispositivo monitorato in questa chiamata
`String`	`getDeviceName(ITestDevice device)` Restituisce il nome del gruppo di dispositivi impostato nella configurazione XML da `ITestDevice`.
	`getDevices()` Restituisce tutti i dispositivi allocati monitorati per questa chiamata.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Restituisce il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.
`int`	`getNumDevicesAllocated()` Restituisce il numero di dispositivi allocati per l'invocazione.
	`getSerials()` Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata
	`getShardsSerials()` Restituisce la mappa di tutte le serie monitorate e dei relativi shard coinvolti nello sharding.
`String`	`getTestTag()` Restituisce il tag test di chiamata.
`static boolean`	`isOnDemand(IInvocationContext context)` Restituisce se viene rilevata l'invocazione del test on demand in base al tipo di attivatore.
`static boolean`	`isPresubmit(IInvocationContext context)` Restituisce se viene rilevato il pre-invio in base al tipo di trigger.
`void`	`lockAttributes()` Blocca il contesto per impedire l'aggiunta di altri attributi di chiamata.
`void`	`logInvocationMetrics()` Registra gli attributi `InvocationMetricLogger` nell'invocazione.
`void`	`markReleasedEarly()` Contrassegna i dispositivi che verranno rilasciati in anteprima.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Imposta il descrittore associato alla configurazione del test che ha avviato l'invocazione
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Imposta il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Imposta il `RecoveryMode` di tutti i dispositivi che fanno parte del contesto
`void`	`setTestTag(String testTag)` Imposta il tag di test dell'invocazione.
`InvocationContext.Context`	`toProto()` Serializza l'istanza di contesto in un protobuf.
`boolean`	`wasReleasedEarly()` Restituisce se i dispositivi sono stati rilasciati in anteprima e non verranno più utilizzati.

Costruttori pubblici

InvocationContext

public InvocationContext ()

Crea un BuildInfo utilizzando i valori predefiniti degli attributi.

Metodi pubblici

addAllocatedDevice

public 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 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 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 void addInvocationAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo Invocation.

Parametri
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

Aggiungi più attributi di chiamata contemporaneamente tramite un UniqueMultiMap.

Parametri
`attributesMap`	`MultiMap`

addSerialsFromShard

public 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.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Esegui l'operazione inversa a InvocationContext.toProto() per recuperare l'istanza.

Parametri
`protoContext`	`InvocationContext.Context`

Ritorni
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

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

Ritorni
`MultiMap<String, String>`

getBuildInfo

public 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 IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisce il IBuildInfo associato al ITestDevice

Parametri
`testDevice`	`ITestDevice`

Ritorni
`IBuildInfo`

getBuildInfoName

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

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

Ritorni

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

Ritorni
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

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

Parametri
`deviceName`	`String`

Ritorni
`ITestDevice`

getDeviceBuildMap

public  getDeviceBuildMap ()

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

Ritorni

getDeviceBySerial

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

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

Ritorni

getDeviceName

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

Restituisce tutti i dispositivi allocati monitorati per questa chiamata.

Ritorni

getInvocationId

public String getInvocationId ()

Ritorni
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

Ritorni
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

Ritorni
`int`

getSerials

public  getSerials ()

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

Ritorni

getShardsSerials

public  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 String getTestTag ()

Restituisce il tag test di chiamata.

Ritorni
`String`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Restituisce se viene rilevata l'invocazione del test on demand in base al tipo di attivatore.

Parametri
`context`	`IInvocationContext`

Ritorni
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Restituisce se viene rilevato il pre-invio in base al tipo di trigger.

Parametri
`context`	`IInvocationContext`

Ritorni
`boolean`

lockAttributes

public void lockAttributes ()

Blocca il contesto per impedire l'aggiunta di altri attributi di chiamata.

logInvocationMetrics

public void logInvocationMetrics ()

Registra gli attributi InvocationMetricLogger nell'invocazione.

markReleasedEarly

public void markReleasedEarly ()

Contrassegna i dispositivi che verranno rilasciati in anteprima.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

Parametri
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

Parametri
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

Parametri
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

Imposta il tag di test dell'invocazione.

Parametri
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Serializza l'istanza di contesto in un protobuf.

Ritorni
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

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

Ritorni
`boolean`