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() .

סיכום

כיתות מקוננות

enum ITestSuite.MultiDeviceModuleStrategy

שדות

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 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)
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 ( TestInformation testInfo)

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

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 setDirectModule ( ModuleDefinition module)
void setInvocationContext ( IInvocationContext invocationContext)

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)

מזריק את המופע של ITestLogger

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 build.

getHostAbis ()

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

void setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
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

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

getAbis

public  getAbis (ITestDevice device)

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

פרמטרים
device ITestDevice

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

זורק
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 (TestInformation testInfo)

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

פרמטרים
testInfo TestInformation

החזרות

getRuntimeHint

public long getRuntimeHint ()

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

החזרות
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 : אובייקט TestInformation המכיל מידע שימושי להפעלת בדיקות.

listener ITestInvocationListener : ה- 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 לשימוש

setDirectModule

public void setDirectModule (ModuleDefinition module)

פרמטרים
module ModuleDefinition

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

פרמטרים
invocationContext IInvocationContext

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)

מזריק את המופע של ITestLogger

פרמטרים
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 נכון אם המודול צריך לרוץ, שקר אחרת.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

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

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

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

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

החזרות

getHostAbis

protected  getHostAbis ()

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

החזרות

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

פרמטרים
strategy ITestSuite.MultiDeviceModuleStrategy

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

פרמטרים
module ModuleDefinition

החזרות
boolean