Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

GceManager

public class GceManager
extends Object

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

Pomocnik, który zarządza wywołaniami GCE do uruchamiania i zatrzymywania oraz zbiera logi z GCE.

Podsumowanie

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

Konstruktory publiczne
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Ten konstruktor został wycofany. Użyj innych konstruktorów, tymczasowo zachowujemy tę opcję ze względu na zgodność wsteczną.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Konstruktor, wariant, który może służyć do podawania nazwy instancji GCE do bezpośredniego użycia.

Metody publiczne
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` Rzeczywiste uruchomienie Acloud do wyłączenia urządzenia wirtualnego.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Aby uniknąć potencjalnych problemów z połączeniem ADB, pobierz raport o błędzie z urządzenia za pomocą ssh.
`HostOrchestratorUtil`	`getHostOrchestratorUtil()` Zwraca wystąpienie elementu `HostOrchestratorUtil`.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Odczytuje bieżącą zawartość logu seryjnego instancji Gce Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Pobieranie raportu o błędzie za pomocą ssh w przypadku instancji zagnieżdżonej.
`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)` Pobierz plik zdalny z zagłębionej instancji i zapisz go w dzienniku.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Pobierz plik zdalny z zagłębionej instancji i zapisz go w dzienniku.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` Zarejestruj wyjście szeregowe urządzenia opisanego przez `GceAvdInfo`.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Wykonaj polecenie zdalne za pomocą ssh na instancji.
`boolean`	`shutdownGce()` Zamknij instancję GCE powiązaną z `startGce()`.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)` Spróbuj uruchomić instancję gce za pomocą Acloud lub Oxygen.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Próbuje uruchomić instancję gce.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` Spróbuj uruchomić instancję gce za pomocą Acloud lub Oxygen.
	`startMultiDevicesGce( buildInfos)` Ta metoda została wycofana. Usuń to po zaktualizowaniu gałęzi głównej.
	`startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)` Próba uruchomienia instancji GCE na wielu urządzeniach za pomocą Oxygen.

Chronione metody
`static`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` Pobierz nazwę instancji z logów rozruchu gce.

Fieldsem

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

Konstruktory publiczne

GceManager

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

Ctor

Parametry
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor`, który zostanie powiązany z urządzeniem GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` powiązany z tym urządzeniem.
`buildInfo`	`IBuildInfo`: `IBuildInfo` opisujący wersję gce do uruchomienia.

GceManager

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

Ten konstruktor został wycofany.
Użyj innych konstruktorów. Zachowujemy to tymczasowo ze względu na zgodność wsteczną.

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

GceManager

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

Konstruktor, wariant, który może służyć do podawania nazwy instancji GCE do bezpośredniego użycia.

Parametry
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor`, który zostanie powiązany z urządzeniem GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` powiązany z tym urządzeniem
`buildInfo`	`IBuildInfo`: `IBuildInfo` opisujący wersję gce do uruchomienia.
`gceInstanceName`	`String`: nazwa instancji, której chcesz użyć.
`gceHost`	`String`: nazwa hosta lub adres IP instancji, której chcesz użyć.

Metody publiczne

AcloudShutdown

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

Rzeczywiste uruchomienie Acloud do wyłączenia urządzenia wirtualnego.

Parametry
`options`	`TestDeviceOptions`: `TestDeviceOptions` dla opcji Acloud
`runUtil`	`IRunUtil`: `IRunUtil` do uruchamiania Acloud
`instanceName`	`String`: instancja do wyłączenia.
`hostname`	`String`: nazwa hosta instancji, używana tylko w przypadku cuttlefisha Oxygen.
`isIpPreconfigured`	`boolean`: czy maszyna wirtualna została utworzona na urządzeniu zdalnym z wstępnie skonfigurowanym adresem IP

Zwroty
`boolean`	Wartość true, jeśli operacja zakończyła się powodzeniem

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Aby uniknąć potencjalnych problemów z połączeniem ADB, pobierz raport o błędzie z urządzenia za pomocą ssh.

Parametry
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` opisujące urządzenie.
`options`	`TestDeviceOptions`: `TestDeviceOptions` opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.
`runUtil`	`IRunUtil`: `IRunUtil` do wykonywania poleceń.

Zwroty
`File`	Plik wskazujący na plik ZIP z informacjami o błędzie lub null, jeśli wystąpił problem.

Rzuty
	IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Zwraca wystąpienie elementu HostOrchestratorUtil.

Zwroty
`HostOrchestratorUtil`

getInstanceSerialLog

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

Odczytuje bieżącą zawartość logu seryjnego instancji Gce Avd.

Parametry
`infos`	`GceAvdInfo`: `GceAvdInfo` opisujący instancję.
`avdConfigFile`	`File`: plik konfiguracji avd
`jsonKeyFile`	`File`: plik klucza JSON konta usługi.
`runUtil`	`IRunUtil`: `IRunUtil` do wykonywania poleceń.

Zwroty
`String`	Dane wyjściowe z dziennika szeregowego lub null, jeśli coś pójdzie nie tak.

getNestedDeviceSshBugreportz

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

Pobieranie raportu o błędzie za pomocą ssh w przypadku instancji zagnieżdżonej. Wymaga to wysłania żądania adb w ramach zagnieżdżonego wystąpienia wirtualnego.

Parametry
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` opisujące urządzenie.
`options`	`TestDeviceOptions`: `TestDeviceOptions` opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.
`runUtil`	`IRunUtil`: `IRunUtil` do wykonywania poleceń.

Zwroty
`File`	Plik wskazujący na plik ZIP z informacjami o błędzie lub null, jeśli wystąpił problem.

Rzuty
	IOException

logAndDeleteFile

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

Parametry
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

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

Parametry
`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)

Pobieranie zdalnego pliku z zagłębionej instancji i zapisywanie go w dzienniku.

Parametry
`logger`	`ITestLogger`: `ITestLogger`, w którym należy zapisać plik.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` opisujące urządzenie.
`options`	`TestDeviceOptions`: `TestDeviceOptions` opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.
`runUtil`	`IRunUtil`: `IRunUtil` do wykonywania poleceń.
`remoteFilePath`	`String`: ścieżka zdalna, pod którą znajduje się plik.
`type`	`LogDataType`: `LogDataType` pliku z rejestrowanymi danymi.

Zwroty
`boolean`	czy plik został zapisany.

logNestedRemoteFile

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

Pobieranie zdalnego pliku z zagłębionej instancji i zapisywanie go w dzienniku.

Parametry
`logger`	`ITestLogger`: `ITestLogger`, w którym należy zapisać plik.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` opisujące urządzenie.
`options`	`TestDeviceOptions`: `TestDeviceOptions` opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.
`runUtil`	`IRunUtil`: `IRunUtil` do wykonywania poleceń.
`remoteFilePath`	`String`: ścieżka zdalna, w której znajduje się plik.
`type`	`LogDataType`: `LogDataType` pliku zapisanego w dzienniku.
`baseName`	`String`: nazwa podstawowa do użycia w logu pliku. Jeśli to pole jest puste, zostanie użyta rzeczywista nazwa pliku.

Zwroty
`boolean`	czy plik został zapisany.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Zarejestruj wyjście szeregowe urządzenia opisanego przez GceAvdInfo.

Parametry
`infos`	`GceAvdInfo`: `GceAvdInfo` opisujący instancję.
`logger`	`ITestLogger`: `ITestLogger`, w którym należy zapisać dziennik seryjny.

remoteSshCommandExecution

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

Wykonaj polecenie zdalne za pomocą ssh na instancji.

Parametry
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` opisujące urządzenie.
`options`	`TestDeviceOptions`: `TestDeviceOptions` opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.
`runUtil`	`IRunUtil`: `IRunUtil` do wykonywania poleceń.
`timeoutMs`	`long`: czas oczekiwania na wykonanie polecenia w milisekundach. Wartość 0 oznacza brak limitu czasu.
`command`	`String`: polecenie zdalne do wykonania.

Zwroty
`CommandResult`	`CommandResult` zawierający wynik wykonania.

shutdownGce

public boolean shutdownGce ()

Zamknij instancję GCE powiązaną z startGce().

Zwroty
`boolean`	zwraca wartość „prawda”, jeśli żądanie zamknięcia gce zostało zgłoszone jako nieblokujące.

startGce

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

Spróbuj uruchomić instancję gce za pomocą Acloud lub Oxygen.

Parametry
`ipDevice`	`String`: początkowy adres IP instancji GCE, w której ma być uruchamiana usługa AVD, `null` jeśli nie dotyczy.
`user`	`String`: użytkownik hosta AVD, `null`, jeśli nie dotyczy
`offset`	`Integer`: przesunięcie numeru urządzenia AVD na hoście, `null`, jeśli nie dotyczy
`attributes`	`MultiMap`: atrybuty powiązane z bieżącym wywołaniem, używane do przekazywania odpowiednich informacji do instancji GCE, aby dodać je jako metadane maszyny wirtualnej.
`logger`	`ITestLogger`: `ITestLogger`, gdzie należy zapisywać logi uruchamiania urządzenia.

Zwroty
`GceAvdInfo`	`GceAvdInfo` opisujący instancję GCE. Może to być instancja BOOT_FAIL.

Rzuty
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

Zwroty
`GceAvdInfo`

Rzuty
`TargetSetupError`

startGce

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

Próbuje uruchomić instancję gce.

Parametry
`ipDevice`	`String`: początkowy adres IP instancji GCE, w której ma być uruchomiony AVD, `null` jeśli nie dotyczy.
`attributes`	`MultiMap`: atrybuty powiązane z bieżącym wywołaniem, używane do przekazywania odpowiednich informacji do instancji GCE, aby dodać je jako metadane maszyny wirtualnej.

Zwroty
`GceAvdInfo`	`GceAvdInfo` opisujący instancję GCE. Może to być instancja BOOT_FAIL.

Rzuty
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

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

Spróbuj uruchomić instancję gce za pomocą Acloud lub Oxygen.

Parametry
`ipDevice`	`String`: początkowy adres IP instancji GCE, w której ma być uruchamiana usługa AVD, `null` jeśli nie dotyczy.
`user`	`String`: użytkownik hosta AVD, `null`, jeśli nie dotyczy
`offset`	`Integer`: przesunięcie numeru urządzenia AVD na hoście, `null`, jeśli nie dotyczy
`attributes`	`MultiMap`: atrybuty powiązane z bieżącym wywołaniem, używane do przekazywania odpowiednich informacji do instancji GCE, aby dodać je jako metadane maszyny wirtualnej.

Zwroty
`GceAvdInfo`	`GceAvdInfo` opisujący instancję GCE. Może to być instancja BOOT_FAIL.

Rzuty
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Ta metoda została wycofana.
Usuń to po zaktualizowaniu gałęzi głównej.

Parametry
`buildInfos`

Zwroty

Rzuty
`TargetSetupError`

startMultiDevicesGce

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

Próba uruchomienia instancji GCE na wielu urządzeniach za pomocą Oxygen.

Parametry
`buildInfos`	: `ERROR(/List)`
`attributes`	`MultiMap`: atrybuty powiązane z bieżącym wywołaniem

Zwroty
	`ERROR(/List)` opisujący informacje o AVd w GCE.

Rzuty
`TargetSetupError`

Chronione metody

buildShutdownCommand

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

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

Zwroty

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Pobierz nazwę instancji z logów rozruchu gce. Wyszukaj wzór „name”: „gce-” , aby wyodrębnić nazwę. Wyodrębniamy dane z dzienników zamiast z pliku wyników, ponieważ w przypadku błędu uruchamiania gce nazwa próbowanego wystąpienia nie będzie widoczna w pliku JSON.

Parametry
`bootupLogs`	`String`

Zwroty
`String`