تهيئة IGlobal

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

فئة لتضمين معلومات الإعدادات الشاملة لمثيل واحد من Trade Federation (تضمين أي عدد من عمليات استدعاء الإعدادات الفعلية)

ملخّص

الطرق العامة

abstract void cleanup()

تنظيف مناسب عند إيقاف Tradefed

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

الإعداد الصحيح في بداية عملية الربط بحساب Google Merchant Center

abstract void validateOptions()

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

الطرق العامة

تنظيف

public abstract void cleanup ()

تنظيف مناسب عند إيقاف Tradefed

cloneConfigWithFilter

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

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

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

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

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 الملف الذي يحتوي على الإعدادات الشاملة الجديدة التي تمّت فلترتها
عمليات الرمي
IOException

الحصول على Commandscheduler

public abstract ICommandScheduler getCommandScheduler ()

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

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

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

تحصل على عنصر الإعدادات المخصّص بالاسم المحدّد.

المعلمات
typeName String: النوع الفريد لعنصر الضبط
المرتجعات
Object الكائن أو القيمة الخالية إذا لم يتم العثور على كائن بهذا الاسم

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

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

المرتجعات
ICredentialFactory ICredentialFactory أو null في حال عدم تحديد أيّ منها

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

تعرض القيمة DeviceManagementGrpcServer أو قيمة خالية إذا لم تكن محددة.

المرتجعات
DeviceManagementGrpcServer

getDeviceManager

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 في حال عدم تحديد أيّ منها في إعدادات المضيف

getKeyStoreFactory

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 في حال عدم تحديد أيّ منها

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

الحصول على مصنع بيئة محاكاة يمكن استخدامه لتشغيل طلب

المرتجعات
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

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

المرتجعات
IShardHelper

getTestInvocationManagementSever

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، مع استبدال أي قيم حالية.

setConfigurationFactory

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

setDeviceManager

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 المحتوى.

setHostMonitors

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

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

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

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

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

يُرجى الاطّلاع على ArgsOptionParser للاطّلاع على التنسيق المتوقّع.

المعلمات
listArgs : وسيطات سطر الأوامر
المرتجعات
الوسيطات غير المستخدَمة
الرميات
ConfigurationException

setOriginalConfig

public abstract void setOriginalConfig (String config)

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

المعلمات
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

لضبط IResourceMetricCollector

المعلمات
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

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

setShardingStrategy

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

validateOptions

public abstract void validateOptions ()

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

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

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