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

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

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

BaseTestSuite , TfSuiteRunner

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

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

AtestRunner , TestMappingSuiteRunner

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

คลาสบทคัดย่อใช้เพื่อรัน 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 ที่สนับสนุนโดยทั้งการทดสอบความเข้ากันได้ `AbiUtils.getAbisSupportedByCompatibility()` และอุปกรณ์ที่ทดสอบ
`static`	`getAbisForBuildTargetArchFromSuite ()` คืน abis ที่เป็นไปได้จาก TestSuiteInfo
`IBuildInfo`	`getBuildInfo ()` การใช้งาน `ITestSuite` อาจต้องการข้อมูลบิลด์เพื่อโหลดการทดสอบ
`final IConfiguration`	`getConfiguration ()` ส่งกลับการร้องขอ `IConfiguration`
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` รับอุปกรณ์ภายใต้การทดสอบ
`ModuleDefinition`	`getDirectModule ()` คืนค่า `ModuleDefinition` ให้ดำเนินการโดยตรง หรือคืนค่า null หากยังไม่มี (เมื่อ ITestSuite ยังไม่ได้แยกชิ้นส่วน)
`IInvocationContext`	`getInvocationContext ()` ส่งกลับบริบทการร้องขอ
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`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`	`setInvocationContext ( IInvocationContext invocationContext)`
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` ตั้งค่ารายการของ `IMetricCollector` ที่กำหนดไว้สำหรับการเรียกใช้การทดสอบ
`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 ที่สนับสนุนโดยสถาปัตยกรรมเป้าหมายการสร้างโฮสต์
	`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`	จริงถ้าโมดูลควรทำงาน มิฉะนั้นจะเป็นเท็จ

รับเอบิส

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`

รับตัวบันทึกการทดสอบปัจจุบัน

public ITestLogger getCurrentTestLogger ()

ส่งคืน
`ITestLogger`

รับอุปกรณ์

public ITestDevice getDevice ()

รับอุปกรณ์ภายใต้การทดสอบ

ส่งคืน
`ITestDevice`	`ITestDevice`

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`

รับโทเค็นที่จำเป็น

public  getRequiredTokens (TestInformation testInfo)

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

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

ส่งคืน

รับคำแนะนำรันไทม์

public long getRuntimeHint ()

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

ส่งคืน
`long`

getTestsผู้อำนวยการ

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)

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

ชุดสร้าง

public void setBuild (IBuildInfo buildInfo)

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

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`

แยก

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

พารามิเตอร์
`shardCountHint`	`Integer` : จำนวนเศษที่พยายาม
`testInfo`	`TestInformation` : `TestInformation` หลัก

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

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

สร้างโมดูลฟัง

protected  createModuleListeners ()

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

ส่งคืน

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

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

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

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

ส่งคืน abis ที่สนับสนุนโดยสถาปัตยกรรมเป้าหมายการสร้างโฮสต์ เปิดเผยสำหรับการทดสอบ

ส่งคืน

รับ HostAbis

protected  getHostAbis ()

ส่งกลับ abis เครื่องโฮสต์

ส่งคืน

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

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

ควรโมดูลรัน

protected boolean shouldModuleRun (ModuleDefinition module)

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

ส่งคืน
`boolean`