InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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

מחלקות משנה ישירות ידועות ‫DelegatedInvocationExecution, ‏ ParentSandboxInvocationExecution, ‏ RemoteInvocationExecution, ‏ SandboxedInvocationExecution DelegatedInvocationExecution ‫InvocationExecution שמעבירים את ההרצה לקובץ בינארי אחר של Tradefed.  ParentSandboxInvocationExecution גרסה של InvocationExecution לפעולות מיוחדות של קריאה לפונקציה הראשית כשמריצים ארגז חול.  RemoteInvocationExecution הטמעה של InvocationExecution שמפעילה הרצה מרחוק.  SandboxedInvocationExecution הרצה מיוחדת של הקריאה בתוך ארגז החול: זוהי InvocationExection כשנמצאים בתוך ארגז החול ומריצים את הפקודה.

---

המחלקות שמתארות את כל שלבי ההפעלה: הורדת build, הכנת היעד, הרצת בדיקות וניקוי. אפשר להרחיב את ההגדרה כדי לשנות את התנהגות ברירת המחדל של חלק מהשלבים. סדר השלבים נקבע על ידי TestInvocation.

סיכום

ערכים קבועים
String	ADB_VERSION_KEY
String	JAVA_CLASSPATH_KEY
String	JAVA_VERSION_KEY

‫Constructors ציבוריים
InvocationExecution()

‫methods ציבוריים
void	cleanUpBuilds(IInvocationContext context, IConfiguration config) מריצים את שלב הניקוי build_provider.
void	doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception) מבצעים את שלב הניקוי של target_preparer ו-multi_target_preparer.
void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener) מריצים את שלב ההגדרה של target_preparer ו-multi_target_preparer.
void	doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) מבצעים את שלב הניקוי של target_preparer ו-multi_target_preparer.
boolean	fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) מריצים את השלב build_provider של הקריאה.
void	reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) לדווח על חלק מיומני המכשיר בשלב אחר של ההפעלה.
void	runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception) מפעילים את ITestDevice.postInvocationTearDown(Throwable) לכל מכשיר שכלול בהפעלה.
void	runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger) מפעילים את ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) לכל מכשיר שכלול בהפעלה.
void	runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener) מריצים את הבדיקה.
boolean	shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) מנסים לפצל את ההגדרה להגדרות משנה, כדי לתזמן מחדש את ההרצה בכמה משאבים במקביל.

שיטות מוגנות
void	collectAutoInfo(IConfiguration config, TestInformation info) איסוף אוטומטי של מידע מסוים במכשיר הראשי שנבדק.
IShardHelper	createShardHelper() יוצר את IShardHelper שבו רוצים להשתמש ומחזיר אותו.
void	customizeDevicePreInvocation(IConfiguration config, IInvocationContext context) אפשרות להתאים אישית חלק מהמכשיר לפני preInvocationSetup.
String	getAdbVersion() הפונקציה מחזירה את גרסת ה-adb שנמצאת בשימוש עבור הקריאה.
List<ITargetPreparer>	getLabPreparersToRun(IConfiguration config, String deviceName) אחזור רשימה של מכיני מעבדה להפעלה במכשיר הזה.
List<ITargetPreparer>	getTargetPreparersToRun(IConfiguration config, String deviceName) אחזור רשימה של מכיני יעדים להפעלה במכשיר הזה.
void	linkExternalDirs(IBuildInfo info, TestInformation testInfo)
void	logHostAdb(IConfiguration config, ITestLogger logger) אוספים את היומנים מ-$TMPDIR/adb.$UID.log.
Throwable	runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> trackPreparersMap)
void	setTestTag(IBuildInfo info, IConfiguration config) הגדרת תג הבדיקה בפרטי הגרסה.

ערכים קבועים

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

ערך קבוע: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

ערך קבוע: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

ערך קבוע: "java_version"

‫constructors ציבוריים

InvocationExecution

public InvocationExecution ()

‫methods ציבוריים

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

פרמטרים
context	‫IInvocationContext: ה-IInvocationContext של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

מבצעים את שלב הניקוי של target_preparer ו-multi_target_preparer. המכשירים מנקים את עצמם.

פרמטרים
context	‫IInvocationContext: ה-IInvocationContext של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.
exception	‫Throwable: החריגה המקורית שהופעלה על ידי הרצת הבדיקה.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

מריצים את שלב ההגדרה של target_preparer ו-multi_target_preparer. מגדיר את כל המכשירים שנדרשים להרצת הבדיקה.

פרמטרים
testInfo	‫TestInformation: ה-TestInformation של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.
listener	‫ITestLogger: ITestLogger כדי לדווח על יומני כשל בהגדרה.

הקפצת הודעות שגיאה (throw)
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

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

פרמטרים
testInfo	‫TestInformation: ה-TestInformation של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.
logger	‫ITestLogger: ITestLogger לדיווח על יומנים.
exception	‫Throwable: החריגה המקורית שהופעלה על ידי הרצת הבדיקה.

הקפצת הודעות שגיאה (throw)
Throwable

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

מריצים את השלב build_provider של הקריאה.

פרמטרים
testInfo	‫TestInformation: ה-TestInformation של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.
rescheduler	‫IRescheduler: IRescheduler, לתזמון מחדש של חלקים מההפעלה לביצוע במשאבים אחרים
listener	‫ITestInvocationListener: ITestInvocation לדיווח על כשלים בהורדת גרסת Build.

החזרות
boolean	‫True אם הורדנו את הגרסה בהצלחה, אחרת False.

הקפצת הודעות שגיאה (throw)
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

לדווח על חלק מיומני המכשיר בשלב אחר של ההפעלה. לדוגמה: logcat.

פרמטרים
device	‫ITestDevice: המכשיר שממנו ידווחו היומנים.
listener	‫ITestLogger: כלי הרישום של היומנים.
stage	‫TestInvocation.Stage: השלב של הקריאה שאנחנו נמצאים בו.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

מפעילים את ITestDevice.postInvocationTearDown(Throwable) לכל מכשיר שכלול בהפעלה.

פרמטרים
context	‫IInvocationContext: ה-IInvocationContext של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.
exception	‫Throwable: החריגה המקורית שהופעלה על ידי הבדיקה, אם יש כזו.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

מפעילים את ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) לכל מכשיר שכלול בהפעלה.

פרמטרים
context	‫IInvocationContext: ה-IInvocationContext של ההפעלה.
config	‫IConfiguration: IConfiguration של הרצת הבדיקה הזו.
logger	‫ITestLogger: ITestLogger לדיווח על יומנים.

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException
TargetSetupError

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

מריצים את הבדיקה.

פרמטרים
info	‫TestInformation: TestInformation להרצת בדיקות.
config	‫IConfiguration: ה-IConfiguration שרוצים להריץ
listener	‫ITestInvocationListener: ITestInvocationListener תוצאות הבדיקה

הקפצת הודעות שגיאה (throw)
Throwable

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

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

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

פרמטרים
config	‫IConfiguration: IConfiguration הנוכחי.
testInfo	‫TestInformation: TestInformation שמכיל את פרטי הבדיקות.
rescheduler	‫IRescheduler: IRescheduler.
logger	‫ITestLogger: ITestLogger שמשמש לרישום בקובץ יומן במהלך חלוקה למקטעים.

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

שיטות מוגנות

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

איסוף אוטומטי של מידע מסוים במכשיר הראשי שנבדק.

פרמטרים
config	IConfiguration
info	TestInformation

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

יוצר את IShardHelper שבו רוצים להשתמש ומחזיר אותו.

החזרות
IShardHelper

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

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

פרמטרים
config	‫IConfiguration: ההגדרה של הקריאה.
context	‫IInvocationContext: ההקשר הנוכחי של הקריאה.

getAdbVersion

protected String getAdbVersion ()

הפונקציה מחזירה את גרסת ה-adb שנמצאת בשימוש עבור הקריאה.

החזרות
String

getLabPreparersToRun

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

מוחלף בכיתות של ארגז חול כדי להגביל את ההרצה של קבצים להכנת שיעור Lab בתוך ארגז החול (sandbox) של הצאצא

פרמטרים
config	IConfiguration
deviceName	String

החזרות
List<ITargetPreparer>

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

מוחלף בכיתות של ארגז חול כדי להגביל את ההרצה של קבצים להכנת שיעור Lab בתוך ארגז החול (sandbox) של הצאצא

פרמטרים
config	IConfiguration
deviceName	String

החזרות
List<ITargetPreparer>

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

פרמטרים
info	IBuildInfo
testInfo	TestInformation

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

אוספים את היומנים מ-$TMPDIR/adb.$UID.log.

פרמטרים
config	IConfiguration
logger	ITestLogger

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

פרמטרים
testInfo	TestInformation
device	ITestDevice
deviceName	String
deviceIndex	int
logger	ITestLogger
exception	Throwable
preparersToRun	List
trackPreparersMap	Map

החזרות
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

הגדרת תג הבדיקה בפרטי הגרסה.

פרמטרים
info	IBuildInfo
config	IConfiguration