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

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

สรุป

ช่อง

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_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 เพื่อเรียกใช้โดยตรง หรือ Null หากยังไม่มี (เมื่อ 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 setSkipContext(SkipContext skipContext)
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 โดยนํา Runner ที่ไม่ได้อยู่ในรายการที่อนุญาตพิเศษออก

getAbisForBuildTargetArch()

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

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

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String ENABLE_RESOLVE_SYM_LINKS

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

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

ขั้นตอน

public static final String STAGE_MODULE_ARTIFACTS

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

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

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

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

ITestSuite

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

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 เพื่อเรียกใช้โดยตรง หรือ Null หากยังไม่มี (เมื่อ ITestSuite ยังไม่ได้รับการแบ่งกลุ่ม)

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

getIntraModuleSharding

public boolean getIntraModuleSharding ()

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

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)

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

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

คิกรีเทิร์น

getRuntimeHint

public long getRuntimeHint ()

แสดงรันไทม์ที่คาดไว้ของการทดสอบเป็นมิลลิวินาที ระบบจะใช้เวลานี้เพื่อจัดสรรภาระงานให้กับการดําเนินการแบบแยกกลุ่ม

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

getTestsDir

public File getTestsDir ()

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

แยก

public boolean isSplitting ()

แสดงค่า "จริง" หากเราอยู่ใน IShardableTest.split(int) ในปัจจุบัน

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

loadTests

public abstract  loadTests ()

เมธอดนามธรรมเพื่อโหลดการกําหนดค่าการทดสอบที่จะเรียกใช้ การทดสอบแต่ละรายการจะกำหนดโดย IConfiguration และชื่อที่ไม่ซ้ำกันซึ่งจะใช้รายงานผล

คิกรีเทิร์น

รายงานไม่ได้ดำเนินการ

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

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

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

reportNotExecuted

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

setCollectTestsOnly

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

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

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

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

ตั้งค่า mPrimaryAbiRun

พารามิเตอร์
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

พารามิเตอร์
dynamicModule boolean

ตั้งค่าข้ามบริบท

public void setSkipContext (SkipContext skipContext)

พารามิเตอร์
skipContext SkipContext

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 โดยนํา Runner ที่ไม่ได้อยู่ในรายการที่อนุญาตพิเศษออก หากการกําหนดค่ามี Runner หลายรายการ ระบบอาจนํา Runner บางรายการออกและการกำหนดค่าจะยังคงทํางานต่อไป

พารามิเตอร์
config IConfiguration: IConfiguration ที่กำลังประเมิน
allowedRunners : รายการที่อนุญาตพิเศษสำหรับ Runner ปัจจุบัน
คิกรีเทิร์น
boolean จริง หากอนุญาตให้โมดูลการกำหนดค่าทำงาน หรือเป็นเท็จ

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

คิกรีเทิร์น

getHostAbis

protected  getHostAbis ()

แสดงค่า abis ของเครื่องโฮสต์

คิกรีเทิร์น

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

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

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