Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

GceManager

public class GceManager
extends Object

java.lang.Объект
↳	com.android.tradefed.device.cloud.GceManager

Помощник, который управляет вызовами GCE для запуска/остановки и сбора журналов из GCE.

Краткое содержание

Поля
`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`

Общественные конструкторы
`GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ктор
`GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Этот конструктор устарел. Используйте другие конструкторы, мы оставляем это временно для обратной совместимости.
`GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor — вариант, который можно использовать для предоставления имени экземпляра GCE для непосредственного использования.

Публичные методы
`static boolean`	`AcloudShutdown ( TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` Фактический запуск Acloud для выключения виртуального устройства.
`void`	`cleanUp ()`
`static File`	`getBugreportzWithSsh ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Получите отчет об ошибках с устройства с помощью ssh, чтобы избежать потенциальных проблем с подключением adb.
`HostOrchestratorUtil`	`getHostOrchestratorUtil ()` Возвращает экземпляр `HostOrchestratorUtil` .
`static String`	`getInstanceSerialLog ( GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Считывает текущее содержимое последовательного журнала экземпляра Gce Avd.
`static File`	`getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Получите отчет об ошибке через ssh для вложенного экземпляра.
`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)` Получите удаленный файл из вложенного экземпляра и запишите его.
`static boolean`	`logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Получите удаленный файл из вложенного экземпляра и запишите его.
`void`	`logSerialOutput ( GceAvdInfo infos, ITestLogger logger)` Зарегистрируйте последовательный вывод устройства, описанного `GceAvdInfo` .
`static CommandResult`	`remoteSshCommandExecution ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Выполните удаленную команду через ssh на экземпляре.
`boolean`	`shutdownGce ()` Завершите работу экземпляра Gce, связанного с `startGce()` .
`GceAvdInfo`	`startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes, ITestLogger logger)` Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.
`GceAvdInfo`	`startGce ()`
`GceAvdInfo`	`startGce (String ipDevice, MultiMap <String, String> attributes)` Попытайтесь запустить экземпляр gce.
`GceAvdInfo`	`startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes)` Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.
	`startMultiDevicesGce ( buildInfos)` Этот метод устарел. Удалите это после обновления основной ветки.
	`startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes)` Попытайтесь запустить экземпляр gce на нескольких устройствах с помощью Oxygen.

Защищенные методы
`static`	`buildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName (String bootupLogs)` Получите имя экземпляра из журналов загрузки gce.

Поля

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

Общественные конструкторы

GceManager

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

Ктор

Параметры
`deviceDesc`	`DeviceDescriptor` : `DeviceDescriptor` , который будет связан с устройством GCE.
`deviceOptions`	`TestDeviceOptions` : `TestDeviceOptions` связанный с устройством.
`buildInfo`	`IBuildInfo` : `IBuildInfo` описывающий запуск сборки gce.

GceManager

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

Этот конструктор устарел.
Используйте другие конструкторы, мы оставляем это временно для обратной совместимости.

Параметры
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

GceManager

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

Ctor — вариант, который можно использовать для предоставления имени экземпляра GCE для непосредственного использования.

Параметры
`deviceDesc`	`DeviceDescriptor` : `DeviceDescriptor` , который будет связан с устройством GCE.
`deviceOptions`	`TestDeviceOptions` : `TestDeviceOptions` связанный с устройством.
`buildInfo`	`IBuildInfo` : `IBuildInfo` описывающий запуск сборки gce.
`gceInstanceName`	`String` : имя экземпляра, который нужно использовать.
`gceHost`	`String` : имя хоста или IP-адрес используемого экземпляра.

Публичные методы

ОблакоВыключение

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

Фактический запуск Acloud для выключения виртуального устройства.

Параметры
`options`	`TestDeviceOptions` : `TestDeviceOptions` для параметров Cloud.
`runUtil`	`IRunUtil` : `IRunUtil` для запуска Acloud.
`instanceName`	`String` : экземпляр для завершения работы.
`hostname`	`String` : имя хоста экземпляра, используется только для каракатиц Oxygen.
`isIpPreconfigured`	`boolean` : был ли AVD создан на удаленном устройстве с предварительно настроенным IP-адресом.

Возврат
`boolean`	Правда в случае успеха

очистка

public void cleanUp ()

getBugreportzWithSsh

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

Получите отчет об ошибках с устройства с помощью ssh, чтобы избежать потенциальных проблем с подключением adb.

Параметры
`gceAvd`	`GceAvdInfo` : `GceAvdInfo` , описывающий устройство.
`options`	`TestDeviceOptions` : `TestDeviceOptions` описывающий параметры устройства, которые будут использоваться для устройства GCE.
`runUtil`	`IRunUtil` : `IRunUtil` для выполнения команд.

Возврат
`File`	Файл, указывающий на отчет об ошибке в формате zip, или значение NULL, если возникла проблема.

Броски
	Исключение IO

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Возвращает экземпляр HostOrchestratorUtil .

Возврат
`HostOrchestratorUtil`

getInstanceSerialLog

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

Считывает текущее содержимое последовательного журнала экземпляра Gce Avd.

Параметры
`infos`	`GceAvdInfo` : `GceAvdInfo` описывающий экземпляр.
`avdConfigFile`	`File` : файл конфигурации avd.
`jsonKeyFile`	`File` : JSON-файл ключей сервисной учетной записи.
`runUtil`	`IRunUtil` : `IRunUtil` для выполнения команд.

Возврат
`String`	Последовательный вывод журнала или ноль, если что-то пойдет не так.

getNestedDeviceSshBugreportz

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

Получите отчет об ошибке через ssh для вложенного экземпляра. Для этого требуется запросить adb во вложенном виртуальном экземпляре.

Параметры
`gceAvd`	`GceAvdInfo` : `GceAvdInfo` , описывающий устройство.
`options`	`TestDeviceOptions` : `TestDeviceOptions` описывающий параметры устройства, которые будут использоваться для устройства GCE.
`runUtil`	`IRunUtil` : `IRunUtil` для выполнения команд.

Возврат
`File`	Файл, указывающий на отчет об ошибке в формате zip, или значение NULL, если возникла проблема.

Броски
	Исключение IO

logAndDeleteFile

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

Параметры
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

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

Параметры
`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)

Получите удаленный файл из вложенного экземпляра и запишите его.

Параметры
`logger`	`ITestLogger` : `ITestLogger` где регистрируется файл.
`gceAvd`	`GceAvdInfo` : `GceAvdInfo` , описывающий устройство.
`options`	`TestDeviceOptions` : `TestDeviceOptions` описывающий параметры устройства, которые будут использоваться для устройства GCE.
`runUtil`	`IRunUtil` : `IRunUtil` для выполнения команд.
`remoteFilePath`	`String` : удаленный путь, по которому можно найти файл.
`type`	`LogDataType` : `LogDataType` зарегистрированного файла.

Возврат
`boolean`	успешно ли зарегистрирован файл.

logNestedRemoteFile

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

Получите удаленный файл из вложенного экземпляра и запишите его.

Параметры
`logger`	`ITestLogger` : `ITestLogger` где регистрируется файл.
`gceAvd`	`GceAvdInfo` : `GceAvdInfo` , описывающий устройство.
`options`	`TestDeviceOptions` : `TestDeviceOptions` описывающий параметры устройства, которые будут использоваться для устройства GCE.
`runUtil`	`IRunUtil` : `IRunUtil` для выполнения команд.
`remoteFilePath`	`String` : удаленный путь, по которому можно найти файл.
`type`	`LogDataType` : `LogDataType` зарегистрированного файла.
`baseName`	`String` : базовое имя, которое будет использоваться для регистрации файла. Если значение равно нулю, будет использоваться фактическое имя файла.

Возврат
`boolean`	успешно ли зарегистрирован файл.

журналSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Зарегистрируйте последовательный вывод устройства, описанного GceAvdInfo .

Параметры
`infos`	`GceAvdInfo` : `GceAvdInfo` описывающий экземпляр.
`logger`	`ITestLogger` : `ITestLogger` где регистрируется последовательный журнал.

удаленноеSshCommandExecution

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

Выполните удаленную команду через ssh на экземпляре.

Параметры
`gceAvd`	`GceAvdInfo` : `GceAvdInfo` , описывающий устройство.
`options`	`TestDeviceOptions` : `TestDeviceOptions` описывающий параметры устройства, которые будут использоваться для устройства GCE.
`runUtil`	`IRunUtil` : `IRunUtil` для выполнения команд.
`timeoutMs`	`long` : тайм-аут команды в миллисекундах. 0 означает отсутствие тайм-аута.
`command`	`String` : удаленная команда для выполнения.

Возврат
`CommandResult`	`CommandResult` содержащий результат выполнения.

выключениеGce

public boolean shutdownGce ()

Завершите работу экземпляра Gce, связанного с startGce() .

Возврат
`boolean`	возвращает true, если отключение gce было запрошено как неблокирующее.

startGce

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

Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.

Параметры
`ipDevice`	`String` : начальный IP-адрес экземпляра GCE для запуска AVD, `null` , если неприменимо.
`user`	`String` : хост, на котором работает пользователь AVD, `null` , если неприменимо.
`offset`	`Integer` : смещение номера устройства AVD на хосте, `null` , если оно неприменимо.
`attributes`	`MultiMap` : атрибуты, связанные с текущим вызовом, используемые для передачи применимой информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины.
`logger`	`ITestLogger` : `ITestLogger` где сохраняются журналы запуска устройства.

Возврат
`GceAvdInfo`	`GceAvdInfo` описывающий экземпляр GCE. Это может быть экземпляр BOOT_FAIL.

Броски
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

Возврат
`GceAvdInfo`

Броски
`TargetSetupError`

startGce

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

Попытайтесь запустить экземпляр gce.

Параметры
`ipDevice`	`String` : начальный IP-адрес экземпляра GCE для запуска AVD, `null` , если неприменимо.
`attributes`	`MultiMap` : атрибуты, связанные с текущим вызовом, используемые для передачи применимой информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины.

Возврат
`GceAvdInfo`	`GceAvdInfo` описывающий экземпляр GCE. Это может быть экземпляр BOOT_FAIL.

Броски
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

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

Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.

Параметры
`ipDevice`	`String` : начальный IP-адрес экземпляра GCE для запуска AVD, `null` , если неприменимо.
`user`	`String` : хост, на котором работает пользователь AVD, `null` , если неприменимо.
`offset`	`Integer` : смещение номера устройства AVD на хосте, `null` , если оно неприменимо.
`attributes`	`MultiMap` : атрибуты, связанные с текущим вызовом, используемые для передачи применимой информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины.

Возврат
`GceAvdInfo`	`GceAvdInfo` описывающий экземпляр GCE. Это может быть экземпляр BOOT_FAIL.

Броски
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Этот метод устарел.
Удалите это после обновления основной ветки.

Параметры
`buildInfos`

Возврат

Броски
`TargetSetupError`

startMultiDevicesGce

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

Попытайтесь запустить экземпляр gce на нескольких устройствах с помощью Oxygen.

Параметры
`buildInfos`	: `ERROR(/List )`
`attributes`	`MultiMap` : атрибуты, связанные с текущим вызовом.

Возврат
	`ERROR(/List )` описывающее информацию GCE Avd.

Броски
`TargetSetupError`

Защищенные методы

сборкаШутдаунКоманда

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

Параметры
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

Возврат

ExtractInstanceName

protected String extractInstanceName (String bootupLogs)

Получите имя экземпляра из журналов загрузки gce. Найдите «имя»: «gce- ' шаблон для извлечения его имени. Мы извлекаем данные из журналов, а не из файла результатов, поскольку в случае сбоя загрузки gce имя экземпляра попытки не отображается в формате JSON.

Параметры
`bootupLogs`	`String`

Возврат
`String`