تهيئة IGlobal

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration


يشير هذا المصطلح إلى فئة تضم معلومات الضبط العامة لمثيل واحد من مثيل اتحاد تجاري. (بما في ذلك أي عدد من استدعاءات الإعدادات الفعلية).

ملخّص

الطرق العامة

abstract void cleanup()

التنظيف بشكل صحيح عند التبديل بين الإغلاق.

abstract File cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)

يمكنك تصفية GlobalConfiguration بناءً على قائمة بيضاء والإخراج إلى ملف XML.

abstract File cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)

تصفية GlobalConfiguration بناءً على قائمة بيضاء مع السماح بمعالجة وقيم الخيارات والإخراج إلى ملف XML.

abstract File cloneConfigWithFilter(String... allowlistConfigs)

يمكنك فلترة GlobalConfiguration استنادًا إلى قائمة مسموح بها والمخرجات إلى ملف XML.

abstract ICommandScheduler getCommandScheduler()

يحصل على ICommandScheduler لاستخدامه من الإعدادات.

abstract Object getConfigurationObject(String typeName)

يحصل على كائن الضبط المخصّص بالاسم الأول.

abstract ICredentialFactory getCredentialFactory()

الحصول على ICredentialFactory لإنشاء بيانات الاعتماد.

abstract DeviceManagementGrpcServer getDeviceManagementServer()

تعرض القيمة DeviceManagementGrpcServer أو قيمة خالية في حال عدم تحديد قيمة.

abstract IDeviceManager getDeviceManager()

يحصل على IDeviceManager لاستخدامه من الإعدادات.

abstract getDeviceMonitors()

يحصل على قائمة IDeviceMonitor من الإعداد العام.

abstract IDeviceSelection getDeviceRequirements()

يحصل على IDeviceSelection لاستخدامه من الإعدادات.

abstract TradefedFeatureServer getFeatureServer()

تعرض القيمة TradefedFeatureServer أو قيمة خالية في حال عدم تحديد قيمة.

abstract IConfigurationServer getGlobalConfigServer()

الحصول على خادم إعداد عام.

abstract getHostMonitors()

يحصل على قائمة IHostMonitor من الإعداد العام.

abstract IHostOptions getHostOptions()

يحصل على IHostOptions لاستخدامه من الإعدادات.

abstract IHostResourceManager getHostResourceManager()

تحصل على IHostResourceManager من الإعداد العام.

abstract IKeyStoreFactory getKeyStoreFactory()

يحصل على IKeyStoreFactory لاستخدامه من الإعدادات.

abstract getMultiDeviceRecoveryHandlers()

يحصل على قائمة IMultiDeviceRecovery لاستخدامها من الإعدادات.

abstract getOptionValues(String optionName)

احصل على قائمة بقيم الخيارات.

abstract getResourceMetricCollectors()

يحصل على قائمة IResourceMetricCollector من الإعداد العام.

abstract ISandboxFactory getSandboxFactory()

الحصول على مصنع وضع حماية يمكن استخدامه لتشغيل استدعاءات

abstract IShardHelper getShardingStrategy()

تعرض السمة IShardHelper التي تحدّد طريقة تقسيم الإعدادات.

abstract TestInvocationManagementServer getTestInvocationManagementSever()

تعرض القيمة TestInvocationManagementServer أو قيمة خالية في حال عدم تحديد قيمة.

abstract ITerribleFailureHandler getWtfHandler()

يحصل على ITerribleFailureHandler لاستخدامه من الإعدادات.

abstract void injectOptionValue(String optionName, String optionValue)

أدخِل قيمة خيار في مجموعة كائنات الضبط.

abstract void injectOptionValue(String optionName, String optionKey, String optionValue)

أدخِل قيمة خيار في مجموعة كائنات الضبط.

abstract void setCommandScheduler(ICommandScheduler scheduler)

اضبط السمة ICommandScheduler، مع استبدال أي قيم حالية.

abstract void setConfigurationFactory(IConfigurationFactory configFactory)

يمكنك ضبط IConfigurationFactory لهذه الإعدادات.

abstract void setConfigurationObject(String name, Object configObject)

طريقة عامة لضبط عنصر الضبط بالاسم المحدّد، مع استبدال أي قيمة حالية.

abstract void setConfigurationObjectList(String typeName, configList)

طريقة عامة لضبط قائمة عناصر الضبط للاسم المحدّد، مع استبدال أي قائمة حالية

abstract void setDeviceManagementServer(DeviceManagementGrpcServer server)

لضبط DeviceManagementGrpcServer.

abstract void setDeviceManager(IDeviceManager deviceManager)

اضبط السمة IDeviceManager، مع استبدال أي قيم حالية.

abstract void setDeviceMonitor(IDeviceMonitor deviceMonitor)

اضبط السمة IDeviceMonitor.

abstract void setDeviceRequirements(IDeviceSelection deviceSelection)

اضبط السمة IDeviceSelection، مع استبدال أي قيم حالية.

abstract void setHostMonitors( hostMonitors)

اضبط قائمة "IHostMonitor".

abstract void setHostOptions(IHostOptions hostOptions)

اضبط السمة IHostOptions، مع استبدال أي قيم حالية.

abstract void setHostResourceManager(IHostResourceManager hostResourceManager)

اضبط السمة IHostResourceManager، مع استبدال أي قيم حالية.

abstract void setInvocationServer(TestInvocationManagementServer server)

لضبط TestInvocationManagementServer.

abstract void setKeyStoreFactory(IKeyStoreFactory factory)

اضبط السمة IKeyStoreFactory، مع استبدال أي قيم حالية.

abstract setOptionsFromCommandLineArgs( listArgs)

اضبط حقول Option للضبط العام باستخدام مجموعة محدّدة من وسيطات سطر الأوامر.

يمكنك الاطّلاع على ArgsOptionParser لمعرفة التنسيق المتوقّع.

abstract void setOriginalConfig(String config)

تضبط هذه السياسة الإعدادات الأصلية المستخدَمة لإنشاء عملية الضبط العامة.

abstract void setResourceMetricCollector(IResourceMetricCollector collector)

لضبط IResourceMetricCollector.

abstract void setSandboxFactory(ISandboxFactory factory)

اضبط السمة ISandboxFactory، مع استبدال أي قيم حالية.

abstract void setShardingStrategy(IShardHelper sharding)

تحدِّد هذه السياسة السمة IShardHelper لاستخدامها عند تقسيم الإعدادات.

abstract void setTradefedFeatureServer(TradefedFeatureServer server)

لضبط TradefedFeatureServer.

abstract void setWtfHandler(ITerribleFailureHandler wtfHandler)

اضبط السمة ITerribleFailureHandler.

abstract void setup()

الإعداد الصحيح في بداية مقايضة الجهاز

abstract void validateOptions()

التحقق من صحة قيم الخيارات

الطرق العامة

تنظيف

public abstract void cleanup ()

التنظيف بشكل صحيح عند التبديل بين الإغلاق.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

يمكنك تصفية GlobalConfiguration بناءً على قائمة بيضاء والإخراج إلى ملف XML.

المعلمات
exclusionPatterns : نمط اسم الفئة المطلوب استبعاده من ملف التفريغ.

allowlistConfigs String: مصفوفة String من الإعدادات التي سيتم تضمينها في ملف XML الجديد إذا تم ضبطها على null, a default list should be used.

المرتجعات
File الملف الذي يحتوي على التهيئة العامة الجديدة التي تمت تصفيتها.

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

يُرجى الاطّلاع أيضًا على:

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

تصفية GlobalConfiguration بناءً على قائمة بيضاء مع السماح بمعالجة وقيم الخيارات والإخراج إلى ملف XML.

المعلمات
exclusionPatterns : نمط اسم الفئة المطلوب استبعاده من ملف التفريغ.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String: مصفوفة String من الإعدادات التي سيتم تضمينها في ملف XML الجديد الملف. إذا تم ضبطها على null, a default list should be used.

المرتجعات
File الملف الذي يحتوي على التهيئة العامة الجديدة التي تمت تصفيتها.

يُرجى الاطّلاع أيضًا على:

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

يمكنك فلترة GlobalConfiguration استنادًا إلى قائمة مسموح بها والمخرجات إلى ملف XML.

على سبيل المثال، للإعدادات التالية: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

جميع الإعدادات باستثناء "key_store" وسننتج ملف تهيئة يحتوي على المحتوى التالي: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

المعلمات
allowlistConfigs String: مصفوفة String من الإعدادات التي سيتم تضمينها في ملف XML الجديد إذا تم ضبطها على null, a default list should be used.

المرتجعات
File الملف الذي يحتوي على التهيئة العامة الجديدة التي تمت تصفيتها.

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

الحصول على Commandscheduler

public abstract ICommandScheduler getCommandScheduler ()

يحصل على ICommandScheduler لاستخدامه من الإعدادات.

المرتجعات
ICommandScheduler ICommandScheduler. لن يتم عرض قيمة فارغة أبدًا.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

يحصل على كائن الضبط المخصّص بالاسم الأول.

المعلمات
typeName String: النوع الفريد لكائن الإعدادات

المرتجعات
Object كائن أو قيمة خالية إذا لم يتم العثور على كائن بهذا الاسم

الحصول على بيانات اعتماد مصنع

public abstract ICredentialFactory getCredentialFactory ()

الحصول على ICredentialFactory لإنشاء بيانات الاعتماد.

المرتجعات
ICredentialFactory ICredentialFactory أو null إذا لم يتم تحديد أي منها.

الحصول على DeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

تعرض القيمة DeviceManagementGrpcServer أو قيمة خالية في حال عدم تحديد قيمة.

المرتجعات
DeviceManagementGrpcServer

الحصول على مدير الجهاز

public abstract IDeviceManager getDeviceManager ()

يحصل على IDeviceManager لاستخدامه من الإعدادات. يدير مجموعة البيانات المتاحة أجهزة للاختبار

المرتجعات
IDeviceManager IDeviceManager المُقدم في الإعدادات.

الحصول على أجهزة مراقبة

public abstract  getDeviceMonitors ()

يحصل على قائمة IDeviceMonitor من الإعداد العام.

المرتجعات
قائمة IDeviceMonitor من الإعداد العام، أو null إذا لم يتم تحديد أي شيء.

الحصول على متطلبات الجهاز

public abstract IDeviceSelection getDeviceRequirements ()

يحصل على IDeviceSelection لاستخدامه من الإعدادات. يمثّل هذا الإعداد فلترًا عامًا. الأجهزة التي يمكن لـ "DeviceManager" رؤيتها.

المرتجعات
IDeviceSelection IDeviceSelection المُقدم في الإعدادات.

الحصول علىخادم الميزات

public abstract TradefedFeatureServer getFeatureServer ()

تعرض القيمة TradefedFeatureServer أو قيمة خالية في حال عدم تحديد قيمة.

المرتجعات
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

الحصول على خادم إعداد عام. يُستخدم خادم التهيئة العام للحصول على إعدادات المضيف من خادم بدلاً من الحصول عليه من الملفات المحلية.

المرتجعات
IConfigurationServer

أجهزة getHostMonitor

public abstract  getHostMonitors ()

يحصل على قائمة IHostMonitor من الإعداد العام.

المرتجعات
قائمة IHostMonitor من الإعداد العام، أو null إذا لم يتم إعدادها .

getHostOptions

public abstract IHostOptions getHostOptions ()

يحصل على IHostOptions لاستخدامه من الإعدادات.

المرتجعات
IHostOptions IDeviceManager المُقدم في الإعدادات.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

تحصل على IHostResourceManager من الإعداد العام.

المرتجعات
IHostResourceManager IHostResourceManager من الإعدادات العامة أو عملية التنفيذ التلقائية LocalHostResourceManager في حال عدم تحديد أي شيء في إعدادات المضيف.

الحصول على مفتاح Store

public abstract IKeyStoreFactory getKeyStoreFactory ()

يحصل على IKeyStoreFactory لاستخدامه من الإعدادات.

المرتجعات
IKeyStoreFactory IKeyStoreFactory أو خالية إذا لم يتم ضبط مصنع تخزين المفاتيح.

مُعامِلات getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

يحصل على قائمة IMultiDeviceRecovery لاستخدامها من الإعدادات.

المرتجعات
قائمة IMultiDeviceRecovery، أو null إذا لم يتم ضبطها.

قيم getOptionValues

public abstract  getOptionValues (String optionName)

احصل على قائمة بقيم الخيارات.

المعلمات
optionName String: اسم خيار الخريطة

المرتجعات
قائمة بقيم الخيار المحدد. null إذا لم يكن اسم الخيار الموجودة.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

يحصل على قائمة IResourceMetricCollector من الإعداد العام.

المرتجعات
قائمة IResourceMetricCollector من الإعداد العام أو null إذا لم يتم تحديد أي منها.

الحصول على صندوق حماية

public abstract ISandboxFactory getSandboxFactory ()

الحصول على مصنع وضع حماية يمكن استخدامه لتشغيل استدعاءات

المرتجعات
ISandboxFactory

استراتيجية الحصول على مشاركة

public abstract IShardHelper getShardingStrategy ()

تعرض السمة IShardHelper التي تحدّد طريقة تقسيم الإعدادات.

المرتجعات
IShardHelper

الحصول علىإدارة اختبار الاستدعاء

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

تعرض القيمة TestInvocationManagementServer أو قيمة خالية في حال عدم تحديد قيمة.

المرتجعات
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

يحصل على ITerribleFailureHandler لاستخدامه من الإعدادات. تتناول ما يجب فعله في حالة إخفاق WTF (يا له من إخفاق مريع) تحدث المقابلة.

المرتجعات
ITerribleFailureHandler ITerribleFailureHandler الواردة في تهيئة، أو خالية إذا لم يتم تعيين أي معالج

قيمة injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

أدخِل قيمة خيار في مجموعة كائنات الضبط.

يُفيد في تقديم قيم للخيارات التي يتم إنشاؤها ديناميكيًا.

المعلمات
optionName String: اسم الخيار

optionValue String: قيم الخيارات

الرميات
ConfigurationException في حال تعذّر ضبط قيمة الخيار

قيمة injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

أدخِل قيمة خيار في مجموعة كائنات الضبط.

يُفيد في تقديم قيم للخيارات التي يتم إنشاؤها ديناميكيًا.

المعلمات
optionName String: اسم خيار الخريطة

optionKey String: مفتاح خيار الخريطة

optionValue String: قيمة خيار الخريطة

الرميات
ConfigurationException في حال تعذّر ضبط قيمة الخيار

setCommandscheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

اضبط السمة ICommandScheduler، مع استبدال أي قيم حالية.

ضبط ضبط المصنع

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

يمكنك ضبط IConfigurationFactory لهذه الإعدادات.

المعلمات
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

طريقة عامة لضبط عنصر الضبط بالاسم المحدّد، مع استبدال أي قيمة حالية.

المعلمات
name String: الاسم الفريد لنوع عنصر الضبط

configObject Object: كائن الإعداد

الرميات
ConfigurationException إذا لم يكن configObject من النوع الصحيح

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

طريقة عامة لضبط قائمة عناصر الضبط للاسم المحدّد، مع استبدال أي قائمة حالية

المعلمات
typeName String: الاسم الفريد لنوع عنصر الضبط

configList : قائمة كائنات الضبط

الرميات
ConfigurationException إذا لم تكن أي كائنات في القائمة من النوع الصحيح

خادم setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

لضبط DeviceManagementGrpcServer.

المعلمات
server DeviceManagementGrpcServer

مدير الجهاز

public abstract void setDeviceManager (IDeviceManager deviceManager)

اضبط السمة IDeviceManager، مع استبدال أي قيم حالية. وهذا يحدد مدير أجهزة اختبار

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

اضبط السمة IDeviceMonitor.

المعلمات
deviceMonitor IDeviceMonitor: الشاشة

الرميات
ConfigurationException إذا سبق أن تم ضبط قيمة IDeviceMonitor.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

اضبط السمة IDeviceSelection، مع استبدال أي قيم حالية. يؤدي هذا إلى إعداد جهاز عام يتيح لك هذا الخيار فلترة الأجهزة التي يمكن لـ DeviceManager الاطّلاع عليها.

setHostMonitor

public abstract void setHostMonitors ( hostMonitors)

اضبط قائمة "IHostMonitor".

المعلمات
hostMonitors : قائمة أجهزة العرض

الرميات
ConfigurationException إذا سبق أن تم ضبط قيمة IHostMonitor.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

اضبط السمة IHostOptions، مع استبدال أي قيم حالية.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

اضبط السمة IHostResourceManager، مع استبدال أي قيم حالية.

خادم setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

لضبط TestInvocationManagementServer.

المعلمات
server TestInvocationManagementServer

تعيين مفتاح Storeمصنع

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

اضبط السمة IKeyStoreFactory، مع استبدال أي قيم حالية.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

اضبط حقول Option للضبط العام باستخدام مجموعة محدّدة من وسيطات سطر الأوامر.

يمكنك الاطّلاع على ArgsOptionParser لمعرفة التنسيق المتوقّع.

المعلمات
listArgs : وسيطات سطر الأوامر

المرتجعات
الوسيطات غير المستخدمة

الرميات
ConfigurationException

الضبط الأصلي

public abstract void setOriginalConfig (String config)

تضبط هذه السياسة الإعدادات الأصلية المستخدَمة لإنشاء عملية الضبط العامة.

المعلمات
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

لضبط IResourceMetricCollector.

المعلمات
collector IResourceMetricCollector

setSandbox جدًا

public abstract void setSandboxFactory (ISandboxFactory factory)

اضبط السمة ISandboxFactory، مع استبدال أي قيم حالية.

استراتيجية تقسيم المجموعة

public abstract void setShardingStrategy (IShardHelper sharding)

تحدِّد هذه السياسة السمة IShardHelper لاستخدامها عند تقسيم الإعدادات.

المعلمات
sharding IShardHelper

خادم setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

لضبط TradefedFeatureServer.

المعلمات
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

اضبط السمة ITerribleFailureHandler.

المعلمات
wtfHandler ITerribleFailureHandler: معالج WTF

الرميات
ConfigurationException إذا كان لدى ITerribleFailureHandler تم تعيينها بالفعل.

إعداد

public abstract void setup ()

الإعداد الصحيح في بداية مقايضة الجهاز

الرميات
com.android.tradefed.config.ConfigurationException
ConfigurationException

خيارات التحقق من الصحة

public abstract void validateOptions ()

التحقق من صحة قيم الخيارات

في الوقت الحالي، سيؤدي هذا فقط إلى التحقُّق من ضبط جميع الخيارات الإلزامية.

الرميات
ConfigurationException إذا كان الإعداد ينقصه حقول إلزامية