דף זה תורגם על ידי Cloud Translation API.

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

תת מחלקות ישירות ידועות

BaseTestSuite , TfSuiteRunner

BaseTestSuite	מבחן להפעלת Suite Test Compatibility עם מערכת סוויטה חדשה.
TfSuiteRunner	יישום של `ITestSuite` אשר יטען בדיקות מתיקיית TF jars res/config/suite/.

תת-מחלקות עקיפות ידועות

AtestRunner , TestMappingSuiteRunner

AtestRunner	הטמעת `ITestSuite`
TestMappingSuiteRunner	יישום של `BaseTestSuite` כדי להריץ בדיקות שצוינו על ידי אפשרות include-filter, או TEST_MAPPING קבצים מ-build, כחבילה.

מחלקה מופשטת משמשת להפעלת 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`	`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 ()` מחזירה את הקשר ההתקשרות.
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`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.
	`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`

החזרות
	ערכת ה-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`

getInvocationContext

public IInvocationContext getInvocationContext ()

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

החזרות
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

החזרות
`MultiMap <String, String>`

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`

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

החזרות

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

פרמטרים
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

פרמטרים
`module`	`ModuleDefinition`

החזרות
`boolean`