A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

GceManager

public class GceManager
extends Object

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

Es un asistente que administra las llamadas a GCE para iniciar o detener y recopilar registros de GCE.

Resumen

Campos
`public static final String`	`GCE_HOSTNAME_KEY`
`public static final String`	`GCE_INSTANCE_CLEANED_KEY`
`public static final String`	`GCE_INSTANCE_NAME_KEY`

Constructores públicos
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Este constructor dejó de estar disponible. Usar otros constructores, lo mantenemos temporalmente para la retrocompatibilidad.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor, variación que se puede usar para proporcionar el nombre de la instancia de GCE que se usará directamente.

Métodos públicos
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname)` Ejecución real de Acloud para apagar el dispositivo virtual.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Obtén un informe de errores del dispositivo con ssh para evitar cualquier problema potencial de conexión de adb.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Lee el contenido actual del registro en serie de la instancia de Gce Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Obtén un informe de errores a través de ssh para una instancia anidada.
`static void`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)` Recupera un archivo remoto de una instancia anidada y haz un registro.
`static void`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Recupera un archivo remoto de una instancia anidada y haz un registro.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` Registra la salida en serie de un dispositivo descrito por `GceAvdInfo`.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Ejecuta el comando remoto a través de ssh en una instancia.
`boolean`	`shutdownGce()` Apaga la instancia de GCE asociada con el `startGce()`.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Intenta iniciar una instancia de GCE

Métodos protegidos
	`buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, MultiMap<String, String> attributes)` Compila y muestra el comando para iniciar GCE.
`String`	`extractInstanceName(String bootupLogs)` Recupera el nombre de la instancia de los registros de inicio de GCE.

Campos

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

Constructores públicos

GceManager

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

Ctor

Parámetros
`deviceDesc`	`DeviceDescriptor`: Es el `DeviceDescriptor` que se asociará con el dispositivo de GCE.
`deviceOptions`	`TestDeviceOptions`: Un `TestDeviceOptions` asociado con el dispositivo.
`buildInfo`	`IBuildInfo`: Es un `IBuildInfo` que describe la compilación de gce que se iniciará.

GceManager

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

Este constructor dejó de estar disponible.
Usa otros constructores. Mantenemos esto de forma temporal para mantener la retrocompatibilidad.

Parámetros
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

GceManager

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

Ctor, variación que se puede usar para proporcionar el nombre de la instancia de GCE que se usará directamente.

Parámetros
`deviceDesc`	`DeviceDescriptor`: Es el `DeviceDescriptor` que se asociará con el dispositivo de GCE.
`deviceOptions`	`TestDeviceOptions`: Un `TestDeviceOptions` asociado con el dispositivo
`buildInfo`	`IBuildInfo`: Es un `IBuildInfo` que describe la compilación de gce que se iniciará.
`gceInstanceName`	`String`: Es el nombre de la instancia que se usará.
`gceHost`	`String`: Es el nombre de host o la IP de la instancia que se usará.

Métodos públicos

AcloudShutdown

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

Ejecución real de Acloud para apagar el dispositivo virtual.

Parámetros
`options`	`TestDeviceOptions`: Es el `TestDeviceOptions` para las opciones de Acloud.
`runUtil`	`IRunUtil`: Es el `IRunUtil` para ejecutar Acloud.
`instanceName`	`String`: Es la instancia que se cerrará.
`hostname`	`String`: Es el nombre de host de la instancia, que solo se usa para Oxygen cuttlefish.

Muestra
`boolean`	Es verdadero si se realiza correctamente.

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Obtén un informe de errores del dispositivo con ssh para evitar cualquier problema potencial de conexión de adb.

Parámetros
`gceAvd`	`GceAvdInfo`: Es el `GceAvdInfo` que describe el dispositivo.
`options`	`TestDeviceOptions`: Un `TestDeviceOptions` que describe las opciones de dispositivos que se usarán para el dispositivo de GCE.
`runUtil`	`IRunUtil`: Un `IRunUtil` para ejecutar comandos.

Muestra
`File`	Es un archivo que apunta al informe de errores ZIP o nulo si se produjo un problema.

getInstanceSerialLog

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

Lee el contenido actual del registro en serie de la instancia de Gce Avd.

Parámetros
`infos`	`GceAvdInfo`: Es el `GceAvdInfo` que describe la instancia.
`avdConfigFile`	`File`: El archivo de configuración de avd
`jsonKeyFile`	`File`: Es el archivo de clave JSON de la cuenta de servicio.
`runUtil`	`IRunUtil`: Un `IRunUtil` para ejecutar comandos.

Muestra
`String`	El resultado del registro en serie o nulo si algo sale mal.

getNestedDeviceSshBugreportz

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

Obtén un informe de errores a través de ssh para una instancia anidada. Esto requiere solicitar el adb en la instancia virtual anidada.

Parámetros
`gceAvd`	`GceAvdInfo`: Es el `GceAvdInfo` que describe el dispositivo.
`options`	`TestDeviceOptions`: Un `TestDeviceOptions` que describe las opciones de dispositivos que se usarán para el dispositivo de GCE.
`runUtil`	`IRunUtil`: Un `IRunUtil` para ejecutar comandos.

Muestra
`File`	Es un archivo que apunta al informe de errores ZIP o nulo si se produjo un problema.

logNestedRemoteFile

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

Recupera un archivo remoto de una instancia anidada y haz un registro.

Parámetros
`logger`	`ITestLogger`: Es el `ITestLogger` en el que se debe registrar el archivo.
`gceAvd`	`GceAvdInfo`: Es el `GceAvdInfo` que describe el dispositivo.
`options`	`TestDeviceOptions`: Un `TestDeviceOptions` que describe las opciones de dispositivos que se usarán para el dispositivo de GCE.
`runUtil`	`IRunUtil`: Un `IRunUtil` para ejecutar comandos.
`remoteFilePath`	`String`: Es la ruta de acceso remota en la que se encuentra el archivo.
`type`	`LogDataType`: Es el `LogDataType` del archivo registrado.

logNestedRemoteFile

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

Recupera un archivo remoto de una instancia anidada y haz un registro.

Parámetros
`logger`	`ITestLogger`: Es el `ITestLogger` en el que se debe registrar el archivo.
`gceAvd`	`GceAvdInfo`: Es el `GceAvdInfo` que describe el dispositivo.
`options`	`TestDeviceOptions`: Un `TestDeviceOptions` que describe las opciones de dispositivos que se usarán para el dispositivo de GCE.
`runUtil`	`IRunUtil`: Un `IRunUtil` para ejecutar comandos.
`remoteFilePath`	`String`: Es la ruta de acceso remota en la que se encuentra el archivo.
`type`	`LogDataType`: Es el `LogDataType` del archivo registrado.
`baseName`	`String`: Es el nombre base que se usará para registrar el archivo. Si es nulo, se usará el nombre de archivo real.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Registra la salida en serie de un dispositivo descrito por GceAvdInfo.

Parámetros
`infos`	`GceAvdInfo`: Es el `GceAvdInfo` que describe la instancia.
`logger`	`ITestLogger`: Es el `ITestLogger` en el que se registra el registro de serie.

remoteSshCommandExecution

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

Ejecuta el comando remoto a través de ssh en una instancia.

Parámetros
`gceAvd`	`GceAvdInfo`: Es el `GceAvdInfo` que describe el dispositivo.
`options`	`TestDeviceOptions`: Un `TestDeviceOptions` que describe las opciones de dispositivos que se usarán para el dispositivo de GCE.
`runUtil`	`IRunUtil`: Un `IRunUtil` para ejecutar comandos.
`timeoutMs`	`long`: Es el tiempo de espera en milisegundos del comando. 0 significa que no hay tiempo de espera.
`command`	`String`: Es el comando remoto que se ejecutará.

Muestra
`CommandResult`	`CommandResult` que contiene el resultado de la ejecución.

shutdownGce

public boolean shutdownGce ()

Apaga la instancia de GCE asociada con el startGce().

Muestra
`boolean`	Muestra verdadero si se solicitó el cierre de GCE como no bloqueador.

startGce

public GceAvdInfo startGce ()

Muestra
`GceAvdInfo`

Arroja
`TargetSetupError`

startGce

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

Intenta iniciar una instancia de GCE

Parámetros
`ipDevice`	`String`: La IP inicial de la instancia de GCE en la que se ejecutará el AVD, `null` si no corresponde
`attributes`	`MultiMap`: Son atributos asociados con la invocación actual que se usan para pasar la información aplicable a la instancia de GCE para que se agregue como metadatos de VM.

Muestra
`GceAvdInfo`	Un `GceAvdInfo` que describe la instancia de GCE Podría ser una instancia de BOOT_FAIL.

Arroja
`TargetSetupError`

Métodos protegidos

buildGceCmd

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                MultiMap<String, String> attributes)

Compila y muestra el comando para iniciar GCE. Se expone para pruebas.

Parámetros
`reportFile`	`File`
`b`	`IBuildInfo`
`ipDevice`	`String`
`attributes`	`MultiMap`

Muestra

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Recupera el nombre de la instancia de los registros de inicio de GCE. Busca el patrón "name": "gce-" para extraer el nombre. Extraemos de los registros en lugar del archivo de resultados porque, en caso de falla de inicio de GCE, el nombre de la instancia que se intentó no se mostrará en JSON.

Parámetros
`bootupLogs`	`String`

Devuelve
`String`