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

الطرق المحمية
	`buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` أنشِئ الأمر وأعِده لتشغيل GCE.
`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 المطلوب تشغيل متوسّط مدة المشاهدة فيه، `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 المطلوب تشغيل متوسّط مدة المشاهدة فيه، `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 المطلوب تشغيل متوسّط مدة المشاهدة فيه، `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`

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

إنشاء GceCmd

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

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

المعلّمات
`reportFile`	`File`
`b`	`IBuildInfo`
`ipDevice`	`String`
`user`	`String`
`offset`	`Integer`
`attributes`	`MultiMap`

الركلات المردودة

أمر 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`