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 คลาสนี้เป็นพื้นฐานของวิธีการเรียกใช้ Suite การใช้งานแต่ละครั้งสามารถกำหนดรายการการทดสอบผ่าน loadTests()
สรุป
คลาสที่ซ้อนกัน | |
---|---|
enum | ITestSuite.MultiDeviceModuleStrategy
|
ทุ่งนา | |
---|---|
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) รับชุด ABI ที่รองรับทั้งการทดสอบความเข้ากันได้ | |
static | getAbisForBuildTargetArchFromSuite () ส่งคืน abi ที่เป็นไปได้จาก TestSuiteInfo |
IBuildInfo | getBuildInfo () การใช้งาน |
final IConfiguration | getConfiguration () ส่งกลับการเรียกใช้ |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () รับอุปกรณ์ภายใต้การทดสอบ |
ModuleDefinition | getDirectModule () ส่งคืน |
IInvocationContext | getInvocationContext () ส่งกลับบริบทการเรียกใช้ |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
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 | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) ตั้งค่ารายการของ |
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 | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) ใช้ตัวกรองข้อมูลเมตากับการกำหนดค่าและดูว่าการกำหนดค่าควรทำงานหรือไม่ |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) ใช้การกรองรายการที่อนุญาตพิเศษของ Runner เพื่อลบนักวิ่งที่ไม่ได้อยู่ในรายการที่อนุญาตพิเศษ |
getAbisForBuildTargetArch () ส่งคืน abi ที่รองรับโดยสถาปัตยกรรมเป้าหมายของการสร้างโฮสต์ | |
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
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_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
publicgetAbis (ITestDevice device)
รับชุด ABI ที่รองรับทั้งการทดสอบความเข้ากันได้ AbiUtils.getAbisSupportedByCompatibility()
และอุปกรณ์ที่กำลังทดสอบ
พารามิเตอร์ | |
---|---|
device | ITestDevice |
คืนสินค้า | |
---|---|
ชุดของ ABI ที่จะทำการทดสอบบน |
ขว้าง | |
---|---|
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
ส่งคืน abi ที่เป็นไปได้จาก TestSuiteInfo
คืนสินค้า | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
การใช้งาน ITestSuite
อาจต้องใช้ข้อมูลบิวด์เพื่อโหลดการทดสอบ
คืนสินค้า | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
ส่งกลับการเรียกใช้ IConfiguration
คืนสินค้า | |
---|---|
IConfiguration |
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
publicgetRequiredTokens (TestInformation testInfo)
ส่งคืนรายการโทเค็นที่ต้องการโดยการทดสอบ คืนค่า null หากไม่มีการสนับสนุนโทเค็น
พารามิเตอร์ | |
---|---|
testInfo | TestInformation |
คืนสินค้า | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
ส่งคืนรันไทม์ที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที เวลาที่ใช้ในการโหลดบาลานซ์ชาร์ด Execution
คืนสินค้า | |
---|---|
long |
getTestsDir
public File getTestsDir ()
คืนสินค้า | |
---|---|
File |
กำลังแยก
public boolean isSplitting ()
คืนค่า จริง หากเราอยู่ใน IShardableTest.split(int)
คืนสินค้า | |
---|---|
boolean |
การทดสอบโหลด
public abstractloadTests ()
วิธีนามธรรมเพื่อโหลดการกำหนดค่าการทดสอบที่จะเรียกใช้ การทดสอบแต่ละครั้งถูกกำหนดโดย 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 |
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
จากการกำหนดค่าสำหรับการทดสอบ
พารามิเตอร์ | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
ฉีดอินสแตนซ์ ITestLogger
พารามิเตอร์ | |
---|---|
testLogger | ITestLogger |
แยก
publicsplit (Integer shardCountHint, TestInformation testInfo)
เวอร์ชันทางเลือกของ split(int)
ซึ่งมี TestInformation
ซึ่งมีข้อมูลเบื้องต้นจากพาเรนต์ที่สร้างชาร์ด มีประโยชน์หากจำเป็นต้องเข้าถึงสิ่งต่าง ๆ เช่นอุปกรณ์หรือข้อมูลบิวด์ในระหว่างการแบ่งส่วนข้อมูล
พารามิเตอร์ | |
---|---|
shardCountHint | Integer : จำนวนชาร์ดที่พยายาม |
testInfo | TestInformation : ผู้ปกครอง TestInformation |
คืนสินค้า | |
---|---|
ชุดของการทดสอบย่อยที่จะดำเนินการแยกกันหรือเป็น null หากปัจจุบันยังไม่สามารถแบ่งการทดสอบได้ |
วิธีการป้องกัน
createModuleListeners
protectedcreateModuleListeners ()
ส่งคืนรายการของ ITestInvocationListener
ที่ใช้ได้กับระดับ ModuleListener
Listener เหล่านี้จะถูกนำกลับมาใช้ใหม่สำหรับแต่ละโมดูล โดยจะไม่ถูกสร้างอินสแตนซ์ใหม่ ดังนั้นจึงไม่ควรถือว่ามีสถานะภายใน
คืนสินค้า | |
---|---|
filterByConfigMetadata
protected boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
ใช้ตัวกรองข้อมูลเมตากับการกำหนดค่าและดูว่าการกำหนดค่าควรทำงานหรือไม่
พารามิเตอร์ | |
---|---|
config | IConfiguration : IConfiguration กำลังถูกประเมิน |
include | MultiMap : ข้อมูลเมตารวม filter |
exclude | MultiMap : ข้อมูลเมตาไม่รวมตัวกรอง |
คืนสินค้า | |
---|---|
boolean | จริง หากโมดูลควรรัน มิฉะนั้น เท็จ |
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
ใช้การกรองรายการที่อนุญาตพิเศษของ Runner เพื่อลบนักวิ่งที่ไม่ได้อยู่ในรายการที่อนุญาตพิเศษ หากการกำหนดค่ามีนักวิ่งหลายคน บางส่วนอาจถูกลบและการกำหนดค่าจะยังคงทำงานอยู่
พารามิเตอร์ | |
---|---|
config | IConfiguration : IConfiguration กำลังถูกประเมิน |
allowedRunners |
คืนสินค้า | |
---|---|
boolean | True หากอนุญาตให้เรียกใช้โมดูลการกำหนดค่า มิฉะนั้นจะเป็นเท็จ |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
ส่งคืน abi ที่รองรับโดยสถาปัตยกรรมเป้าหมายของการสร้างโฮสต์ เปิดเผยสำหรับการทดสอบ
คืนสินค้า | |
---|---|
getHostAbis
protectedgetHostAbis ()
ส่งคืน abis เครื่องโฮสต์
คืนสินค้า | |
---|---|
setMultiDeviceStrategy
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
พารามิเตอร์ | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
ควรModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
พารามิเตอร์ | |
---|---|
module | ModuleDefinition |
คืนสินค้า | |
---|---|
boolean |
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2022-11-07 UTC