IConfiguration

public interface IConfiguration

com.android.tradefed.config.IConfiguration

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

סיכום

‫methods ציבוריים

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 שמשויך לשם שצוין, או null אם לא נמצאה התאמה.

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()

מקבל את ה-IMultiTargetPreparers מההגדרה שצריך להפעיל לפני כל 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()

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

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)

הפונקציה מחזירה את הערך true אם מכשיר מוגדר מתויג בתג isFake=true, אחרת היא מחזירה את הערך false.

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)

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

abstract void setBuildProvider(IBuildProvider provider)

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

abstract void setCommandLine(String[] arrayArgs)

מגדירה את שורת הפקודה ששימשה ליצירת IConfiguration.

abstract void setCommandOptions(ICommandOptions cmdOptions)

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

abstract void setConfigurationObject(String name, Object configObject)

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

abstract void setConfigurationObjectList(String name, 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)

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

abstract void setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)

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

abstract void setMultiTargetPreparers(List<IMultiTargetPreparer> multiTargPreps)

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

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)

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

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)

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

abstract void validateOptions()

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

‫methods ציבוריים

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.
הקפצת הודעות שגיאה (throw)
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: רשימת סוגי האובייקטים שלא צריך לבצע dump שלהם.
הקפצת הודעות שגיאה (throw)
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: רשימת סוגי האובייקטים שלא צריך לבצע dump שלהם.
printDeprecatedOptions ‫boolean: האם להדפיס אפשרויות שסומנו כהוצאה משימוש
printUnchangedOptions boolean

הקפצת הודעות שגיאה (throw)
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 שמשויך לשם שצוין, או 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 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 ()

מקבל את ה-IMultiTargetPreparers מההגדרה שצריך להפעיל לפני כל 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 ()

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

החזרות
List<ITestInvocationListener> ‫ITestInvocationListeners שסופקו בהגדרה.

getTests

public abstract List<IRemoteTest> getTests ()

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

החזרות
List<IRemoteTest> הבדיקות שמופיעות בהגדרה

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

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

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

פרמטרים
optionName ‫String: שם האפשרות
optionValue ‫String: ערך האפשרות
הקפצת הודעות שגיאה (throw)
ConfigurationException אם לא הצלחנו להגדיר את הערך של האפשרות

injectOptionValue

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

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

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

פרמטרים
optionName ‫String: שם האפשרות
optionKey ‫String: המפתח האופציונלי לאפשרויות המפה, או null
optionValue ‫String: הערך של אפשרות המיפוי
הקפצת הודעות שגיאה (throw)
ConfigurationException אם לא הצלחנו להגדיר את הערך של האפשרות

injectOptionValueWithSource

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

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

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

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

injectOptionValues

public abstract void injectOptionValues (List<OptionDef> optionDefs)

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

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

פרמטרים
optionDefs ‫List: רשימה של הגדרות אפשרויות להחדרה
הקפצת הודעות שגיאה (throw)
ConfigurationException אם הגדרת ערכי האפשרויות נכשלה

isDeviceConfiguredFake

public abstract boolean isDeviceConfiguredFake (String deviceName)

הפונקציה מחזירה את הערך true אם מכשיר מוגדר מתויג בתג isFake=true, אחרת היא מחזירה את הערך false.

פרמטרים
deviceName String

החזרות
boolean

partialDeepClone

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

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

פרמטרים
objectToDeepClone ‫List: רשימת אובייקטים של הגדרות שצריך לשכפל באופן מלא.
client ‫IKeyStoreClient: לקוח מאגר המפתחות.
החזרות
IConfiguration ההגדרה ששוכפלה באופן חלקי.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.config.ConfigurationException
ConfigurationException

printCommandUsage

public abstract void printCommandUsage (boolean importantOnly, 
                PrintStream out)

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

פרמטרים
importantOnly ‫boolean: אם true, רק העזרה לגבי האפשרויות החשובות להדפסה
out ‫PrintStream: PrintStream שבו רוצים להשתמש.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.config.ConfigurationException
ConfigurationException

resolveDynamicOptions

public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

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

פרמטרים
resolver ‫DynamicRemoteFileResolver: DynamicRemoteFileResolver לפתרון הקבצים
הקפצת הודעות שגיאה (throw)
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
BuildRetrievalError
ConfigurationException

safeInjectOptionValues

public abstract void safeInjectOptionValues (List<OptionDef> optionDefs)

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

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

פרמטרים
optionDefs ‫List: רשימה של הגדרות אפשרויות להחדרה
הקפצת הודעות שגיאה (throw)
ConfigurationException אם יצירת OptionSetter נכשלה

setBestEffortOptionsFromCommandLineArgs

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

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

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

פרמטרים
listArgs ‫List: הארגומנטים בשורת הפקודה
keyStoreClient ‫IKeyStoreClient: IKeyStoreClient לשימוש.
החזרות
List<String> הארגומנטים שלא נעשה בהם שימוש
הקפצת הודעות שגיאה (throw)
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: אובייקט ההגדרות
הקפצת הודעות שגיאה (throw)
ConfigurationException אם configObject לא היה מהסוג הנכון

setConfigurationObjectList

public abstract void setConfigurationObjectList (String name, 
                List<?> configList)

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

פרמטרים
name ‫String: השם הייחודי של סוג אובייקט ההגדרה.
configList ‫List: רשימת אובייקטים של הגדרות
הקפצת הודעות שגיאה (throw)
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)

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

setMultiTargetPreparer

public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

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

setMultiTargetPreparers

public abstract void setMultiTargetPreparers (List<IMultiTargetPreparer> multiTargPreps)

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

setOptionsFromCommandLineArgs

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

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

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

פרמטרים
listArgs ‫List: הארגומנטים בשורת הפקודה
החזרות
List<String> הארגומנטים שלא נעשה בהם שימוש
הקפצת הודעות שגיאה (throw)
ConfigurationException

setOptionsFromCommandLineArgs

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

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

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

פרמטרים
listArgs ‫List: הארגומנטים בשורת הפקודה
keyStoreClient ‫IKeyStoreClient: IKeyStoreClient לשימוש.
החזרות
List<String> הארגומנטים שלא נעשה בהם שימוש
הקפצת הודעות שגיאה (throw)
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)

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

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)

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

validateOptions

public abstract void validateOptions ()

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

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

הקפצת הודעות שגיאה (throw)
ConfigurationException אם ההגדרה לא תקינה