IConfiguration

public interface IConfiguration

com.android.tradefed.config.IConfiguration

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

ملخّص

الإجراءات العامة

abstract void addFilesToClean(Set<File> toBeCleaned)

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

abstract void cleanConfigurationData()

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

abstract IConfiguration clone()

إنشاء نسخة سطحية من هذا العنصر

abstract void dumpXml(PrintWriter output)

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

abstract void dumpXml(PrintWriter output, List<String> excludeFilters)

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

abstract void dumpXml(PrintWriter output, List<String> excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)

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

abstract Collection<Object> 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 List<?> getConfigurationObjectList(String typeName)

مشابهة لـ getConfigurationObject(String)، ولكن لأنواع عناصر الإعداد التي تتوافق مع عناصر متعددة.

abstract CoverageOptions getCoverageOptions()

تعرض هذه السمة CoverageOptions المطلوب استخدامه من الإعداد.

abstract List<IDeviceConfiguration> getDeviceConfig()

تعرض هذه السمة IDeviceConfiguration من الإعدادات.

abstract IDeviceConfiguration getDeviceConfigByName(String nameDevice)

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

abstract TestDeviceOptions getDeviceOptions()

تعرض هذه السمة TestDeviceOptions المطلوب استخدامه من الإعداد.

abstract IDeviceRecovery getDeviceRecovery()

تعرض هذه السمة IDeviceRecovery المطلوب استخدامه من الإعداد.

abstract IDeviceSelection getDeviceRequirements()

تعرض هذه السمة IDeviceSelection المطلوب استخدامه من الإعداد.

abstract Set<File> getFilesToClean()

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

abstract GlobalTestFilter getGlobalFilters()

تعرض هذه السمة GlobalTestFilter لعملية الاستدعاء.

abstract Set<String> getInopOptions()

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

abstract List<ITargetPreparer> getLabPreparers()

تعرض هذه السمة ITargetPreparer من الإعدادات.

abstract ILeveledLogOutput getLogOutput()

تعرض هذه السمة ILeveledLogOutput المطلوب استخدامه من الإعداد.

abstract ILogSaver getLogSaver()

تعرض هذه السمة ILogSaver المطلوب استخدامه من الإعداد.

abstract List<IMetricCollector> getMetricCollectors()

تعرض هذه السمة IMetricCollector من الإعدادات.

abstract List<IMultiTargetPreparer> getMultiPreTargetPreparers()

تعرض هذه السمة IMultiTargetPreparer من عملية الضبط التي يجب تنفيذها قبل أي من target_preparers للأجهزة.

abstract List<IMultiTargetPreparer> getMultiTargetPreparers()

تعرض هذه السمة IMultiTargetPreparer من الإعدادات.

abstract String getName()

تعرِض هذه السمة اسم الإعداد.

abstract List<IPostProcessor> getPostProcessors()

تعرض هذه السمة IPostProcessor من الإعدادات.

abstract IRetryDecision getRetryDecision()

تعرض هذه السمة IRetryDecision المستخدَم في عملية الاستدعاء.

abstract SkipManager getSkipManager()

تعرض هذه السمة SkipManager لعملية الاستدعاء.

abstract List<ISystemStatusChecker> getSystemStatusCheckers()

تعرض هذه السمة ISystemStatusChecker من الإعدادات.

abstract List<ITargetPreparer> getTargetPreparers()

تعرض هذه السمة ITargetPreparer من الإعدادات.

abstract List<ITestInvocationListener> getTestInvocationListeners()

تعرض هذه السمة ITestInvocationListener المطلوب استخدامه من الإعدادات.

abstract List<IRemoteTest> getTests()

تعرض هذه السمة IRemoteTests ليتم تشغيلها من الإعداد.

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(List<OptionDef> optionDefs)

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

abstract boolean isDeviceConfiguredFake(String deviceName)

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

abstract IConfiguration partialDeepClone(List<String> objectToDeepClone, IKeyStoreClient client)

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

abstract void printCommandUsage(boolean importantOnly, PrintStream out)

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

abstract void resolveDynamicOptions(DynamicRemoteFileResolver resolver)

حلّ خيارات File التي تشير إلى موقع جغرافي بعيد

abstract void safeInjectOptionValues(List<OptionDef> optionDefs)

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

abstract List<String> setBestEffortOptionsFromCommandLineArgs(List<String> listArgs, IKeyStoreClient keyStoreClient)

اضبط حقول 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, List<?> configList)

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

abstract void setCoverageOptions(CoverageOptions coverageOptions)

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

abstract void setDeviceConfig(IDeviceConfiguration deviceConfig)

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

abstract void setDeviceConfigList(List<IDeviceConfiguration> deviceConfigs)

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

abstract void setDeviceMetricCollectors(List<IMetricCollector> 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(List<ITargetPreparer> 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(List<IMultiTargetPreparer> multiPreTargPreps)

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

abstract void setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)

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

abstract void setMultiTargetPreparers(List<IMultiTargetPreparer> multiTargPreps)

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

abstract List<String> setOptionsFromCommandLineArgs(List<String> listArgs)

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

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

abstract List<String> setOptionsFromCommandLineArgs(List<String> listArgs, IKeyStoreClient keyStoreClient)

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

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

abstract void setPostProcessors(List<IPostProcessor> processors)

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

abstract void setRetryDecision(IRetryDecision decisionRetry)

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

abstract void setSkipManager(SkipManager skipManager)

تضبط هذه السمة SkipManager لعملية الاستدعاء.

abstract void setSystemStatusChecker(ISystemStatusChecker systemChecker)

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

abstract void setSystemStatusCheckers(List<ISystemStatusChecker> systemCheckers)

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

abstract void setTargetPreparer(ITargetPreparer preparer)

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

abstract void setTargetPreparers(List<ITargetPreparer> preparers)

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

abstract void setTest(IRemoteTest test)

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

abstract void setTestInvocationListener(ITestInvocationListener listener)

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

abstract void setTestInvocationListeners(List<ITestInvocationListener> listeners)

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

abstract void setTests(List<IRemoteTest> tests)

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

abstract void validateOptions()

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

الإجراءات العامة

addFilesToClean

public abstract void addFilesToClean (Set<File> toBeCleaned)

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

المعلَمات
toBeCleaned Set

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 إليه.
عمليات الطرح
java.io.IOException
IOException

dumpXml

public abstract void dumpXml (PrintWriter output, 
                List<String> excludeFilters)

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

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

المعلَمات
output ‫PrintWriter: الكاتب الذي سيتم طباعة ملف XML إليه.
excludeFilters List: قائمة بأنواع العناصر التي يجب عدم تفريغها
عمليات الطرح
java.io.IOException
IOException

dumpXml

public abstract void dumpXml (PrintWriter output, 
                List<String> excludeFilters, 
                boolean printDeprecatedOptions, 
                boolean printUnchangedOptions)

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

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

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

عمليات الطرح
java.io.IOException
IOException

getAllConfigurationObjectsOfType

public abstract Collection<Object> getAllConfigurationObjectsOfType (String typeName)

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

المعلَمات
typeName ‫String: النوع الفريد لعنصر الإعداد
المرتجعات
Collection<Object> قائمة بكائنات الإعدادات من النوع المحدّد

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 List<?> getConfigurationObjectList (String typeName)

مشابهة لـ getConfigurationObject(String)، ولكن لأنواع عناصر الإعداد التي تتوافق مع عناصر متعددة.

المعلَمات
typeName String: اسم النوع الفريد لعنصر الإعدادات
المرتجعات
List<?> قائمة عناصر الإعدادات أو null إذا كان نوع العنصر الذي يحمل الاسم المحدّد غير متوفّر.

getCoverageOptions

public abstract CoverageOptions getCoverageOptions ()

تعرض هذه السمة CoverageOptions المطلوب استخدامه من الإعداد.

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

getDeviceConfig

public abstract List<IDeviceConfiguration> getDeviceConfig ()

تعرض هذه السمة IDeviceConfiguration من الإعدادات.

المرتجعات
List<IDeviceConfiguration> IDeviceConfigurations المقدَّمة بالترتيب في الإعدادات

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 Set<File> getFilesToClean ()

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

المرتجعات
Set<File>

getGlobalFilters

public abstract GlobalTestFilter getGlobalFilters ()

تعرض هذه السمة GlobalTestFilter لعملية الاستدعاء.

المرتجعات
GlobalTestFilter

getInopOptions

public abstract Set<String> getInopOptions ()

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

المرتجعات
Set<String>

getLabPreparers

public abstract List<ITargetPreparer> getLabPreparers ()

تعرض هذه السمة ITargetPreparer من الإعدادات.

المرتجعات
List<ITargetPreparer> ITargetPreparers المقدَّمة بالترتيب في الإعدادات

getLogOutput

public abstract ILeveledLogOutput getLogOutput ()

تعرض هذه السمة ILeveledLogOutput المطلوب استخدامه من الإعداد.

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

getLogSaver

public abstract ILogSaver getLogSaver ()

تعرض هذه السمة ILogSaver المطلوب استخدامه من الإعداد.

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

getMetricCollectors

public abstract List<IMetricCollector> getMetricCollectors ()

تعرض هذه السمة IMetricCollector من الإعدادات.

المرتجعات
List<IMetricCollector>

getMultiPreTargetPreparers

public abstract List<IMultiTargetPreparer> getMultiPreTargetPreparers ()

تعرض هذه السمة IMultiTargetPreparer من عملية الضبط التي يجب تنفيذها قبل أي من target_preparers للأجهزة.

المرتجعات
List<IMultiTargetPreparer> IMultiTargetPreparers المقدَّمة بالترتيب في الإعدادات

getMultiTargetPreparers

public abstract List<IMultiTargetPreparer> getMultiTargetPreparers ()

تعرض هذه السمة IMultiTargetPreparer من الإعدادات.

المرتجعات
List<IMultiTargetPreparer> IMultiTargetPreparers المقدَّمة بالترتيب في الإعدادات

getName

public abstract String getName ()

تعرِض هذه السمة اسم الإعداد.

المرتجعات
String

getPostProcessors

public abstract List<IPostProcessor> getPostProcessors ()

تعرض هذه السمة IPostProcessor من الإعدادات.

المرتجعات
List<IPostProcessor>

getRetryDecision

public abstract IRetryDecision getRetryDecision ()

تعرض هذه السمة IRetryDecision المستخدَم في عملية الاستدعاء.

المرتجعات
IRetryDecision

getSkipManager

public abstract SkipManager getSkipManager ()

تعرض هذه السمة SkipManager لعملية الاستدعاء.

المرتجعات
SkipManager

getSystemStatusCheckers

public abstract List<ISystemStatusChecker> getSystemStatusCheckers ()

تعرض هذه السمة ISystemStatusChecker من الإعدادات.

المرتجعات
List<ISystemStatusChecker> ISystemStatusCheckers المقدَّمة بالترتيب في الإعدادات

getTargetPreparers

public abstract List<ITargetPreparer> getTargetPreparers ()

تعرض هذه السمة ITargetPreparer من الإعدادات.

المرتجعات
List<ITargetPreparer> ITargetPreparers المقدَّمة بالترتيب في الإعدادات

getTestInvocationListeners

public abstract List<ITestInvocationListener> getTestInvocationListeners ()

تعرض هذه السمة ITestInvocationListener المطلوب استخدامه من الإعدادات.

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

getTests

public abstract List<IRemoteTest> getTests ()

تعرض هذه السمة IRemoteTests ليتم تشغيلها من الإعداد.

المرتجعات
List<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 (List<OptionDef> optionDefs)

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

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

المعلَمات
optionDefs ‫List: قائمة بتعريفات الخيارات المطلوب إدخالها
عمليات الطرح
ConfigurationException في حال تعذّر ضبط قيم الخيار

isDeviceConfiguredFake

public abstract boolean isDeviceConfiguredFake (String deviceName)

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

المعلَمات
deviceName String

المرتجعات
boolean

partialDeepClone

public abstract IConfiguration partialDeepClone (List<String> objectToDeepClone, 
                IKeyStoreClient client)

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

المعلَمات
objectToDeepClone ‫List: قائمة بعناصر الإعدادات التي سيتم استنساخها بشكل كامل.
client ‫IKeyStoreClient: تمثّل هذه السمة عميل ملف تخزين المفاتيح.
المرتجعات
IConfiguration الإعدادات التي تم استنساخها جزئيًا
عمليات الطرح
com.android.tradefed.config.ConfigurationException
ConfigurationException

printCommandUsage

public abstract void printCommandUsage (boolean importantOnly, 
                PrintStream out)

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

المعلَمات
importantOnly boolean: إذا كان true يطبع المساعدة للخيارات المهمة فقط
out PrintStream: PrintStream المطلوب استخدامه
عمليات الطرح
com.android.tradefed.config.ConfigurationException
ConfigurationException

resolveDynamicOptions

public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

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

المعلَمات
resolver DynamicRemoteFileResolver: DynamicRemoteFileResolver لحلّ الملفات
عمليات الطرح
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
BuildRetrievalError
ConfigurationException

safeInjectOptionValues

public abstract void safeInjectOptionValues (List<OptionDef> optionDefs)

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

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

المعلَمات
optionDefs ‫List: قائمة بتعريفات الخيارات المطلوب إدخالها
عمليات الطرح
ConfigurationException في حال تعذّر إنشاء OptionSetter

setBestEffortOptionsFromCommandLineArgs

public abstract List<String> setBestEffortOptionsFromCommandLineArgs (List<String> listArgs, 
                IKeyStoreClient keyStoreClient)

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

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

المعلَمات
listArgs ‫List: وسيطات سطر الأوامر
keyStoreClient ‫IKeyStoreClient: IKeyStoreClient لاستخدامها.
المرتجعات
List<String> الوسيطات غير المستخدَمة
عمليات الطرح
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, 
                List<?> configList)

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

المعلَمات
name String: الاسم الفريد لنوع عنصر الإعدادات.
configList ‫List: قائمة عناصر الإعدادات
عمليات الطرح
ConfigurationException إذا كانت أي عناصر في القائمة من النوع غير الصحيح

setCoverageOptions

public abstract void setCoverageOptions (CoverageOptions coverageOptions)

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

المعلَمات
coverageOptions CoverageOptions

setDeviceConfig

public abstract void setDeviceConfig (IDeviceConfiguration deviceConfig)

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

setDeviceConfigList

public abstract void setDeviceConfigList (List<IDeviceConfiguration> deviceConfigs)

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

setDeviceMetricCollectors

public abstract void setDeviceMetricCollectors (List<IMetricCollector> collectors)

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

المعلَمات
collectors List

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 (List<ITargetPreparer> 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 (List<IMultiTargetPreparer> multiPreTargPreps)

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

setMultiTargetPreparer

public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

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

setMultiTargetPreparers

public abstract void setMultiTargetPreparers (List<IMultiTargetPreparer> multiTargPreps)

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

setOptionsFromCommandLineArgs

public abstract List<String> setOptionsFromCommandLineArgs (List<String> listArgs)

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

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

المعلَمات
listArgs ‫List: وسيطات سطر الأوامر
المرتجعات
List<String> الوسيطات غير المستخدَمة
عمليات الطرح
ConfigurationException

setOptionsFromCommandLineArgs

public abstract List<String> setOptionsFromCommandLineArgs (List<String> listArgs, 
                IKeyStoreClient keyStoreClient)

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

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

المعلَمات
listArgs ‫List: وسيطات سطر الأوامر
keyStoreClient ‫IKeyStoreClient: IKeyStoreClient لاستخدامها.
المرتجعات
List<String> الوسيطات غير المستخدَمة
عمليات الطرح
ConfigurationException

setPostProcessors

public abstract void setPostProcessors (List<IPostProcessor> processors)

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

المعلَمات
processors List

setRetryDecision

public abstract void setRetryDecision (IRetryDecision decisionRetry)

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

setSkipManager

public abstract void setSkipManager (SkipManager skipManager)

تضبط هذه السمة SkipManager لعملية الاستدعاء.

المعلَمات
skipManager SkipManager

setSystemStatusChecker

public abstract void setSystemStatusChecker (ISystemStatusChecker systemChecker)

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

setSystemStatusCheckers

public abstract void setSystemStatusCheckers (List<ISystemStatusChecker> systemCheckers)

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

setTargetPreparer

public abstract void setTargetPreparer (ITargetPreparer preparer)

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

setTargetPreparers

public abstract void setTargetPreparers (List<ITargetPreparer> preparers)

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

setTest

public abstract void setTest (IRemoteTest test)

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

setTestInvocationListener

public abstract void setTestInvocationListener (ITestInvocationListener listener)

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

setTestInvocationListeners

public abstract void setTestInvocationListeners (List<ITestInvocationListener> listeners)

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

setTests

public abstract void setTests (List<IRemoteTest> tests)

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

validateOptions

public abstract void validateOptions ()

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

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

عمليات الطرح
ConfigurationException إذا كانت الإعدادات غير صالحة