החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
↳	com.android.tradefed.invoker.InvocationContext

הטמעה כללית של IInvocationContext.

סיכום

‫constructors ציבוריים
`InvocationContext()` יוצר `BuildInfo` באמצעות ערכי מאפיינים שמוגדרים כברירת מחדל.

‫methods ציבוריים
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` מעקב אחרי מפה של שם המכשיר בהגדרה שמשויך ל-`ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` מוסיפים ITestDevice למעקב על ידי המטא-נתונים כשהמכשיר מוקצה.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` מוסיפים `IBuildInfo` כדי לעקוב אחרי שם ההגדרה של המכשיר.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` מוסיפים מאפיין הפעלה.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` אפשר להוסיף כמה מאפייני הפעלה בבת אחת באמצעות `UniqueMultiMap`.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` מוסיפים מספר סידורי למעקב כשהוא מוקצה לאחד מהרסיסים שמריצים בדיקות.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` פעולה הפוכה ל-`InvocationContext.toProto()` כדי להחזיר את המופע.
`MultiMap<String, String>`	`getAttributes()` הפונקציה מחזירה עותק של המפה שמכילה את כל מאפייני הקריאה.
`IBuildInfo`	`getBuildInfo(String deviceName)` החזרת `IBuildInfo` שמשויך לשם של הגדרת המכשיר שצוין.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` החזרת `IBuildInfo` שמשויך ל-`ITestDevice`
`String`	`getBuildInfoName(IBuildInfo info)` מחזירה את השם של קבוצת המכשירים בהגדרת ה-XML מתוך `IBuildInfo`.
`List<IBuildInfo>`	`getBuildInfos()` מחזירה את כל ה-`IBuildInfo` שמתבצע מעקב אחריהם עבור הקריאה הזו.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` מחזירה את המתאר שמשויך להגדרת הבדיקה שהפעילה את הקריאה
`ITestDevice`	`getDevice(String deviceName)` החזרת `ITestDevice` שמשויך לשם של הגדרת המכשיר שצוין.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` החזרת המיפוי של שיוך פרטי המכשיר/הגרסה
`ITestDevice`	`getDeviceBySerial(String serial)` הפונקציה מחזירה את `ITestDevice` שמשויך למספר הסידורי שצוין.
`List<String>`	`getDeviceConfigNames()` מחזירה את רשימת השמות של הגדרות המכשיר של המכשיר שעליו מתבצע מעקב בקריאה הזו
`String`	`getDeviceName(ITestDevice device)` מחזירה את השם של קבוצת המכשירים בהגדרת ה-XML מתוך `ITestDevice`.
`List<ITestDevice>`	`getDevices()` החזרת כל המכשירים שהוקצו למעקב עבור הקריאה הזו.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` מחזירה את הקשר של הפעלת המודול בזמן שהוא מופעל כחלק מחבילה.
`int`	`getNumDevicesAllocated()` הפונקציה מחזירה את מספר המכשירים שהוקצו לקריאה לפונקציה.
`List<String>`	`getSerials()` מחזירה את רשימת המספרים הסידוריים של המכשיר שעליו מתבצע מעקב בהפעלה הזו
`Map<Integer, List<String>>`	`getShardsSerials()` הפונקציה מחזירה את המיפוי של כל המספרים הסידוריים שעוקבים אחריהם ואת הרסיס שלהם שמעורב בשיתוף.
`String`	`getTestTag()` מחזירה את הקריאה test-tag.
`static boolean`	`isApiTrigger(IInvocationContext context)` הפונקציה מחזירה את התוצאה של זיהוי הפעלת בדיקה מבוססת API על סמך סוג הטריגר.
`static boolean`	`isOnDemand(IInvocationContext context)` הפונקציה מחזירה את הערך true אם זוהה הפעלה של בדיקה לפי דרישה על סמך סוג הטריגר.
`static boolean`	`isPresubmit(IInvocationContext context)` הפונקציה מחזירה תשובה אם זיהינו בדיקה לפני שליחה על סמך סוג הטריגר.
`void`	`lockAttributes()` נועלים את ההקשר כדי למנוע הוספה של מאפייני הפעלה נוספים.
`void`	`logInvocationMetrics()` מתעדים את מאפייני `InvocationMetricLogger` בקריאה לפונקציה.
`void`	`markReleasedEarly()` מסמנים את המכשירים שיוצאים משימוש מוקדם.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` מגדיר את המתאר שמשויך להגדרת הבדיקה שהפעילה את הקריאה
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` הגדרת הקשר של הפעלת המודול בזמן שהוא מופעל כחלק מחבילה.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` הגדרה של `RecoveryMode` של כל המכשירים שכלולים בהקשר
`void`	`setTestTag(String testTag)` מגדירה את תג הבדיקה של הקריאה לפונקציה.
`InvocationContext.Context`	`toProto()` מבצעים סריאליזציה של מופע ההקשר ל-protobuf.
`boolean`	`wasReleasedEarly()` הפונקציה מחזירה את הערך True אם המכשירים שוחררו מוקדם ולא יהיה בהם יותר שימוש, או את הערך False אם המכשירים לא שוחררו מוקדם.

‫constructors ציבוריים

InvocationContext

public InvocationContext ()

יוצר BuildInfo באמצעות ערכי מאפיינים שמוגדרים כברירת מחדל.

‫methods ציבוריים

addAllocatedDevice

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

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

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

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

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

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

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

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

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

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

מוסיפים מאפיין הפעלה.

פרמטרים
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

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

פרמטרים
`attributesMap`	`MultiMap`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                List<String> serials)

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

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

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

פעולה הפוכה ל-InvocationContext.toProto() כדי להחזיר את המופע.

פרמטרים
`protoContext`	`InvocationContext.Context`

החזרות
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

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

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

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

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

פרמטרים
`deviceName`	`String`

החזרות
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

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

פרמטרים
`testDevice`	`ITestDevice`

החזרות
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

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

פרמטרים
`info`	`IBuildInfo`

החזרות
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

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

החזרות
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

החזרות
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

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

פרמטרים
`deviceName`	`String`

החזרות
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

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

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

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

פרמטרים
`serial`	`String`

החזרות
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

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

החזרות
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

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

פרמטרים
`device`	`ITestDevice`

החזרות
`String`

getDevices

public List<ITestDevice> getDevices ()

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

החזרות
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

החזרות
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

החזרות
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

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

החזרות
`int`

getSerials

public List<String> getSerials ()

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

החזרות
`List<String>`

getShardsSerials

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

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

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

getTestTag

public String getTestTag ()

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

החזרות
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

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

פרמטרים
`context`	`IInvocationContext`

החזרות
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

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

פרמטרים
`context`	`IInvocationContext`

החזרות
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

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

פרמטרים
`context`	`IInvocationContext`

החזרות
`boolean`

lockAttributes

public void lockAttributes ()

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

logInvocationMetrics

public void logInvocationMetrics ()

מתעדים את מאפייני InvocationMetricLogger בקריאה לפונקציה.

markReleasedEarly

public void markReleasedEarly ()

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

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

פרמטרים
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

פרמטרים
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

פרמטרים
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

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

פרמטרים
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

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

החזרות
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

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

החזרות
`boolean`