หน้านี้ได้รับการแปลโดย Cloud Translation API

ไอเทสสวีท

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

คลาสย่อยโดยตรงที่รู้จัก

BaseTestSuite , TfSuiteRunner

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

คลาสย่อยทางอ้อมที่รู้จัก

AtestRunner , TestMappingSuiteRunner

เอเทสรันเนอร์	การใช้งาน `ITestSuite`
TestMappingSuiteRunner	การใช้งาน `BaseTestSuite` เพื่อรันการทดสอบที่ระบุโดยตัวเลือก include-filter หรือไฟล์ TEST_MAPPING จาก build เป็นชุด

คลาส 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 ที่รองรับทั้งการทดสอบความเข้ากันได้ `AbiUtils.getAbisSupportedByCompatibility()` และอุปกรณ์ที่อยู่ระหว่างการทดสอบ
`static`	`getAbisForBuildTargetArchFromSuite ()` ส่งกลับค่า Abis ที่เป็นไปได้จาก TestSuiteInfo
`IBuildInfo`	`getBuildInfo ()` การใช้งาน `ITestSuite` อาจต้องใช้ข้อมูลบิลด์เพื่อโหลดการทดสอบ
`final IConfiguration`	`getConfiguration ()` ส่งคืน `IConfiguration` การเรียกใช้
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` รับอุปกรณ์ภายใต้การทดสอบ
`ModuleDefinition`	`getDirectModule ()` ส่งคืน `ModuleDefinition` ที่จะดำเนินการโดยตรง หรือเป็นโมฆะหากยังไม่มี (เมื่อยังไม่ได้แบ่งส่วน ITestSuite)
`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)` `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)` `setMetricCollectors ( collectors)` ตั้งค่ารายการ `IMetricCollector` ที่กำหนดไว้สำหรับการทดสอบการทำงาน
`void`	`setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)`
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` ตั้งค่า mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` เมื่อทำการแบ่งส่วนข้อมูลแบบกระจาย เราไม่สามารถมี ModuleDefinition ที่แชร์การทดสอบในพูล ไม่เช่นนั้นการแบ่งส่วนย่อยภายในโมดูลจะไม่ทำงาน ดังนั้นเราจึงอนุญาตให้ปิดการใช้งานได้
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` ตั้งค่า `ISystemStatusChecker` จากการกำหนดค่าสำหรับการทดสอบ
`void`	`setTestLogger ( ITestLogger testLogger)` แทรกอินสแตนซ์ `ITestLogger`
	`split (Integer shardCountHint, TestInformation testInfo)` เวอร์ชันทางเลือกของ `split(int)` ซึ่งจัดเตรียม `TestInformation` ซึ่งมีข้อมูลเบื้องต้นจากผู้ปกครองที่สร้างชาร์ด

วิธีการที่ได้รับการป้องกัน
	`createModuleListeners ()` ส่งคืนรายการ `ITestInvocationListener` ที่ใช้ได้กับระดับ `ModuleListener`
`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`	เป็นจริงหากโมดูลควรรัน มิฉะนั้นจะเป็นเท็จ

รับอาบิส

public  getAbis (ITestDevice device)

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

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

การส่งคืน
	ชุดของ ABI ที่จะทำการทดสอบ

ขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

ส่งกลับค่า Abis ที่เป็นไปได้จาก TestSuiteInfo

การส่งคืน

รับ BuildInfo

public IBuildInfo getBuildInfo ()

การใช้งาน ITestSuite อาจต้องใช้ข้อมูลบิลด์เพื่อโหลดการทดสอบ

การส่งคืน
`IBuildInfo`

รับการกำหนดค่า

public final IConfiguration getConfiguration ()

ส่งคืน IConfiguration การเรียกใช้

การส่งคืน
`IConfiguration`

รับ CurrentTestLogger

public ITestLogger getCurrentTestLogger ()

การส่งคืน
`ITestLogger`

รับอุปกรณ์

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

public  getRequiredTokens (TestInformation testInfo)

ส่งคืนรายการโทเค็นที่ต้องการจากการทดสอบ ส่งคืนค่าว่างหากไม่มีการสนับสนุนโทเค็น

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

การส่งคืน

รับ RuntimeHint

public long getRuntimeHint ()

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

การส่งคืน
`long`

รับการทดสอบDir

public File getTestsDir ()

การส่งคืน
`File`

คือการแยก

public boolean isSplitting ()

คืนค่าเป็นจริงหากขณะนี้เราอยู่ใน IShardableTest.split(int)

การส่งคืน
`boolean`

การทดสอบโหลด

public abstract  loadTests ()

วิธีการสรุปเพื่อโหลดการกำหนดค่าการทดสอบที่จะเรียกใช้ การทดสอบแต่ละครั้งถูกกำหนดโดย IConfiguration และชื่อเฉพาะที่จะใช้รายงานผลลัพธ์

การส่งคืน

รายงาน NotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

รายงานการทดสอบที่ยังไม่ได้ดำเนินการไปยังผู้ฟังหลักที่ให้ไว้ ควรรายงานว่าล้มเหลวพร้อมกับข้อความ NOT_EXECUTED_FAILURE

พารามิเตอร์
`listener`	`ITestInvocationListener` : ผู้ฟังหลักที่จะรายงานผลลัพธ์ที่ไม่ได้ดำเนินการ
`message`	`String` : ข้อความที่จะเชื่อมโยงกับความล้มเหลวที่ไม่ถูกดำเนินการ

รายงาน NotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

พารามิเตอร์
`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`

ชุดสร้าง

public void setBuild (IBuildInfo buildInfo)

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

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`

แยก

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

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

การส่งคืน
	ชุดของการทดสอบย่อยที่จะดำเนินการแยกกันหรือ `null` หากการทดสอบยังไม่สามารถแบ่งส่วนได้

วิธีการที่ได้รับการป้องกัน

createModuleListeners

protected  createModuleListeners ()

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

การส่งคืน

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

พารามิเตอร์
`config`	`IConfiguration` : `IConfiguration` ที่กำลังได้รับการประเมิน
`allowedRunners`	: รายชื่อนักวิ่งปัจจุบัน

การส่งคืน
`boolean`	เป็นจริงหากโมดูลการกำหนดค่าได้รับอนุญาตให้รัน มิฉะนั้นจะเป็นเท็จ

getAbisForBuildTargetArch.getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

ส่งคืน Abis ที่สถาปัตยกรรมเป้าหมายของ Host build เปิดเผยสำหรับการทดสอบ

การส่งคืน

getHostAbis

protected  getHostAbis ()

ส่งคืนเครื่องโฮสต์ abis

การส่งคืน

ควร ModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

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

การส่งคืน
`boolean`