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

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

الإعدادات

public class Configuration
extends Object implements IConfiguration

java.lang.Object
↳	com.android.tradefed.config.Configuration

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

ملخّص

الحقول
`public static final String`	`BUILD_PROVIDER_TYPE_NAME`
`public static final String`	`CMD_OPTIONS_TYPE_NAME`
`public static final String`	`CONFIGURATION_DESCRIPTION_TYPE_NAME`
`public static final String`	`COVERAGE_OPTIONS_TYPE_NAME`
`public static final String`	`DEVICE_METRICS_COLLECTOR_TYPE_NAME`
`public static final String`	`DEVICE_NAME`
`public static final String`	`DEVICE_OPTIONS_TYPE_NAME`
`public static final String`	`DEVICE_RECOVERY_TYPE_NAME`
`public static final String`	`DEVICE_REQUIREMENTS_TYPE_NAME`
`public static final String`	`GLOBAL_FILTERS_TYPE_NAME`
`public static final String`	`LAB_PREPARER_TYPE_NAME`
`public static final String`	`LOGGER_TYPE_NAME`
`public static final String`	`LOG_SAVER_TYPE_NAME`
`public static final String`	`METRIC_POST_PROCESSOR_TYPE_NAME`
`public static final String`	`MULTI_PREPARER_TYPE_NAME`
`public static final String`	`MULTI_PRE_TARGET_PREPARER_TYPE_NAME`
`public static final`	`NON_MODULE_OBJECTS`
`public static final String`	`RESULT_REPORTER_TYPE_NAME`
`public static final String`	`RETRY_DECISION_TYPE_NAME`
`public static final String`	`SANBOX_OPTIONS_TYPE_NAME`
`public static final String`	`SANDBOX_TYPE_NAME`
`public static final String`	`SKIP_MANAGER_TYPE_NAME`
`public static final String`	`SYSTEM_STATUS_CHECKER_TYPE_NAME`
`public static final String`	`TARGET_PREPARER_TYPE_NAME`
`public static final String`	`TEST_TYPE_NAME`

وظائف الإنشاء العامة
`Configuration(String name, String description)` تُنشئ `Configuration` باستخدام كائنات الإعدادات التلقائية.

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

الطرق المحمية
`boolean`	`isRemoteEnvironment()` لعرض ما إذا كانت بيئة TF هي طلب تشغيل عن بُعد أم لا.

الحقول

BUILD_PROVIDER_TYPE_NAME

public static final String BUILD_PROVIDER_TYPE_NAME

CMD_OPTIONS_TYPE_NAME

public static final String CMD_OPTIONS_TYPE_NAME

CONFIGURATION_DESCRIPTION_TYPE_NAME

public static final String CONFIGURATION_DESCRIPTION_TYPE_NAME

COVERAGE_OPTIONS_TYPE_NAME

public static final String COVERAGE_OPTIONS_TYPE_NAME

DEVICE_METRICS_COLLECTOR_TYPE_NAME

public static final String DEVICE_METRICS_COLLECTOR_TYPE_NAME

DEVICE_NAME

public static final String DEVICE_NAME

DEVICE_OPTIONS_TYPE_NAME

public static final String DEVICE_OPTIONS_TYPE_NAME

DEVICE_RECOVERY_TYPE_NAME

public static final String DEVICE_RECOVERY_TYPE_NAME

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

GLOBAL_FILTERS_TYPE_NAME

public static final String GLOBAL_FILTERS_TYPE_NAME

LAB_PREPARER_TYPE_NAME

public static final String LAB_PREPARER_TYPE_NAME

LOGGER_TYPE_NAME

public static final String LOGGER_TYPE_NAME

LOG_SAVER_TYPE_NAME

public static final String LOG_SAVER_TYPE_NAME

METRIC_POST_PROCESSOR_TYPE_NAME

public static final String METRIC_POST_PROCESSOR_TYPE_NAME

MULTI_PREPARER_TYPE_NAME

public static final String MULTI_PREPARER_TYPE_NAME

MULTI_PRE_TARGET_PREPARER_TYPE_NAME

public static final String MULTI_PRE_TARGET_PREPARER_TYPE_NAME

NON_MODULE_OBJECTS

public static final  NON_MODULE_OBJECTS

RESULT_REPORTER_TYPE_NAME

public static final String RESULT_REPORTER_TYPE_NAME

RETRY_DECISION_TYPE_NAME

public static final String RETRY_DECISION_TYPE_NAME

SANBOX_OPTIONS_TYPE_NAME

public static final String SANBOX_OPTIONS_TYPE_NAME

SANDBOX_TYPE_NAME

public static final String SANDBOX_TYPE_NAME

SKIP_MANAGER_TYPE_NAME

public static final String SKIP_MANAGER_TYPE_NAME

SYSTEM_STATUS_CHECKER_TYPE_NAME

public static final String SYSTEM_STATUS_CHECKER_TYPE_NAME

TARGET_PREPARER_TYPE_NAME

public static final String TARGET_PREPARER_TYPE_NAME

TEST_TYPE_NAME

public static final String TEST_TYPE_NAME

وظائف الإنشاء العامة

الإعدادات

public Configuration (String name, 
                String description)

تُنشئ Configuration باستخدام كائنات الإعدادات التلقائية.

المعلمات
`name`	`String`
`description`	`String`

الطرق العامة

addFilesToClean

public void addFilesToClean ( toBeCleaned)

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

المعلمات
`toBeCleaned`

cleanConfigurationData

public void cleanConfigurationData ()

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

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

public Configuration clone ()

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

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

dumpXml

public void dumpXml (PrintWriter output)

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

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

dumpXml

public void dumpXml (PrintWriter output, 
                 excludeFilters)

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

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

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

dumpXml

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

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

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

getAllConfigurationObjectsOfType

public  getAllConfigurationObjectsOfType (String configType)

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

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

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

getBuildProvider

public IBuildProvider getBuildProvider ()

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

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

getCommandLine

public String getCommandLine ()

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

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

getCommandOptions

public ICommandOptions getCommandOptions ()

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

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

getConfigurationDescription

public ConfigurationDescriptor getConfigurationDescription ()

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

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

getConfigurationObject

public Object getConfigurationObject (String typeName)

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

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

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

getConfigurationObjectList

public  getConfigurationObjectList (String typeName)

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

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

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

getCoverageOptions

public CoverageOptions getCoverageOptions ()

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

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

getDescription

public String getDescription ()

المرتجعات
`String`	وصف موجز يمكن للمستخدم قراءته `Configuration`

getDeviceConfig

public  getDeviceConfig ()

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

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

getDeviceConfigByName

public IDeviceConfiguration getDeviceConfigByName (String nameDevice)

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

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

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

getDeviceOptions

public TestDeviceOptions getDeviceOptions ()

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

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

getDeviceRecovery

public IDeviceRecovery getDeviceRecovery ()

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

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

getDeviceRequirements

public IDeviceSelection getDeviceRequirements ()

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

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

getFilesToClean

public  getFilesToClean ()

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

المرتجعات

getGlobalFilters

public GlobalTestFilter getGlobalFilters ()

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

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

getInopOptions

public  getInopOptions ()

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

المرتجعات

getLabPreparers

public  getLabPreparers ()

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

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

getLogOutput

public ILeveledLogOutput getLogOutput ()

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

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

getLogSaver

public ILogSaver getLogSaver ()

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

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

getMetricCollectors

public  getMetricCollectors ()

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

المرتجعات

getMultiDeviceSupportedTag

public static  getMultiDeviceSupportedTag ()

عرض ERROR(/Set) من العلامات المتوافقة في علامة جهاز لإعداد الأجهزة المتعددة

المرتجعات

getMultiPreTargetPreparers

public  getMultiPreTargetPreparers ()

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

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

getMultiTargetPreparers

public  getMultiTargetPreparers ()

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

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

getName

public String getName ()

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

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

getPostProcessors

public  getPostProcessors ()

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

المرتجعات

getRetryDecision

public IRetryDecision getRetryDecision ()

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

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

getSkipManager

public SkipManager getSkipManager ()

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

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

getSystemStatusCheckers

public  getSystemStatusCheckers ()

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

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

getTargetPreparers

public  getTargetPreparers ()

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

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

getTestInvocationListeners

public  getTestInvocationListeners ()

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

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

getTests

public  getTests ()

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

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

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionValue)

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

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

المعلمات
`optionName`	`String`: اسم الخيار
`optionValue`	‫`String`: قيمة الخيار

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

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

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

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

المعلمات
`optionName`	`String`: اسم الخيار
`optionKey`	`String`: المفتاح الاختياري لخيارات الخريطة، أو قيمة فارغة
`optionValue`	`String`: قيمة خيار الربط

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

injectOptionValueWithSource

public void injectOptionValueWithSource (String optionName, 
                String optionKey, 
                String optionValue, 
                String source)

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

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

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

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

injectOptionValues

public void injectOptionValues ( optionDefs)

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

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

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

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

isDeviceConfiguredFake

public boolean isDeviceConfiguredFake (String deviceName)

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

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

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

partialDeepClone

public IConfiguration partialDeepClone ( objectToDeepClone, 
                IKeyStoreClient client)

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

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

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

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

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

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

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

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

resolveDynamicOptions

public void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

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

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

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

safeInjectOptionValues

public void safeInjectOptionValues ( optionDefs)

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

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

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

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

setBestEffortOptionsFromCommandLineArgs

public  setBestEffortOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

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

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

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

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

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

setBuildProvider

public void setBuildProvider (IBuildProvider provider)

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

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

setCommandLine

public void setCommandLine (String[] arrayArgs)

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

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

setCommandOptions

public void setCommandOptions (ICommandOptions cmdOptions)

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

setConfigurationObject

public void setConfigurationObject (String typeName, 
                Object configObject)

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

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

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

setConfigurationObjectList

public void setConfigurationObjectList (String typeName, 
                 configList)

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

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

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

setCoverageOptions

public void setCoverageOptions (CoverageOptions coverageOptions)

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

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

setDeviceConfig

public void setDeviceConfig (IDeviceConfiguration deviceConfig)

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

setDeviceConfigList

public void setDeviceConfigList ( deviceConfigs)

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

setDeviceMetricCollectors

public void setDeviceMetricCollectors ( collectors)

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

المعلمات
`collectors`

setDeviceOptions

public void setDeviceOptions (TestDeviceOptions devOptions)

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

المعلمات
`devOptions`	`TestDeviceOptions`

setDeviceRecovery

public void setDeviceRecovery (IDeviceRecovery recovery)

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

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

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

setLabPreparer

public void setLabPreparer (ITargetPreparer preparer)

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

setLabPreparers

public void setLabPreparers ( preparers)

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

setLogOutput

public void setLogOutput (ILeveledLogOutput logger)

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

setMultiPreTargetPreparer

public void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPrep)

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

setMultiPreTargetPreparers

public void setMultiPreTargetPreparers ( multiPreTargPreps)

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

setMultiTargetPreparer

public void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

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

setMultiTargetPreparers

public void setMultiTargetPreparers ( multiTargPreps)

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

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

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

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

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

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

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

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

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

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

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

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

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

setPostProcessors

public void setPostProcessors ( processors)

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

المعلمات
`processors`

setRetryDecision

public void setRetryDecision (IRetryDecision decisionRetry)

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

setSystemStatusChecker

public void setSystemStatusChecker (ISystemStatusChecker systemChecker)

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

setSystemStatusCheckers

public void setSystemStatusCheckers ( systemCheckers)

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

setTargetPreparer

public void setTargetPreparer (ITargetPreparer preparer)

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

setTargetPreparers

public void setTargetPreparers ( preparers)

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

setTest

public void setTest (IRemoteTest test)

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

setTestInvocationListener

public void setTestInvocationListener (ITestInvocationListener listener)

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

setTestInvocationListeners

public void setTestInvocationListeners ( listeners)

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

setTests

public void setTests ( tests)

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

validateOptions

public void validateOptions ()

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

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

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

الطرق المحمية

isRemoteEnvironment

protected boolean isRemoteEnvironment ()

لعرض ما إذا كانت بيئة TF هي طلب تشغيل عن بُعد أم لا.

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