IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

כיתה שמכילה את פרטי ההגדרה הגלובליים של מכונה אחת של Trade Federation (כולל מספר כלשהו של הפעלות של הגדרות בפועל).

סיכום

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

abstract void cleanup()

ניקוי תקין בסגירת tradefed.

abstract File cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)

סינון של GlobalConfiguration על סמך רשימת היתרים והעברת הפלט לקובץ XML.

abstract File cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)

סינון של GlobalConfiguration על סמך רשימת לבנה, תוך מתן אפשרות לזיוף של ערכי האפשרויות ולהוצאה לקובץ XML.

abstract File cloneConfigWithFilter(String... allowlistConfigs)

סינון GlobalConfiguration על סמך רשימת ההיתרים והפלט לקובץ XML.

abstract ICommandScheduler getCommandScheduler()

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

abstract Object getConfigurationObject(String typeName)

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

abstract ICredentialFactory getCredentialFactory()

הפונקציה מקבלת את ICredentialFactory ליצירת פרטי כניסה.

abstract DeviceManagementGrpcServer getDeviceManagementServer()

הפונקציה מחזירה את הערך של DeviceManagementGrpcServer או null אם הערך לא מוגדר.

abstract IDeviceManager getDeviceManager()

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

abstract getDeviceMonitors()

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

abstract IDeviceSelection getDeviceRequirements()

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

abstract TradefedFeatureServer getFeatureServer()

הפונקציה מחזירה את הערך של TradefedFeatureServer או null אם הערך לא מוגדר.

abstract IConfigurationServer getGlobalConfigServer()

אחזור של שרת ההגדרות הגלובלי.

abstract getHostMonitors()

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

abstract IHostOptions getHostOptions()

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

abstract IHostResourceManager getHostResourceManager()

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

abstract IKeyStoreFactory getKeyStoreFactory()

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

abstract getMultiDeviceRecoveryHandlers()

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

abstract getOptionValues(String optionName)

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

abstract getResourceMetricCollectors()

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

abstract ISandboxFactory getSandboxFactory()

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

abstract IShardHelper getShardingStrategy()

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

abstract TestInvocationManagementServer getTestInvocationManagementSever()

הפונקציה מחזירה את הערך של TestInvocationManagementServer או null אם הערך לא מוגדר.

abstract ITerribleFailureHandler getWtfHandler()

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

abstract void injectOptionValue(String optionName, String optionValue)

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

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

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

abstract void setCommandScheduler(ICommandScheduler scheduler)

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

abstract void setConfigurationFactory(IConfigurationFactory configFactory)

מגדירים את IConfigurationFactory להגדרה הזו.

abstract void setConfigurationObject(String name, Object configObject)

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

abstract void setConfigurationObjectList(String typeName, configList)

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

abstract void setDeviceManagementServer(DeviceManagementGrpcServer server)

הגדרת DeviceManagementGrpcServer.

abstract void setDeviceManager(IDeviceManager deviceManager)

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

abstract void setDeviceMonitor(IDeviceMonitor deviceMonitor)

מגדירים את IDeviceMonitor.

abstract void setDeviceRequirements(IDeviceSelection deviceSelection)

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

abstract void setHostMonitors( hostMonitors)

מגדירים את הרשימה IHostMonitor.

abstract void setHostOptions(IHostOptions hostOptions)

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

abstract void setHostResourceManager(IHostResourceManager hostResourceManager)

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

abstract void setInvocationServer(TestInvocationManagementServer server)

הגדרת TestInvocationManagementServer.

abstract void setKeyStoreFactory(IKeyStoreFactory factory)

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

abstract setOptionsFromCommandLineArgs( listArgs)

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

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

abstract void setOriginalConfig(String config)

הגדרת ההגדרה המקורית ששימשה ליצירת ההגדרה הגלובלית.

abstract void setResourceMetricCollector(IResourceMetricCollector collector)

הגדרת IResourceMetricCollector.

abstract void setSandboxFactory(ISandboxFactory factory)

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

abstract void setShardingStrategy(IShardHelper sharding)

הגדרת IShardHelper לשימוש בחלוקה של תצורה.

abstract void setTradefedFeatureServer(TradefedFeatureServer server)

הגדרת TradefedFeatureServer.

abstract void setWtfHandler(ITerribleFailureHandler wtfHandler)

מגדירים את ITerribleFailureHandler.

abstract void setup()

הגדרה נכונה בתחילת תהליך ה-tradefed.

abstract void validateOptions()

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

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

ניקוי

public abstract void cleanup ()

ניקוי תקין בסגירת tradefed.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

סינון של GlobalConfiguration על סמך רשימת היתרים והעברת הפלט לקובץ XML.

פרמטרים
exclusionPatterns : התבנית של שם הכיתה שרוצים להחריג מהאשפה.
allowlistConfigs String: מערך String של הגדרות אישיות שכלולות בקובץ ה-XML החדש. אם הערך שהוגדר הוא null, a default list should be used.
החזרות
File הקובץ שמכיל את קובץ התצורה הגלובלי המסונן החדש.
זריקות
IOException

מידע נוסף:

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

סינון של GlobalConfiguration על סמך רשימת לבנה, תוך מתן אפשרות לזיוף של ערכי האפשרויות ולהוצאה לקובץ XML.

פרמטרים
exclusionPatterns : התבנית של שם הכיתה שרוצים להחריג מהאשפה.
transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String: מערך String של הגדרות אישיות שכלולות בקובץ ה-XML החדש. אם הערך שהוגדר הוא null, a default list should be used.
החזרות
File הקובץ שמכיל את קובץ התצורה הגלובלי המסונן החדש.

מידע נוסף:

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

סינון GlobalConfiguration על סמך רשימת ההיתרים והפלט לקובץ XML.

לדוגמה, בהגדרה הבאה: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

כל ההגדרות מלבד 'key_store' יסוננו, והתוצאה תהיה קובץ תצורה עם התוכן הבא: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

פרמטרים
allowlistConfigs String: מערך String של הגדרות אישיות שכלולות בקובץ ה-XML החדש. אם הערך שהוגדר הוא null, a default list should be used.
החזרות
File הקובץ שמכיל את קובץ התצורה הגלובלי המסונן החדש.
זריקות
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

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

החזרות
ICommandScheduler ICommandScheduler. הפונקציה לעולם לא תחזיר ערך null.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

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

פרמטרים
typeName String: הסוג הייחודי של אובייקט התצורה
החזרות
Object האובייקט או null אם לא נמצא אובייקט עם השם הזה

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

הפונקציה מקבלת את ICredentialFactory ליצירת פרטי כניסה.

החזרות
ICredentialFactory ICredentialFactory או null אם לא צוין אף אחד מהם.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

הפונקציה מחזירה את הערך של DeviceManagementGrpcServer או null אם הערך לא מוגדר.

החזרות
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

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

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

getDeviceMonitors

public abstract  getDeviceMonitors ()

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

החזרות
רשימת IDeviceMonitor מהתצורה הגלובלית, או null אם לא צוין אף ערך.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

הפונקציה מקבלת את IDeviceSelection לשימוש מהתצורה. מייצג מסנן גלובלי של המכשירים שאפשר לראות בהם את DeviceManager.

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

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

הפונקציה מחזירה את הערך של TradefedFeatureServer או null אם הערך לא מוגדר.

החזרות
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

אחזור של שרת ההגדרות הגלובלי. שרת התצורה הגלובלי משמש לקבלת הגדרות המארח משרת, במקום לקבל אותן מקובצים מקומיים.

החזרות
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

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

החזרות
רשימת IHostMonitor מהתצורה הגלובלית, או null אם לא צוין אף ערך.

getHostOptions

public abstract IHostOptions getHostOptions ()

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

החזרות
IHostOptions IDeviceManager שצוין בתצורה.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

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

החזרות
IHostResourceManager הערך של IHostResourceManager מהתצורה הגלובלית, או הטמעת ברירת המחדל LocalHostResourceManager אם לא צוין ערך בתצורת המארח.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

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

החזרות
IKeyStoreFactory IKeyStoreFactory או null אם לא מוגדר מפעל של מאגר מפתחות.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

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

החזרות
הרשימה של IMultiDeviceRecovery, או null אם לא הוגדרה.

getOptionValues

public abstract  getOptionValues (String optionName)

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

פרמטרים
optionName ‫String: שם אפשרות המפה
החזרות
רשימה של הערכים של האפשרות הנתונה. null אם שם האפשרות לא קיים.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

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

החזרות
הרשימה של IResourceMetricCollector מהתצורה הגלובלית או null אם לא צוין אף ערך.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

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

החזרות
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

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

החזרות
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

הפונקציה מחזירה את הערך של TestInvocationManagementServer או null אם הערך לא מוגדר.

החזרות
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

הפונקציה מקבלת את ITerribleFailureHandler לשימוש מהתצורה. הטיפול באירוע WTF (What a Terrible Failure)

החזרות
ITerribleFailureHandler הערך של ITerribleFailureHandler שצוין בתצורה, או null אם לא הוגדר טיפול

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

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

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

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

injectOptionValue

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

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

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

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

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

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

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

מגדירים את IConfigurationFactory להגדרה הזו.

פרמטרים
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

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

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

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

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

פרמטרים
typeName String: השם הייחודי של סוג אובייקט התצורה.
configList : רשימת אובייקטי התצורה
זריקות
ConfigurationException אם יש אובייקטים ברשימה שהם לא מהסוג הנכון

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

הגדרת DeviceManagementGrpcServer.

פרמטרים
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

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

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

מגדירים את IDeviceMonitor.

פרמטרים
deviceMonitor IDeviceMonitor: המסך
זריקות
ConfigurationException אם כבר הוגדר IDeviceMonitor.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

מגדירים את IDeviceSelection, ומחליפים את הערכים הקיימים. הפעולה הזו מגדירה מסנן מכשירי גלובלי שקובע אילו מכשירים DeviceManager יוכל לראות.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

מגדירים את הרשימה IHostMonitor.

פרמטרים
hostMonitors : רשימת המסכים
זריקות
ConfigurationException אם כבר הוגדר IHostMonitor.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

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

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

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

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

הגדרת TestInvocationManagementServer.

פרמטרים
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

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

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

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

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

פרמטרים
listArgs : הארגומנטים בשורת הפקודה
החזרות
הארגומנטים שלא נצרכו
זריקות
ConfigurationException

setOriginalConfig

public abstract void setOriginalConfig (String config)

הגדרת ההגדרה המקורית ששימשה ליצירת ההגדרה הגלובלית.

פרמטרים
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

הגדרת IResourceMetricCollector.

פרמטרים
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

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

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

הגדרת IShardHelper לשימוש בחלוקה של תצורה.

פרמטרים
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

הגדרת TradefedFeatureServer.

פרמטרים
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

מגדירים את ITerribleFailureHandler.

פרמטרים
wtfHandler ITerribleFailureHandler: ה-handler של WTF
זריקות
ConfigurationException אם כבר הוגדר ITerribleFailureHandler.

הגדרה

public abstract void setup ()

הגדרה נכונה בתחילת תהליך ה-tradefed.

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

validateOptions

public abstract void validateOptions ()

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

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

זריקות
ConfigurationException אם בהגדרה חסרים שדות חובה