اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

GceManager

public class GceManager
extends Object

java.lang.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)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor، وهو نوع من المتغيرات يمكن استخدامه لتوفير اسم مثيل GCE المطلوب استخدامه مباشرةً.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, List<IBuildInfo> testResourceBuildInfos)` تم إيقاف هذا الباني نهائيًا. استخدِم أدوات إنشاء أخرى، وسنحتفظ بهذه الأداة مؤقتًا لضمان التوافق مع الأنظمة القديمة.

الإجراءات العامة
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` تنفيذ Acloud الفعلي لإيقاف الجهاز الافتراضي
`void`	`cleanUp()`
`static void`	`collectErrorSignatures(File remoteFile)`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` احصل على bugreportz من الجهاز باستخدام 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, String baseName, List<String> scpArgs)` استرجاع ملف بعيد من مثيل متداخل وتسجيله
`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
`List<GceAvdInfo>`	`startMultiDevicesGce(List<IBuildInfo> buildInfos, MultiMap<String, String> attributes)` محاولة بدء مثيل GCE لأجهزة متعددة باستخدام Oxygen
`List<GceAvdInfo>`	`startMultiDevicesGce(List<IBuildInfo> buildInfos)` تم إيقاف هذه الطريقة نهائيًا. يجب إزالة هذا النص بعد تعديل الفرع الرئيسي.

طُرق محمية
`static List<String>`	`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-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

القيمة الثابتة: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Constant Value: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

القيمة الثابتة: "gce-ip-pre-configured"

طُرق وضع التصميم العامة

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, 
                String gceInstanceName, 
                String gceHost)

Ctor، وهو نوع من المتغيرات يمكن استخدامه لتوفير اسم مثيل GCE المطلوب استخدامه مباشرةً.

المعلَمات
`deviceDesc`	`DeviceDescriptor`: هو `DeviceDescriptor` الذي سيتم ربطه بجهاز GCE.
`deviceOptions`	‫`TestDeviceOptions`: `TestDeviceOptions` مرتبط بالجهاز
`buildInfo`	`IBuildInfo`: `IBuildInfo` يصف عملية إنشاء GCE التي سيتم البدء بها.
`gceInstanceName`	`String`: اسم المثيل الذي سيتم استخدامه.
`gceHost`	`String`: اسم المضيف أو عنوان IP للمثيل الذي سيتم استخدامه.

GceManager

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

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

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

الإجراءات العامة

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 cuttlefish.
`isIpPreconfigured`	‫`boolean`: ما إذا كان قد تم إنشاء المحاكي على جهاز بعيد باستخدام عنوان IP تم ضبطه مسبقًا

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

cleanUp

public void cleanUp ()

collectErrorSignatures

public static void collectErrorSignatures (File remoteFile)

المعلَمات
`remoteFile`	`File`

getBugreportzWithSsh

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

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

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

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

عمليات الطرح
	java.io.IOException
`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`: ملف إعداد الجهاز الافتراضي الذي يعمل بنظام التشغيل Android
`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`	ملف يشير إلى تقرير الخطأ المضغوط، أو قيمة فارغة في حال حدوث مشكلة

عمليات الطرح
	java.io.IOException
`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, 
                String baseName, 
                List<String> scpArgs)

استرجاع ملف بعيد من مثيل متداخل وتسجيله

المعلَمات
`logger`	`ITestLogger`: `ITestLogger` حيث يتم تسجيل الملف.
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` التي تصف الجهاز
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`remoteFilePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف
`type`	`LogDataType`: `LogDataType` الخاص بالملف الذي تم تسجيله
`baseName`	`String`: الاسم الأساسي الذي سيتم استخدامه لتسجيل الملف. إذا كانت القيمة فارغة، سيتم استخدام اسم الملف الفعلي.
`scpArgs`	‫`List`: وسيطات إضافية سيتم تمريرها إلى أمر scp

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

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 الذي سيتم تشغيل محاكي Android عليه، `null` إذا لم يكن ذلك منطبقًا
`user`	‫`String`: مضيف تشغيل مستخدم جهاز Android الظاهري، `null` إذا لم يكن ذلك منطبقًا
`offset`	‫`Integer`: إزاحة رقم الجهاز في المحاكي على المضيف، `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 الذي سيتم تشغيل محاكي Android عليه، `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 الذي سيتم تشغيل محاكي Android عليه، `null` إذا لم يكن ذلك منطبقًا
`user`	‫`String`: مضيف تشغيل مستخدم جهاز Android الظاهري، `null` إذا لم يكن ذلك منطبقًا
`offset`	‫`Integer`: إزاحة رقم الجهاز في المحاكي على المضيف، `null` إذا لم يكن ذلك منطبقًا
`attributes`	`MultiMap`: سمات مرتبطة بعملية الاستدعاء الحالية، تُستخدَم لتمرير المعلومات ذات الصلة إلى مثيل GCE ليتم إضافتها كبيانات وصفية للآلة الافتراضية

المرتجعات
`GceAvdInfo`	`GceAvdInfo` يصف مثيل GCE يمكن أن يكون مثيلاً لـ BOOT_FAIL.

عمليات الطرح
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

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

محاولة بدء مثيل GCE لأجهزة متعددة باستخدام Oxygen

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

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

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

startMultiDevicesGce

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

تم إيقاف هذا الإجراء نهائيًا.
Remove this after master branch is updated.

المعلَمات
`buildInfos`	`List`

القيم المُعادة
`List<GceAvdInfo>`

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

طُرق محمية

buildShutdownCommand

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

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

المرتجعات
`List<String>`

extractInstanceName

protected String extractInstanceName (String bootupLogs)

استرداد اسم الجهاز الظاهري من سجلّات بدء التشغيل في GCE ابحث عن "الاسم": النمط "gce-" لاستخراج اسمه. نستخرج البيانات من السجلات بدلاً من ملف النتائج لأنّه في حال تعذّر بدء تشغيل الجهاز الظاهري على Google Compute Engine، لن يظهر اسم الجهاز الظاهري الذي تمت محاولة تشغيله في ملف JSON.

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

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