IGlobalConfiguration

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

getCommandScheduler

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 المقدَّمة في الإعدادات

getDeviceMonitors

public abstract  getDeviceMonitors ()

الحصول على قائمة IDeviceMonitor من الإعدادات العامة

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

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

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

المرتجعات
IDeviceSelection IDeviceSelection المقدَّمة في الإعدادات

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

تعرِض القيمة TradefedFeatureServer أو قيمة فارغة إذا لم تكن محدّدة.

المرتجعات
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

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

المرتجعات
IConfigurationServer

getHostMonitors

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 أو القيمة null إذا لم يتم ضبط مصنع ملف تخزين مفاتيح

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

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

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

validateOptions

public abstract void validateOptions ()

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

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

عمليات الرمي
ConfigurationException إذا كانت الإعدادات لا تتضمّن حقولًا إلزامية