اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

IConfiguration

public interface IConfiguration

com.android.tradefed.config.IConfiguration

الفئات الفرعية غير المباشرة المعروفة

الإعداد

الإعداد تنفيذ IConfiguration محدّد يخزِّن عناصر الإعدادات المحمَّلة في خريطة

معلومات الضبط لاستدعاء TradeFederation يحتوي كلّ استدعاء TradeFederation على IConfiguration واحد. تخزِّن IConfiguration جميع العناصر المفوَّضة التي يجب استخدامها أثناء الاستدعاء، وOption المرتبطة بها.

ملخّص

الطرق العامة
`abstract void`	`addFilesToClean( toBeCleaned)` إضافة الملفات التي يجب تنظيفها أثناء `cleanConfigurationData()`
`abstract void`	`cleanConfigurationData()` حذف أي ملفات تم تنزيلها إلى حقول الخيارات التي تم حلّها للملفات البعيدة
`abstract IConfiguration`	`clone()` أنشئ نسخة سطحية من هذا الكائن.
`abstract void`	`dumpXml(PrintWriter output)` الحصول على ملف XML الموسّع للإعداد مع جميع الخيارات المعروضة لهذا `IConfiguration` بصفتها `String`
`abstract void`	`dumpXml(PrintWriter output, excludeFilters)` تحصل على ملف XML الموسّع للإعداد مع جميع الخيارات المعروضة لهذا `IConfiguration` باستثناء فلاتر العناصر حسب اسم المفتاح.
`abstract void`	`dumpXml(PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)` تحصل على ملف XML الموسّع للإعداد مع جميع الخيارات المعروضة لهذا `IConfiguration` باستثناء فلاتر العناصر حسب اسم المفتاح.
`abstract`	`getAllConfigurationObjectsOfType(String typeName)` واجهة عامة للحصول على جميع عناصر اسم نوع معيّن على جميع الأجهزة
`abstract IBuildProvider`	`getBuildProvider()` تحصل على `IBuildProvider` من الإعدادات.
`abstract String`	`getCommandLine()` تحصل على سطر الأوامر المستخدَم لإنشاء هذا `IConfiguration`.
`abstract ICommandOptions`	`getCommandOptions()` تحصل على `ICommandOptions` المطلوب استخدامه من الإعداد.
`abstract ConfigurationDescriptor`	`getConfigurationDescription()` لعرض `ConfigurationDescriptor` المقدَّمة في الإعدادات.
`abstract Object`	`getConfigurationObject(String typeName)` واجهة عامة للحصول على عنصر الإعدادات الذي يحمل اسم النوع المحدَّد
`abstract`	`getConfigurationObjectList(String typeName)` يشبه `getConfigurationObject(String)`، ولكن لأنواع كائنات الإعداد التي تتيح كائنات متعددة.
`abstract CoverageOptions`	`getCoverageOptions()` تحصل على `CoverageOptions` المطلوب استخدامه من الإعداد.
`abstract`	`getDeviceConfig()` تحصل على `IDeviceConfiguration` من الإعدادات.
`abstract IDeviceConfiguration`	`getDeviceConfigByName(String nameDevice)` عرض `IDeviceConfiguration` المرتبط بالاسم المقدَّم، أو عرض قيمة فارغة في حال عدم العثور عليه
`abstract TestDeviceOptions`	`getDeviceOptions()` تحصل على `TestDeviceOptions` المطلوب استخدامه من الإعداد.
`abstract IDeviceRecovery`	`getDeviceRecovery()` تحصل على `IDeviceRecovery` المطلوب استخدامه من الإعداد.
`abstract IDeviceSelection`	`getDeviceRequirements()` تحصل على `IDeviceSelection` المطلوب استخدامه من الإعداد.
`abstract`	`getFilesToClean()` الحصول على قائمة الملفات التي سيتمّت إزالتها أثناء `cleanConfigurationData()`
`abstract GlobalTestFilter`	`getGlobalFilters()` تحصل على `GlobalTestFilter` للطلب.
`abstract`	`getInopOptions()` الحصول على أسماء الخيارات التي لم تغيّر أي قيم
`abstract`	`getLabPreparers()` تحصل على `ITargetPreparer` من الإعداد.
`abstract ILeveledLogOutput`	`getLogOutput()` تحصل على `ILeveledLogOutput` المطلوب استخدامه من الإعداد.
`abstract ILogSaver`	`getLogSaver()` تحصل على `ILogSaver` المطلوب استخدامه من الإعداد.
`abstract`	`getMetricCollectors()` تحصل على `IMetricCollector` من الإعدادات.
`abstract`	`getMultiPreTargetPreparers()` تحصل على `IMultiTargetPreparer` من الإعدادات التي يجب تنفيذها قبل أي من أدوات إعداد الأجهزة target_preparers.
`abstract`	`getMultiTargetPreparers()` تحصل على `IMultiTargetPreparer` من الإعدادات.
`abstract String`	`getName()` عرض اسم الإعداد
`abstract`	`getPostProcessors()` تحصل على `IPostProcessor` من الإعدادات.
`abstract IRetryDecision`	`getRetryDecision()` عرض `IRetryDecision` المستخدَم في الاستدعاء
`abstract SkipManager`	`getSkipManager()` تحصل على `SkipManager` للطلب.
`abstract`	`getSystemStatusCheckers()` تحصل على `ISystemStatusChecker` من الإعدادات.
`abstract`	`getTargetPreparers()` تحصل على `ITargetPreparer` من الإعدادات.
`abstract`	`getTestInvocationListeners()` تحصل على `ITestInvocationListener` المطلوب استخدامها من الإعداد.
`abstract`	`getTests()` تحصل على `IRemoteTest` لتشغيلها من الإعداد.
`abstract void`	`injectOptionValue(String optionName, String optionValue)` أدرِج قيمة خيار في مجموعة عناصر الإعداد.
`abstract void`	`injectOptionValue(String optionName, String optionKey, String optionValue)` أدرِج قيمة خيار في مجموعة عناصر الإعداد.
`abstract void`	`injectOptionValueWithSource(String optionName, String optionKey, String optionValue, String optionSource)` أدرِج قيمة خيار في مجموعة عناصر الإعداد.
`abstract void`	`injectOptionValues( optionDefs)` إدراج قيم خيارات متعددة في مجموعة عناصر الضبط
`abstract boolean`	`isDeviceConfiguredFake(String deviceName)` تعرِض هذه السمة ما إذا كان الجهاز الذي تم ضبطه مصنّفًا على أنّه isFake=true أم لا.
`abstract IConfiguration`	`partialDeepClone( objectToDeepClone, IKeyStoreClient client)` أنشئ نسخة طبق الأصل أساسية من `clone()`، ثم أنشئ نسخة طبق الأصل مفصّلة لقائمة عناصر الإعداد المحدّدة.
`abstract void`	`printCommandUsage(boolean importantOnly, PrintStream out)` إخراج نص مساعدة حول استخدام سطر الأوامر لهذه الإعدادات إلى printStream المحدَّد
`abstract void`	`resolveDynamicOptions(DynamicRemoteFileResolver resolver)` حلّ خيارات `ERROR(/File)` التي تشير إلى موقع جغرافي بعيد
`abstract void`	`safeInjectOptionValues( optionDefs)` إدراج قيم خيارات متعددة في مجموعة عناصر الضبط بدون طرح خطأ في حال تعذّر تطبيق أحد الخيارات
`abstract`	`setBestEffortOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` اضبط حقول config `Option` باستخدام مجموعة معيّنة من مَعلمات سطر الأوامر باستخدام أفضل أسلوب جهد.
`abstract void`	`setBuildProvider(IBuildProvider provider)` استبدِل `IBuildProvider` الحالي في الإعدادات.
`abstract void`	`setCommandLine(String[] arrayArgs)` لضبط سطر الأوامر المستخدَم لإنشاء هذا `IConfiguration`.
`abstract void`	`setCommandOptions(ICommandOptions cmdOptions)` ضبط `ICommandOptions`، مع استبدال أي قيم حالية
`abstract void`	`setConfigurationObject(String name, Object configObject)` طريقة عامة لضبط كائن الإعدادات بالاسم المحدّد، مع استبدال أي قيمة حالية.
`abstract void`	`setConfigurationObjectList(String name, configList)` طريقة عامة لضبط قائمة عناصر الضبط للاسم المحدّد، مع استبدال أي قيمة حالية.
`abstract void`	`setCoverageOptions(CoverageOptions coverageOptions)` اضبط `CoverageOptions`، مع استبدال أي قيم حالية.
`abstract void`	`setDeviceConfig(IDeviceConfiguration deviceConfig)` اضبط `IDeviceConfiguration`، مع استبدال أي قيمة حالية.
`abstract void`	`setDeviceConfigList( deviceConfigs)` اضبط القيم `IDeviceConfiguration`، مع استبدال أي قيمة حالية.
`abstract void`	`setDeviceMetricCollectors( collectors)` اضبط قائمة `IMetricCollector`، مع استبدال أي قيم حالية.
`abstract void`	`setDeviceOptions(TestDeviceOptions deviceOptions)` ضبط `TestDeviceOptions`، مع استبدال أي قيم حالية
`abstract void`	`setDeviceRecovery(IDeviceRecovery recovery)` اضبط `IDeviceRecovery`، مع استبدال أي قيمة حالية.
`abstract void`	`setDeviceRequirements(IDeviceSelection deviceSelection)` ضبط `IDeviceSelection`، مع استبدال أي قيم حالية
`abstract void`	`setLabPreparer(ITargetPreparer preparer)` اضبط `ITargetPreparer`، مع استبدال أي قيمة حالية.
`abstract void`	`setLabPreparers( preparers)` اضبط قائمة `ITargetPreparer`، مع استبدال أي قيمة حالية.
`abstract void`	`setLogOutput(ILeveledLogOutput logger)` اضبط `ILeveledLogOutput`، مع استبدال أي قيمة حالية.
`abstract void`	`setLogSaver(ILogSaver logSaver)` اضبط `ILogSaver`، مع استبدال أي قيمة حالية.
`abstract void`	`setMultiPreTargetPreparer(IMultiTargetPreparer multiPreTargPreps)` طريقة سهلة لضبط `IMultiTargetPreparer` واحد في هذه الإعدادات التي يجب تنفيذها قبل أيّ من أدوات إعداد الأجهزة target_preparers، مع استبدال أيّ قيم حالية
`abstract void`	`setMultiPreTargetPreparers( multiPreTargPreps)` اضبط قائمة `IMultiTargetPreparer` في هذه الإعدادات التي يجب تنفيذها قبل أي من أدوات target_preparers للأجهزة، مع استبدال أي قيم حالية.
`abstract void`	`setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)` طريقة سهلة لضبط `IMultiTargetPreparer` واحد في هذه الإعدادات، مع استبدال أي قيم حالية
`abstract void`	`setMultiTargetPreparers( multiTargPreps)` اضبط قائمة `IMultiTargetPreparer` في هذه الإعدادات، مع استبدال أي قيم حالية.
`abstract`	`setOptionsFromCommandLineArgs( listArgs)` ضبط حقول config `Option` باستخدام مجموعة معيّنة من مَعلمات سطر الأوامر ‫`ArgsOptionParser` للتنسيق المتوقّع
`abstract`	`setOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` ضبط حقول config `Option` باستخدام مجموعة معيّنة من مَعلمات سطر الأوامر يُرجى الاطّلاع على `ArgsOptionParser` للاطّلاع على التنسيق المتوقّع.
`abstract void`	`setPostProcessors( processors)` اضبط قائمة `IPostProcessor`، مع استبدال أي قيم حالية.
`abstract void`	`setRetryDecision(IRetryDecision decisionRetry)` اضبط `IRetryDecision`، مع استبدال أي قيمة حالية.
`abstract void`	`setSystemStatusChecker(ISystemStatusChecker systemChecker)` طريقة سهلة لضبط `ISystemStatusChecker` واحد في هذه الإعدادات، مع استبدال أي قيم حالية
`abstract void`	`setSystemStatusCheckers( systemCheckers)` اضبط قائمة `ISystemStatusChecker` في هذه الإعدادات، مع استبدال أي قيم حالية.
`abstract void`	`setTargetPreparer(ITargetPreparer preparer)` اضبط `ITargetPreparer`، مع استبدال أي قيمة حالية.
`abstract void`	`setTargetPreparers( preparers)` اضبط قائمة `ITargetPreparer`، مع استبدال أي قيمة حالية.
`abstract void`	`setTest(IRemoteTest test)` طريقة سهلة لضبط `IRemoteTest` واحد في هذه الإعدادات، مع استبدال أي قيم حالية
`abstract void`	`setTestInvocationListener(ITestInvocationListener listener)` طريقة سهلة لضبط `ITestInvocationListener` واحد
`abstract void`	`setTestInvocationListeners( listeners)` ضبط قائمة `ITestInvocationListener`، مع استبدال أي قيم حالية
`abstract void`	`setTests( tests)` اضبط قائمة `IRemoteTest` في هذه الإعدادات، مع استبدال أي قيم حالية.
`abstract void`	`validateOptions()` تحقَّق من صحة قيم الخيارات.

الطرق العامة

addFilesToClean

public abstract void addFilesToClean ( toBeCleaned)

إضافة الملفات التي يجب تنظيفها أثناء cleanConfigurationData()

المعلمات
`toBeCleaned`

cleanConfigurationData

public abstract void cleanConfigurationData ()

حذف أي ملفات تم تنزيلها إلى حقول الخيارات التي تم حلّها للملفات البعيدة

نسخة طبق الأصل

public abstract IConfiguration clone ()

أنشئ نسخة سطحية من هذا الكائن.

المرتجعات
`IConfiguration`	نسخة من {link IConfiguration}

dumpXml

public abstract void dumpXml (PrintWriter output)

الحصول على ملف XML الموسّع للإعداد مع جميع الخيارات المعروضة لهذا IConfiguration بصفتها String

المعلمات
`output`	‫`PrintWriter`: كاتب لطباعة ملف xml

عمليات الرمي
	IOException

dumpXml

public abstract void dumpXml (PrintWriter output, 
                 excludeFilters)

تحصل على ملف XML الموسّع للإعداد مع جميع الخيارات المعروضة لهذا IConfiguration باستثناء فلاتر العناصر حسب اسم المفتاح.

مثال على الفلتر: Configuration.TARGET_PREPARER_TYPE_NAME.

المعلمات
`output`	‫`PrintWriter`: كاتب لطباعة ملف xml
`excludeFilters`	: قائمة أنواع العناصر التي يجب عدم تفريغها

عمليات الرمي
	IOException

dumpXml

public abstract void dumpXml (PrintWriter output, 
                 excludeFilters, 
                boolean printDeprecatedOptions, 
                boolean printUnchangedOptions)

مثال على الفلتر: Configuration.TARGET_PREPARER_TYPE_NAME.

المعلمات
`output`	‫`PrintWriter`: كاتب لطباعة ملف xml
`excludeFilters`	: قائمة أنواع العناصر التي يجب عدم تفريغها
`printDeprecatedOptions`	`boolean`: تحديد ما إذا كان سيتم طباعة الخيارات التي تم وضع علامة "متوقفة نهائيًا" عليها
`printUnchangedOptions`	`boolean`

عمليات الرمي
	IOException

getAllConfigurationObjectsOfType

public abstract  getAllConfigurationObjectsOfType (String typeName)

واجهة عامة للحصول على جميع عناصر اسم نوع معيّن على جميع الأجهزة

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

المرتجعات
	قائمة عناصر الضبط من النوع المحدّد

getBuildProvider

public abstract IBuildProvider getBuildProvider ()

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

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

getCommandLine

public abstract String getCommandLine ()

تحصل على سطر الأوامر المستخدَم لإنشاء هذا IConfiguration.

المرتجعات
`String`	سطر الأوامر المستخدَم لإنشاء هذا `IConfiguration`.

getCommandOptions

public abstract ICommandOptions getCommandOptions ()

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

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

getConfigurationDescription

public abstract ConfigurationDescriptor getConfigurationDescription ()

لعرض ConfigurationDescriptor المقدَّمة في الإعدادات.

المرتجعات
`ConfigurationDescriptor`

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

واجهة عامة للحصول على عنصر الإعدادات الذي يحمل اسم النوع المحدَّد

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

المرتجعات
`Object`	عنصر الإعدادات أو `null` إذا لم يكن نوع العنصر الذي يحمل الاسم المُعطى متوفّرًا

getConfigurationObjectList

public abstract  getConfigurationObjectList (String typeName)

يشبه getConfigurationObject(String)، ولكن لأنواع كائنات الإعداد التي تتيح كائنات متعددة.

المعلمات
`typeName`	`String`: اسم النوع الفريد لعنصر الإعدادات

المرتجعات
	قائمة عناصر الإعدادات أو `null` إذا لم يكن نوع العنصر الذي يحمل اسمًا معيّنًا متوفّرًا

getCoverageOptions

public abstract CoverageOptions getCoverageOptions ()

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

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

getDeviceConfig

public abstract  getDeviceConfig ()

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

المرتجعات
	`IDeviceConfiguration` التي تم تقديمها بالترتيب في الإعداد

getDeviceConfigByName

public abstract IDeviceConfiguration getDeviceConfigByName (String nameDevice)

عرض IDeviceConfiguration المرتبط بالاسم المقدَّم، أو عرض قيمة فارغة في حال عدم العثور عليه

المعلمات
`nameDevice`	`String`

المرتجعات
`IDeviceConfiguration`

getDeviceOptions

public abstract TestDeviceOptions getDeviceOptions ()

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

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

getDeviceRecovery

public abstract IDeviceRecovery getDeviceRecovery ()

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

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

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

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

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

getFilesToClean

public abstract  getFilesToClean ()

الحصول على قائمة الملفات التي سيتمّت إزالتها أثناء cleanConfigurationData()

المرتجعات

getGlobalFilters

public abstract GlobalTestFilter getGlobalFilters ()

تحصل على GlobalTestFilter للطلب.

المرتجعات
`GlobalTestFilter`

getInopOptions

public abstract  getInopOptions ()

الحصول على أسماء الخيارات التي لم تغيّر أي قيم

المرتجعات

getLabPreparers

public abstract  getLabPreparers ()

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

المرتجعات
	`ITargetPreparer` التي تم تقديمها بالترتيب في الإعداد

getLogOutput

public abstract ILeveledLogOutput getLogOutput ()

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

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

getLogSaver

public abstract ILogSaver getLogSaver ()

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

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

getMetricCollectors

public abstract  getMetricCollectors ()

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

المرتجعات

getMultiPreTargetPreparers

public abstract  getMultiPreTargetPreparers ()

تحصل على IMultiTargetPreparer من الإعدادات التي يجب تنفيذها قبل أي من أدوات إعداد الأجهزة target_preparers.

المرتجعات
	`IMultiTargetPreparer` التي تم تقديمها بالترتيب في الإعداد

getMultiTargetPreparers

public abstract  getMultiTargetPreparers ()

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

المرتجعات
	`IMultiTargetPreparer` التي تم تقديمها بالترتيب في الإعداد

getName

public abstract String getName ()

عرض اسم الإعداد

المرتجعات
`String`

getPostProcessors

public abstract  getPostProcessors ()

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

المرتجعات

getRetryDecision

public abstract IRetryDecision getRetryDecision ()

عرض IRetryDecision المستخدَم في الاستدعاء

المرتجعات
`IRetryDecision`

getSkipManager

public abstract SkipManager getSkipManager ()

تحصل على SkipManager للطلب.

المرتجعات
`SkipManager`

getSystemStatusCheckers

public abstract  getSystemStatusCheckers ()

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

المرتجعات
	`ISystemStatusChecker` التي تم تقديمها بالترتيب في الإعداد

getTargetPreparers

public abstract  getTargetPreparers ()

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

المرتجعات
	`ITargetPreparer` التي تم تقديمها بالترتيب في الإعداد

getTestInvocationListeners

public abstract  getTestInvocationListeners ()

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

المرتجعات
	`ITestInvocationListener` المقدَّمة في الإعدادات.

getTests

public abstract  getTests ()

تحصل على IRemoteTest لتشغيلها من الإعداد.

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

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`	في حال تعذّر ضبط قيمة الخيار

injectOptionValueWithSource

public abstract void injectOptionValueWithSource (String optionName, 
                String optionKey, 
                String optionValue, 
                String optionSource)

أدرِج قيمة خيار في مجموعة عناصر الإعداد.

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

المعلمات
`optionName`	`String`: اسم الخيار
`optionKey`	`String`: المفتاح الاختياري لخيارات الخريطة، أو قيمة فارغة
`optionValue`	‫`String`: قيمة خيار الربط
`optionSource`	`String`: إعداد المصدر الذي قدّم قيمة هذا الخيار

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

injectOptionValues

public abstract void injectOptionValues ( optionDefs)

إدراج قيم خيارات متعددة في مجموعة عناصر الضبط

وهي مفيدة لإدخال العديد من قيم الخيارات في آنٍ واحد بعد إنشاء عنصر جديد.

المعلمات
`optionDefs`	: قائمة بتعريفات الخيارات المطلوب إدراجها

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

isDeviceConfiguredFake

public abstract boolean isDeviceConfiguredFake (String deviceName)

تعرِض هذه السمة ما إذا كان الجهاز الذي تم ضبطه مصنّفًا على أنّه isFake=true أم لا.

المعلمات
`deviceName`	`String`

المرتجعات
`boolean`

partialDeepClone

public abstract IConfiguration partialDeepClone ( objectToDeepClone, 
                IKeyStoreClient client)

أنشئ نسخة طبق الأصل أساسية من clone()، ثم أنشئ نسخة طبق الأصل مفصّلة لقائمة عناصر الإعداد المحدّدة.

المعلمات
`objectToDeepClone`	: قائمة عناصر الضبط التي سيتم استنساخها بشكل كامل
`client`	`IKeyStoreClient`: برنامج تخزين المفاتيح

المرتجعات
`IConfiguration`	الإعدادات التي تم استنساخها جزئيًا

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

printCommandUsage

public abstract void printCommandUsage (boolean importantOnly, 
                PrintStream out)

إخراج نص مساعدة حول استخدام سطر الأوامر لهذه الإعدادات إلى printStream المحدَّد

المعلمات
`importantOnly`	`boolean`: إذا كانت `true` تطبع مساعدة الخيارات المهمة فقط
`out`	`PrintStream`: `ERROR(/PrintStream)` المطلوب استخدامه

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

resolveDynamicOptions

public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

حلّ خيارات ERROR(/File) التي تشير إلى موقع جغرافي بعيد يتطلب ذلك استدعاء cleanConfigurationData() لتنظيف الملفات.

المعلمات
`resolver`	`DynamicRemoteFileResolver`: `DynamicRemoteFileResolver` لحلّ المشاكل في الملفات

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

safeInjectOptionValues

public abstract void safeInjectOptionValues ( optionDefs)

إدراج قيم خيارات متعددة في مجموعة عناصر الضبط بدون طرح خطأ في حال تعذّر تطبيق أحد الخيارات

وهي مفيدة لإدخال العديد من قيم الخيارات في آنٍ واحد بعد إنشاء عنصر جديد.

المعلمات
`optionDefs`	: قائمة بتعريفات الخيارات المطلوب إدراجها

عمليات الرمي
`ConfigurationException`	في حال تعذّر إنشاء `OptionSetter`

setBestEffortOptionsFromCommandLineArgs

public abstract  setBestEffortOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

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

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

المعلمات
`listArgs`	: وسيطات سطر الأوامر
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` لاستخدامها.

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

عمليات الرمي
`ConfigurationException`

setBuildProvider

public abstract void setBuildProvider (IBuildProvider provider)

استبدِل IBuildProvider الحالي في الإعدادات.

المعلمات
`provider`	`IBuildProvider`: `IBuildProvider` الجديدة

setCommandLine

public abstract void setCommandLine (String[] arrayArgs)

لضبط سطر الأوامر المستخدَم لإنشاء هذا IConfiguration. يخزّن هذا الإجراء سطر الأوامر بأكمله، بما في ذلك اسم الإعداد، على عكس setOptionsFromCommandLineArgs.

المعلمات
`arrayArgs`	`String`: سطر الأوامر

setCommandOptions

public abstract void setCommandOptions (ICommandOptions cmdOptions)

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

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

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

المعلمات
`name`	‫`String`: الاسم الفريد لنوع عنصر الإعدادات
`configObject`	`Object`: عنصر الضبط

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

setConfigurationObjectList

public abstract void setConfigurationObjectList (String name, 
                 configList)

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

المعلمات
`name`	‫`String`: الاسم الفريد لنوع عنصر الإعدادات
`configList`	: قائمة عناصر الإعدادات

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

setCoverageOptions

public abstract void setCoverageOptions (CoverageOptions coverageOptions)

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

المعلمات
`coverageOptions`	`CoverageOptions`

setDeviceConfig

public abstract void setDeviceConfig (IDeviceConfiguration deviceConfig)

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

setDeviceConfigList

public abstract void setDeviceConfigList ( deviceConfigs)

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

setDeviceMetricCollectors

public abstract void setDeviceMetricCollectors ( collectors)

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

المعلمات
`collectors`

setDeviceOptions

public abstract void setDeviceOptions (TestDeviceOptions deviceOptions)

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

المعلمات
`deviceOptions`	`TestDeviceOptions`

setDeviceRecovery

public abstract void setDeviceRecovery (IDeviceRecovery recovery)

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

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

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

setLabPreparer

public abstract void setLabPreparer (ITargetPreparer preparer)

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

setLabPreparers

public abstract void setLabPreparers ( preparers)

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

setLogOutput

public abstract void setLogOutput (ILeveledLogOutput logger)

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

setLogSaver

public abstract void setLogSaver (ILogSaver logSaver)

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

setMultiPreTargetPreparer

public abstract void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPreps)

طريقة سهلة لضبط IMultiTargetPreparer واحد في هذه الإعدادات التي يجب تنفيذها قبل أيّ من أدوات إعداد الأجهزة target_preparers، مع استبدال أيّ قيم حالية

setMultiPreTargetPreparers

public abstract void setMultiPreTargetPreparers ( multiPreTargPreps)

اضبط قائمة IMultiTargetPreparer في هذه الإعدادات التي يجب تنفيذها قبل أي من أدوات target_preparers للأجهزة، مع استبدال أي قيم حالية.

setMultiTargetPreparer

public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

طريقة سهلة لضبط IMultiTargetPreparer واحد في هذه الإعدادات، مع استبدال أي قيم حالية

setMultiTargetPreparers

public abstract void setMultiTargetPreparers ( multiTargPreps)

اضبط قائمة IMultiTargetPreparer في هذه الإعدادات، مع استبدال أي قيم حالية.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

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

‫ArgsOptionParser للتنسيق المتوقّع

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

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

عمليات الرمي
`ConfigurationException`

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

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

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

المعلمات
`listArgs`	: وسيطات سطر الأوامر
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` لاستخدامها.

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

عمليات الرمي
`ConfigurationException`

setPostProcessors

public abstract void setPostProcessors ( processors)

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

المعلمات
`processors`

setRetryDecision

public abstract void setRetryDecision (IRetryDecision decisionRetry)

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

setSystemStatusChecker

public abstract void setSystemStatusChecker (ISystemStatusChecker systemChecker)

طريقة سهلة لضبط ISystemStatusChecker واحد في هذه الإعدادات، مع استبدال أي قيم حالية

setSystemStatusCheckers

public abstract void setSystemStatusCheckers ( systemCheckers)

اضبط قائمة ISystemStatusChecker في هذه الإعدادات، مع استبدال أي قيم حالية.

setTargetPreparer

public abstract void setTargetPreparer (ITargetPreparer preparer)

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

setTargetPreparers

public abstract void setTargetPreparers ( preparers)

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

setTest

public abstract void setTest (IRemoteTest test)

طريقة سهلة لضبط IRemoteTest واحد في هذه الإعدادات، مع استبدال أي قيم حالية

setTestInvocationListener

public abstract void setTestInvocationListener (ITestInvocationListener listener)

طريقة سهلة لضبط ITestInvocationListener واحد

setTestInvocationListeners

public abstract void setTestInvocationListeners ( listeners)

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

setTests

public abstract void setTests ( tests)

اضبط قائمة IRemoteTest في هذه الإعدادات، مع استبدال أي قيم حالية.

validateOptions

public abstract void validateOptions ()

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

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

عمليات الرمي
`ConfigurationException`	if config is not valid