IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

الفئات الفرعية غير المباشرة المعروفة GlobalConfiguration GlobalConfiguration تنفيذ 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(String)

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

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	إذا كانت الإعدادات لا تتضمّن حقولًا إلزامية