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`

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 to 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 użycia bezpośrednio.

Metody publiczne
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname)` 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.
`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 zagłębionej instancji.
`static void`	`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 void`	`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()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Próba uruchomienia instancji gce

Chronione metody
	`buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, MultiMap<String, String> attributes)` Utwórz i zwróć polecenie uruchamiania GCE.
`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

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 użycia bezpośrednio.

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 do użycia.
`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)

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.

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.

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.

logNestedRemoteFile

public static void 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.

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 z rejestrowanymi danymi.

logNestedRemoteFile

public static void 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.

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.

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 ()

Zwroty
`GceAvdInfo`

Rzuty
`TargetSetupError`

startGce

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

Próba uruchomienia instancji 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 w celu dodania ich jako metadanych maszyny wirtualnej.

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

Rzuty
`TargetSetupError`

Chronione metody

buildGceCmd

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

Utwórz i zwróć polecenie uruchamiania GCE. Wyeksponowane do testowania.

Parametry
`reportFile`	`File`
`b`	`IBuildInfo`
`ipDevice`	`String`
`attributes`	`MultiMap`

Zwroty

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Pobierz nazwę instancji z logów rozruchu gce. Wyszukaj wzór „name”: „gce-” w celu wyodrębnienia nazwy. Wyciągamy dane z dzienników zamiast z pliku z wynikami, ponieważ w przypadku błędu uruchamiania gce nazwa próbowanego wystąpienia nie będzie widoczna w pliku JSON.

Parametry
`bootupLogs`	`String`

Zwroty
`String`