اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

الإعداد

public class Configuration
extends Object implements IConfiguration

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

تنفيذ IConfiguration ملموس يخزّن عناصر الإعدادات التي تم تحميلها في خريطة.

ملخّص

الثوابت
`String`	`BUILD_PROVIDER_TYPE_NAME`
`String`	`CMD_OPTIONS_TYPE_NAME`
`String`	`CONFIGURATION_DESCRIPTION_TYPE_NAME`
`String`	`COVERAGE_OPTIONS_TYPE_NAME`
`String`	`DEVICE_METRICS_COLLECTOR_TYPE_NAME`
`String`	`DEVICE_NAME`
`String`	`DEVICE_OPTIONS_TYPE_NAME`
`String`	`DEVICE_RECOVERY_TYPE_NAME`
`String`	`DEVICE_REQUIREMENTS_TYPE_NAME`
`String`	`GLOBAL_FILTERS_TYPE_NAME`
`String`	`LAB_PREPARER_TYPE_NAME`
`String`	`LOGGER_TYPE_NAME`
`String`	`LOG_SAVER_TYPE_NAME`
`String`	`METRIC_POST_PROCESSOR_TYPE_NAME`
`String`	`MULTI_PREPARER_TYPE_NAME`
`String`	`MULTI_PRE_TARGET_PREPARER_TYPE_NAME`
`String`	`RESULT_REPORTER_TYPE_NAME`
`String`	`RETRY_DECISION_TYPE_NAME`
`String`	`SANBOX_OPTIONS_TYPE_NAME`
`String`	`SANDBOX_TYPE_NAME`
`String`	`SKIP_MANAGER_TYPE_NAME`
`String`	`SYSTEM_STATUS_CHECKER_TYPE_NAME`
`String`	`TARGET_PREPARER_TYPE_NAME`
`String`	`TEST_TYPE_NAME`

الحقول
`public static final Set<String>`	`NON_MODULE_OBJECTS`

طُرق وضع التصميم العامة
`Configuration(String name, String description)` تنشئ هذه الدالة `Configuration` مع كائنات الإعداد التلقائي.

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

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

الثوابت

BUILD_PROVIDER_TYPE_NAME

public static final String BUILD_PROVIDER_TYPE_NAME

القيمة الثابتة: "build_provider"

CMD_OPTIONS_TYPE_NAME

public static final String CMD_OPTIONS_TYPE_NAME

القيمة الثابتة: "cmd_options"

CONFIGURATION_DESCRIPTION_TYPE_NAME

public static final String CONFIGURATION_DESCRIPTION_TYPE_NAME

Constant Value: "config_desc"

COVERAGE_OPTIONS_TYPE_NAME

public static final String COVERAGE_OPTIONS_TYPE_NAME

Constant Value: "coverage"

DEVICE_METRICS_COLLECTOR_TYPE_NAME

public static final String DEVICE_METRICS_COLLECTOR_TYPE_NAME

القيمة الثابتة: "metrics_collector"

DEVICE_NAME

public static final String DEVICE_NAME

القيمة الثابتة: "device"

DEVICE_OPTIONS_TYPE_NAME

public static final String DEVICE_OPTIONS_TYPE_NAME

القيمة الثابتة: "device_options"

DEVICE_RECOVERY_TYPE_NAME

public static final String DEVICE_RECOVERY_TYPE_NAME

القيمة الثابتة: "device_recovery"

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

القيمة الثابتة: "device_requirements"

GLOBAL_FILTERS_TYPE_NAME

public static final String GLOBAL_FILTERS_TYPE_NAME

Constant Value: "global_filters"

LAB_PREPARER_TYPE_NAME

public static final String LAB_PREPARER_TYPE_NAME

Constant Value: "lab_preparer"

LOGGER_TYPE_NAME

public static final String LOGGER_TYPE_NAME

Constant Value: "logger"

LOG_SAVER_TYPE_NAME

public static final String LOG_SAVER_TYPE_NAME

القيمة الثابتة: "log_saver"

METRIC_POST_PROCESSOR_TYPE_NAME

public static final String METRIC_POST_PROCESSOR_TYPE_NAME

القيمة الثابتة: "metric_post_processor"

MULTI_PREPARER_TYPE_NAME

public static final String MULTI_PREPARER_TYPE_NAME

القيمة الثابتة: "multi_target_preparer"

MULTI_PRE_TARGET_PREPARER_TYPE_NAME

public static final String MULTI_PRE_TARGET_PREPARER_TYPE_NAME

القيمة الثابتة: "multi_pre_target_preparer"

RESULT_REPORTER_TYPE_NAME

public static final String RESULT_REPORTER_TYPE_NAME

القيمة الثابتة: "result_reporter"

RETRY_DECISION_TYPE_NAME

public static final String RETRY_DECISION_TYPE_NAME

القيمة الثابتة: "retry_decision"

SANBOX_OPTIONS_TYPE_NAME

public static final String SANBOX_OPTIONS_TYPE_NAME

القيمة الثابتة: "sandbox_options"

SANDBOX_TYPE_NAME

public static final String SANDBOX_TYPE_NAME

القيمة الثابتة: "sandbox"

SKIP_MANAGER_TYPE_NAME

public static final String SKIP_MANAGER_TYPE_NAME

القيمة الثابتة: "skip_manager"

SYSTEM_STATUS_CHECKER_TYPE_NAME

public static final String SYSTEM_STATUS_CHECKER_TYPE_NAME

القيمة الثابتة: "system_checker"

TARGET_PREPARER_TYPE_NAME

public static final String TARGET_PREPARER_TYPE_NAME

القيمة الثابتة: "target_preparer"

TEST_TYPE_NAME

public static final String TEST_TYPE_NAME

Constant Value: "test"

الحقول

NON_MODULE_OBJECTS

public static final Set<String> NON_MODULE_OBJECTS

طُرق وضع التصميم العامة

الإعداد

public Configuration (String name, 
                String description)

تنشئ هذه الدالة Configuration مع كائنات الإعداد التلقائي.

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

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

addFilesToClean

public void addFilesToClean (Set<File> toBeCleaned)

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

المعلَمات
`toBeCleaned`	`Set`

cleanConfigurationData

public void cleanConfigurationData ()

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

استنساخ

public Configuration clone ()

تنشئ هذه الطريقة نسخة سطحية من هذا العنصر.

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

dumpXml

public void dumpXml (PrintWriter output)

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

المعلَمات
`output`	‫`PrintWriter`: الكاتب الذي سيتم طباعة ملف XML إليه.

عمليات الطرح
`IOException`

dumpXml

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

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

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

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

عمليات الطرح
`IOException`

dumpXml

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

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

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

عمليات الطرح
`IOException`

getAllConfigurationObjectsOfType

public Collection<Object> getAllConfigurationObjectsOfType (String configType)

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

المعلَمات
`configType`	‫`String`: النوع الفريد لعنصر الإعداد

المرتجعات
`Collection<Object>`	قائمة بكائنات الإعدادات من النوع المحدّد

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

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

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

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

getCoverageOptions

public CoverageOptions getCoverageOptions ()

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

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

getDescription

public String getDescription ()

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

getDeviceConfig

public List<IDeviceConfiguration> getDeviceConfig ()

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

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

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

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

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

getGlobalFilters

public GlobalTestFilter getGlobalFilters ()

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

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

getInopOptions

public Set<String> getInopOptions ()

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

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

getLabPreparers

public List<ITargetPreparer> getLabPreparers ()

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

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

getLogOutput

public ILeveledLogOutput getLogOutput ()

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

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

getLogSaver

public ILogSaver getLogSaver ()

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

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

getMetricCollectors

public List<IMetricCollector> getMetricCollectors ()

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

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

getMultiDeviceSupportedTag

public static Set<String> getMultiDeviceSupportedTag ()

عرض Set للعلامات المتوافقة في علامة جهاز لإعداد أجهزة متعددة

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

getMultiPreTargetPreparers

public List<IMultiTargetPreparer> getMultiPreTargetPreparers ()

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

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

getMultiTargetPreparers

public List<IMultiTargetPreparer> getMultiTargetPreparers ()

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

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

getName

public String getName ()

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

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

getPostProcessors

public List<IPostProcessor> getPostProcessors ()

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

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

getRetryDecision

public IRetryDecision getRetryDecision ()

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

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

getSkipManager

public SkipManager getSkipManager ()

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

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

getSystemStatusCheckers

public List<ISystemStatusChecker> getSystemStatusCheckers ()

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

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

getTargetPreparers

public List<ITargetPreparer> getTargetPreparers ()

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

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

getTestInvocationListeners

public List<ITestInvocationListener> getTestInvocationListeners ()

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

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

getTests

public List<IRemoteTest> getTests ()

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

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

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

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

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

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

isDeviceConfiguredFake

public boolean isDeviceConfiguredFake (String deviceName)

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

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

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

partialDeepClone

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

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

المعلَمات
`objectToDeepClone`	‫`List`: قائمة بعناصر الإعدادات التي سيتم استنساخها بشكل كامل.
`client`	‫`IKeyStoreClient`: تمثّل هذه السمة عميل ملف تخزين المفاتيح.

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

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

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

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

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

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

resolveDynamicOptions

public void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

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

المعلَمات
`resolver`	`DynamicRemoteFileResolver`: `DynamicRemoteFileResolver` لحلّ الملفات

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

safeInjectOptionValues

public void safeInjectOptionValues (List<OptionDef> optionDefs)

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

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

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

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

setBestEffortOptionsFromCommandLineArgs

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

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

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

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

المرتجعات
`List<String>`	الوسيطات غير المستخدَمة

عمليات الطرح
`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, 
                List<?> configList)

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

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

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

setCoverageOptions

public void setCoverageOptions (CoverageOptions coverageOptions)

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

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

setDeviceConfig

public void setDeviceConfig (IDeviceConfiguration deviceConfig)

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

setDeviceConfigList

public void setDeviceConfigList (List<IDeviceConfiguration> deviceConfigs)

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

setDeviceMetricCollectors

public void setDeviceMetricCollectors (List<IMetricCollector> collectors)

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

المعلَمات
`collectors`	`List`

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

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

setMultiTargetPreparer

public void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

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

setMultiTargetPreparers

public void setMultiTargetPreparers (List<IMultiTargetPreparer> multiTargPreps)

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

setOptionsFromCommandLineArgs

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

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

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

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

المرتجعات
`List<String>`	الوسيطات غير المستخدَمة

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

setOptionsFromCommandLineArgs

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

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

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

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

المرتجعات
`List<String>`	الوسيطات غير المستخدَمة

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

setPostProcessors

public void setPostProcessors (List<IPostProcessor> processors)

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

المعلَمات
`processors`	`List`

setRetryDecision

public void setRetryDecision (IRetryDecision decisionRetry)

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

setSkipManager

public void setSkipManager (SkipManager skipManager)

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

المعلَمات
`skipManager`	`SkipManager`

setSystemStatusChecker

public void setSystemStatusChecker (ISystemStatusChecker systemChecker)

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

setSystemStatusCheckers

public void setSystemStatusCheckers (List<ISystemStatusChecker> systemCheckers)

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

setTargetPreparer

public void setTargetPreparer (ITargetPreparer preparer)

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

setTargetPreparers

public void setTargetPreparers (List<ITargetPreparer> preparers)

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

setTest

public void setTest (IRemoteTest test)

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

setTestInvocationListener

public void setTestInvocationListener (ITestInvocationListener listener)

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

setTestInvocationListeners

public void setTestInvocationListeners (List<ITestInvocationListener> listeners)

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

setTests

public void setTests (List<IRemoteTest> tests)

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

validateOptions

public void validateOptions ()

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

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

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

طُرق محمية

isRemoteEnvironment

protected boolean isRemoteEnvironment ()

تعرِض هذه السمة ما إذا كانت بيئة TensorFlow عبارة عن استدعاء عن بُعد.

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