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

احصل على 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)

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

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)

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

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

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

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 ملف يشير إلى تقرير الخطأ المضغوط، أو قيمة فارغة في حال حدوث مشكلة
الرميات
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 ملف يشير إلى تقرير الخطأ المضغوط، أو قيمة فارغة في حال حدوث مشكلة
الرميات
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)

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

المعلمات
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  startMultiDevicesGce ( buildInfos)

تم إيقاف استخدام هذه الطريقة نهائيًا.
Remove this after master branch is updated.

المعلمات
buildInfos

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

startMultiDevicesGce

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

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

المعلمات
buildInfos : ERROR(/List)
attributes ‫MultiMap: السمات المرتبطة بالطلب الحالي
المرتجعات
ERROR(/List) يصف معلومات GCE Avd.
الرميات
TargetSetupError

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

buildShutdownCommand

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

المعلمات
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

المرتجعات

extractInstanceName

protected String extractInstanceName (String bootupLogs)

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

المعلمات
bootupLogs String

المرتجعات
String