ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest, IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest, ITestLoggerReceiver

java.lang.Object
com.android.tradefed.testtype.suite.ITestSuite


מחלקה מופשטת משמשת להפעלת Test Suite. מחלקה זו מספקת את הבסיס לאופן הפעלת הסוויטה. כל מימוש יכול להגדיר את רשימת הבדיקות באמצעות שיטת loadTests() .

סיכום

שדות

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RANDOM_SEED

public static final String REBOOT_BEFORE_TEST

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TOKEN_KEY

בנאים ציבוריים

ITestSuite ()

שיטות ציבוריות

void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
final void enableRebootBeforeTest ()

מגדיר אתחול-לפני-בדיקה ל-true.

getAbis (ITestDevice device)

מקבל את ערכת ABIs הנתמכת הן על ידי בדיקת תאימות AbiUtils.getAbisSupportedByCompatibility() והן על ידי המכשיר הנבדק.

static getAbisForBuildTargetArchFromSuite ()

מחזיר את ה-abis האפשרי מ-TestSuiteInfo.

IBuildInfo getBuildInfo ()

יישום של ITestSuite עשוי לדרוש את פרטי הבנייה כדי לטעון את הבדיקות.

final IConfiguration getConfiguration ()

מחזירה את ה- IConfiguration של ההזמנה.

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

קבל את המכשיר בבדיקה.

ModuleDefinition getDirectModule ()

מחזירה את ModuleDefinition לביצוע ישירות, או null אם אין עדיין (כאשר ה-ITestSuite עדיין לא נחתך).

IInvocationContext getInvocationContext ()

מחזירה את הקשר ההתקשרות.

final String getRequestedAbi ()

מחזיר את ה-abi המבוקש עם האפשרות -a או --abi.

getRequiredTokens ()
long getRuntimeHint ()

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

File getTestsDir ()
boolean isSplitting ()

מחזירה true אם אנו נמצאים כעת ב- IShardableTest.split(int) .

abstract loadTests ()

שיטה מופשטת לטעינת תצורת הבדיקות שתופעל.

void reportNotExecuted (ITestInvocationListener listener, String message)

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

void reportNotExecuted (ITestInvocationListener listener)

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

final void run (TestInformation testInfo, ITestInvocationListener listener)

שיטת הפעלה כללית עבור כל הבדיקות שנטענו מ- loadTests() .

void setAbiName (String abiName)

הגדר את הערך של mAbiName

final void setAbis ( abis) setAbis ( abis)
void setBuild (IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

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

void setConfiguration ( IConfiguration configuration)

מזריק את IConfiguration בשימוש.

void setDevice (ITestDevice device)

הזרקו את המכשיר הנבדק.

void setInvocationContext (IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

קבל את ה-Guice Injector הנוכחי מהקריאה.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

מגדיר את רשימת ה- IMetricCollector שהוגדרו להפעלת המבחן.

void setPrimaryAbiRun (boolean primaryAbiRun)

הגדר את הערך של mPrimaryAbiRun

void setShouldMakeDynamicModule (boolean dynamicModule)

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

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

מגדיר את ISystemStatusChecker s מהתצורה של הבדיקה.

void setTestLogger (ITestLogger testLogger)

split (Integer shardCountHint, TestInformation testInfo)

גרסה חלופית של split(int) המספקת גם TestInformation שמכיל מידע מוקדם מההורה שיוצר את הרסיסים.

שיטות מוגנות

createModuleListeners ()

מחזירה את רשימת ה- ITestInvocationListener הרלוונטית לרמת ModuleListener .

boolean filterByConfigMetadata ( IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)

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

boolean filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

החל את סינון רשימת ההיתרים של Runner, הסר כל רץ שלא היה ברשימת ההיתרים.

getAbisForBuildTargetArch ()

החזר את ה-ABIS הנתמך על ידי ארכיטקטורת היעד של בניית Host.

getHostAbis ()

מחזיר את המכונה המארח abis.

boolean shouldModuleRun ( ModuleDefinition module)

שדות

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

זרע אקראי

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

בנאים ציבוריים

ITestSuite

public ITestSuite ()

שיטות ציבוריות

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

פרמטרים
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

פרמטרים
filters MultiMap

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

מגדיר אתחול-לפני-בדיקה ל-true.

getAbis

public  getAbis (ITestDevice device)

מקבל את ערכת ABIs הנתמכת הן על ידי בדיקת תאימות AbiUtils.getAbisSupportedByCompatibility() והן על ידי המכשיר הנבדק.

פרמטרים
device ITestDevice

החזרות
ערכת ה-ABI להפעיל את הבדיקות

זורק
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

מחזיר את ה-abis האפשרי מ-TestSuiteInfo.

החזרות

getBuildInfo

public IBuildInfo getBuildInfo ()

יישום של ITestSuite עשוי לדרוש את פרטי הבנייה כדי לטעון את הבדיקות.

החזרות
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

מחזירה את ה- IConfiguration של ההזמנה.

החזרות
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

החזרות
ITestLogger

getDevice

public ITestDevice getDevice ()

קבל את המכשיר בבדיקה.

החזרות
ITestDevice ה- ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

מחזירה את ModuleDefinition לביצוע ישירות, או null אם אין עדיין (כאשר ה-ITestSuite עדיין לא נחתך).

החזרות
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

מחזירה את הקשר ההתקשרות.

החזרות
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

מחזיר את ה-abi המבוקש עם האפשרות -a או --abi.

החזרות
String

getRequiredTokens

public  getRequiredTokens ()

החזרות

getRuntimeHint

public long getRuntimeHint ()

החזר את זמן הריצה הצפוי של הבדיקה באלפיות שניות. הזמן מנוצל לביצוע הטעינה של ה-Sharded Balance

החזרות
long

getTestsDir

public File getTestsDir ()

החזרות
File

הוא פיצול

public boolean isSplitting ()

מחזירה true אם אנו נמצאים כעת ב- IShardableTest.split(int) .

החזרות
boolean

בדיקות עומס

public abstract  loadTests ()

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

החזרות

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

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

פרמטרים
listener ITestInvocationListener : המאזין הראשי שבו לדווח על התוצאות שלא בוצעו.

message String : ההודעה שיש לשייך לכישלון שלא בוצע.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

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

פרמטרים
listener ITestInvocationListener : המאזין הראשי שבו לדווח על התוצאות שלא בוצעו.

לָרוּץ

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

שיטת הפעלה כללית עבור כל הבדיקות שנטענו מ- loadTests() .

פרמטרים
testInfo TestInformation

listener ITestInvocationListener

זורק
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

הגדר את הערך של mAbiName

פרמטרים
abiName String

setAbis

public final void setAbis ( abis)

פרמטרים
abis

setBuild

public void setBuild (IBuildInfo buildInfo)

פרמטרים
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

מזריק את IConfiguration בשימוש.

פרמטרים
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

הזרקו את המכשיר הנבדק.

פרמטרים
device ITestDevice : ה- ITestDevice לשימוש

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

פרמטרים
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

קבל את ה-Guice Injector הנוכחי מהקריאה. זה אמור לאפשר לנו להמשיך בהזרקת האובייקט של מודולים.

פרמטרים
injector Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

מגדיר את רשימת ה- IMetricCollector שהוגדרו להפעלת המבחן.

פרמטרים
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

הגדר את הערך של mPrimaryAbiRun

פרמטרים
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

פרמטרים
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

מגדיר את ISystemStatusChecker s מהתצורה של הבדיקה.

פרמטרים
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

פרמטרים
testLogger ITestLogger

לְפַצֵל

public  split (Integer shardCountHint, 
                TestInformation testInfo)

גרסה חלופית של split(int) המספקת גם TestInformation שמכיל מידע מוקדם מההורה שיוצר את הרסיסים. זה שימושי אם יש צורך לגשת לדברים כמו מידע על מכשיר או מבנה במהלך הריסוק.

פרמטרים
shardCountHint Integer : ספירת הרסיסים הניסיונות.

testInfo TestInformation : ה- TestInformation האב

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

שיטות מוגנות

createModuleListeners

protected  createModuleListeners ()

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

החזרות

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

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

פרמטרים
config IConfiguration : ה- IConfiguration המוערך.

include MultiMap : המטא נתונים כוללים מסנן

exclude MultiMap : מסנן אי הכללה של מטא נתונים

החזרות
boolean נכון אם המודול צריך לרוץ, false אחרת.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

פרמטרים
config IConfiguration : ה- IConfiguration המוערך.

allowedRunners : רשימת הלבנים הנוכחית של הרצים.

החזרות
boolean True אם מודול התצורה מורשה לפעול, false אחרת.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

החזר את ה-ABIS הנתמך על ידי ארכיטקטורת היעד של בניית Host. נחשף לבדיקה.

החזרות

getHostAbis

protected  getHostAbis ()

מחזיר את המכונה המארח abis.

החזרות

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

פרמטרים
module ModuleDefinition

החזרות
boolean