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 שנתמכים על ידי בדיקת התאימות AbiUtils.getAbisSupportedByCompatibility() וגם על ידי המכשיר בבדיקה.

static getAbisForBuildTargetArchFromSuite()

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

IBuildInfo getBuildInfo()

כדי להטמיע את ITestSuite, יכול להיות שיהיה צורך בפרטי ה-build כדי לטעון את הבדיקות.

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)
void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

צריך להריץ את חבילת הבדיקה במצב Collector בלבד. לשם כך נדרשים כל בדיקות המשנה כדי להטמיע גם את הממשק הזה.

void setConfiguration(IConfiguration configuration)

החדרת IConfiguration בשימוש.

void setDevice(ITestDevice device)

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

void setDirectModule(ModuleDefinition module)
void setIntraModuleSharding(boolean intraModuleSharding)
void setInvocationContext(IInvocationContext invocationContext)

void setMetricCollectors( collectors)

הגדרת הרשימה של פריטי IMetricCollector שהוגדרו להרצת הבדיקה.

void setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
void setPrimaryAbiRun(boolean primaryAbiRun)

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

void setShouldMakeDynamicModule(boolean dynamicModule)

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

void setSystemStatusChecker( systemCheckers)

הגדרת ה-ISystemStatusChecker מההגדרות של הבדיקה.

void setTestLogger(ITestLogger testLogger)

החדרה של המכונה ITestLogger

split(Integer shardCountHint, TestInformation testInfo)

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

שיטות מוגנות

createModuleListeners()

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

boolean filterByRunnerType(IConfiguration config, allowedRunners)

הפעילו את המסנן 'רשימת היתרים של 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

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

public  getAbis (ITestDevice device)

מקבל את קבוצת ממשקי ה-ABI שנתמכים על ידי בדיקת התאימות AbiUtils.getAbisSupportedByCompatibility() וגם על ידי המכשיר בבדיקה.

פרמטרים
device ITestDevice

החזרות
הקבוצה של ממשקי ABI שעליהם מריצים את הבדיקות

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

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

החזרות

getBuildInfo

public IBuildInfo getBuildInfo ()

כדי להטמיע את ITestSuite, יכול להיות שיהיה צורך בפרטי ה-build כדי לטעון את הבדיקות.

החזרות
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 ()

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

החזרות
long

getTestsDir

public File getTestsDir ()

החזרות
File

מפצל

public boolean isSplitting ()

הפונקציה מחזירה את הערך True אם המיקום הנוכחי שלנו הוא IShardableTest.split(int).

החזרות
boolean

בדיקות טעינה

public abstract  loadTests ()

שיטה מופשטת לטעינת הגדרות הבדיקה שיופעלו. כל בדיקה מוגדרת לפי 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

setBuild

public void setBuild (IBuildInfo buildInfo)

פרמטרים
buildInfo IBuildInfo

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

פיצול

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

פרמטרים
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 שנתמך על ידי ארכיטקטורת היעד של ה-build של המארח. חשיפה לבדיקה.

החזרות

getHostAbis

protected  getHostAbis ()

הפונקציה מחזירה את ה-Abis של המכונה המארחת.

החזרות

needModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

פרמטרים
module ModuleDefinition

החזרות
boolean