החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

IConfiguration

public interface IConfiguration

com.android.tradefed.config.IConfiguration

תת-כיתות עקיפות ידועות

הגדרה

הגדרה הטמעה קונקרטית של IConfiguration שמאחסנת את אובייקטי התצורה שהועלו במפה.

פרטי ההגדרה של קריאה ל-TradeFederation. לכל קריאה ל-TradeFederation יש IConfiguration יחיד. ב-IConfiguration מאוחסנים כל אובייקטי הענקת הגישה שצריך להשתמש בהם במהלך ההפעלה, וגם ה-Option's המשויכים אליהם.

סיכום

שיטות ציבוריות
`abstract void`	`addFilesToClean( toBeCleaned)` הוספת קבצים שצריך לנקות במהלך `cleanConfigurationData()`
`abstract void`	`cleanConfigurationData()` מוחקים את כל הקבצים שהורדתם לשדות האפשרויות של קבצים מרוחקים.
`abstract IConfiguration`	`clone()` יוצרים עותק שטחי של האובייקט הזה.
`abstract void`	`dumpXml(PrintWriter output)` הפונקציה מקבלת את קובץ ה-XML המורחב של התצורה עם כל האפשרויות שמוצגות ל-`IConfiguration` הזה בתור `String`.
`abstract void`	`dumpXml(PrintWriter output, excludeFilters)` הפונקציה מקבלת את קובץ ה-XML המורחב של ההגדרות עם כל האפשרויות שמוצגות ל-`IConfiguration` הזה, בניכוי המסננים של האובייקטים לפי שם המפתח שלהם.
`abstract void`	`dumpXml(PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)` הפונקציה מקבלת את קובץ ה-XML המורחב של ההגדרה עם כל האפשרויות שמוצגות ל-`IConfiguration` הזה, בניכוי מסנני האובייקטים לפי שם המפתח שלהם.
`abstract`	`getAllConfigurationObjectsOfType(String typeName)` ממשק גנרי לקבלת כל האובייקטים של שם סוג נתון במכשירים שונים.
`abstract IBuildProvider`	`getBuildProvider()` הפונקציה מקבלת את `IBuildProvider` מההגדרה.
`abstract String`	`getCommandLine()` הפונקציה מקבלת את שורת הפקודה ששימשה ליצירת `IConfiguration` הזה.
`abstract ICommandOptions`	`getCommandOptions()` הפונקציה מקבלת את `ICommandOptions` לשימוש מהתצורה.
`abstract ConfigurationDescriptor`	`getConfigurationDescription()` הפונקציה מחזירה את הערך של `ConfigurationDescriptor` שצוין בהגדרה.
`abstract Object`	`getConfigurationObject(String typeName)` ממשק גנרי לקבלת אובייקט התצורה עם שם הסוג הנתון.
`abstract`	`getConfigurationObjectList(String typeName)` דומה ל-`getConfigurationObject(String)`, אבל לסוגי אובייקטים של הגדרות שתומכים בכמה אובייקטים.
`abstract CoverageOptions`	`getCoverageOptions()` הפונקציה מקבלת את `CoverageOptions` לשימוש מהתצורה.
`abstract`	`getDeviceConfig()` הפונקציה מקבלת את הערכים של `IDeviceConfiguration` מההגדרה.
`abstract IDeviceConfiguration`	`getDeviceConfigByName(String nameDevice)` הפונקציה מחזירה את הערך של `IDeviceConfiguration` שמשויך לשם שצוין, או ערך null אם לא נמצא.
`abstract TestDeviceOptions`	`getDeviceOptions()` הפונקציה מקבלת את `TestDeviceOptions` לשימוש מהתצורה.
`abstract IDeviceRecovery`	`getDeviceRecovery()` הפונקציה מקבלת את `IDeviceRecovery` לשימוש מהתצורה.
`abstract IDeviceSelection`	`getDeviceRequirements()` הפונקציה מקבלת את `IDeviceSelection` לשימוש מהתצורה.
`abstract`	`getFilesToClean()` הצגת רשימת הקבצים שיימחקו במהלך `cleanConfigurationData()`
`abstract GlobalTestFilter`	`getGlobalFilters()` הפונקציה מקבלת את `GlobalTestFilter` של ההפעלה.
`abstract`	`getInopOptions()` אחזור שמות האפשרויות שלא השתנו בהן ערכים
`abstract`	`getLabPreparers()` הפונקציה מקבלת את הערכים של `ITargetPreparer` מההגדרה.
`abstract ILeveledLogOutput`	`getLogOutput()` הפונקציה מקבלת את `ILeveledLogOutput` לשימוש מהתצורה.
`abstract ILogSaver`	`getLogSaver()` הפונקציה מקבלת את `ILogSaver` לשימוש מהתצורה.
`abstract`	`getMetricCollectors()` הפונקציה מקבלת את הערכים של `IMetricCollector` מההגדרה.
`abstract`	`getMultiPreTargetPreparers()` הפונקציה מקבלת את הערכים של `IMultiTargetPreparer` מההגדרות, שצריך להריץ לפני כל אחד מה-target_preparers של המכשירים.
`abstract`	`getMultiTargetPreparers()` הפונקציה מקבלת את הערכים של `IMultiTargetPreparer` מההגדרה.
`abstract String`	`getName()` הפונקציה מחזירה את שם התצורה.
`abstract`	`getPostProcessors()` הפונקציה מקבלת את הערכים של `IPostProcessor` מההגדרה.
`abstract IRetryDecision`	`getRetryDecision()` הפונקציה מחזירה את `IRetryDecision` ששימש להפעלה.
`abstract SkipManager`	`getSkipManager()` הפונקציה מקבלת את הערך של `SkipManager` לקריאה.
`abstract`	`getSystemStatusCheckers()` הפונקציה מקבלת את הערכים של `ISystemStatusChecker` מההגדרה.
`abstract`	`getTargetPreparers()` הפונקציה מקבלת את הערכים של `ITargetPreparer` מההגדרה.
`abstract`	`getTestInvocationListeners()` הפונקציה מקבלת את הערכים של `ITestInvocationListener` לשימוש מהתצורה.
`abstract`	`getTests()` הפונקציה מקבלת את ה-`IRemoteTest` לריצה מההגדרה.
`abstract void`	`injectOptionValue(String optionName, String optionValue)` הזרקת ערך אפשרות לקבוצת אובייקטי התצורה.
`abstract void`	`injectOptionValue(String optionName, String optionKey, String optionValue)` הזרקת ערך אפשרות לקבוצת אובייקטי התצורה.
`abstract void`	`injectOptionValueWithSource(String optionName, String optionKey, String optionValue, String optionSource)` הזרקת ערך אפשרות לקבוצת אובייקטי התצורה.
`abstract void`	`injectOptionValues( optionDefs)` הזרקה של מספר ערכים של אפשרויות לקבוצת אובייקטי התצורה.
`abstract boolean`	`isDeviceConfiguredFake(String deviceName)` הפונקציה מחזירה אם מכשיר מוגדר מסומן בתג isFake=true או לא.
`abstract IConfiguration`	`partialDeepClone( objectToDeepClone, IKeyStoreClient client)` יוצרים עותק מקור מ-`clone()` ואז יוצרים עותק מקור מעמיק של רשימת אובייקט התצורה הנתון.
`abstract void`	`printCommandUsage(boolean importantOnly, PrintStream out)` הפונקציה הזו מפיקה טקסט עזרה לגבי השימוש בשורת הפקודה של ההגדרה הזו, ומעבירה אותו ל-printStream שצוין.
`abstract void`	`resolveDynamicOptions(DynamicRemoteFileResolver resolver)` פתרון האפשרויות של `ERROR(/File)` שמצביעות למיקום מרוחק.
`abstract void`	`safeInjectOptionValues( optionDefs)` הזרקה של מספר ערכים של אפשרויות לקבוצת אובייקטי התצורה, בלי להפעיל שגיאה אם אי אפשר להחיל אחת מהאפשרויות.
`abstract`	`setBestEffortOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` הגדרת שדות התצורה `Option` באמצעות קבוצה נתונה של ארגומנטים של שורת הפקודה, באמצעות גישה של מאמץ מרבי.
`abstract void`	`setBuildProvider(IBuildProvider provider)` מחליפים את הערך הנוכחי של `IBuildProvider` בתצורה.
`abstract void`	`setCommandLine(String[] arrayArgs)` הגדרת שורת הפקודה ששימשה ליצירת `IConfiguration` הזה.
`abstract void`	`setCommandOptions(ICommandOptions cmdOptions)` מגדירים את `ICommandOptions`, מחליפים את הערכים הקיימים
`abstract void`	`setConfigurationObject(String name, Object configObject)` שיטה גנרית להגדרת אובייקט התצורה עם השם שצוין, והחלפת כל ערך קיים.
`abstract void`	`setConfigurationObjectList(String name, configList)` שיטה גנרית להגדרת רשימת אובייקטי התצורה לשם הנתון, תוך החלפת כל ערך קיים.
`abstract void`	`setCoverageOptions(CoverageOptions coverageOptions)` מגדירים את `CoverageOptions`, ומחליפים את הערכים הקיימים.
`abstract void`	`setDeviceConfig(IDeviceConfiguration deviceConfig)` מגדירים `IDeviceConfiguration`, שמחליף כל ערך קיים.
`abstract void`	`setDeviceConfigList( deviceConfigs)` מגדירים את הערכים של `IDeviceConfiguration`, ומחליפים את הערכים הקיימים.
`abstract void`	`setDeviceMetricCollectors( collectors)` מגדירים את רשימת הערכים של `IMetricCollector`, ומחליפים את הערכים הקיימים.
`abstract void`	`setDeviceOptions(TestDeviceOptions deviceOptions)` מגדירים את `TestDeviceOptions`, מחליפים את הערכים הקיימים
`abstract void`	`setDeviceRecovery(IDeviceRecovery recovery)` מגדירים את `IDeviceRecovery`, מחליפים את הערך הקיים.
`abstract void`	`setDeviceRequirements(IDeviceSelection deviceSelection)` מגדירים את `IDeviceSelection`, מחליפים את הערכים הקיימים
`abstract void`	`setLabPreparer(ITargetPreparer preparer)` מגדירים את `ITargetPreparer`, מחליפים את הערך הקיים.
`abstract void`	`setLabPreparers( preparers)` מגדירים את רשימת הערכים של `ITargetPreparer`, ומחליפים את הערכים הקיימים.
`abstract void`	`setLogOutput(ILeveledLogOutput logger)` מגדירים את `ILeveledLogOutput`, מחליפים את הערך הקיים.
`abstract void`	`setLogSaver(ILogSaver logSaver)` מגדירים את `ILogSaver`, מחליפים את הערך הקיים.
`abstract void`	`setMultiPreTargetPreparer(IMultiTargetPreparer multiPreTargPreps)` שיטה נוחה להגדרת `IMultiTargetPreparer` יחיד בתצורה הזו, שצריך להריץ לפני כל אחד מה-target_preparers של המכשירים, ולהחליף את הערכים הקיימים
`abstract void`	`setMultiPreTargetPreparers( multiPreTargPreps)` מגדירים את רשימת ה-`IMultiTargetPreparer`s בהגדרה הזו שצריך להריץ לפני כל אחד מה-target_preparers של המכשירים, ומחליפים את הערכים הקיימים
`abstract void`	`setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)` שיטה נוחה להגדרת `IMultiTargetPreparer` יחיד בהגדרה הזו, שתחליף את כל הערכים הקיימים
`abstract void`	`setMultiTargetPreparers( multiTargPreps)` מגדירים את רשימת ה-`IMultiTargetPreparer` בהגדרה הזו, ומחליפים את הערכים הקיימים
`abstract`	`setOptionsFromCommandLineArgs( listArgs)` הגדרת שדות ה-config `Option` באמצעות קבוצה נתונה של ארגומנטים בשורת הפקודה `ArgsOptionParser` לפורמט הצפוי
`abstract`	`setOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` הגדרת שדות ה-config `Option` באמצעות קבוצה נתונה של ארגומנטים בשורת הפקודה הפורמט הצפוי מפורט במאמר `ArgsOptionParser`
`abstract void`	`setPostProcessors( processors)` מגדירים את רשימת הערכים של `IPostProcessor`, ומחליפים את הערכים הקיימים.
`abstract void`	`setRetryDecision(IRetryDecision decisionRetry)` מגדירים את `IRetryDecision`, מחליפים את הערך הקיים.
`abstract void`	`setSystemStatusChecker(ISystemStatusChecker systemChecker)` שיטה נוחה להגדרת `ISystemStatusChecker` יחיד בהגדרה הזו, שתחליף את כל הערכים הקיימים
`abstract void`	`setSystemStatusCheckers( systemCheckers)` מגדירים את רשימת ה-`ISystemStatusChecker` בהגדרה הזו, ומחליפים את הערכים הקיימים
`abstract void`	`setTargetPreparer(ITargetPreparer preparer)` מגדירים את `ITargetPreparer`, מחליפים את הערך הקיים.
`abstract void`	`setTargetPreparers( preparers)` מגדירים את רשימת הערכים של `ITargetPreparer`, ומחליפים את הערכים הקיימים.
`abstract void`	`setTest(IRemoteTest test)` שיטה נוחה להגדרת `IRemoteTest` יחיד בהגדרה הזו, שמחליף את כל הערכים הקיימים
`abstract void`	`setTestInvocationListener(ITestInvocationListener listener)` שיטה נוחה להגדרת `ITestInvocationListener` יחיד
`abstract void`	`setTestInvocationListeners( listeners)` הגדרת רשימת הערכים של `ITestInvocationListener`, תוך החלפה של ערכים קיימים
`abstract void`	`setTests( tests)` מגדירים את רשימת ה-`IRemoteTest` בהגדרה הזו, ומחליפים את הערכים הקיימים
`abstract void`	`validateOptions()` מאמתים את ערכי האפשרויות.

שיטות ציבוריות

addFilesToClean

public abstract void addFilesToClean ( toBeCleaned)

הוספת קבצים שצריך לנקות במהלך cleanConfigurationData()

פרמטרים
`toBeCleaned`

cleanConfigurationData

public abstract void cleanConfigurationData ()

מוחקים את כל הקבצים שהורדתם לשדות האפשרויות של קבצים מרוחקים.

לשכפל

public abstract IConfiguration clone ()

יוצרים עותק שטחי של האובייקט הזה.

החזרות
`IConfiguration`	עותק של {link IConfiguration}

dumpXml

public abstract void dumpXml (PrintWriter output)

הפונקציה מקבלת את קובץ ה-XML המורחב של התצורה עם כל האפשרויות שמוצגות ל-IConfiguration הזה בתור String.

פרמטרים
`output`	`PrintWriter`: הגורם שרוצים להדפיס אליו את קובץ ה-XML.

זריקות
	IOException

dumpXml

public abstract void dumpXml (PrintWriter output, 
                 excludeFilters)

הפונקציה מקבלת את קובץ ה-XML המורחב של ההגדרות עם כל האפשרויות שמוצגות ל-IConfiguration הזה, בניכוי המסננים של האובייקטים לפי שם המפתח שלהם.

דוגמה למסנן: Configuration.TARGET_PREPARER_TYPE_NAME.

פרמטרים
`output`	`PrintWriter`: הגורם שרוצים להדפיס אליו את קובץ ה-XML.
`excludeFilters`	: רשימת סוגי האובייקטים שלא צריך לבצע עליהם גרסת dump.

זריקות
	IOException

dumpXml

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

הפונקציה מקבלת את קובץ ה-XML המורחב של ההגדרה עם כל האפשרויות שמוצגות ל-IConfiguration הזה, בניכוי מסנני האובייקטים לפי שם המפתח שלהם.

דוגמה למסנן: Configuration.TARGET_PREPARER_TYPE_NAME.

פרמטרים
`output`	`PrintWriter`: הגורם שרוצים להדפיס אליו את קובץ ה-XML.
`excludeFilters`	: רשימת סוגי האובייקטים שלא צריך לפרסם.
`printDeprecatedOptions`	`boolean`: האם להדפיס אפשרויות שסומנו כ'לא בשימוש'
`printUnchangedOptions`	`boolean`

זריקות
	IOException

getAllConfigurationObjectsOfType

public abstract  getAllConfigurationObjectsOfType (String typeName)

ממשק גנרי לקבלת כל האובייקטים של שם סוג נתון במכשירים שונים.

פרמטרים
`typeName`	`String`: הסוג הייחודי של אובייקט התצורה

החזרות
	רשימת אובייקטי התצורה מהסוג הנתון.

getBuildProvider

public abstract IBuildProvider getBuildProvider ()

הפונקציה מקבלת את IBuildProvider מההגדרה.

החזרות
`IBuildProvider`	`IBuildProvider` שצוין בתצורה

getCommandLine

public abstract String getCommandLine ()

הפונקציה מקבלת את שורת הפקודה ששימשה ליצירת IConfiguration הזה.

החזרות
`String`	שורת הפקודה ששימשה ליצירת `IConfiguration` הזה.

getCommandOptions

public abstract ICommandOptions getCommandOptions ()

הפונקציה מקבלת את ICommandOptions לשימוש מהתצורה.

החזרות
`ICommandOptions`	`ICommandOptions` שצוין בתצורה.

getConfigurationDescription

public abstract ConfigurationDescriptor getConfigurationDescription ()

הפונקציה מחזירה את הערך של ConfigurationDescriptor שצוין בהגדרה.

החזרות
`ConfigurationDescriptor`

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

ממשק גנרי לקבלת אובייקט התצורה עם שם הסוג הנתון.

פרמטרים
`typeName`	`String`: הסוג הייחודי של אובייקט התצורה

החזרות
`Object`	אובייקט התצורה או הערך `null` אם סוג האובייקט בשם הנתון לא קיים.

getConfigurationObjectList

public abstract  getConfigurationObjectList (String typeName)

דומה ל-getConfigurationObject(String), אבל לסוגי אובייקטים של הגדרות שתומכים בכמה אובייקטים.

פרמטרים
`typeName`	`String`: שם הסוג הייחודי של אובייקט התצורה

החזרות
	רשימת אובייקטי התצורה, או `null` אם סוג האובייקט עם השם הנתון לא קיים.

getCoverageOptions

public abstract CoverageOptions getCoverageOptions ()

הפונקציה מקבלת את CoverageOptions לשימוש מהתצורה.

החזרות
`CoverageOptions`	`CoverageOptions` שצוין בתצורה.

getDeviceConfig

public abstract  getDeviceConfig ()

הפונקציה מקבלת את הערכים של IDeviceConfiguration מההגדרה.

החזרות
	הערכים של `IDeviceConfiguration` שצוינו לפי הסדר בתצורה

getDeviceConfigByName

public abstract IDeviceConfiguration getDeviceConfigByName (String nameDevice)

הפונקציה מחזירה את הערך של IDeviceConfiguration שמשויך לשם שצוין, או ערך null אם לא נמצא.

פרמטרים
`nameDevice`	`String`

החזרות
`IDeviceConfiguration`

getDeviceOptions

public abstract TestDeviceOptions getDeviceOptions ()

הפונקציה מקבלת את TestDeviceOptions לשימוש מהתצורה.

החזרות
`TestDeviceOptions`	`TestDeviceOptions` שצוין בתצורה.

getDeviceRecovery

public abstract IDeviceRecovery getDeviceRecovery ()

הפונקציה מקבלת את IDeviceRecovery לשימוש מהתצורה.

החזרות
`IDeviceRecovery`	`IDeviceRecovery` שצוין בתצורה.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

הפונקציה מקבלת את IDeviceSelection לשימוש מהתצורה.

החזרות
`IDeviceSelection`	`IDeviceSelection` שצוין בתצורה.

getFilesToClean

public abstract  getFilesToClean ()

הצגת רשימת הקבצים שיימחקו במהלך cleanConfigurationData()

החזרות

getGlobalFilters

public abstract GlobalTestFilter getGlobalFilters ()

הפונקציה מקבלת את GlobalTestFilter של ההפעלה.

החזרות
`GlobalTestFilter`

getInopOptions

public abstract  getInopOptions ()

אחזור שמות האפשרויות שלא השתנו בהן ערכים

החזרות

getLabPreparers

public abstract  getLabPreparers ()

הפונקציה מקבלת את הערכים של ITargetPreparer מההגדרה.

החזרות
	הערכים של `ITargetPreparer` שצוינו לפי הסדר בתצורה

getLogOutput

public abstract ILeveledLogOutput getLogOutput ()

הפונקציה מקבלת את ILeveledLogOutput לשימוש מהתצורה.

החזרות
`ILeveledLogOutput`	`ILeveledLogOutput` שצוין בתצורה.

getLogSaver

public abstract ILogSaver getLogSaver ()

הפונקציה מקבלת את ILogSaver לשימוש מהתצורה.

החזרות
`ILogSaver`	`ILogSaver` שצוין בתצורה.

getMetricCollectors

public abstract  getMetricCollectors ()

הפונקציה מקבלת את הערכים של IMetricCollector מההגדרה.

החזרות

getMultiPreTargetPreparers

public abstract  getMultiPreTargetPreparers ()

הפונקציה מקבלת את הערכים של IMultiTargetPreparer מההגדרה שצריך להריץ לפני כל אחד מה-target_preparers של המכשירים.

החזרות
	הערכים של `IMultiTargetPreparer` שצוינו לפי הסדר בתצורה

getMultiTargetPreparers

public abstract  getMultiTargetPreparers ()

הפונקציה מקבלת את הערכים של IMultiTargetPreparer מההגדרה.

החזרות
	הערכים של `IMultiTargetPreparer` שצוינו לפי הסדר בתצורה

getName

public abstract String getName ()

הפונקציה מחזירה את שם התצורה.

החזרות
`String`

getPostProcessors

public abstract  getPostProcessors ()

הפונקציה מקבלת את הערכים של IPostProcessor מההגדרה.

החזרות

getRetryDecision

public abstract IRetryDecision getRetryDecision ()

הפונקציה מחזירה את הערך של IRetryDecision ששימש לקריאה.

החזרות
`IRetryDecision`

getSkipManager

public abstract SkipManager getSkipManager ()

הפונקציה מקבלת את הערך של SkipManager לקריאה.

החזרות
`SkipManager`

getSystemStatusCheckers

public abstract  getSystemStatusCheckers ()

הפונקציה מקבלת את הערכים של ISystemStatusChecker מההגדרה.

החזרות
	הערכים של `ISystemStatusChecker` שצוינו לפי הסדר בתצורה

getTargetPreparers

public abstract  getTargetPreparers ()

הפונקציה מקבלת את הערכים של ITargetPreparer מההגדרה.

החזרות
	הערכים של `ITargetPreparer` שצוינו לפי הסדר בתצורה

getTestInvocationListeners

public abstract  getTestInvocationListeners ()

הפונקציה מקבלת את הערכים של ITestInvocationListener לשימוש מהתצורה.

החזרות
	הערכים של `ITestInvocationListener` שצוינו בתצורה.

getTests

public abstract  getTests ()

הפונקציה מקבלת את ה-IRemoteTest לריצה מההגדרה.

החזרות
	הבדיקות שצוינו בהגדרה

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

הזרקת ערך אפשרות לקבוצת אובייקטי התצורה.

אפשר להשתמש בהם כדי לספק ערכים לאפשרויות שנוצרות באופן דינמי.

פרמטרים
`optionName`	`String`: שם האפשרות
`optionValue`	`String`: ערך האפשרות

זריקות
`ConfigurationException`	אם לא הצלחתם להגדיר את ערך האפשרות

injectOptionValue

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

הזרקת ערך אפשרות לקבוצת אובייקטי התצורה.

אפשר להשתמש בהם כדי לספק ערכים לאפשרויות שנוצרות באופן דינמי.

פרמטרים
`optionName`	‫`String`: שם האפשרות
`optionKey`	`String`: המפתח האופציונלי לאפשרויות המפה, או null
`optionValue`	`String`: הערך של אפשרות המיפוי

זריקות
`ConfigurationException`	אם לא הצלחתם להגדיר את ערך האפשרות

injectOptionValueWithSource

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

הזרקת ערך אפשרות לקבוצת אובייקטי התצורה.

אפשר להשתמש בהם כדי לספק ערכים לאפשרויות שנוצרות באופן דינמי.

פרמטרים
`optionName`	‫`String`: שם האפשרות
`optionKey`	`String`: המפתח האופציונלי לאפשרויות המפה, או null
`optionValue`	`String`: הערך של אפשרות המיפוי
`optionSource`	`String`: הגדרת המקור שסיפקה את ערך האפשרות הזה

זריקות
`ConfigurationException`	אם לא הצלחתם להגדיר את ערך האפשרות

injectOptionValues

public abstract void injectOptionValues ( optionDefs)

הזרקה של מספר ערכים של אפשרויות לקבוצת אובייקטי התצורה.

שימושי להחדרת ערכי אפשרויות רבים בו-זמנית אחרי יצירת אובייקט חדש.

פרמטרים
`optionDefs`	: רשימה של הגדרות אפשרויות להזרקה

זריקות
`ConfigurationException`	if failed to set option values

isDeviceConfiguredFake

public abstract boolean isDeviceConfiguredFake (String deviceName)

הפונקציה מחזירה אם מכשיר מוגדר מסומן בתג isFake=true או לא.

פרמטרים
`deviceName`	`String`

החזרות
`boolean`

partialDeepClone

public abstract IConfiguration partialDeepClone ( objectToDeepClone, 
                IKeyStoreClient client)

יוצרים עותק מקור מ-clone() ואז יוצרים עותק מקור מעמיק של רשימת אובייקט התצורה הנתון.

פרמטרים
`objectToDeepClone`	: רשימת אובייקטי התצורה שרוצים ליצור להם עותק מלא.
`client`	`IKeyStoreClient`: לקוח מאגר המפתחות.

החזרות
`IConfiguration`	ההגדרות של העותק המשובט חלקית.

זריקות
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

printCommandUsage

public abstract void printCommandUsage (boolean importantOnly, 
                PrintStream out)

הפונקציה הזו מפיקה טקסט עזרה לגבי השימוש בשורת הפקודה של ההגדרה הזו, ומעבירה אותו ל-printStream שצוין.

פרמטרים
`importantOnly`	`boolean`: אם `true` מודפסת רק עזרה לגבי האפשרויות החשובות
`out`	`PrintStream`: ה-`ERROR(/PrintStream)` שבו רוצים להשתמש.

זריקות
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

resolveDynamicOptions

public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

פתרון האפשרויות של ERROR(/File) שמצביעות על מיקום מרוחק. לשם כך, צריך לקרוא לפונקציה cleanConfigurationData() כדי לנקות את הקבצים.

פרמטרים
`resolver`	`DynamicRemoteFileResolver`: ה-`DynamicRemoteFileResolver` לפתרון הקבצים

זריקות
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
`BuildRetrievalError`
`ConfigurationException`

safeInjectOptionValues

public abstract void safeInjectOptionValues ( optionDefs)

הזרקה של מספר ערכים של אפשרויות לקבוצת אובייקטי התצורה, בלי להפעיל שגיאה אם אי אפשר להחיל אחת מהאפשרויות.

שימושי להחדרת ערכים רבים של אפשרויות בבת אחת אחרי יצירת אובייקט חדש.

פרמטרים
`optionDefs`	: רשימה של הגדרות אפשרויות להזרקה

זריקות
`ConfigurationException`	if failed to create the `OptionSetter`

setBestEffortOptionsFromCommandLineArgs

public abstract  setBestEffortOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

הגדרת שדות התצורה Option באמצעות קבוצה נתונה של ארגומנטים של שורת הפקודה, באמצעות גישה של מאמץ מרבי.

הפורמט הצפוי מפורט במאמר ArgsOptionParser

פרמטרים
`listArgs`	: הארגומנטים בשורת הפקודה
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` לשימוש.

החזרות
	הארגומנטים שלא נצרכו

זריקות
`ConfigurationException`

setBuildProvider

public abstract void setBuildProvider (IBuildProvider provider)

מחליפים את הערך הנוכחי של IBuildProvider בתצורה.

פרמטרים
`provider`	`IBuildProvider`: `IBuildProvider` החדש

setCommandLine

public abstract void setCommandLine (String[] arrayArgs)

הגדרת שורת הפקודה ששימשה ליצירת IConfiguration הזה. הפונקציה הזו שומרת את שורת הפקודה כולה, כולל שם התצורה, בניגוד לפונקציה setOptionsFromCommandLineArgs.

פרמטרים
`arrayArgs`	`String`: שורת הפקודה

setCommandOptions

public abstract void setCommandOptions (ICommandOptions cmdOptions)

מגדירים את ICommandOptions, מחליפים את הערכים הקיימים

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

שיטה גנרית להגדרת אובייקט התצורה עם השם שצוין, והחלפת כל ערך קיים.

פרמטרים
`name`	`String`: השם הייחודי של סוג אובייקט התצורה.
`configObject`	`Object`: אובייקט התצורה

זריקות
`ConfigurationException`	אם configObject לא היה מהסוג הנכון

setConfigurationObjectList

public abstract void setConfigurationObjectList (String name, 
                 configList)

שיטה גנרית להגדרת רשימת אובייקטי התצורה לשם הנתון, תוך החלפת כל ערך קיים.

פרמטרים
`name`	`String`: השם הייחודי של סוג אובייקט התצורה.
`configList`	: רשימת אובייקטי התצורה

זריקות
`ConfigurationException`	אם יש אובייקטים ברשימה שהם לא מהסוג הנכון

setCoverageOptions

public abstract void setCoverageOptions (CoverageOptions coverageOptions)

מגדירים את CoverageOptions, ומחליפים את הערכים הקיימים.

פרמטרים
`coverageOptions`	`CoverageOptions`

setDeviceConfig

public abstract void setDeviceConfig (IDeviceConfiguration deviceConfig)

מגדירים IDeviceConfiguration, שמחליף ערך קיים כלשהו.

setDeviceConfigList

public abstract void setDeviceConfigList ( deviceConfigs)

מגדירים את הערכים של IDeviceConfiguration, ומחליפים את הערכים הקיימים.

setDeviceMetricCollectors

public abstract void setDeviceMetricCollectors ( collectors)

מגדירים את רשימת הערכים של IMetricCollector, ומחליפים את הערכים הקיימים.

פרמטרים
`collectors`

setDeviceOptions

public abstract void setDeviceOptions (TestDeviceOptions deviceOptions)

מגדירים את TestDeviceOptions, מחליפים את הערכים הקיימים

פרמטרים
`deviceOptions`	`TestDeviceOptions`

setDeviceRecovery

public abstract void setDeviceRecovery (IDeviceRecovery recovery)

מגדירים את IDeviceRecovery, מחליפים את הערך הקיים.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

מגדירים את IDeviceSelection, מחליפים את הערכים הקיימים

setLabPreparer

public abstract void setLabPreparer (ITargetPreparer preparer)

מגדירים את ITargetPreparer, מחליפים את הערך הקיים.

setLabPreparers

public abstract void setLabPreparers ( preparers)

מגדירים את רשימת הערכים של ITargetPreparer, ומחליפים את הערכים הקיימים.

setLogOutput

public abstract void setLogOutput (ILeveledLogOutput logger)

מגדירים את ILeveledLogOutput, מחליפים את הערך הקיים.

setLogSaver

public abstract void setLogSaver (ILogSaver logSaver)

מגדירים את ILogSaver, מחליפים את הערך הקיים.

setMultiPreTargetPreparer

public abstract void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPreps)

שיטה נוחה להגדרת IMultiTargetPreparer יחיד בתצורה הזו, שצריך להריץ לפני כל אחד מה-target_preparers של המכשירים, ולהחליף את הערכים הקיימים

setMultiPreTargetPreparers

public abstract void setMultiPreTargetPreparers ( multiPreTargPreps)

מגדירים את רשימת ה-IMultiTargetPreparers בהגדרה הזו שצריך להריץ לפני כל אחד מה-target_preparers של המכשירים, ומחליפים את הערכים הקיימים

setMultiTargetPreparer

public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

שיטה נוחה להגדרת IMultiTargetPreparer יחיד בהגדרה הזו, שתחליף את כל הערכים הקיימים

setMultiTargetPreparers

public abstract void setMultiTargetPreparers ( multiTargPreps)

מגדירים את רשימת ה-IMultiTargetPreparer בהגדרה הזו, ומחליפים את הערכים הקיימים

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

הגדרת שדות ה-config Option באמצעות קבוצה נתונה של ארגומנטים בשורת הפקודה

ArgsOptionParser לפורמט הצפוי

פרמטרים
`listArgs`	: הארגומנטים בשורת הפקודה

החזרות
	הארגומנטים שלא נצרכו

זריקות
`ConfigurationException`

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

הגדרת שדות ה-config Option באמצעות קבוצה נתונה של ארגומנטים בשורת הפקודה

הפורמט הצפוי מפורט במאמר ArgsOptionParser

פרמטרים
`listArgs`	: הארגומנטים בשורת הפקודה
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` לשימוש.

החזרות
	הארגומנטים שלא נצרכו

זריקות
`ConfigurationException`

setPostProcessors

public abstract void setPostProcessors ( processors)

מגדירים את רשימת הערכים של IPostProcessor, ומחליפים את הערכים הקיימים.

פרמטרים
`processors`

setRetryDecision

public abstract void setRetryDecision (IRetryDecision decisionRetry)

מגדירים את IRetryDecision, מחליפים את הערך הקיים.

setSystemStatusChecker

public abstract void setSystemStatusChecker (ISystemStatusChecker systemChecker)

שיטה נוחה להגדרת ISystemStatusChecker יחיד בהגדרה הזו, שתחליף את כל הערכים הקיימים

setSystemStatusCheckers

public abstract void setSystemStatusCheckers ( systemCheckers)

מגדירים את רשימת ה-ISystemStatusChecker בהגדרה הזו, ומחליפים את הערכים הקיימים

setTargetPreparer

public abstract void setTargetPreparer (ITargetPreparer preparer)

מגדירים את ITargetPreparer, מחליפים את הערך הקיים.

setTargetPreparers

public abstract void setTargetPreparers ( preparers)

מגדירים את רשימת הערכים של ITargetPreparer, ומחליפים את הערכים הקיימים.

setTest

public abstract void setTest (IRemoteTest test)

שיטה נוחה להגדרת IRemoteTest יחיד בהגדרה הזו, שמחליף את כל הערכים הקיימים

setTestInvocationListener

public abstract void setTestInvocationListener (ITestInvocationListener listener)

שיטה נוחה להגדרת ITestInvocationListener יחיד

setTestInvocationListeners

public abstract void setTestInvocationListeners ( listeners)

הגדרת רשימת הערכים של ITestInvocationListener, החלפת הערכים הקיימים

setTests

public abstract void setTests ( tests)

מגדירים את רשימת ה-IRemoteTest בהגדרה הזו, ומחליפים את הערכים הקיימים

validateOptions

public abstract void validateOptions ()

מאמתים את ערכי האפשרויות.

בשלב הזה, הבדיקה רק תאשר שכל האפשרויות החובה הוגדרו

זריקות
`ConfigurationException`	if config is not valid