از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار trunk و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، توصیه می‌کنیم android-latest-release به جای aosp-main استفاده کنید. شاخه manifest در android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مدیر جی‌سی‌ای

public class GceManager
extends Object

شیء جاوا
↳	com.android.tradefed.device.cloud.GceManager

کمکی که فراخوانی‌های GCE برای شروع/توقف و جمع‌آوری لاگ‌ها از GCE را مدیریت می‌کند.

خلاصه

ثابت‌ها
`String`	`GCE_HOSTNAME_KEY`
`String`	`GCE_INSTANCE_CLEANED_KEY`
`String`	`GCE_INSTANCE_NAME_KEY`
`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)` برای جلوگیری از هرگونه مشکل احتمالی اتصال adb، با استفاده از ssh یک گزارش اشکال (bugreportz) از دستگاه دریافت کنید.
`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 یک گزارش اشکال (bugreport) دریافت کنید.
`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 چند دستگاهی با اکسیژن.

روش‌های محافظت‌شده
`static`	`buildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName (String bootupLogs)` نام نمونه را از لاگ‌های بوت gce بازیابی کنید.

ثابت‌ها

کلید نام میزبان GCE

public static final String GCE_HOSTNAME_KEY

مقدار ثابت: "gce-hostname"

کلید GCE_INSTANCE_CLEANED

public static final String GCE_INSTANCE_CLEANED_KEY

مقدار ثابت: "gce-instance-clean-called"

کلید نام نمونه GCE

public static final String GCE_INSTANCE_NAME_KEY

مقدار ثابت: "gce-instance-name"

کلید پیکربندی اولیه GCE_IP

public static final String GCE_IP_PRECONFIGURED_KEY

مقدار ثابت: "gce-ip-pre-configured"

سازندگان عمومی

مدیر جی‌سی‌ای

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

کِتور

پارامترها
`deviceDesc`	`DeviceDescriptor` : `DeviceDescriptor` که با دستگاه GCE مرتبط خواهد بود.
`deviceOptions`	`TestDeviceOptions` : یک `TestDeviceOptions` مرتبط با دستگاه.
`buildInfo`	`IBuildInfo` : یک `IBuildInfo` که ساخت gce را برای شروع توصیف می‌کند.

مدیر جی‌سی‌ای

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

این سازنده منسوخ شده است.
از سازنده‌های دیگر استفاده کنید، ما این را موقتاً برای سازگاری با نسخه‌های قبلی نگه می‌داریم.

پارامترها
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

مدیر جی‌سی‌ای

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` : نام میزبان یا آی‌پی نمونه‌ای که قرار است استفاده شود.

روش‌های عمومی

خاموش کردن Acloud

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

اجرای واقعی Acloud برای خاموش کردن دستگاه مجازی.

پارامترها
`options`	`TestDeviceOptions` : گزینه‌های `TestDeviceOptions` برای گزینه‌های Acloud
`runUtil`	`IRunUtil` : `IRunUtil` برای اجرای Acloud
`instanceName`	`String` : نمونه‌ای که باید خاموش شود.
`hostname`	`String` : نام میزبان نمونه، فقط برای ماهی مرکب اکسیژن استفاده می‌شود.
`isIpPreconfigured`	`boolean` : آیا AVD روی یک دستگاه از راه دور با IP از پیش تنظیم شده ایجاد شده است یا خیر

بازگشت‌ها
`boolean`	در صورت موفقیت، درست است

پاکسازی

public void cleanUp ()

دریافت گزارش خرابی با Ssh

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

برای جلوگیری از هرگونه مشکل احتمالی اتصال adb، با استفاده از ssh یک گزارش اشکال (bugreportz) از دستگاه دریافت کنید.

پارامترها
`gceAvd`	`GceAvdInfo` : اطلاعات `GceAvdInfo` که دستگاه را توصیف می‌کند.
`options`	`TestDeviceOptions` : یک `TestDeviceOptions` که گزینه‌های دستگاه مورد استفاده برای دستگاه GCE را توصیف می‌کند.
`runUtil`	`IRunUtil` : یک `IRunUtil` برای اجرای دستورات.

بازگشت‌ها
`File`	فایلی که به فایل زیپ bugreport اشاره می‌کند، یا در صورت بروز مشکل null.

پرتاب‌ها
	استثنای IO

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

نمونه‌ی HostOrchestratorUtil را برمی‌گرداند.

بازگشت‌ها
`HostOrchestratorUtil`

دریافت نمونه سریال لاگ

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`	خروجی گزارش سریال یا اگر مشکلی پیش بیاید، null.

دریافت دستگاه توکار (NestedDeviceSsh)

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

دریافت گزارش اشکال (bugreport) از طریق ssh برای یک نمونه تودرتو. این کار مستلزم درخواست adb در نمونه مجازی تودرتو است.

پارامترها
`gceAvd`	`GceAvdInfo` : اطلاعات `GceAvdInfo` که دستگاه را توصیف می‌کند.
`options`	`TestDeviceOptions` : یک `TestDeviceOptions` که گزینه‌های دستگاه مورد استفاده برای دستگاه GCE را توصیف می‌کند.
`runUtil`	`IRunUtil` : یک `IRunUtil` برای اجرای دستورات.

بازگشت‌ها
`File`	فایلی که به فایل زیپ bugreport اشاره می‌کند، یا در صورت بروز مشکل null.

پرتاب‌ها
	استثنای IO

logAndDeleteFile

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

پارامترها
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

دایرکتوری لاگ

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` : نام پایه‌ای که برای ثبت فایل استفاده می‌شود. اگر null باشد، نام واقعی فایل استفاده خواهد شد.

بازگشت‌ها
`boolean`	آیا فایل با موفقیت ثبت شده است یا خیر.

خروجی سریال logSerial

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

خروجی سریال دستگاهی را که توسط GceAvdInfo توصیف شده است، ثبت کنید.

پارامترها
`infos`	`GceAvdInfo` : `GceAvdInfo` که نمونه را توصیف می‌کند.
`logger`	`ITestLogger` : `ITestLogger` جایی است که گزارش سریال را ثبت می‌کند.

اجرای فرمان remoteSsh

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` : مدت زمان اجرای دستور بر حسب میلی‌ثانیه. عدد ۰ به معنی عدم وجود زمان است.
`command`	`String` : دستور از راه دور برای اجرا.

بازگشت‌ها
`CommandResult`	`CommandResult` حاوی نتیجه اجرا.

خاموش کردنGce

public boolean shutdownGce ()

نمونه‌ی Gce مرتبط با startGce() را خاموش می‌کند.

بازگشت‌ها
`boolean`	اگر درخواست خاموش کردن gce به عنوان غیر مسدودکننده باشد، مقدار true را برمی‌گرداند.

شروعGce

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`

شروعGce

public GceAvdInfo startGce ()

بازگشت‌ها
`GceAvdInfo`

پرتاب‌ها
`TargetSetupError`

شروعGce

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`

شروعGce

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 چند دستگاهی با اکسیژن.

پارامترها
`buildInfos`	: `ERROR(/List )`
`attributes`	`MultiMap` : ویژگی‌های مرتبط با فراخوانی فعلی

بازگشت‌ها
	یک `ERROR(/List )` که اطلاعات GCE Avd را توصیف می‌کند.

پرتاب‌ها
`TargetSetupError`

روش‌های محافظت‌شده

دستور buildShutdown

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

پارامترها
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

بازگشت‌ها

استخراج نام نمونه

protected String extractInstanceName (String bootupLogs)

نام نمونه را از لاگ‌های بوت gce بازیابی کنید. عبارت 'name' را جستجو کنید: 'gce-' ' الگو برای استخراج نام آن. ما به جای فایل نتیجه، از گزارش‌ها استخراج می‌کنیم زیرا در صورت خرابی بوت gce، نام نمونه‌ی تلاش شده در json نشان داده نمی‌شود.

پارامترها
`bootupLogs`	`String`

بازگشت‌ها
`String`