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()
สรุป
เขตข้อมูล | |
---|---|
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 | TOKEN_KEY
|
ผู้สร้างสาธารณะ | |
---|---|
ITestSuite () |
วิธีการสาธารณะ | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
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 () |
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 | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) ใช้การกรองรายการที่อนุญาตพิเศษของนักวิ่ง โดยลบนักวิ่งที่ไม่ได้อยู่ในรายการที่อนุญาตพิเศษออก |
getAbisForBuildTargetArch () ส่งคืน abis ที่สนับสนุนโดยสถาปัตยกรรมเป้าหมายการสร้างโฮสต์ | |
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_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
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_STAGING_ARTIFACTS
public static final String SKIP_STAGING_ARTIFACTS
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
ผู้สร้างสาธารณะ
ITestSuite
public ITestSuite ()
วิธีการสาธารณะ
เพิ่มโมดูลข้อมูลเมตาไม่รวมตัวกรอง
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
พารามิเตอร์ | |
---|---|
filters | MultiMap |
เพิ่มโมดูลข้อมูลเมตารวมตัวกรอง
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
พารามิเตอร์ | |
---|---|
filters | MultiMap |
filterByConfigเมทาดาทา
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 |
getDirectModule
public ModuleDefinition getDirectModule ()
คืนค่า ModuleDefinition
ให้ดำเนินการโดยตรง หรือคืนค่า null หากยังไม่มี (เมื่อ ITestSuite ยังไม่ได้แยกชิ้นส่วน)
ส่งคืน | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
ส่งกลับบริบทการร้องขอ
ส่งคืน | |
---|---|
IInvocationContext |
รับโมดูลข้อมูลเมตารวมตัวกรอง
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
ส่งคืน | |
---|---|
MultiMap <String, String> |
getRequestedAbi
public final String getRequestedAbi ()
ส่งกลับ abi ที่ร้องขอด้วยตัวเลือก -a หรือ --abi
ส่งคืน | |
---|---|
String |
รับโทเค็นที่จำเป็น
publicgetRequiredTokens (TestInformation testInfo)
ส่งกลับรายการโทเค็นที่จำเป็นโดยการทดสอบ คืนค่า null หากไม่รองรับโทเค็น
พารามิเตอร์ | |
---|---|
testInfo | TestInformation |
ส่งคืน | |
---|---|
รับคำแนะนำรันไทม์
public long getRuntimeHint ()
ส่งคืนรันไทม์ที่คาดไว้ของการทดสอบเป็นมิลลิวินาที เวลาที่ใช้ในการโหลดบาลานซ์การดำเนินการชาร์ด
ส่งคืน | |
---|---|
long |
getTestsผู้อำนวยการ
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 |
เซ็ตเอบิเนม
public void setAbiName (String abiName)
ตั้งค่าของ mAbiName
พารามิเตอร์ | |
---|---|
abiName | String |
เซทเอบิส
public final void setAbis (abis)
พารามิเตอร์ | |
---|---|
abis |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
เรียกใช้ชุดทดสอบในโหมดตัวรวบรวมเท่านั้น ซึ่งจำเป็นต้องมีการทดสอบย่อยทั้งหมดเพื่อใช้อินเทอร์เฟซนี้ด้วย
setConfiguration
public void setConfiguration (IConfiguration configuration)
ใส่ IConfiguration
ที่ใช้งานอยู่
พารามิเตอร์ | |
---|---|
configuration | IConfiguration |
ชุดอุปกรณ์
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 หากการทดสอบไม่สามารถแบ่งย่อยได้ในขณะนี้ |
วิธีการป้องกัน
สร้างโมดูลฟัง
protectedcreateModuleListeners ()
ส่งคืนรายการ ITestInvocationListener
ที่ใช้ได้กับระดับ ModuleListener
Listener เหล่านี้จะถูกนำมาใช้ซ้ำสำหรับแต่ละโมดูล โดยจะไม่ถูกสร้างใหม่ ดังนั้นจึงไม่ควรถือว่าเป็นสถานะภายใน
ส่งคืน | |
---|---|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
ใช้การกรองรายการที่อนุญาตพิเศษของนักวิ่ง โดยลบนักวิ่งที่ไม่ได้อยู่ในรายการที่อนุญาตพิเศษออก หากคอนฟิกูเรชันมีรันเนอร์หลายตัว บางรันอาจถูกลบออกและคอนฟิกูเรชันจะยังคงรันอยู่
พารามิเตอร์ | |
---|---|
config | IConfiguration : IConfiguration ที่ได้รับการประเมิน |
allowedRunners |
ส่งคืน | |
---|---|
boolean | เป็นจริงถ้าโมดูลการกำหนดค่าได้รับอนุญาตให้ทำงาน มิฉะนั้นจะเป็นเท็จ |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
ส่งคืน abis ที่สนับสนุนโดยสถาปัตยกรรมเป้าหมายการสร้างโฮสต์ เปิดเผยสำหรับการทดสอบ
ส่งคืน | |
---|---|
รับ HostAbis
protectedgetHostAbis ()
ส่งกลับ abis เครื่องโฮสต์
ส่งคืน | |
---|---|
setMultiDeviceStrategy
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
พารามิเตอร์ | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
ควรโมดูลรัน
protected boolean shouldModuleRun (ModuleDefinition module)
พารามิเตอร์ | |
---|---|
module | ModuleDefinition |
ส่งคืน | |
---|---|
boolean |