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 TEST_TYPE_KEY

public static final String TEST_TYPE_VALUE_PERFORMANCE

public static final String TOKEN_KEY

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)

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

static getAbisForBuildTargetArchFromSuite ()

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

IBuildInfo getBuildInfo ()

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

final IConfiguration getConfiguration ()

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

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

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

ModuleDefinition getDirectModule ()

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

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 אם אנו נמצאים כעת ב- 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 setIntraModuleSharding (boolean intraModuleSharding)
void setInvocationContext ( IInvocationContext invocationContext)

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

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

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

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_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

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

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

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

ITestSuite

public ITestSuite ()

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

addModuleMetadataExcludeFilters

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

פרמטרים
filters MultiMap

addModuleMetadataIncludeFilters

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

פרמטרים
filters MultiMap

cleanUpSuiteSetup

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

getAbis

public  getAbis (ITestDevice device)

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

פרמטרים
device ITestDevice

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

זורק
com.android.tradefed.device.DeviceNotAvailableException
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

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

public  getRequiredTokens (TestInformation testInfo)

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

פרמטרים
testInfo TestInformation

החזרות

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 : אובייקט 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

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

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 . מאזינים אלה ישמשו מחדש עבור כל מודול, הם לא יופעלו מחדש ולכן הם לא צריכים לקבל מצב פנימי.

החזרות

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