ITestSuite

public abstract class ITestSuite
extends Object implements IBuildReceiver, IConfigurationReceiver, IDeviceTest, IInvocationContextReceiver, IMetricCollectorReceiver, IRemoteTest, IReportNotExecuted, IRuntimeHintProvider, IShardableTest, ISystemStatusCheckerReceiver, ITestCollector, ITestLoggerReceiver, ITokenRequest

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

คลาสย่อยโดยตรงที่รู้จัก BaseTestSuite, TfSuiteRunner BaseTestSuite การทดสอบการเรียกใช้ชุดเครื่องมือทดสอบความเข้ากันได้กับระบบชุดใหม่  TfSuiteRunner การใช้งาน ITestSuite ซึ่งจะโหลดการทดสอบจาก TF jars res/config/suite/ โฟลเดอร์

คลาสย่อยโดยอ้อมที่รู้จัก AtestRunner, TestMappingSuiteRunner AtestRunner การใช้งาน ITestSuite TestMappingSuiteRunner การใช้ BaseTestSuite เพื่อเรียกใช้การทดสอบที่ระบุโดยตัวเลือก include-filter หรือ TEST_MAPPING ไฟล์จากบิลด์ในรูปแบบชุด

---

คลาส Abstract ที่ใช้ในการเรียกใช้ Test Suite ชั้นเรียนนี้เป็นข้อมูลพื้นฐานเกี่ยวกับการใช้งาน Suite การใช้งานแต่ละครั้งจะกำหนดรายการการทดสอบผ่านเมธอด loadTests() ได้

สรุป

ช่อง
public static final String	ABI_OPTION
public static final String	ACTIVE_MAINLINE_PARAMETER_KEY
public static final String	ENABLE_RESOLVE_SYM_LINKS
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	STAGE_MODULE_ARTIFACTS
public static final String	TEST_TYPE_KEY
public static final String	TEST_TYPE_VALUE_PERFORMANCE
public static final String	TOKEN_KEY
protected boolean	mEnableResolveSymlinks
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 ที่ทั้งการทดสอบความเข้ากันได้ AbiUtils.getAbisSupportedByCompatibility() และอุปกรณ์ที่อยู่ระหว่างการทดสอบรองรับ
static	getAbisForBuildTargetArchFromSuite() แสดงผล Abis ที่เป็นไปได้จาก TestSuiteInfo
IBuildInfo	getBuildInfo() การใช้งาน ITestSuite อาจต้องมีข้อมูลบิลด์เพื่อโหลดการทดสอบ
final IConfiguration	getConfiguration() แสดงผลการเรียกใช้ IConfiguration
ITestLogger	getCurrentTestLogger()
ITestDevice	getDevice() นำอุปกรณ์มาทดสอบ
ModuleDefinition	getDirectModule() แสดง ModuleDefinition เพื่อดำเนินการโดยตรง หรือเป็นค่าว่างถ้ายังไม่มี (เมื่อฟังก์ชัน ยังไม่มีการชาร์ด ITestSuite)
boolean	getIntraModuleSharding()
IInvocationContext	getInvocationContext() แสดงผลบริบทการเรียกใช้
MultiMap<String, String>	getModuleMetadataIncludeFilters()
ITestSuite.MultiDeviceModuleStrategy	getMultiDeviceStrategy()
final String	getRequestedAbi() แสดงผล abi ที่ขอพร้อมตัวเลือก -a หรือ --abi
	getRequiredTokens(TestInformation testInfo) แสดงรายการโทเค็นที่จำเป็นโดยการทดสอบ
long	getRuntimeHint() แสดงผลรันไทม์ที่คาดไว้ของการทดสอบใน มิลลิวินาที
File	getTestsDir()
boolean	isSplitting() แสดงค่า "จริง" หากตอนนี้เราอยู่ใน 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)
void	setBuild(IBuildInfo buildInfo)
void	setCollectTestsOnly(boolean shouldCollectTest) เรียกใช้ชุดทดสอบในโหมดตัวรวบรวมเท่านั้น โดยต้องใช้การทดสอบย่อยทั้งหมดเพื่อดำเนินการ ของอินเทอร์เฟซด้วย
void	setConfiguration(IConfiguration configuration) แทรก IConfiguration ที่ใช้งานอยู่
void	setDevice(ITestDevice device) ใส่อุปกรณ์ที่อยู่ระหว่างการทดสอบ
void	setDirectModule(ModuleDefinition module)
void	setIntraModuleSharding(boolean intraModuleSharding)
void	setInvocationContext(IInvocationContext invocationContext)
void	setMetricCollectors( collectors) ตั้งค่ารายการ IMetricCollector ที่กำหนดไว้สำหรับการดำเนินการทดสอบ
void	setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
void	setPrimaryAbiRun(boolean primaryAbiRun) กำหนดค่าของ mPrimaryAbiRun
void	setShouldMakeDynamicModule(boolean dynamicModule) เมื่อทำการชาร์ดดิ้งแบบกระจาย เราไม่สามารถมี ModuleDefinition ที่แชร์การทดสอบในพูล มิฉะนั้นการชาร์ดดิ้งภายในโมดูลจะไม่ทำงาน เราจึงอนุญาตให้ปิดใช้งาน
void	setSystemStatusChecker( systemCheckers) ตั้งค่า ISystemStatusChecker จากการกำหนดค่าสำหรับการทดสอบ
void	setTestLogger(ITestLogger testLogger) แทรกอินสแตนซ์ ITestLogger
	split(Integer shardCountHint, TestInformation testInfo) เวอร์ชันทางเลือกของ split(int) ซึ่งมี TestInformation ด้วย ซึ่งมีข้อมูลในช่วงแรกจากผู้ปกครองที่สร้างชาร์ด

วิธีการป้องกัน
	createModuleListeners() แสดงรายการ ITestInvocationListener ที่เกี่ยวข้องกับ ModuleListener
boolean	filterByRunnerType(IConfiguration config, allowedRunners) ใช้การกรองรายการที่อนุญาตพิเศษของ Runner ลบตัววิ่งที่ไม่อยู่ในรายการที่อนุญาตพิเศษ
	getAbisForBuildTargetArch() แสดงผล abis ที่สถาปัตยกรรมเป้าหมายของบิลด์โฮสต์รองรับ
	getHostAbis() แสดงผล Abis ของเครื่องโฮสต์
boolean	shouldModuleRun(ModuleDefinition module)

ช่อง

ตัวเลือก ABI

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

ENABLE_RESOLVE_SYM_LINKS

public static final String ENABLE_RESOLVE_SYM_LINKS

พารามิเตอร์หลัก

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_โพสต์

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_ตัวกรอง

public static final String MODULE_METADATA_INCLUDE_FILTER

MODULE_START_TIME

public static final String MODULE_START_TIME

พารามิเตอร์คีย์

public static final String PARAMETER_KEY

รายการที่อนุญาต

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

สุ่ม

public static final String RANDOM_SEED

ไวท์ลิสต์

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

ขั้นตอน

public static final String STAGE_MODULE_ARTIFACTS

ประเภทการทดสอบคีย์

public static final String TEST_TYPE_KEY

ประสิทธิภาพ TEST_TYPE_VALUE_

public static final String TEST_TYPE_VALUE_PERFORMANCE

โทเค็น

public static final String TOKEN_KEY

mActivateReachSymlinks

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

ช่างก่อสร้างสาธารณะ

ITestSuite

public ITestSuite ()

วิธีการสาธารณะ

addModuleMetadataExcludeFilter

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

พารามิเตอร์
filters	MultiMap

addModuleMetadataIncludeFilter

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

พารามิเตอร์
filters	MultiMap

การตั้งค่า clearUpSuite

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	True หากโมดูลควรทำงาน มิฉะนั้นจะเป็น False

GetAbis

public  getAbis (ITestDevice device)

รับชุด ABI ที่ทั้งการทดสอบความเข้ากันได้ AbiUtils.getAbisSupportedByCompatibility() และอุปกรณ์ที่อยู่ระหว่างการทดสอบรองรับ

พารามิเตอร์
device	ITestDevice

คิกรีเทิร์น
	ชุด ABI ที่จะทำการทดสอบ

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

getAbisForBuildTargetArchจากSuite

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 เพื่อดำเนินการโดยตรง หรือเป็นค่าว่างถ้ายังไม่มี (เมื่อฟังก์ชัน ยังไม่มีการชาร์ด ITestSuite)

คิกรีเทิร์น
ModuleDefinition

getIntraModuleSharding

public boolean getIntraModuleSharding ()

คิกรีเทิร์น
boolean

getInvocationContext

public IInvocationContext getInvocationContext ()

แสดงผลบริบทการเรียกใช้

คิกรีเทิร์น
IInvocationContext

getModuleMetadataIncludeFilter

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

คิกรีเทิร์น
MultiMap<String, String>

กลยุทธ์หลายอุปกรณ์

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

คิกรีเทิร์น
ITestSuite.MultiDeviceModuleStrategy

getRequestAbi

public final String getRequestedAbi ()

แสดงผล abi ที่ขอพร้อมตัวเลือก -a หรือ --abi

คิกรีเทิร์น
String

getrequiredTokens

public  getRequiredTokens (TestInformation testInfo)

แสดงรายการโทเค็นที่จำเป็นโดยการทดสอบ แสดงผลเป็น Null หากไม่มีการสนับสนุนโทเค็น

พารามิเตอร์
testInfo	TestInformation

คิกรีเทิร์น

getRuntimeHint

public long getRuntimeHint ()

แสดงผลรันไทม์ที่คาดไว้ของการทดสอบใน มิลลิวินาที เวลาที่ใช้ในการโหลดการดำเนินการชาร์ดยอดคงเหลือ

คิกรีเทิร์น
long

getTestsDir

public File getTestsDir ()

คิกรีเทิร์น
File

แยก

public boolean isSplitting ()

แสดงค่า "จริง" หากตอนนี้เราอยู่ใน IShardableTest.split(int)

คิกรีเทิร์น
boolean

การทดสอบภาระงาน

public abstract  loadTests ()

วิธีแบบแอบสแตรกเพื่อโหลดการกำหนดค่าการทดสอบที่จะเรียกใช้ การทดสอบแต่ละครั้งจะกำหนดโดย 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

SetAbis

public final void setAbis ( abis)

พารามิเตอร์
abis

ตั้งค่าบิลด์

public void setBuild (IBuildInfo buildInfo)

พารามิเตอร์
buildInfo	IBuildInfo

ตั้งค่า CollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

เรียกใช้ชุดทดสอบในโหมดตัวรวบรวมเท่านั้น โดยต้องใช้การทดสอบย่อยทั้งหมดเพื่อดำเนินการ ของอินเทอร์เฟซด้วย

ตั้งค่าการกำหนดค่า

public void setConfiguration (IConfiguration configuration)

แทรก IConfiguration ที่ใช้งานอยู่

พารามิเตอร์
configuration	IConfiguration

ตั้งค่าอุปกรณ์

public void setDevice (ITestDevice device)

ใส่อุปกรณ์ที่อยู่ระหว่างการทดสอบ

พารามิเตอร์
device	ITestDevice: ITestDevice ที่จะใช้

setDirectModule

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

ตั้งค่ากลยุทธ์หลายอุปกรณ์

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

พารามิเตอร์
strategy	ITestSuite.MultiDeviceModuleStrategy

ตั้งค่าหลัก AbiRun

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

แยก

public  split (Integer shardCountHint, 
                TestInformation testInfo)

เวอร์ชันทางเลือกของ split(int) ซึ่งมี TestInformation ด้วย ซึ่งมีข้อมูลในช่วงแรกจากผู้ปกครองที่สร้างชาร์ด ซึ่งมีประโยชน์ในกรณีต่อไปนี้ ต้องมีการเข้าถึงข้อมูลอุปกรณ์หรือบิลด์ในระหว่างการชาร์ดดิ้ง

พารามิเตอร์
shardCountHint	Integer: จำนวนชาร์ดที่พยายาม
testInfo	TestInformation: TestInformation ระดับบน

คิกรีเทิร์น
	คอลเล็กชันของการทดสอบย่อยที่จะดำเนินการแยกต่างหากหรือ null หากการทดสอบคือ ไม่สามารถชาร์ดได้ในขณะนี้

วิธีการป้องกัน

createModuleListener

protected  createModuleListeners ()

แสดงรายการ ITestInvocationListener ที่เกี่ยวข้องกับ ModuleListener ระบบจะนำผู้ฟังเหล่านี้มาใช้ใหม่สำหรับแต่ละโมดูล โดยจะไม่ยืนยันอีกครั้ง พวกเขาไม่ควรทึกทักเอาสถานะภายใน

คิกรีเทิร์น

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

ใช้การกรองรายการที่อนุญาตพิเศษของ Runner ลบตัววิ่งที่ไม่อยู่ในรายการที่อนุญาตพิเศษ หากมี มีการกำหนดค่ามีตัวเรียกใช้หลายรายการ ซึ่งอาจถูกนำออกและการกำหนดค่าจะยังคงทำงานอยู่

พารามิเตอร์
config	IConfiguration: IConfiguration ที่กำลังประเมิน
allowedRunners	: รายการที่อนุญาตพิเศษของนักวิ่งปัจจุบัน

คิกรีเทิร์น
boolean	จริง หากอนุญาตให้โมดูลการกำหนดค่าทำงาน หรือเป็นเท็จ

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

แสดงผล abis ที่สถาปัตยกรรมเป้าหมายของบิลด์โฮสต์รองรับ เปิดเผยสำหรับการทดสอบ

คิกรีเทิร์น

getHostAbis

protected  getHostAbis ()

แสดงผล Abis ของเครื่องโฮสต์

คิกรีเทิร์น

โมดูลควรเรียกใช้

protected boolean shouldModuleRun (ModuleDefinition module)

พารามิเตอร์
module	ModuleDefinition

คิกรีเทิร์น
boolean