Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

GceManager

public class GceManager
extends Object

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

Helper yang mengelola panggilan GCE untuk memulai/menghentikan dan mengumpulkan log dari GCE.

Ringkasan

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

Konstruktor publik
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Konstruktor ini tidak digunakan lagi. Gunakan konstruktor lain, kami mempertahankannya untuk sementara untuk kompatibilitas mundur.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor, variasi yang dapat digunakan untuk memberikan nama instance GCE yang akan digunakan secara langsung.

Metode publik
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname)` Acloud yang sebenarnya berjalan untuk mematikan perangkat virtual.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Dapatkan bugreportz dari perangkat menggunakan ssh untuk menghindari potensi masalah koneksi adb.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Membaca konten saat ini dari log serial instance Gce Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Mendapatkan bugreport melalui ssh untuk instance bertingkat.
`static void`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)` Mengambil file jarak jauh dari instance bertingkat dan mencatatnya ke dalam log.
`static void`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Mengambil file jarak jauh dari instance bertingkat dan mencatatnya ke dalam log.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` Mencatat output serial perangkat yang dijelaskan oleh `GceAvdInfo` ke dalam log.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Jalankan perintah jarak jauh melalui ssh pada instance.
`boolean`	`shutdownGce()` Matikan instance GCE yang terkait dengan `startGce()`.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Mencoba memulai instance gce

Metode yang dilindungi
	`buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, MultiMap<String, String> attributes)` Buat dan tampilkan perintah untuk meluncurkan GCE.
`String`	`extractInstanceName(String bootupLogs)` Ambil nama instance dari log booting gce.

Kolom

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

Konstruktor publik

GceManager

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

Ctor

Parameter
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` yang akan dikaitkan dengan perangkat GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` yang terkait dengan perangkat.
`buildInfo`	`IBuildInfo`: `IBuildInfo` yang menjelaskan build gce yang akan dimulai.

GceManager

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

Konstruktor ini tidak digunakan lagi.
Gunakan konstruktor lain, kami mempertahankannya untuk sementara waktu untuk kompatibilitas mundur.

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

GceManager

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

Ctor, variasi yang dapat digunakan untuk memberikan nama instance GCE yang akan digunakan secara langsung.

Parameter
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` yang akan dikaitkan dengan perangkat GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` yang terkait dengan perangkat
`buildInfo`	`IBuildInfo`: `IBuildInfo` yang menjelaskan build gce yang akan dimulai.
`gceInstanceName`	`String`: Nama instance yang akan digunakan.
`gceHost`	`String`: Nama host atau IP instance yang akan digunakan.

Metode publik

AcloudShutdown

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

Acloud yang sebenarnya berjalan untuk mematikan perangkat virtual.

Parameter
`options`	`TestDeviceOptions`: `TestDeviceOptions` untuk opsi Acloud
`runUtil`	`IRunUtil`: `IRunUtil` untuk menjalankan Acloud
`instanceName`	`String`: Instance yang akan dimatikan.
`hostname`	`String`: nama host instance, hanya digunakan untuk cuttlefish Oksigen.

Hasil
`boolean`	Benar jika berhasil

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Dapatkan bugreportz dari perangkat menggunakan ssh untuk menghindari potensi masalah koneksi adb.

Parameter
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` yang mendeskripsikan perangkat.
`options`	`TestDeviceOptions`: `TestDeviceOptions` yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
`runUtil`	`IRunUtil`: `IRunUtil` untuk mengeksekusi perintah.

Hasil
`File`	File yang mengarah ke bugreport zip, atau null jika terjadi masalah.

getInstanceSerialLog

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

Membaca konten saat ini dari log serial instance Gce Avd.

Parameter
`infos`	`GceAvdInfo`: `GceAvdInfo` yang menjelaskan instance.
`avdConfigFile`	`File`: file konfigurasi avd
`jsonKeyFile`	`File`: file kunci json akun layanan.
`runUtil`	`IRunUtil`: `IRunUtil` untuk mengeksekusi perintah.

Hasil
`String`	Output log serial atau null jika terjadi masalah.

getNestedDeviceSshBugreportz

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

Mendapatkan bugreport melalui ssh untuk instance bertingkat. Hal ini memerlukan permintaan adb dalam instance virtual bertingkat.

Parameter
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` yang mendeskripsikan perangkat.
`options`	`TestDeviceOptions`: `TestDeviceOptions` yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
`runUtil`	`IRunUtil`: `IRunUtil` untuk mengeksekusi perintah.

Hasil
`File`	File yang mengarah ke bugreport zip, atau null jika terjadi masalah.

logNestedRemoteFile

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

Mengambil file jarak jauh dari instance bertingkat dan mencatatnya ke dalam log.

Parameter
`logger`	`ITestLogger`: `ITestLogger` tempat file dicatat ke dalam log.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` yang mendeskripsikan perangkat.
`options`	`TestDeviceOptions`: `TestDeviceOptions` yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
`runUtil`	`IRunUtil`: `IRunUtil` untuk mengeksekusi perintah.
`remoteFilePath`	`String`: Jalur jarak jauh tempat file ditemukan.
`type`	`LogDataType`: `LogDataType` file yang dicatat ke dalam log.

logNestedRemoteFile

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

Mengambil file jarak jauh dari instance bertingkat dan mencatatnya ke dalam log.

Parameter
`logger`	`ITestLogger`: `ITestLogger` tempat file dicatat ke dalam log.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` yang mendeskripsikan perangkat.
`options`	`TestDeviceOptions`: `TestDeviceOptions` yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
`runUtil`	`IRunUtil`: `IRunUtil` untuk mengeksekusi perintah.
`remoteFilePath`	`String`: Jalur jarak jauh tempat file ditemukan.
`type`	`LogDataType`: `LogDataType` file yang dicatat ke dalam log.
`baseName`	`String`: Nama dasar yang akan digunakan untuk mencatat file ke dalam log. Jika null, nama file yang sebenarnya akan digunakan.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Mencatat output serial perangkat yang dijelaskan oleh GceAvdInfo ke dalam log.

Parameter
`infos`	`GceAvdInfo`: `GceAvdInfo` yang menjelaskan instance.
`logger`	`ITestLogger`: `ITestLogger` tempat mencatat log serial.

remoteSshCommandExecution

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

Jalankan perintah jarak jauh melalui ssh pada instance.

Parameter
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` yang mendeskripsikan perangkat.
`options`	`TestDeviceOptions`: `TestDeviceOptions` yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
`runUtil`	`IRunUtil`: `IRunUtil` untuk mengeksekusi perintah.
`timeoutMs`	`long`: Waktu tunggu dalam milidetik untuk perintah. 0 berarti tidak ada waktu tunggu.
`command`	`String`: Perintah jarak jauh yang akan dieksekusi.

Hasil
`CommandResult`	`CommandResult` yang berisi hasil eksekusi.

shutdownGce

public boolean shutdownGce ()

Matikan instance GCE yang terkait dengan startGce().

Hasil
`boolean`	menampilkan true jika penghentian gce diminta sebagai non-blocking.

startGce

public GceAvdInfo startGce ()

Hasil
`GceAvdInfo`

Menampilkan
`TargetSetupError`

startGce

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

Mencoba memulai instance gce

Parameter
`ipDevice`	`String`: IP awal instance GCE untuk menjalankan AVD, `null` jika tidak berlaku
`attributes`	`MultiMap`: atribut yang terkait dengan pemanggilan saat ini, digunakan untuk meneruskan informasi yang berlaku ke instance GCE yang akan ditambahkan sebagai metadata VM

Hasil
`GceAvdInfo`	`GceAvdInfo` yang mendeskripsikan instance GCE. Dapat berupa instance BOOT_FAIL.

Menampilkan
`TargetSetupError`

Metode yang dilindungi

buildGceCmd

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

Buat dan tampilkan perintah untuk meluncurkan GCE. Ditampilkan untuk pengujian.

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

Hasil

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Ambil nama instance dari log booting gce. Telusuri pola 'name': 'gce-' untuk mengekstrak namanya. Kami mengekstrak dari log, bukan file hasil karena saat kegagalan booting gce, nama instance yang dicoba tidak akan ditampilkan dalam json.

Parameter
`bootupLogs`	`String`

Hasil
`String`