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

مدير Google Workspace

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)` كتور
`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.
`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`	`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)` حاول تشغيل مثيل جهاز متعدد الأجهزة باستخدام الأكسجين.

الطرق المحمية
`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

شركة إنشاءات عامة

مدير Google Workspace

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

كتور

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

مدير Google Workspace

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

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

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

مدير Google Workspace

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 للمثيل المطلوب استخدامه.

الطرق العامة

إيقاف السحابة الإلكترونية

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

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

الرميات
	IOاستثناء

أمر getInstanceSerialLog

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`	ناتج السجل التسلسلي أو فارغ إذا حدث خطأ ما.

الحصول على NestedDeviceSshBugreportz

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

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

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

المرتجعات
`File`	يشير هذا المصطلح إلى ملف يشير إلى تقرير أخطاء zip، أو يكون فارغًا في حال حدوث مشكلة.

الرميات
	IOاستثناء

دليل السجل

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`	ما إذا كان قد تمّ تسجيل الملف بنجاح أم لا.

الرقم التسلسلي لالإخراج

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

يمكنك تسجيل الإخراج التسلسلي لجهاز موصوف من خلال GceAvdInfo.

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

عن بُعدSshCommandExecution

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` تحتوي على نتيجة التنفيذ.

إيقاف التشغيل

public boolean shutdownGce ()

يتم إيقاف مثيل Gce المرتبط بـ startGce().

المرتجعات
`boolean`	تعرض القيمة "صحيح" إذا تم طلب إيقاف خدمة Google Search Console على أنّها لا تؤدي إلى الحظر.

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`: رقم إزاحة متوسّط مدة المشاهدة للجهاز في المضيف، و`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`: رقم إزاحة متوسّط مدة المشاهدة للجهاز في المضيف، و`null` إذا لم يكن كذلك سارٍ
`attributes`	`MultiMap`: سمات مرتبطة بالاستدعاء الحالي، وتُستخدم لاجتياز الاختبار الساري وصولاً إلى مثيل GCE لإضافتها كبيانات وصفية للأجهزة الافتراضية

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

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

بدء متعدد الأجهزة

public  startMultiDevicesGce ( buildInfos)

تم إيقاف هذه الطريقة نهائيًا.
يُرجى إزالته بعد تعديل الفرع الرئيسي.

المعلمات
`buildInfos`

المرتجعات

الرميات
`TargetSetupError`

بدء متعدد الأجهزة

public  startMultiDevicesGce ( buildInfos, 
                MultiMap<String, String> attributes)

حاول تشغيل مثيل جهاز متعدد الأجهزة باستخدام الأكسجين.

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

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

الرميات
`TargetSetupError`

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

أمر BuildLaunchdownCommand

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`