ביצוע
public
class
InvocationExecution
extends Object
implements
IInvocationExecution
JavaScript.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
מחלקה שמתארת את כל שלבי ההפעלה: בניית הורדה, target_prep, הרצת בדיקות, ניקוי.
אפשר להרחיב את ההגדרה כדי לעקוף את התנהגות ברירת המחדל של שלבים מסוימים. סדר השלבים נקבע לפי
TestInvocation
סיכום
שדות | |
---|---|
public
static
final
String |
ADB_VERSION_KEY
|
public
static
final
String |
JAVA_CLASSPATH_KEY
|
public
static
final
String |
JAVA_VERSION_KEY
|
בנאים ציבוריים | |
---|---|
InvocationExecution()
|
שיטות ציבוריות | |
---|---|
void
|
cleanUpBuilds(IInvocationContext context, IConfiguration config)
מבצעים את שלב הניקוי של build_provider. |
void
|
doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)
מבצעים את השלב target_preparer ו-multi_target_preparer cleanUp. |
void
|
doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)
מבצעים את השלב target_preparer ו-multi_target_preparer setUp. |
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)
יש להפעיל את |
void
|
runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)
יש להפעיל את |
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()
יוצרים החזרה של |
void
|
customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)
מומלץ להתאים אישית חלק מהמכשיר לפני ההגדרה preInvocationSetup. |
String
|
getAdbVersion()
מחזירה את גרסת ה-adb שבה נעשה שימוש לביצוע ההפעלה. |
|
getLabPreparersToRun(IConfiguration config, String deviceName)
אחזור רשימה של מכינים שיעורי Lab להפעלה במכשיר הזה. |
|
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,
|
void
|
setTestTag(IBuildInfo info, IConfiguration config)
טיפול בהגדרת תג הבדיקה בפרטי ה-build. |
שדות
ADB_VERSION_KEY
public static final String ADB_VERSION_KEY
JAVA_CLASSPATH_KEY
public static final String JAVA_CLASSPATH_KEY
JAVA_VERSION_KEY
public static final String JAVA_VERSION_KEY
בנאים ציבוריים
ביצוע
public InvocationExecution ()
שיטות ציבוריות
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
מבצעים את שלב הניקוי של build_provider. משויך לאחזור ה-build.
פרמטרים | |
---|---|
context |
IInvocationContext : ה-IInvocationContext של ההפעלה. |
config |
IConfiguration : ה-IConfiguration בהרצת הבדיקה הזו. |
DoCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
מבצעים את השלב target_preparer ו-multi_target_preparer cleanUp. האם המכשירים נקיים למעלה.
פרמטרים | |
---|---|
context |
IInvocationContext : ה-IInvocationContext של ההפעלה. |
config |
IConfiguration : ה-IConfiguration בהרצת הבדיקה הזו. |
exception |
Throwable : החריגה המקורית שגרמה לבדיקה. |
לעשות הגדרה
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
מבצעים את השלב target_preparer ו-multi_target_preparer setUp. האם כל המכשירים מתאימים שנדרשת לצורך הרצת הבדיקה.
פרמטרים | |
---|---|
testInfo |
TestInformation : ה-TestInformation של ההפעלה. |
config |
IConfiguration : ה-IConfiguration בהרצת הבדיקה הזו. |
listener |
ITestLogger : ITestLogger לדיווח על יומנים של כשלים בהגדרה. |
קליעות | |
---|---|
BuildError |
|
DeviceNotAvailableException |
|
TargetSetupError |
סגירה
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 : החריגה המקורית שגרמה לבדיקה. |
אחזור Build
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 אם הורדנו את ה-build בהצלחה, אחרת false. |
קליעות | |
---|---|
BuildRetrievalError |
|
DeviceNotAvailableException |
יומני דוחות
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 לדיווח על יומנים. |
קליעות | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
בדיקות runTest
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
הרצת הבדיקה.
פרמטרים | |
---|---|
info |
TestInformation : ה-TestInformation שאיתו מריצים בדיקות. |
config |
IConfiguration : ה-IConfiguration להפעלה |
listener |
ITestInvocationListener : ITestInvocationListener של תוצאות הבדיקה |
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 |
שיטות מוגנות
collectedAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
איסוף אוטומטי של חלק מהמידע במכשיר הראשי שנמצא בבדיקה.
פרמטרים | |
---|---|
config |
IConfiguration |
info |
TestInformation |
קליעות | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
יוצרים החזרה של IShardHelper
לשימוש.
החזרות | |
---|---|
IShardHelper |
הפעלה מראש של מכשיר מותאם אישית
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
מומלץ להתאים אישית חלק מהמכשיר לפני ההגדרה preInvocationSetup.
פרמטרים | |
---|---|
config |
IConfiguration : הגדרת ההפעלה. |
context |
IInvocationContext : הקשר ההפעלה הנוכחי. |
גרסת getAdbVersion
protected String getAdbVersion ()
מחזירה את גרסת ה-adb שבה נעשה שימוש לביצוע ההפעלה.
החזרות | |
---|---|
String |
הכנה למעבדה
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
אחזור רשימה של מכינים שיעורי Lab להפעלה במכשיר הזה.
המדיניות בוטלה בכיתות ב-Sandbox כדי להגביל את ההפעלה של מכינים שיעורי Lab בתוך ה-Sandbox צאצא
פרמטרים | |
---|---|
config |
IConfiguration |
deviceName |
String |
החזרות | |
---|---|
|
GetTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
אחזור רשימה של מכינים יעד להפעלה במכשיר הזה.
המדיניות בוטלה בכיתות ב-Sandbox כדי להגביל את ההפעלה של מכינים שיעורי Lab בתוך ה-Sandbox צאצא
פרמטרים | |
---|---|
config |
IConfiguration |
deviceName |
String |
החזרות | |
---|---|
|
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,preparersToRun, trackPreparersMap)
פרמטרים | |
---|---|
testInfo |
TestInformation |
device |
ITestDevice |
deviceName |
String |
deviceIndex |
int |
logger |
ITestLogger |
exception |
Throwable |
preparersToRun |
|
trackPreparersMap |
|
החזרות | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
טיפול בהגדרת תג הבדיקה בפרטי ה-build.
פרמטרים | |
---|---|
info |
IBuildInfo |
config |
IConfiguration |