مدير 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

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

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)

يتم تشغيل 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

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

مدير 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)

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

المعلمات
options TestDeviceOptions: TestDeviceOptions لخيارات Acloud
runUtil IRunUtil: IRunUtil المطلوب تشغيل Acloud
instanceName String: المثيل المطلوب إيقاف تشغيله
hostname String: اسم المضيف للمثيل، ويتم استخدامه فقط لحبار الأكسجين.
المرتجعات
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، أو يكون فارغًا في حال حدوث مشكلة.

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

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

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

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

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

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

إنشاء GceCmd

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

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

المعلمات
reportFile File

b IBuildInfo

ipDevice String

attributes MultiMap

المرتجعات

اسم الاستخراج

protected String extractInstanceName (String bootupLogs)

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

المعلمات
bootupLogs String

المرتجعات
String