ביצוע

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)

יש להפעיל את 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 שבה נעשה שימוש לביצוע ההפעלה.

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, preparersToRun, trackPreparersMap)
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

הכנה למעבדה

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

המדיניות בוטלה בכיתות ב-Sandbox כדי להגביל את ההפעלה של מכינים שיעורי Lab בתוך ה-Sandbox צאצא

פרמטרים
config IConfiguration

deviceName String

החזרות

GetTargetPreparersToRun

protected  getTargetPreparersToRun (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