IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

תת-כיתות עקיפות ידועות InvocationContext InvocationContext הטמעה כללית של IInvocationContext.

---

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

סיכום

קבועים
String	INVOCATION_ID מפתח המשמש לאחסון מזהה ההפעלה המשויך.

שיטות ציבוריות
abstract void	addAllocatedDevice( deviceWithName) מעקב אחרי מפה של שם מכשיר ההגדרה שמשויך ל-ITestDevice.
abstract void	addAllocatedDevice(String deviceName, ITestDevice testDevice) מוסיפים מכשיר ITestDevice כדי שהמטא-נתונים יעקבו אחריו כשהמכשיר יוקצה.
abstract void	addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo) מוסיפים IBuildInfo כדי לעקוב אחרי שם תצורת המכשיר.
abstract void	addInvocationAttribute(String attributeName, String attributeValue) מוסיפים מאפיין קריאה.
abstract void	addInvocationAttributes(MultiMap<String, String> attributesMap) הוספת כמה מאפייני קריאה בבת אחת באמצעות UniqueMultiMap.
default void	addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis) מוסיפים מדד של תזמון ההפעלה.
abstract void	addSerialsFromShard(Integer index, serials) הוספת מספר סידורי למעקב אחרי הקצאה לאחד מהשברים שמריצים כמה בדיקות.
default String	getAttribute(String key) שיטה נוחה לאחזור מאפיין של הקשר ההפעלה כצמד מפתח/ערך יחיד.
abstract MultiMap<String, String>	getAttributes() הפונקציה מחזירה עותק של המפה שמכילה את כל מאפייני ההפעלה.
abstract IBuildInfo	getBuildInfo(String deviceName) הפונקציה מחזירה את הערך של IBuildInfo שמשויך לשם של הגדרות המכשיר שצוין.
abstract IBuildInfo	getBuildInfo(ITestDevice testDevice) החזרת הערך של IBuildInfo שמשויך ל-ITestDevice
abstract String	getBuildInfoName(IBuildInfo info) הפונקציה מחזירה את השם של קבוצת המכשירים שמוגדרת בתצורת ה-XML מ-IBuildInfo.
abstract	getBuildInfos() החזרת כל הערכים של IBuildInfo שבוצעה עליהם מעקב בקריאה הזו.
abstract ConfigurationDescriptor	getConfigurationDescriptor() הפונקציה מחזירה את התיאור המשויך להגדרת הבדיקה שהפעילה את ההפעלה.
abstract ITestDevice	getDevice(String deviceName) הפונקציה מחזירה את הערך של ITestDevice שמשויך לשם של הגדרות המכשיר שצוין.
abstract	getDeviceBuildMap() החזרת המפה של השיוך של פרטי המכשיר/הגרסה
abstract ITestDevice	getDeviceBySerial(String serial) הפונקציה מחזירה את הערך של ITestDevice שמשויך למספר הסידורי שצוין.
abstract	getDeviceConfigNames() החזרת רשימת השמות של הגדרות המכשיר של המכשיר שנמצא במעקב בהפעלה הזו
abstract String	getDeviceName(ITestDevice device) הפונקציה מחזירה את השם של קבוצת המכשירים בתצורת ה-XML מ-ITestDevice.
abstract	getDevices() החזרת כל המכשירים שהוקצו למעקב בקריאה הזו.
abstract String	getInvocationId()
default	getInvocationTimingMetrics() הפונקציה מחזירה את המפה שמכילה את מדדי תזמון ההפעלה.
abstract IInvocationContext	getModuleInvocationContext() הפונקציה מחזירה את הקשר ההפעלה של המודול בזמן שהוא מופעל כחלק מחבילה.
abstract int	getNumDevicesAllocated() הפונקציה מחזירה את מספר המכשירים שהוקצו להפעלה.
abstract	getSerials() החזרת רשימת המספרים הסידוריים של המכשיר שעליו מתבצע מעקב בקריאה הזו
abstract	getShardsSerials() הפונקציה מחזירה את המפה של כל הסדרות שבמעקב ואת החלק שלהן שמעורב בפיצול.
abstract String	getTestTag() הפונקציה מחזירה את תג הבדיקה של ההפעלה.
abstract void	markReleasedEarly() מסמנים את המכשירים שיפורסמו מוקדם.
abstract void	setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor) הגדרת המתאר שמשויך להגדרת הבדיקה שהפעילה את ההפעלה
abstract void	setModuleInvocationContext(IInvocationContext invocationContext) הגדרת ההקשר של ההפעלה של המודול בזמן שהוא מופעל כחלק מחבילה.
abstract void	setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode) הגדרת RecoveryMode של כל המכשירים שנכללים בהקשר
abstract void	setTestTag(String testTag) הגדרת תג הבדיקה של ההפעלה.
abstract InvocationContext.Context	toProto() סריאליזציה של מופע ההקשר ל-protobuf.
abstract boolean	wasReleasedEarly() הפונקציה מחזירה את הערך true אם המכשירים הושקו מוקדם ולא יהיו בשימוש יותר, או את הערך false אם לא.

קבועים

INVOCATION_ID

public static final String INVOCATION_ID

מפתח המשמש לאחסון מזהה ההפעלה המשויך.

ערך קבוע: "invocation-id"

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

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

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

פרמטרים
deviceWithName	: ה-ERROR(/Map) של מכשיר נוסף למעקב

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

מוסיפים מכשיר ITestDevice כדי שהמטא-נתונים יעקבו אחריו כשהמכשיר יוקצה. מגדיר את פרטי ה-build כ-null במפה.

פרמטרים
deviceName	String: השם של הגדרות המכשיר שרוצים לשייך ל-ITestDevice
testDevice	ITestDevice: להוספה למכשירים שהוקצו.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

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

פרמטרים
deviceName	String: שם תצורת המכשיר
buildinfo	IBuildInfo: IBuildInfo שמשויך לשם של הגדרות המכשיר.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

מוסיפים מאפיין קריאה.

פרמטרים
attributeName	String
attributeValue	String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

הוספת כמה מאפייני קריאה בבת אחת באמצעות UniqueMultiMap.

פרמטרים
attributesMap	MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

מוסיפים מדד של תזמון ההפעלה.

פרמטרים
timingEvent	IInvocationContext.TimingEvent
durationMillis	Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

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

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

getAttribute

public String getAttribute (String key)

שיטה נוחה לאחזור מאפיין של הקשר ההפעלה כצמד מפתח/ערך יחיד. אף פעם לא מחזירים ערך null.

פרמטרים
key	String

החזרות
String	מחרוזת ריקה אם המפתח לא קיים, אחרת הערך.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

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

החזרות
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

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

פרמטרים
deviceName	String

החזרות
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

החזרת הערך של IBuildInfo שמשויך ל-ITestDevice

פרמטרים
testDevice	ITestDevice

החזרות
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

הפונקציה מחזירה את השם של קבוצת המכשירים שמוגדרת בתצורת ה-XML מ-IBuildInfo. הפונקציה מחזירה ערך null אם לא ניתן למצוא התאמה ל-IBuildInfo

פרמטרים
info	IBuildInfo

החזרות
String

getBuildInfos

public abstract  getBuildInfos ()

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

החזרות

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

החזרות
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

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

פרמטרים
deviceName	String

החזרות
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

החזרת המפה של השיוך של פרטי המכשיר/הגרסה

החזרות

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

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

פרמטרים
serial	String

החזרות
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

החזרות

getDeviceName

public abstract String getDeviceName (ITestDevice device)

הפונקציה מחזירה את השם של קבוצת המכשירים בתצורת ה-XML מ-ITestDevice. הפונקציה מחזירה null אם לא ניתן להתאים את ITestDevice.

פרמטרים
device	ITestDevice

החזרות
String

getDevices

public abstract  getDevices ()

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

החזרות

getInvocationId

public abstract String getInvocationId ()

החזרות
String	מזהה ההפעלה המשויך או null אם לא מקושר להפעלה

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

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

החזרות

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

החזרות
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

החזרות
int

getSerials

public abstract  getSerials ()

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

החזרות

getShardsSerials

public abstract  getShardsSerials ()

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

החזרות

getTestTag

public abstract String getTestTag ()

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

החזרות
String

markReleasedEarly

public abstract void markReleasedEarly ()

מסמנים את המכשירים שיפורסמו מוקדם.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

הגדרת המתאר שמשויך להגדרת הבדיקה שהפעילה את ההפעלה

פרמטרים
configurationDescriptor	ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

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

פרמטרים
invocationContext	IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

הגדרת RecoveryMode של כל המכשירים שנכללים בהקשר

פרמטרים
mode	ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

הגדרת תג הבדיקה של ההפעלה.

פרמטרים
testTag	String

toProto

public abstract InvocationContext.Context toProto ()

סריאליזציה של מופע ההקשר ל-protobuf.

החזרות
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

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

החזרות
boolean