A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 degli attributi predefiniti.

Metodi pubblici
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` Tieni traccia di una mappa del nome del dispositivo di configurazione associato a un `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Aggiungi un ITestDevice da monitorare in base ai 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 invocazione contemporaneamente tramite un `UniqueMultiMap`.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` Aggiungi un numero di serie da monitorare come assegnato a uno degli shard che esegue alcuni test.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Operazione inversa a `InvocationContext.toProto()` per ripristinare l'istanza.
`MultiMap<String, String>`	`getAttributes()` Restituisce una copia della mappa contenente tutti gli attributi di invocazione.
`IBuildInfo`	`getBuildInfo(String deviceName)` Restituisci `IBuildInfo` associato al nome della configurazione del dispositivo fornito.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Restituisci `IBuildInfo` associato a `ITestDevice`
`String`	`getBuildInfoName(IBuildInfo info)` Restituisce il nome del gruppo di dispositivi nella configurazione XML da `IBuildInfo`.
`List<IBuildInfo>`	`getBuildInfos()` Restituisce tutti i `IBuildInfo` monitorati per questa chiamata.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Restituisce il descrittore associato alla configurazione di test che ha avviato la chiamata
`ITestDevice`	`getDevice(String deviceName)` Restituisci `ITestDevice` associato al nome della configurazione del dispositivo fornito.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` Restituisce la mappa dell'associazione tra dispositivo e informazioni sulla build
`ITestDevice`	`getDeviceBySerial(String serial)` Restituisce il `ITestDevice` associato al numero di serie fornito.
`List<String>`	`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 nella configurazione XML da `ITestDevice`.
`List<ITestDevice>`	`getDevices()` Restituisce tutti i dispositivi monitorati allocati per questa chiamata.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Restituisce il contesto di invocazione del modulo durante l'esecuzione nell'ambito di una suite.
`int`	`getNumDevicesAllocated()` Restituisce il numero di dispositivi allocati per l'invocazione.
`List<String>`	`getSerials()` Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata
`Map<Integer, List<String>>`	`getShardsSerials()` Restituisce la mappa di tutti i numeri di serie monitorati e del relativo shard coinvolto nello sharding.
`String`	`getTestTag()` Restituisce il tag di test di chiamata.
`static boolean`	`isApiTrigger(IInvocationContext context)` Restituisce un valore che indica se viene rilevata l'invocazione di test basata su API in base al tipo di trigger.
`static boolean`	`isOnDemand(IInvocationContext context)` Restituisce un valore che indica se viene rilevata l'invocazione del test on demand in base al tipo di trigger.
`static boolean`	`isPresubmit(IInvocationContext context)` Restituisce un valore che indica se viene rilevato un test pre-invio in base al tipo di trigger.
`void`	`lockAttributes()` Blocca il contesto per impedire l'aggiunta di altri attributi di invocazione.
`void`	`logInvocationMetrics()` Registra gli attributi `InvocationMetricLogger` nell'invocazione.
`void`	`markReleasedEarly()` Contrassegna i dispositivi come rilasciati in anticipo.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Imposta il descrittore associato alla configurazione di test che ha avviato la chiamata
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Imposta il contesto di invocazione del modulo durante l'esecuzione nell'ambito 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 test-tag di invocazione.
`InvocationContext.Context`	`toProto()` Serializza un'istanza di contesto in un protobuf.
`boolean`	`wasReleasedEarly()` Restituisce un valore che indica se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.

Costruttori pubblici

InvocationContext

public InvocationContext ()

Crea un BuildInfo utilizzando i valori degli attributi predefiniti.

Metodi pubblici

addAllocatedDevice

public void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

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

Parametri
`deviceWithName`	`Map`: l'`Map` del dispositivo aggiuntivo da monitorare

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

Aggiungi un ITestDevice da monitorare in base ai metadati quando il dispositivo viene allocato. imposterà le informazioni sulla build 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 invocazione contemporaneamente tramite un UniqueMultiMap.

Parametri
`attributesMap`	`MultiMap`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                List<String> serials)

Aggiungi un numero di serie da monitorare come assegnato a uno degli shard che esegue alcuni test.

Parametri
`index`	`Integer`: l'indice dello shard che utilizza i numeri di serie
`serials`	`List`: l'elenco dei numeri di serie da monitorare.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Operazione inversa a InvocationContext.toProto() per ripristinare l'istanza.

Parametri
`protoContext`	`InvocationContext.Context`

Resi
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

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

Resi
`MultiMap<String, String>`

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

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

Parametri
`deviceName`	`String`

Resi
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisci IBuildInfo associato a ITestDevice

Parametri
`testDevice`	`ITestDevice`

Resi
`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`

Resi
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

Resi
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

Restituisce il descrittore associato alla configurazione di test che ha avviato la chiamata

Resi
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

Restituisci ITestDevice associato al nome della configurazione del dispositivo fornito.

Parametri
`deviceName`	`String`

Resi
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Restituisce la mappa dell'associazione tra dispositivo e informazioni sulla build

Resi
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

Restituisce il ITestDevice associato al numero di serie fornito. Evita di utilizzarne troppi, in quanto non è la ricerca più veloce.

Parametri
`serial`	`String`

Resi
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

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

Resi
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

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

Parametri
`device`	`ITestDevice`

Resi
`String`

getDevices

public List<ITestDevice> getDevices ()

Restituisce tutti i dispositivi monitorati allocati per questa chiamata.

Resi
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

Resi
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Restituisce il contesto di invocazione del modulo durante l'esecuzione nell'ambito di una suite.

Resi
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

Resi
`int`

getSerials

public List<String> getSerials ()

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

Resi
`List<String>`

getShardsSerials

public Map<Integer, List<String>> getShardsSerials ()

Restituisce la mappa di tutti i numeri di serie monitorati e del relativo shard coinvolto nello sharding. Vuoto se non si tratta di una chiamata con partizionamento.

Resi
`Map<Integer, List<String>>`

getTestTag

public String getTestTag ()

Restituisce il tag di test di chiamata.

Resi
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

Restituisce un valore che indica se viene rilevata l'invocazione di test basati su API in base al tipo di trigger.

Parametri
`context`	`IInvocationContext`

Resi
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Restituisce un valore che indica se viene rilevata l'invocazione del test on demand in base al tipo di trigger.

Parametri
`context`	`IInvocationContext`

Resi
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Restituisce un valore che indica se viene rilevato un test pre-invio in base al tipo di trigger.

Parametri
`context`	`IInvocationContext`

Resi
`boolean`

lockAttributes

public void lockAttributes ()

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

logInvocationMetrics

public void logInvocationMetrics ()

Registra gli attributi InvocationMetricLogger nell'invocazione.

markReleasedEarly

public void markReleasedEarly ()

Contrassegna i dispositivi come rilasciati in anticipo.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Imposta il descrittore associato alla configurazione di test che ha avviato la chiamata

Parametri
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

Imposta il contesto di invocazione del modulo durante l'esecuzione nell'ambito 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 test-tag di invocazione.

Parametri
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Serializza un'istanza di contesto in un protobuf.

Resi
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

Restituisce un valore che indica se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.

Resi
`boolean`