החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

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

BaseTestSuite

public class BaseTestSuite
extends ITestSuite

java.lang.Object
↳	com.android.tradefed.testtype.suite.ITestSuite
	↳	com.android.tradefed.testtype.suite.BaseTestSuite

תת-כיתות ישירות ידועות

TestMappingSuiteRunner

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

בדיקה להרצת חבילה לבדיקות תאימות (CTS) עם מערכת חבילה חדשה.

סיכום

קבועים
`char`	`MODULE_OPTION_SHORT_NAME`
`char`	`TEST_OPTION_SHORT_NAME`

שדות
`public static final String`	`CONFIG_PATTERNS_OPTION`
`public static final String`	`EXCLUDE_FILTER_OPTION`
`public static final String`	`INCLUDE_FILTER_OPTION`
`public static final String`	`MODULE_OPTION`
`public static final String`	`TEST_ARG_OPTION`
`public static final String`	`TEST_OPTION`

קונסטרוקטורים גלויים לכולם
`BaseTestSuite()`

שיטות ציבוריות
`void`	`addConfigPatterns( patterns)` הוספת דפוסי תצורה
`void`	`addModuleArgs( moduleArgs)` הוספת ארגומנטים של מודול
`SuiteModuleLoader`	`createModuleLoader( includeFiltersFormatted, excludeFiltersFormatted, testArgs, moduleArgs)` יוצרים את ה-`SuiteModuleLoader` שאחראי לטעינה של ה-`IConfiguration` ומקצים לו חלק מהאפשרויות.
`SuiteModuleLoader`	`getModuleLoader()` הפונקציה מחזירה את הערך הנוכחי של `SuiteModuleLoader`.
	`loadTests()` שיטה מופשטת לטעינת הגדרות הבדיקות שיופעלו.
	`loadingStrategy( abis, testsDirs, String suitePrefix, String suiteTag)` שיטת הטעינה שמוגדרת כברירת מחדל תטען מהמשאבים ומהספרייה של הבדיקות.
`void`	`reevaluateFilters()`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setEnableOptionalParameterizedModules(boolean enableOptionalParameter)` מגדירים אם מודולים אופציונליים עם פרמטרים מופעלים או לא.
`void`	`setEnableParameterizedModules(boolean enableParameter)` מגדירים אם מודולים עם פרמטרים מופעלים או לא.
`void`	`setExcludeFilter( excludeFilters)` הגדרת מסנני החרגה לבדיקת התאימות
`void`	`setIncludeFilter( includeFilters)` הגדרת מסנני הכללה לבדיקת התאימות
`void`	`setModuleParameter(ModuleParameters forceParameter)`

שיטות מוגנות
	`getExcludeFilter()` מקבל עותק של מסנני החרגה לבדיקה התאימות
	`getFoldableStates(ITestDevice device)`
	`getIncludeFilter()` אחזור עותק של מסנני ההכללה לצורך בדיקת התאימות
`void`	`setPrioritizeHostConfig(boolean prioritizeHostConfig)` מגדירים את האפשרות prioritize-host-config.
`void`	`setupFilters(File testsDir)` הגדרת המסננים של הכללה/החרגה על סמך אם שם המודול ניתן.
`boolean`	`shouldModuleRun(ModuleDefinition module)`

קבועים

MODULE_OPTION_SHORT_NAME

public static final char MODULE_OPTION_SHORT_NAME

ערך קבוע: 109 (0x0000006d)

TEST_OPTION_SHORT_NAME

public static final char TEST_OPTION_SHORT_NAME

ערך קבוע: 116 (0x00000074)

שדות

CONFIG_PATTERNS_OPTION

public static final String CONFIG_PATTERNS_OPTION

EXCLUDE_FILTER_OPTION

public static final String EXCLUDE_FILTER_OPTION

INCLUDE_FILTER_OPTION

public static final String INCLUDE_FILTER_OPTION

MODULE_OPTION

public static final String MODULE_OPTION

TEST_ARG_OPTION

public static final String TEST_ARG_OPTION

TEST_OPTION

public static final String TEST_OPTION

קונסטרוקטורים גלויים לכולם

BaseTestSuite

public BaseTestSuite ()

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

addConfigPatterns

public void addConfigPatterns ( patterns)

הוספת דפוסי תצורה

פרמטרים
`patterns`

addModuleArgs

public void addModuleArgs ( moduleArgs)

הוספת ארגומנטים של מודול

פרמטרים
`moduleArgs`

createModuleLoader

public SuiteModuleLoader createModuleLoader ( includeFiltersFormatted, 
                 excludeFiltersFormatted, 
                 testArgs, 
                 moduleArgs)

יוצרים את ה-SuiteModuleLoader שאחראי לטעינה של ה-IConfiguration ומקצים לו חלק מהאפשרויות.

פרמטרים
`includeFiltersFormatted`	: המסננים נכללים בנתונים שעבר עיבוד ופורמט.
`excludeFiltersFormatted`	: מסנני ההחרגה בפורמט ובניתוח.
`testArgs`	: רשימת הארגומנטים של הבדיקה (`IRemoteTest`).
`moduleArgs`	: רשימת הארגומנטים של המודול.

החזרות
`SuiteModuleLoader`	`SuiteModuleLoader` שנוצר.

getModuleLoader

public SuiteModuleLoader getModuleLoader ()

הפונקציה מחזירה את הערך הנוכחי של SuiteModuleLoader.

החזרות
`SuiteModuleLoader`

loadTests

public  loadTests ()

שיטה מופשטת לטעינת הגדרות הבדיקות שיופעלו. כל בדיקה מוגדרת באמצעות IConfiguration ושם ייחודי שבו יוצגו התוצאות.

החזרות

loadingStrategy

public  loadingStrategy ( abis, 
                 testsDirs, 
                String suitePrefix, 
                String suiteTag)

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

פרמטרים
`abis`	: קבוצת ABIs שרוצים להריץ.
`testsDirs`	: ספריית הבדיקות.
`suitePrefix`	`String`: קידומת לסינון ספריית המשאבים.
`suiteTag`	`String`: תג המארז שצריך לכלול מודול. הערך יכול להיות null.

החזרות
	רשימה של הגדרות שהועלו לחבילה.

reevaluateFilters

public void reevaluateFilters ()

setBuild

public void setBuild (IBuildInfo buildInfo)

פרמטרים
`buildInfo`	`IBuildInfo`

setEnableOptionalParameterizedModules

public void setEnableOptionalParameterizedModules (boolean enableOptionalParameter)

מגדירים אם מודולים אופציונליים עם פרמטרים מופעלים או לא.

פרמטרים
`enableOptionalParameter`	`boolean`

setEnableParameterizedModules

public void setEnableParameterizedModules (boolean enableParameter)

מגדירים אם מודולים עם פרמטרים מופעלים או לא.

פרמטרים
`enableParameter`	`boolean`

setExcludeFilter

public void setExcludeFilter ( excludeFilters)

הגדרת מסנני החרגה לבדיקת התאימות

פרמטרים
`excludeFilters`

setIncludeFilter

public void setIncludeFilter ( includeFilters)

הגדרת מסנני הכללה לבדיקת התאימות

פרמטרים
`includeFilters`

setModuleParameter

public void setModuleParameter (ModuleParameters forceParameter)

פרמטרים
`forceParameter`	`ModuleParameters`

שיטות מוגנות

getExcludeFilter

protected  getExcludeFilter ()

מקבל עותק של מסנני החרגה לבדיקה התאימות

החזרות

getFoldableStates

protected  getFoldableStates (ITestDevice device)

פרמטרים
`device`	`ITestDevice`

החזרות

זריקות
`DeviceNotAvailableException`

getIncludeFilter

protected  getIncludeFilter ()

אחזור עותק של מסנני ההכללה לצורך בדיקת התאימות

החזרות

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

מגדירים את האפשרות prioritize-host-config.

פרמטרים
`prioritizeHostConfig`	`boolean`: true כדי לתת עדיפות להגדרות המארח, כלומר, להריץ בדיקת מארח אם אפשר.

setupFilters

protected void setupFilters (File testsDir)

הגדרת המסננים של הכללה/החרגה על סמך אם שם המודול ניתן.

פרמטרים
`testsDir`	`File`

זריקות
	אם לא נמצא קובץ כלשהו.

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

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

החזרות
`boolean`