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 ที่สนับสนุนโดยทั้งการทดสอบความเข้ากันได้ 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)

รายงานการทดสอบที่ไม่ได้ดำเนินการไปยังผู้ฟังหลักที่ให้ไว้ ควรรายงานว่าล้มเหลวด้วยข้อความ 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

ชุดสร้าง

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