اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

GceManager

public class GceManager
extends Object

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

مساعد يدير طلبات GCE لبدء/إيقاف جمع السجلات من GCE

ملخّص

الحقول
`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`

وظائف الإنشاء العامة
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`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)` يمكنك الحصول على تقرير أخطاء من الجهاز باستخدام ssh لتجنُّب أي مشكلة محتملة في الاتصال عبر adb.
`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 لمثيل متداخل
`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 على أجهزة متعددة باستخدام Oxygen

الطرق المحمية
`static`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` استرداد اسم المثيل من سجلات تشغيل gce

الحقول

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

وظائف الإنشاء العامة

GceManager

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

Ctor

المعلمات
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` الذي سيتم ربطه بجهاز GCE
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` مرتبط بالجهاز
`buildInfo`	`IBuildInfo`: `IBuildInfo` يصف عملية إنشاء gce للبدء.

GceManager

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

تم إيقاف هذا المُنشئ نهائيًا.
استخدِم أدوات الإنشاء الأخرى، وسنحتفظ بهذه الأدوات مؤقتًا للتوافق مع الإصدارات القديمة.

المعلمات
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

GceManager

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`: اسم المضيف أو عنوان IP للمثيل المطلوب استخدامه.

الطرق العامة

AcloudShutdown

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`: اسم مضيف النسخة، لا يُستخدَم إلا مع حبار Oxygen
`isIpPreconfigured`	`boolean`: ما إذا تم إنشاء جهاز افتراضي Android على جهاز بعيد باستخدام عنوان IP تم ضبطه مسبقًا

المرتجعات
`boolean`	صحيح إذا كان الإجراء ناجحًا

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

يمكنك الحصول على تقرير أخطاء من الجهاز باستخدام ssh لتجنُّب أي مشكلة محتملة في الاتصال عبر adb.

المعلمات
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` التي تصف الجهاز
`options`	`TestDeviceOptions`: `TestDeviceOptions` يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر

المرتجعات
`File`	ملف يشير إلى تقرير الخطأ بتنسيق zip، أو ملف فارغ في حال حدوث مشكلة

عمليات الرمي
	IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

تعرِض مثيل HostOrchestratorUtil.

المرتجعات
`HostOrchestratorUtil`

getInstanceSerialLog

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

لقراءة المحتوى الحالي لسجلّ تسلسلي لوحدة Gce Avd

المعلمات
`infos`	`GceAvdInfo`: `GceAvdInfo` الذي يصف المثيل
`avdConfigFile`	`File`: ملف إعدادات جهاز افتراضي
`jsonKeyFile`	`File`: ملف مفتاح json لحساب الخدمة.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر

المرتجعات
`String`	إخراج السجلّ التسلسلي أو القيمة الخالية إذا حدث خطأ

getNestedDeviceSshBugreportz

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

الحصول على تقرير أخطاء عبر ssh لمثيل متداخل يتطلب ذلك طلب adb في المثيل الافتراضي المُدمَج.

المعلمات
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` التي تصف الجهاز
`options`	`TestDeviceOptions`: `TestDeviceOptions` يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر

المرتجعات
`File`	ملف يشير إلى تقرير الخطأ بتنسيق zip، أو ملف فارغ في حال حدوث مشكلة

عمليات الرمي
	IOException

logAndDeleteFile

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

المعلمات
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

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`: الاسم الأساسي الذي سيتم استخدامه لتسجيل الملف. إذا كان القيمة فارغة، سيتم استخدام اسم الملف الفعلي.

المرتجعات
`boolean`	ما إذا تم تسجيل الملف بنجاح

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

سجِّل الإخراج التسلسلي لجهاز يصفه GceAvdInfo.

المعلمات
`infos`	`GceAvdInfo`: `GceAvdInfo` الذي يصف المثيل
`logger`	‫`ITestLogger`: `ITestLogger` حيث يتم تسجيل السجلّ التسلسلي

remoteSshCommandExecution

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`: وقت الاستراحة بالملي ثانية للطلب. تعني القيمة 0 عدم وجود مهلة.
`command`	`String`: الأمر عن بُعد المطلوب تنفيذه.

المرتجعات
`CommandResult`	`CommandResult` التي تحتوي على نتيجة التنفيذ

shutdownGce

public boolean shutdownGce ()

أوقِف نسخة Gce الافتراضية المرتبطة بـ startGce().

المرتجعات
`boolean`	تعرِض القيمة "صحيح" إذا تم طلب إيقاف gce كإجراء غير حظر.

startGce

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`

startGce

public GceAvdInfo startGce ()

المرتجعات
`GceAvdInfo`

عمليات الرمي
`TargetSetupError`

startGce

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`

startGce

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 على أجهزة متعددة باستخدام Oxygen

المعلمات
`buildInfos`	: `ERROR(/List)`
`attributes`	`MultiMap`: السمات المرتبطة بالاستدعاء الحالي

المرتجعات
	`ERROR(/List)` يصف معلومات Avd في GCE

عمليات الرمي
`TargetSetupError`

الطرق المحمية

buildShutdownCommand

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

المعلمات
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

المرتجعات

extractInstanceName

protected String extractInstanceName (String bootupLogs)

استرداد اسم المثيل من سجلات تشغيل gce ابحث عن النمط ‎"name": "gce-" لاستخراج الاسم. نُستخرج البيانات من السجلات بدلاً من ملف النتائج لأنّه في حال تعطُّل عملية تشغيل gce، لن يظهر اسم المثيل الذي تمّت محاولة تشغيله في ملف json.

المعلمات
`bootupLogs`	`String`

المرتجعات
`String`