IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

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

סיכום

ערכים קבועים

String INVOCATION_ID

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

‫methods ציבוריים

abstract void addAllocatedDevice(Map<String, ITestDevice> 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, List<String> 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 List<IBuildInfo> getBuildInfos()

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

abstract ConfigurationDescriptor getConfigurationDescriptor()

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

abstract ITestDevice getDevice(String deviceName)

החזרת ITestDevice שמשויך לשם של הגדרת המכשיר שצוין.

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

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

abstract ITestDevice getDeviceBySerial(String serial)

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

abstract List<String> getDeviceConfigNames()

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

abstract String getDeviceName(ITestDevice device)

מחזירה את השם של קבוצת המכשירים בהגדרת ה-XML מתוך ITestDevice.

abstract List<ITestDevice> getDevices()

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

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

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

abstract IInvocationContext getModuleInvocationContext()

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

abstract int getNumDevicesAllocated()

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

abstract List<String> getSerials()

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

abstract Map<Integer, List<String>> getShardsSerials()

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

abstract String getTestTag()

מחזירה את הקריאה test-tag.

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"

‫methods ציבוריים

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

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

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

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

מוסיפים ITestDevice למעקב על ידי המטא-נתונים כשהמכשיר מוקצה. יגדיר את פרטי הגרסה כ-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, 
                List<String> serials)

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

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

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 List<IBuildInfo> getBuildInfos ()

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

החזרות
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

החזרות
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

החזרת ITestDevice שמשויך לשם של הגדרת המכשיר שצוין.

פרמטרים
deviceName String

החזרות
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

החזרות
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

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

פרמטרים
serial String

החזרות
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

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

החזרות
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

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

פרמטרים
device ITestDevice

החזרות
String

getDevices

public abstract List<ITestDevice> getDevices ()

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

החזרות
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

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

החזרות
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

החזרות
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

החזרות
int

getSerials

public abstract List<String> getSerials ()

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

החזרות
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

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

החזרות
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

מחזירה את הקריאה test-tag.

החזרות
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