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.

GceManager

public class GceManager
extends Object

java.lang.Object
↳	com.android.tradefed.device.cloud.GceManager

Helper che gestisce le chiamate a GCE per avviare/arrestare e raccogliere i log da GCE.

Riepilogo

Campi
`public static final String`	`GCE_HOSTNAME_KEY`
`public static final String`	`GCE_INSTANCE_CLEANED_KEY`
`public static final String`	`GCE_INSTANCE_NAME_KEY`
`public static final String`	`GCE_IP_PRECONFIGURED_KEY`

Costruttori pubblici
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Questo costruttore è deprecato. Utilizza altri costruttori, lo manteniamo temporaneamente per la compatibilità con le versioni precedenti.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor, una variante che può essere utilizzata per fornire il nome dell'istanza GCE da utilizzare direttamente.

Metodi pubblici
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` Esecuzione effettiva di Acloud per spegnere il dispositivo virtuale.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Ricevi un bugreportz dal dispositivo utilizzando SSH per evitare potenziali problemi di connessione ADB.
`HostOrchestratorUtil`	`getHostOrchestratorUtil()` Restituisce l'istanza di `HostOrchestratorUtil`.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Legge i contenuti correnti del log seriale dell'istanza GCE Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Ricevi una segnalazione di bug tramite SSH per un'istanza nidificata.
`static void`	`logAndDeleteFile(File tempFile, String dataName, ITestLogger logger)`
`static void`	`logDirectory(File remoteDirectory, String baseName, ITestLogger logger, LogDataType type)`
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)` Recupera un file remoto da un'istanza nidificata e registralo.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Recupera un file remoto da un'istanza nidificata e registralo.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` Registra l'output seriale di un dispositivo descritto da `GceAvdInfo`.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Esegui il comando remoto tramite SSH su un'istanza.
`boolean`	`shutdownGce()` Arresta l'istanza GCE associata al `startGce()`.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)` Prova ad avviare un'istanza GCE con Acloud o Oxygen.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Prova ad avviare un'istanza GCE.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` Prova ad avviare un'istanza GCE con Acloud o Oxygen.
	`startMultiDevicesGce( buildInfos)` Questo metodo è deprecato. Rimuovi questa riga dopo l'aggiornamento del ramo principale.
	`startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)` Prova ad avviare un'istanza GCE con più dispositivi con Oxygen.

Metodi protetti
`static`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` Recupera il nome dell'istanza dai log di avvio GCE.

Campi

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Costruttori pubblici

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo)

Ctor

Parametri
`deviceDesc`	`DeviceDescriptor`: il `DeviceDescriptor` che verrà associato al dispositivo GCE.
`deviceOptions`	`TestDeviceOptions`: un `TestDeviceOptions` associato al dispositivo.
`buildInfo`	`IBuildInfo`: un `IBuildInfo` che descrive la build GCE da avviare.

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                 testResourceBuildInfos)

Questo costruttore è deprecato.
Utilizza altri costruttori. Manteniamo questa opzione temporaneamente per la compatibilità con le versioni precedenti.

Parametri
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                String gceInstanceName, 
                String gceHost)

Ctor, una variante che può essere utilizzata per fornire il nome dell'istanza GCE da utilizzare direttamente.

Parametri
`deviceDesc`	`DeviceDescriptor`: il `DeviceDescriptor` che verrà associato al dispositivo GCE.
`deviceOptions`	`TestDeviceOptions`: un `TestDeviceOptions` associato al dispositivo
`buildInfo`	`IBuildInfo`: un `IBuildInfo` che descrive la build GCE da avviare.
`gceInstanceName`	`String`: il nome dell'istanza da utilizzare.
`gceHost`	`String`: il nome host o l'indirizzo IP dell'istanza da utilizzare.

Metodi pubblici

AcloudShutdown

public static boolean AcloudShutdown (TestDeviceOptions options, 
                IRunUtil runUtil, 
                String instanceName, 
                String hostname, 
                boolean isIpPreconfigured)

Esecuzione effettiva di Acloud per spegnere il dispositivo virtuale.

Parametri
`options`	`TestDeviceOptions`: il `TestDeviceOptions` per le opzioni Acloud
`runUtil`	`IRunUtil`: il `IRunUtil` per eseguire Acloud
`instanceName`	`String`: l'istanza da arrestare.
`hostname`	`String`: nome host dell'istanza, utilizzato solo per Oxygen cuttlefish.
`isIpPreconfigured`	`boolean`: indica se l'AVD è stato creato su un dispositivo remoto con IP preconfigurato

Ritorni
`boolean`	Vero se l'operazione è riuscita

cleanUp

public void cleanUp ()

getBugreportzWithSsh

public static File getBugreportzWithSsh (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

Ricevi un bugreportz dal dispositivo utilizzando SSH per evitare potenziali problemi di connessione ADB.

Parametri
`gceAvd`	`GceAvdInfo`: i `GceAvdInfo` che descrivono il dispositivo.
`options`	`TestDeviceOptions`: un `TestDeviceOptions` che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.
`runUtil`	`IRunUtil`: un `IRunUtil` per eseguire comandi.

Ritorni
`File`	Un file che rimanda alla segnalazione di bug ZIP o null se si è verificato un problema.

Lanci
	IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Restituisce l'istanza di HostOrchestratorUtil.

Ritorni
`HostOrchestratorUtil`

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

Legge i contenuti correnti del log seriale dell'istanza GCE Avd.

Parametri
`infos`	`GceAvdInfo`: il `GceAvdInfo` che descrive l'istanza.
`avdConfigFile`	`File`: il file di configurazione dell'avd
`jsonKeyFile`	`File`: il file della chiave JSON dell'account di servizio.
`runUtil`	`IRunUtil`: un `IRunUtil` per eseguire comandi.

Ritorni
`String`	L'output del log seriale o null se si verifica un problema.

getNestedDeviceSshBugreportz

public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

Ricevi una segnalazione di bug tramite SSH per un'istanza nidificata. Questo richiede la richiesta di adb nell'istanza virtuale nidificata.

Parametri
`gceAvd`	`GceAvdInfo`: i `GceAvdInfo` che descrivono il dispositivo.
`options`	`TestDeviceOptions`: un `TestDeviceOptions` che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.
`runUtil`	`IRunUtil`: un `IRunUtil` per eseguire comandi.

Ritorni
`File`	Un file che rimanda alla segnalazione di bug ZIP o null se si è verificato un problema.

Lanci
	IOException

logAndDeleteFile

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

Parametri
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

Parametri
`remoteDirectory`	`File`
`baseName`	`String`
`logger`	`ITestLogger`
`type`	`LogDataType`

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type)

Recupera un file remoto da un'istanza nidificata e registralo.

Parametri
`logger`	`ITestLogger`: il `ITestLogger` in cui registrare il file.
`gceAvd`	`GceAvdInfo`: i `GceAvdInfo` che descrivono il dispositivo.
`options`	`TestDeviceOptions`: un `TestDeviceOptions` che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.
`runUtil`	`IRunUtil`: un `IRunUtil` per eseguire comandi.
`remoteFilePath`	`String`: il percorso remoto in cui trovare il file.
`type`	`LogDataType`: il `LogDataType` del file registrato.

Ritorni
`boolean`	se il file è stato registrato correttamente.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName)

Recupera un file remoto da un'istanza nidificata e registralo.

Parametri
`logger`	`ITestLogger`: il `ITestLogger` in cui registrare il file.
`gceAvd`	`GceAvdInfo`: i `GceAvdInfo` che descrivono il dispositivo.
`options`	`TestDeviceOptions`: un `TestDeviceOptions` che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.
`runUtil`	`IRunUtil`: un `IRunUtil` per eseguire comandi.
`remoteFilePath`	`String`: il percorso remoto in cui trovare il file.
`type`	`LogDataType`: il `LogDataType` del file registrato.
`baseName`	`String`: il nome base da utilizzare per registrare il file. Se è nullo, verrà utilizzato il nome del file reale.

Ritorni
`boolean`	se il file è stato registrato correttamente.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Registra l'output seriale di un dispositivo descritto da GceAvdInfo.

Parametri
`infos`	`GceAvdInfo`: il `GceAvdInfo` che descrive l'istanza.
`logger`	`ITestLogger`: il `ITestLogger` in cui registrare il log di serie.

remoteSshCommandExecution

public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                long timeoutMs, 
                String... command)

Esegui il comando remoto tramite SSH su un'istanza.

Parametri
`gceAvd`	`GceAvdInfo`: i `GceAvdInfo` che descrivono il dispositivo.
`options`	`TestDeviceOptions`: un `TestDeviceOptions` che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.
`runUtil`	`IRunUtil`: un `IRunUtil` per eseguire comandi.
`timeoutMs`	`long`: il timeout in millisecondi per il comando. 0 significa nessun timeout.
`command`	`String`: il comando remoto da eseguire.

Ritorni
`CommandResult`	`CommandResult` contenente il risultato dell'esecuzione.

shutdownGce

public boolean shutdownGce ()

Arresta l'istanza GCE associata al startGce().

Ritorni
`boolean`	Restituisce true se l'arresto di GCE è stato richiesto come non bloccante.

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes, 
                ITestLogger logger)

Prova ad avviare un'istanza GCE con Acloud o Oxygen.

Parametri
`ipDevice`	`String`: l'indirizzo IP iniziale dell'istanza GCE in cui eseguire l'AVD, `null` se non applicabile
`user`	`String`: l'utente che esegue l'host dell'AVD, `null` se non applicabile
`offset`	`Integer`: l'offset del numero di dispositivo dell'AVD nell'host, `null` se non applicabile
`attributes`	`MultiMap`: attributi associati all'attuale chiamata, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM
`logger`	`ITestLogger`: il `ITestLogger` in cui registrare i log di avvio del dispositivo.

Ritorni
`GceAvdInfo`	un `GceAvdInfo` che descrive l'istanza GCE. Potrebbe essere un'istanza di BOOT_FAIL.

Lanci
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

Ritorni
`GceAvdInfo`

Lanci
`TargetSetupError`

startGce

public GceAvdInfo startGce (String ipDevice, 
                MultiMap<String, String> attributes)

Prova ad avviare un'istanza GCE.

Parametri
`ipDevice`	`String`: l'indirizzo IP iniziale dell'istanza GCE in cui eseguire l'AVD, `null` se non applicabile
`attributes`	`MultiMap`: attributi associati all'attuale chiamata, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM

Ritorni
`GceAvdInfo`	un `GceAvdInfo` che descrive l'istanza GCE. Potrebbe essere un'istanza di BOOT_FAIL.

Lanci
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

Prova ad avviare un'istanza GCE con Acloud o Oxygen.

Parametri
`ipDevice`	`String`: l'indirizzo IP iniziale dell'istanza GCE in cui eseguire l'AVD, `null` se non applicabile
`user`	`String`: l'utente che esegue l'host dell'AVD, `null` se non applicabile
`offset`	`Integer`: l'offset del numero di dispositivo dell'AVD nell'host, `null` se non applicabile
`attributes`	`MultiMap`: attributi associati all'attuale chiamata, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM

Ritorni
`GceAvdInfo`	un `GceAvdInfo` che descrive l'istanza GCE. Potrebbe essere un'istanza di BOOT_FAIL.

Lanci
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Questo metodo è deprecato.
Rimuovi questa riga dopo l'aggiornamento del ramo principale.

Parametri
`buildInfos`

Ritorni

Lanci
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos, 
                MultiMap<String, String> attributes)

Prova ad avviare un'istanza GCE con più dispositivi con Oxygen.

Parametri
`buildInfos`	: `ERROR(/List)`
`attributes`	`MultiMap`: attributi associati all'invocazione corrente

Ritorni
	un `ERROR(/List)` che descrive le informazioni Avd di GCE.

Lanci
`TargetSetupError`

Metodi protetti

buildShutdownCommand

protected static  buildShutdownCommand (File config, 
                TestDeviceOptions options, 
                String instanceName, 
                String hostname, 
                boolean isIpPreconfigured)

Parametri
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

Ritorni

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Recupera il nome dell'istanza dai log di avvio GCE. Cerca il pattern "name": "gce-" per estrarne il nome. Estraiamo i dati dai log anziché dal file dei risultati perché, in caso di errore di avvio GCE, il nome dell'istanza tentata non viene visualizzato in JSON.

Parametri
`bootupLogs`	`String`

Ritorni
`String`