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

คลาส 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 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()

โอกาสในการล้างข้อมูลทั้งหมดที่จำเป็นในระหว่างการตั้งค่า Suite แต่ไม่จำเป็นต้องทำการทดสอบ

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

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

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

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 ()

โอกาสในการล้างข้อมูลทั้งหมดที่จำเป็นในระหว่างการตั้งค่า Suite แต่ไม่จำเป็นต้องทำการทดสอบ

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

setMetricCollector"

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