IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

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

סיכום

קבועים

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

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

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

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

קבועים

INVOCATION_ID

public static final String INVOCATION_ID

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

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

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

addAllocationDevice

public abstract void addAllocatedDevice ( deviceWithName)

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

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

addAllocationDevice

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

addSeriessFromShard

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

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

החזרות

getDeviceBySeries

public abstract ITestDevice getDeviceBySerial (String serial)

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

פרמטרים
serial String

החזרות
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

החזרות

GetDeviceName

public abstract String getDeviceName (ITestDevice device)

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

פרמטרים
device ITestDevice

החזרות
String

אחזור מכשירים

public abstract  getDevices ()

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

החזרות

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

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

החזרות

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

החזרות
IInvocationContext

getNumמכשיריםAllocation

public abstract int getNumDevicesAllocated ()

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

החזרות
int

getSeriess

public abstract  getSerials ()

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

החזרות

getShardsSeriess

public abstract  getShardsSerials ()

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

החזרות

getTestTag

public abstract String getTestTag ()

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

החזרות
String

MarkReleasedEAP

public abstract void markReleasedEarly ()

סימון המכשירים שמשגרים מוקדם יותר.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

פרמטרים
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

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

פרמטרים
invocationContext IInvocationContext

setRecoveryModeForAllDevice.

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

פרמטרים
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

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

פרמטרים
testTag String

לפרוטו

public abstract InvocationContext.Context toProto ()

הצגה טורית של מכונת ההקשר לתוך Protobuf.

החזרות
InvocationContext.Context

שוחרר מוקדם

public abstract boolean wasReleasedEarly ()

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

החזרות
boolean