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_END_TIME
|
public
static
final
String |
MODULE_METADATA_EXCLUDE_FILTER
|
public
static
final
String |
MODULE_METADATA_INCLUDE_FILTER
|
public
static
final
String |
MODULE_START_TIME
|
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_STAGING_ARTIFACTS
|
public
static
final
String |
SKIP_SYSTEM_STATUS_CHECKER
|
public
static
final
String |
STAGE_MODULE_ARTIFACTS
|
public
static
final
String |
TEST_TYPE_KEY
|
public
static
final
String |
TEST_TYPE_VALUE_PERFORMANCE
|
public
static
final
String |
TOKEN_KEY
|
protected
boolean |
mEnableResolveSymlinks
|
protected
boolean |
mRecoverDeviceByCvd
|
בנאים ציבוריים | |
---|---|
ITestSuite()
|
שיטות ציבוריות | |
---|---|
void
|
addModuleMetadataExcludeFilters(MultiMap<String, String> filters)
|
void
|
addModuleMetadataIncludeFilters(MultiMap<String, String> filters)
|
void
|
cleanUpSuiteSetup()
הזדמנות לנקות את כל מה שהיה צריך במהלך ההגדרה של הסוויטות, אבל לא נדרשות כדי להריץ את הבדיקות. |
boolean
|
filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
מחילים את מסנן המטא-נתונים על התצורה ובודקים אם ההגדרה צריכה לפעול. |
|
getAbis(ITestDevice device)
מקבל את קבוצת ממשקי ה-ABI שנתמכים על ידי בדיקת התאימות |
static
|
getAbisForBuildTargetArchFromSuite()
מחזירה את ה-Abis האפשריים מה-TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
כדי להטמיע את |
final
IConfiguration
|
getConfiguration()
הפונקציה מחזירה את ההפעלה |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
מעבירים את המכשיר לבדיקה. |
ModuleDefinition
|
getDirectModule()
הפונקציה מחזירה את |
boolean
|
getIntraModuleSharding()
|
IInvocationContext
|
getInvocationContext()
מחזירה את ההקשר של ההפעלה. |
MultiMap<String, String>
|
getModuleMetadataIncludeFilters()
|
ITestSuite.MultiDeviceModuleStrategy
|
getMultiDeviceStrategy()
|
final
String
|
getRequestedAbi()
מחזירה את ה-Abi המבוקש עם האפשרות a או --abi. |
|
getRequiredTokens(TestInformation testInfo)
מחזירה את רשימת האסימונים הנדרשים על ידי הבדיקה. |
long
|
getRuntimeHint()
הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות השנייה. |
File
|
getTestsDir()
|
boolean
|
isSplitting()
הפונקציה מחזירה את הערך True אם המיקום הנוכחי שלנו הוא |
abstract
|
loadTests()
שיטה מופשטת לטעינת הגדרות הבדיקה שיופעלו. |
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
דיווח על הבדיקות שלא בוצעו למאזינים הראשי שסופקו. |
void
|
reportNotExecuted(ITestInvocationListener listener)
דיווח על הבדיקות שלא בוצעו למאזינים הראשי שסופקו. |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
שיטת הרצה כללית לכל הבדיקות שנטען מ- |
void
|
setAbiName(String abiName)
הגדרת הערך של mAbiName |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
צריך להריץ את חבילת הבדיקה במצב Collector בלבד. לשם כך נדרשים כל בדיקות המשנה כדי להטמיע גם את הממשק הזה. |
void
|
setConfiguration(IConfiguration configuration)
החדרת |
void
|
setDevice(ITestDevice device)
צריך להזריק את המכשיר בבדיקה. |
void
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
הגדרת הרשימה של פריטי |
void
|
setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
|
void
|
setPrimaryAbiRun(boolean primaryAbiRun)
הגדרת הערך של mPrimaryAbiRun |
void
|
setShouldMakeDynamicModule(boolean dynamicModule)
כשמבצעים פיצול מבוזר, לא ניתן ליצור מודול שמשתף בדיקות במאגר, אחרת הפיצול בתוך המודול לא יפעל, ולכן אנחנו מאפשרים להשבית אותו. |
void
|
setSystemStatusChecker(
הגדרת ה- |
void
|
setTestLogger(ITestLogger testLogger)
החדרה של המכונה |
|
split(Integer shardCountHint, TestInformation testInfo)
גרסה חלופית של |
שיטות מוגנות | |
---|---|
|
createModuleListeners()
הפונקציה מחזירה את הרשימה של |
boolean
|
filterByRunnerType(IConfiguration config,
הפעילו את המסנן 'רשימת היתרים של Runner' והסירו את כל הרצים שלא נכללו ברשימת ההיתרים. |
|
getAbisForBuildTargetArch()
החזרת ה-Abis שנתמך על ידי ארכיטקטורת היעד של ה-build של המארח. |
|
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_END_TIME
public static final String MODULE_END_TIME
MODULE_metaDATA_EXCLUDE_ filter
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_metaDATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
MODULE_START_TIME
public static final String MODULE_START_TIME
פרמטר_מפתח
public static final String PARAMETER_KEY
PREPARER_WHITELIST
public static final String PREPARER_WHITELIST
PRIMARY_ABI_RUN
public static final String PRIMARY_ABI_RUN
RANDOM_SEED
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_STAGING_ARTIFACTS
public static final String SKIP_STAGING_ARTIFACTS
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
STAGE_MODULE_ARTIFACTS
public static final String STAGE_MODULE_ARTIFACTS
TEST_TYPE_KEY
public static final String TEST_TYPE_KEY
TEST_TYPE_VALUE_PERFORMANCE
public static final String TEST_TYPE_VALUE_PERFORMANCE
TOKEN_KEY
public static final String TOKEN_KEY
קישורי mEnableפתורSymlinks
protected boolean mEnableResolveSymlinks
mRecoverDeviceByCvd
protected boolean mRecoverDeviceByCvd
בנאים ציבוריים
ITestSuite
public ITestSuite ()
שיטות ציבוריות
addModuleMetadataהחרגתFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
פרמטרים | |
---|---|
filters |
MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
פרמטרים | |
---|---|
filters |
MultiMap |
הגדרת cleanUpSuite
public void cleanUpSuiteSetup ()
הזדמנות לנקות את כל מה שהיה צריך במהלך ההגדרה של הסוויטות, אבל לא נדרשות כדי להריץ את הבדיקות.
filterByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
מחילים את מסנן המטא-נתונים על התצורה ובודקים אם ההגדרה צריכה לפעול.
פרמטרים | |
---|---|
config |
IConfiguration : IConfiguration בבדיקה. |
include |
MultiMap : המסנן של המטא-נתונים כולל |
exclude |
MultiMap : מסנן ההחרגה של המטא-נתונים |
החזרות | |
---|---|
boolean |
הערך הוא True אם המודול צריך לפעול, אחרת False. |
getAbis
publicgetAbis (ITestDevice device)
מקבל את קבוצת ממשקי ה-ABI שנתמכים על ידי בדיקת התאימות AbiUtils.getAbisSupportedByCompatibility()
וגם על ידי המכשיר בבדיקה.
פרמטרים | |
---|---|
device |
ITestDevice |
החזרות | |
---|---|
|
הקבוצה של ממשקי ABI שעליהם מריצים את הבדיקות |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
מחזירה את ה-Abis האפשריים מה-TestSuiteInfo.
החזרות | |
---|---|
|
getBuildInfo
public IBuildInfo getBuildInfo ()
כדי להטמיע את ITestSuite
, יכול להיות שיהיה צורך בפרטי ה-build כדי לטעון את הבדיקות.
החזרות | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
הפונקציה מחזירה את ההפעלה IConfiguration
.
החזרות | |
---|---|
IConfiguration |
getDirectModule
public ModuleDefinition getDirectModule ()
הפונקציה מחזירה את ModuleDefinition
כך שתתבצע ישירות, או ערך null אם אין עדיין (כשה-ITestSuite לא פוצל עדיין).
החזרות | |
---|---|
ModuleDefinition |
getIntraModuleSharding
public boolean getIntraModuleSharding ()
החזרות | |
---|---|
boolean |
getInvocationContext
public IInvocationContext getInvocationContext ()
מחזירה את ההקשר של ההפעלה.
החזרות | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
החזרות | |
---|---|
MultiMap<String, String> |
getMultiDeviceStrategy
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
החזרות | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
getRequestedAbi
public final String getRequestedAbi ()
מחזירה את ה-Abi המבוקש עם האפשרות a או --abi.
החזרות | |
---|---|
String |
getrequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
מחזירה את רשימת האסימונים הנדרשים על ידי הבדיקה. הפונקציה מחזירה ערך null אם אין תמיכה באסימון.
פרמטרים | |
---|---|
testInfo |
TestInformation |
החזרות | |
---|---|
|
getRuntimeHint
public long getRuntimeHint ()
הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות השנייה. הזמן משמש לטעינת היתרה המפוצלת
החזרות | |
---|---|
long |
getTestsDir
public File getTestsDir ()
החזרות | |
---|---|
File |
מפצל
public boolean isSplitting ()
הפונקציה מחזירה את הערך True אם המיקום הנוכחי שלנו הוא IShardableTest.split(int)
.
החזרות | |
---|---|
boolean |
בדיקות טעינה
public abstractloadTests ()
שיטה מופשטת לטעינת הגדרות הבדיקה שיופעלו. כל בדיקה מוגדרת לפי IConfiguration
ושם ייחודי שבאמצעותו היא תדווח על התוצאות.
החזרות | |
---|---|
|
דוח שלא בוצע
public void reportNotExecuted (ITestInvocationListener listener, String message)
דיווח על הבדיקות שלא בוצעו למאזינים הראשי שסופקו. צריך לדווח עליהם כנכשלים עם ההודעה NOT_EXECUTED_FAILURE
.
פרמטרים | |
---|---|
listener |
ITestInvocationListener : המאזינים העיקריים שבהם מדווחים על התוצאות שלא בוצעו. |
message |
String : ההודעה שתשויך לכשל שלא בוצע. |
דוח שלא בוצע
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 |
|
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
צריך להריץ את חבילת הבדיקה במצב Collector בלבד. לשם כך נדרשים כל בדיקות המשנה כדי להטמיע גם את הממשק הזה.
הגדרה
public void setConfiguration (IConfiguration configuration)
החדרת IConfiguration
בשימוש.
פרמטרים | |
---|---|
configuration |
IConfiguration |
הגדרת מכשיר
public void setDevice (ITestDevice device)
צריך להזריק את המכשיר בבדיקה.
פרמטרים | |
---|---|
device |
ITestDevice : ITestDevice לשימוש |
setDirectModule
public void setDirectModule (ModuleDefinition module)
פרמטרים | |
---|---|
module |
ModuleDefinition |
setIntraModuleSharding
public void setIntraModuleSharding (boolean intraModuleSharding)
פרמטרים | |
---|---|
intraModuleSharding |
boolean |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
פרמטרים | |
---|---|
invocationContext |
IInvocationContext |
setMetricCollectors
public void setMetricCollectors (collectors)
הגדרת הרשימה של פריטי IMetricCollector
שהוגדרו להרצת הבדיקה.
פרמטרים | |
---|---|
collectors |
|
setMultiDeviceStrategy
public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
פרמטרים | |
---|---|
strategy |
ITestSuite.MultiDeviceModuleStrategy |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
הגדרת הערך של mPrimaryAbiRun
פרמטרים | |
---|---|
primaryAbiRun |
boolean |
setShooldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
כשמבצעים פיצול מבוזר, לא ניתן ליצור מודול שמשתף בדיקות במאגר, אחרת הפיצול בתוך המודול לא יפעל, ולכן אנחנו מאפשרים להשבית אותו.
פרמטרים | |
---|---|
dynamicModule |
boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
הגדרת ה-ISystemStatusChecker
מההגדרות של הבדיקה.
פרמטרים | |
---|---|
systemCheckers |
|
setTestLogger
public void setTestLogger (ITestLogger testLogger)
החדרה של המכונה ITestLogger
פרמטרים | |
---|---|
testLogger |
ITestLogger |
פיצול
publicsplit (Integer shardCountHint, TestInformation testInfo)
גרסה חלופית של split(int)
, שמספקת גם TestInformation
שמכיל מידע מוקדם מההורה שיוצר את הפיצולים. האפשרות הזו שימושית אם צריך לגשת לדברים כמו
מידע על המכשיר או build במהלך החלוקה.
פרמטרים | |
---|---|
shardCountHint |
Integer : מספר המפוצלים שניסינו ליצור. |
testInfo |
TestInformation : ההורה TestInformation |
החזרות | |
---|---|
|
אוסף של בדיקות משנה שיבוצעו בנפרד או null אם הבדיקה לא ניתנת לפיצול כרגע |
שיטות מוגנות
createModuleListeners.
protectedcreateModuleListeners ()
הפונקציה מחזירה את הרשימה של ITestInvocationListener
הרלוונטית לרמה ModuleListener
. המאזינים האלה יעשו שימוש חוזר בכל מודול, והם לא יעברו לשימוש מחדש ולכן
הם לא צריכים להניח מצב פנימי.
החזרות | |
---|---|
|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
הפעילו את המסנן 'רשימת היתרים של Runner' והסירו את כל הרצים שלא נכללו ברשימת ההיתרים. אם בהגדרה מסוימת יש כמה הרצתים, ייתכן שחלקם יוסרו וההגדרה תמשיך לפעול.
פרמטרים | |
---|---|
config |
IConfiguration : IConfiguration בבדיקה. |
allowedRunners |
: רשימת ההיתרים הנוכחית להרצה. |
החזרות | |
---|---|
boolean |
הערך הוא True אם מודול ההגדרה מורשה לפעול, אחרת False. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
החזרת ה-Abis שנתמך על ידי ארכיטקטורת היעד של ה-build של המארח. חשיפה לבדיקה.
החזרות | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
הפונקציה מחזירה את ה-Abis של המכונה המארחת.
החזרות | |
---|---|
|
needModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
פרמטרים | |
---|---|
module |
ModuleDefinition |
החזרות | |
---|---|
boolean |