ไอเทสสวีท
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 |
คลาส Abstract ที่ใช้ในการรัน Test Suite ชั้นเรียนนี้จะให้ข้อมูลพื้นฐานเกี่ยวกับวิธีการทำงานของ 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) รับชุด ABI ที่รองรับทั้งการทดสอบความเข้ากันได้ | |
static | getAbisForBuildTargetArchFromSuite () ส่งกลับค่า Abis ที่เป็นไปได้จาก TestSuiteInfo |
IBuildInfo | getBuildInfo () การใช้งาน |
final IConfiguration | getConfiguration () ส่งคืน |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () รับอุปกรณ์ภายใต้การทดสอบ |
ModuleDefinition | getDirectModule () ส่งคืน |
IInvocationContext | getInvocationContext () ส่งกลับบริบทการร้องขอ |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
ITestSuite.MultiDeviceModuleStrategy | getMultiDeviceStrategy () |
final String | getRequestedAbi () ส่งคืน abi ที่ร้องขอพร้อมกับตัวเลือก -a หรือ --abi |
getRequiredTokens ( TestInformation testInfo) ส่งคืนรายการโทเค็นที่ต้องการโดยการทดสอบ | |
long | getRuntimeHint () ส่งกลับรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที |
File | getTestsDir () |
boolean | isSplitting () คืนค่าเป็นจริงหากขณะนี้เราอยู่ใน |
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 ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) เรียกใช้ชุดการทดสอบในโหมดตัวรวบรวมเท่านั้น ซึ่งจำเป็นต้องมีการทดสอบย่อยทั้งหมดเพื่อใช้อินเทอร์เฟซนี้ด้วย |
void | setConfiguration ( IConfiguration configuration) แทรก |
void | setDevice ( ITestDevice device) ฉีดอุปกรณ์ภายใต้การทดสอบ |
void | setDirectModule ( ModuleDefinition module) |
void | setIntraModuleSharding (boolean intraModuleSharding) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) ตั้งค่ารายการ |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
void | setPrimaryAbiRun (boolean primaryAbiRun) ตั้งค่า mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) เมื่อทำการแบ่งส่วนข้อมูลแบบกระจาย เราไม่สามารถมี ModuleDefinition ที่แชร์การทดสอบในพูล ไม่เช่นนั้นการแบ่งส่วนย่อยภายในโมดูลจะไม่ทำงาน ดังนั้นเราจึงอนุญาตให้ปิดการใช้งานได้ |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) ตั้งค่า |
void | setTestLogger ( ITestLogger testLogger) แทรกอินสแตนซ์ |
split (Integer shardCountHint, TestInformation testInfo) เวอร์ชันทางเลือกของ |
วิธีการที่ได้รับการป้องกัน | |
---|---|
createModuleListeners () ส่งคืนรายการ | |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) ใช้การกรองรายการนักวิ่งที่อนุญาตพิเศษ โดยลบนักวิ่งที่ไม่ได้อยู่ในรายการที่ปลอดภัยออก |
getAbisForBuildTargetArch () ส่งคืน Abis ที่สถาปัตยกรรมเป้าหมายของ Host 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
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
ผู้รับเหมาก่อสร้างสาธารณะ
ไอเทสสวีท
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 | เป็นจริงหากโมดูลควรรัน มิฉะนั้นจะเป็นเท็จ |
รับอาบิส
publicgetAbis (ITestDevice device)
รับชุด ABI ที่รองรับทั้งการทดสอบความเข้ากันได้ AbiUtils.getAbisSupportedByCompatibility()
และอุปกรณ์ที่อยู่ระหว่างการทดสอบ
พารามิเตอร์ | |
---|---|
device | ITestDevice |
การส่งคืน | |
---|---|
ชุดของ ABI ที่จะทำการทดสอบ |
ขว้าง | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
ส่งกลับค่า Abis ที่เป็นไปได้จาก TestSuiteInfo
การส่งคืน | |
---|---|
รับ BuildInfo
public IBuildInfo getBuildInfo ()
การใช้งาน ITestSuite
อาจต้องใช้ข้อมูลบิลด์เพื่อโหลดการทดสอบ
การส่งคืน | |
---|---|
IBuildInfo |
รับการกำหนดค่า
public final IConfiguration getConfiguration ()
ส่งคืน IConfiguration
การเรียกใช้
การส่งคืน | |
---|---|
IConfiguration |
รับอุปกรณ์
public ITestDevice getDevice ()
รับอุปกรณ์ภายใต้การทดสอบ
การส่งคืน | |
---|---|
ITestDevice | ITestDevice |
รับDirectModule
public ModuleDefinition getDirectModule ()
ส่งคืน ModuleDefinition
ที่จะดำเนินการโดยตรง หรือเป็นโมฆะหากยังไม่มี (เมื่อยังไม่ได้แบ่งส่วน ITestSuite)
การส่งคืน | |
---|---|
ModuleDefinition |
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)
ส่งคืนรายการโทเค็นที่ต้องการจากการทดสอบ ส่งคืนค่าว่างหากไม่มีการสนับสนุนโทเค็น
พารามิเตอร์ | |
---|---|
testInfo | TestInformation |
การส่งคืน | |
---|---|
รับ RuntimeHint
public long getRuntimeHint ()
ส่งกลับรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที เวลาที่ใช้ในการโหลดการดำเนินการแบ่งส่วนยอดคงเหลือ
การส่งคืน | |
---|---|
long |
รับการทดสอบDir
public File getTestsDir ()
การส่งคืน | |
---|---|
File |
คือการแยก
public boolean isSplitting ()
คืนค่าเป็นจริงหากขณะนี้เราอยู่ใน IShardableTest.split(int)
การส่งคืน | |
---|---|
boolean |
การทดสอบโหลด
public abstractloadTests ()
วิธีการสรุปเพื่อโหลดการกำหนดค่าการทดสอบที่จะเรียกใช้ การทดสอบแต่ละครั้งถูกกำหนดโดย IConfiguration
และชื่อเฉพาะที่จะใช้รายงานผลลัพธ์
การส่งคืน | |
---|---|
รายงาน NotExecuted
public void reportNotExecuted (ITestInvocationListener listener, String message)
รายงานการทดสอบที่ยังไม่ได้ดำเนินการไปยังผู้ฟังหลักที่ให้ไว้ ควรรายงานว่าล้มเหลวพร้อมกับข้อความ NOT_EXECUTED_FAILURE
พารามิเตอร์ | |
---|---|
listener | ITestInvocationListener : ผู้ฟังหลักที่จะรายงานผลลัพธ์ที่ไม่ได้ดำเนินการ |
message | String : ข้อความที่จะเชื่อมโยงกับความล้มเหลวที่ไม่ถูกดำเนินการ |
รายงาน NotExecuted
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 |
เซตอาบิส
public final void setAbis (abis)
พารามิเตอร์ | |
---|---|
abis |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
เรียกใช้ชุดการทดสอบในโหมดตัวรวบรวมเท่านั้น ซึ่งจำเป็นต้องมีการทดสอบย่อยทั้งหมดเพื่อใช้อินเทอร์เฟซนี้ด้วย
ตั้งค่าคอนฟิก
public void setConfiguration (IConfiguration configuration)
แทรก IConfiguration
ที่ใช้งานอยู่
พารามิเตอร์ | |
---|---|
configuration | IConfiguration |
ตั้งค่าอุปกรณ์
public void setDevice (ITestDevice device)
ฉีดอุปกรณ์ภายใต้การทดสอบ
พารามิเตอร์ | |
---|---|
device | ITestDevice : ITestDevice ที่จะใช้ |
ตั้งค่า DirectModule
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 |
ตั้งค่า PrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
ตั้งค่า mPrimaryAbiRun
พารามิเตอร์ | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
เมื่อทำการแบ่งส่วนข้อมูลแบบกระจาย เราไม่สามารถมี ModuleDefinition ที่แชร์การทดสอบในพูล ไม่เช่นนั้นการแบ่งส่วนย่อยภายในโมดูลจะไม่ทำงาน ดังนั้นเราจึงอนุญาตให้ปิดการใช้งานได้
พารามิเตอร์ | |
---|---|
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
ซึ่งมีข้อมูลเบื้องต้นจากผู้ปกครองที่สร้างชาร์ด ซึ่งจะมีประโยชน์หากจำเป็นต้องเข้าถึงสิ่งต่างๆ เช่น ข้อมูลอุปกรณ์หรือบิวด์ในระหว่างการชาร์ดดิ้ง
พารามิเตอร์ | |
---|---|
shardCountHint | Integer : จำนวนชาร์ดที่พยายาม |
testInfo | TestInformation : The parent TestInformation |
การส่งคืน | |
---|---|
ชุดของการทดสอบย่อยที่จะดำเนินการแยกกันหรือ null หากการทดสอบยังไม่สามารถแบ่งส่วนได้ |
วิธีการที่ได้รับการป้องกัน
createModuleListeners
protectedcreateModuleListeners ()
ส่งคืนรายการ ITestInvocationListener
ที่ใช้ได้กับระดับ ModuleListener
Listener เหล่านี้จะถูกนำมาใช้ซ้ำสำหรับแต่ละโมดูล โดยจะไม่ถูกสร้างอินสแตนซ์ใหม่ ดังนั้นจึงไม่ควรถือว่ามีสถานะภายใน
การส่งคืน | |
---|---|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
ใช้การกรองรายการนักวิ่งที่อนุญาตพิเศษ โดยลบนักวิ่งที่ไม่ได้อยู่ในรายการที่ปลอดภัยออก หากการกำหนดค่ามีรันเนอร์หลายตัว บางตัวอาจถูกลบออกและการกำหนดค่าจะยังคงทำงานอยู่
พารามิเตอร์ | |
---|---|
config | IConfiguration : IConfiguration ที่กำลังได้รับการประเมิน |
allowedRunners |
การส่งคืน | |
---|---|
boolean | เป็นจริงหากโมดูลการกำหนดค่าได้รับอนุญาตให้รัน มิฉะนั้นจะเป็นเท็จ |
getAbisForBuildTargetArch.getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
ส่งคืน Abis ที่สถาปัตยกรรมเป้าหมายของ Host build เปิดเผยสำหรับการทดสอบ
การส่งคืน | |
---|---|
getHostAbis
protectedgetHostAbis ()
ส่งคืนเครื่องโฮสต์ abis
การส่งคืน | |
---|---|
ควร ModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
พารามิเตอร์ | |
---|---|
module | ModuleDefinition |
การส่งคืน | |
---|---|
boolean |