2026'dan itibaren, ana kararlı geliştirme modelimizle uyumlu olmak ve ekosistem için platform kararlılığını sağlamak amacıyla kaynak kodunu 2. ve 4. çeyreklerde AOSP'de yayınlayacağız. AOSP'yi oluşturmak ve AOSP'ye katkıda bulunmak için android-latest-release kullanın. android-latest-release manifest dalı her zaman AOSP'ye gönderilen en son sürümü referans alır. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

GceManager

public class GceManager
extends Object

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

GCE'den günlükleri başlatmak/durdurmak ve toplamak için GCE çağrılarını yöneten yardımcı.

Özet

Sabitler
`String`	`GCE_HOSTNAME_KEY`
`String`	`GCE_INSTANCE_CLEANED_KEY`
`String`	`GCE_INSTANCE_NAME_KEY`
`String`	`GCE_IP_PRECONFIGURED_KEY`

Herkese açık oluşturucular
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Doğrudan kullanılacak GCE örneği adını sağlamak için kullanılabilecek varyasyon olan Ctor.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, List<IBuildInfo> testResourceBuildInfos)` Bu oluşturucunun desteği sonlandırılmıştır. Diğer oluşturucuları kullanın. Bu işlev, geriye dönük uyumluluk için geçici olarak tutulur.

Herkese açık yöntemler
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` Sanal cihazı kapatmak için gerçek Acloud çalıştırması.
`void`	`cleanUp()`
`static void`	`collectErrorSignatures(File remoteFile)`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Olası bir adb bağlantı sorununu önlemek için ssh kullanarak cihazdan bir bugreportz alın.
`HostOrchestratorUtil`	`getHostOrchestratorUtil()` `HostOrchestratorUtil` örneğini döndürür.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Gce Avd örneği seri günlüğünün mevcut içeriğini okur.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` İç içe yerleştirilmiş bir örnek için SSH üzerinden hata raporu alma.
`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, String baseName, List<String> scpArgs)` İç içe yerleştirilmiş bir örnekten uzak bir dosyayı getirin ve günlüğe kaydedin.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)` İç içe yerleştirilmiş bir örnekten uzak bir dosyayı getirin ve günlüğe kaydedin.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` İç içe yerleştirilmiş bir örnekten uzak bir dosyayı getirin ve günlüğe kaydedin.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` `GceAvdInfo` ile açıklanan bir cihazın seri çıkışını kaydedin.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Bir örnekte ssh üzerinden uzak komutu yürütün.
`boolean`	`shutdownGce()` `startGce()` ile ilişkili GCE örneğini kapatın.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)` Acloud veya Oxygen ile bir GCE örneğini başlatmaya çalışın.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Bir GCE örneğini başlatmayı deneyin.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` Acloud veya Oxygen ile bir GCE örneğini başlatmaya çalışın.
`List<GceAvdInfo>`	`startMultiDevicesGce(List<IBuildInfo> buildInfos, MultiMap<String, String> attributes)` Oxygen ile birden fazla cihazda GCE örneğini başlatmaya çalışın.
`List<GceAvdInfo>`	`startMultiDevicesGce(List<IBuildInfo> buildInfos)` Bu yöntem kullanımdan kaldırılmıştır. Ana dal güncellendikten sonra bunu kaldırın.

Korunan yöntemler
`static List<String>`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` Örnek adını GCE başlatma günlüklerinden alın.

Sabitler

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Sabit Değer: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Sabit Değer: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Sabit Değer: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Sabit Değer: "gce-ip-pre-configured"

Herkese açık oluşturucular

GceManager

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

Ctor

Parametreler
`deviceDesc`	`DeviceDescriptor`: GCE cihazıyla ilişkilendirilecek `DeviceDescriptor`.
`deviceOptions`	`TestDeviceOptions`: Cihazla ilişkili bir `TestDeviceOptions`.
`buildInfo`	`IBuildInfo`: Başlatılacak GCE derlemesini açıklayan bir `IBuildInfo`.

GceManager

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

Doğrudan kullanılacak GCE örneği adını sağlamak için kullanılabilecek varyasyon olan Ctor.

Parametreler
`deviceDesc`	`DeviceDescriptor`: GCE cihazıyla ilişkilendirilecek `DeviceDescriptor`.
`deviceOptions`	`TestDeviceOptions`: Cihazla ilişkili bir `TestDeviceOptions`
`buildInfo`	`IBuildInfo`: Başlatılacak GCE derlemesini açıklayan bir `IBuildInfo`.
`gceInstanceName`	`String`: Kullanılacak örnek adı.
`gceHost`	`String`: Kullanılacak örneğin ana makine adı veya IP'si.

GceManager

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

Bu oluşturucunun desteği sonlandırılmıştır.
Diğer oluşturucuları kullanın. Geriye dönük uyumluluk için bu işlevi geçici olarak koruyoruz.

Parametreler
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`	`List`

Herkese açık yöntemler

AcloudShutdown

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

Sanal cihazı kapatmak için gerçek Acloud çalıştırması.

Parametreler
`options`	`TestDeviceOptions`: Acloud seçenekleri için `TestDeviceOptions`
`runUtil`	`IRunUtil`: Acloud'u çalıştırmak için `IRunUtil`
`instanceName`	`String`: Kapatılacak örnek.
`hostname`	`String`: Yalnızca Oxygen cuttlefish için kullanılan örneğin ana makine adı.
`isIpPreconfigured`	`boolean`: AVD'nin, önceden yapılandırılmış IP'ye sahip uzak bir cihazda oluşturulup oluşturulmadığı

İadeler
`boolean`	Başarılıysa doğru

cleanUp

public void cleanUp ()

collectErrorSignatures

public static void collectErrorSignatures (File remoteFile)

Parametreler
`remoteFile`	`File`

getBugreportzWithSsh

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

Olası bir adb bağlantı sorununu önlemek için ssh kullanarak cihazdan bir bugreportz alın.

Parametreler
`gceAvd`	`GceAvdInfo`: Cihazı tanımlayan `GceAvdInfo`.
`options`	`TestDeviceOptions`: GCE cihazı için kullanılacak cihaz seçeneklerini açıklayan bir `TestDeviceOptions`.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.

İadeler
`File`	ZIP hata raporunu gösteren bir dosya veya sorun oluştuysa boş (null).

Verdiği hatalar
	java.io.IOException
`IOException`

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

HostOrchestratorUtil örneğini döndürür.

İadeler
`HostOrchestratorUtil`

getInstanceSerialLog

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

Gce Avd örneği seri günlüğünün mevcut içeriğini okur.

Parametreler
`infos`	`GceAvdInfo`: Örneği açıklayan `GceAvdInfo`.
`avdConfigFile`	`File`: AVD yapılandırma dosyası
`jsonKeyFile`	`File`: Hizmet hesabı JSON anahtar dosyası.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.

İadeler
`String`	Bir sorun oluşursa seri günlük çıkışı veya boş (null) değer.

getNestedDeviceSshBugreportz

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

İç içe yerleştirilmiş bir örnek için SSH üzerinden hata raporu alma. Bunun için iç içe yerleştirilmiş sanal örnekte adb'nin istenmesi gerekir.

Parametreler
`gceAvd`	`GceAvdInfo`: Cihazı tanımlayan `GceAvdInfo`.
`options`	`TestDeviceOptions`: GCE cihazı için kullanılacak cihaz seçeneklerini açıklayan bir `TestDeviceOptions`.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.

İadeler
`File`	ZIP hata raporunu gösteren bir dosya veya sorun oluştuysa boş (null).

Verdiği hatalar
	java.io.IOException
`IOException`

logAndDeleteFile

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

Parametreler
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

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

Parametreler
`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, 
                String baseName, 
                List<String> scpArgs)

İç içe yerleştirilmiş bir örnekten uzak bir dosyayı getirin ve günlüğe kaydedin.

Parametreler
`logger`	`ITestLogger`: Dosyanın kaydedileceği `ITestLogger`.
`gceAvd`	`GceAvdInfo`: Cihazı tanımlayan `GceAvdInfo`.
`options`	`TestDeviceOptions`: GCE cihazı için kullanılacak cihaz seçeneklerini açıklayan bir `TestDeviceOptions`.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.
`remoteFilePath`	`String`: Dosyanın bulunduğu uzak yol.
`type`	`LogDataType`: kaydedilen dosyanın `LogDataType`.
`baseName`	`String`: Dosyayı kaydetmek için kullanılacak temel ad. Boşsa gerçek dosya adı kullanılır.
`scpArgs`	`List`: scp komutuna iletilecek ek bağımsız değişkenler

İadeler
`boolean`	Dosyanın başarıyla kaydedilip kaydedilmediği

logNestedRemoteFile

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

İç içe yerleştirilmiş bir örnekten uzak bir dosyayı getirin ve günlüğe kaydedin.

Parametreler
`logger`	`ITestLogger`: Dosyanın kaydedileceği `ITestLogger`.
`gceAvd`	`GceAvdInfo`: Cihazı tanımlayan `GceAvdInfo`.
`options`	`TestDeviceOptions`: GCE cihazı için kullanılacak cihaz seçeneklerini açıklayan bir `TestDeviceOptions`.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.
`remoteFilePath`	`String`: Dosyanın bulunduğu uzak yol.
`type`	`LogDataType`: kaydedilen dosyanın `LogDataType`.

İadeler
`boolean`	Dosyanın başarıyla kaydedilip kaydedilmediği

logNestedRemoteFile

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

İç içe yerleştirilmiş bir örnekten uzak bir dosyayı getirin ve günlüğe kaydedin.

Parametreler
`logger`	`ITestLogger`: Dosyanın kaydedileceği `ITestLogger`.
`gceAvd`	`GceAvdInfo`: Cihazı tanımlayan `GceAvdInfo`.
`options`	`TestDeviceOptions`: GCE cihazı için kullanılacak cihaz seçeneklerini açıklayan bir `TestDeviceOptions`.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.
`remoteFilePath`	`String`: Dosyanın bulunduğu uzak yol.
`type`	`LogDataType`: kaydedilen dosyanın `LogDataType`.
`baseName`	`String`: Dosyayı kaydetmek için kullanılacak temel ad. Boşsa gerçek dosya adı kullanılır.

İadeler
`boolean`	Dosyanın başarıyla kaydedilip kaydedilmediği

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

GceAvdInfo ile açıklanan bir cihazın seri çıkışını kaydedin.

Parametreler
`infos`	`GceAvdInfo`: Örneği açıklayan `GceAvdInfo`.
`logger`	`ITestLogger`: Seri günlüğün kaydedileceği `ITestLogger`.

remoteSshCommandExecution

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

Bir örnekte ssh üzerinden uzak komutu yürütün.

Parametreler
`gceAvd`	`GceAvdInfo`: Cihazı tanımlayan `GceAvdInfo`.
`options`	`TestDeviceOptions`: GCE cihazı için kullanılacak cihaz seçeneklerini açıklayan bir `TestDeviceOptions`.
`runUtil`	`IRunUtil`: komutları yürütmek için `IRunUtil`.
`timeoutMs`	`long`: Komut için milisaniye cinsinden zaman aşımı. 0, zaman aşımı olmadığı anlamına gelir.
`command`	`String`: Yürütülecek uzaktan komut.

İadeler
`CommandResult`	Yürütme sonucunu içeren `CommandResult`.

shutdownGce

public boolean shutdownGce ()

startGce() ile ilişkili GCE örneğini kapatın.

İadeler
`boolean`	GCE kapatma işlemi engellemeyen şekilde istenmişse true değerini döndürür.

startGce

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

Acloud veya Oxygen ile bir GCE örneğini başlatmaya çalışın.

Parametreler
`ipDevice`	`String`: AVD'nin çalıştırılacağı GCE örneğinin ilk IP'si, `null` geçerli değilse
`user`	`String`: AVD'yi çalıştıran ana makine kullanıcısı, `null` geçerli değilse
`offset`	`Integer`: Ana makinedeki AVD'nin cihaz numarası telafisi, geçerli değilse `null`
`attributes`	`MultiMap`: Geçerli çağırmayla ilişkili özellikler, geçerli bilgileri VM meta verileri olarak eklenecek GCE örneğine aktarmak için kullanılır.
`logger`	`ITestLogger`: Cihaz lansmanı günlüklerinin kaydedileceği `ITestLogger`.

İadeler
`GceAvdInfo`	GCE örneğini açıklayan bir `GceAvdInfo`. BOOT_FAIL örneği olabilir.

Verdiği hatalar
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

İadeler
`GceAvdInfo`

Verdiği hatalar
`TargetSetupError`

startGce

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

Bir GCE örneğini başlatmayı deneyin.

Parametreler
`ipDevice`	`String`: AVD'nin çalıştırılacağı GCE örneğinin ilk IP'si, `null` geçerli değilse
`attributes`	`MultiMap`: Geçerli çağırmayla ilişkili özellikler, geçerli bilgileri VM meta verileri olarak eklenecek GCE örneğine aktarmak için kullanılır.

İadeler
`GceAvdInfo`	GCE örneğini açıklayan bir `GceAvdInfo`. BOOT_FAIL örneği olabilir.

Verdiği hatalar
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

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

Acloud veya Oxygen ile bir GCE örneğini başlatmaya çalışın.

Parametreler
`ipDevice`	`String`: AVD'nin çalıştırılacağı GCE örneğinin ilk IP'si, `null` geçerli değilse
`user`	`String`: AVD'yi çalıştıran ana makine kullanıcısı, `null` geçerli değilse
`offset`	`Integer`: Ana makinedeki AVD'nin cihaz numarası telafisi, geçerli değilse `null`
`attributes`	`MultiMap`: Geçerli çağırmayla ilişkili özellikler, geçerli bilgileri VM meta verileri olarak eklenecek GCE örneğine aktarmak için kullanılır.

İadeler
`GceAvdInfo`	GCE örneğini açıklayan bir `GceAvdInfo`. BOOT_FAIL örneği olabilir.

Verdiği hatalar
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos, 
                MultiMap<String, String> attributes)

Oxygen ile birden fazla cihazda GCE örneğini başlatmaya çalışın.

Parametreler
`buildInfos`	`List`: `ERROR(/List)`
`attributes`	`MultiMap`: Geçerli çağırmayla ilişkili özellikler

İadeler
`List<GceAvdInfo>`	GCE Avd Bilgilerini açıklayan bir `ERROR(/List)`.

Verdiği hatalar
`TargetSetupError`

startMultiDevicesGce

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos)

Bu yöntem kullanımdan kaldırılmıştır.
Ana dal güncellendikten sonra bunu kaldırın.

Parametreler
`buildInfos`	`List`

Döndürülenler
`List<GceAvdInfo>`

Verdiği hatalar
`TargetSetupError`

Korunan yöntemler

buildShutdownCommand

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

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

İadeler
`List<String>`

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Örnek adını GCE başlatma günlüklerinden alın. "Ad"ı arayın: Adını çıkarmak için "gce-" kalıbı. GCE başlatma hatası durumunda, denenmiş örnek adı JSON'da gösterilmeyeceğinden sonuç dosyası yerine günlüklerden bilgi çıkarırız.

Parametreler
`bootupLogs`	`String`

Return'ler
`String`