اعتبارًا من 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`

وظائف الإنشاء العامة
`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)` يتم تشغيل Acloud الفعلي لإيقاف الجهاز الافتراضي.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` يمكنك الحصول على تقرير أخطاء من الجهاز باستخدام ssh لتجنُّب أي مشكلة محتملة في الاتصال عبر adb.
`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`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)` جلب ملف عن بُعد من مثيل مُدمَج وتسجيله
`static void`	`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()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` محاولة بدء مثيل gce

الطرق المحمية
	`buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, MultiMap<String, String> attributes)` أنشئ الأمر لبدء GCE وأعِد عرضه.
`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

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

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)

يتم تشغيل Acloud الفعلي لإيقاف الجهاز الافتراضي.

المعلمات
`options`	`TestDeviceOptions`: `TestDeviceOptions` لخيارات Acloud
`runUtil`	`IRunUtil`: `IRunUtil` لتشغيل Acloud
`instanceName`	`String`: النسخة التي سيتم إيقافها
`hostname`	‫`String`: اسم مضيف النسخة، لا يُستخدَم إلا مع حبار Oxygen

المرتجعات
`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، أو ملف فارغ في حال حدوث مشكلة

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، أو ملف فارغ في حال حدوث مشكلة

logNestedRemoteFile

public static void 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` للملف الذي تم تسجيله

logNestedRemoteFile

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

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

المرتجعات
`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.

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

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

buildGceCmd

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

أنشئ الأمر لبدء GCE وأعِد عرضه. تمّ عرضها للاختبار.

المعلمات
`reportFile`	`File`
`b`	`IBuildInfo`
`ipDevice`	`String`
`attributes`	`MultiMap`

المرتجعات

extractInstanceName

protected String extractInstanceName (String bootupLogs)

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

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

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