ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, ITestCollector

java.lang.Object
   ↳ com.android.tradefed.testtype.suite.ModuleDefinition

คอนเทนเนอร์สำหรับการกำหนดค่าการทดสอบ คลาสนี้เป็นตัวช่วยในการเตรียมตัวและทำการทดสอบ

สรุป

ค่าคงที่

String ISOLATION_COST

String MODULE_ABI

String MODULE_CACHED

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากมีการแคชผลลัพธ์ของโมดูลทดสอบ

String MODULE_CONTROLLER

String MODULE_EXTERNAL_DEPENDENCIES

String MODULE_ID

รหัสโมดูลคือชื่อที่จะใช้เพื่อระบุโมดูลอย่างไม่ซ้ำกันในระหว่าง testRunStart

String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

String MODULE_ISOLATED

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากโมดูลทำงานในอุปกรณ์ที่เพิ่งเตรียมใหม่

String MODULE_NAME

ชื่อโมดูลคือชื่อฐานที่เชื่อมโยงกับโมดูล ซึ่งโดยปกติจะมาจากไฟล์กำหนดค่า Xml TF ที่โหลดโมดูล

String MODULE_PARAMETERIZATION

String MODULE_SKIPPED

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากข้ามโมดูลทดสอบ

String MODULE_TEST_COUNT

String PREPARATION_TIME

String RETRY_FAIL_COUNT

String RETRY_SUCCESS_COUNT

String RETRY_TIME

String SPARSE_MODULE

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากมีการรายงานเฉพาะเหตุการณ์ระดับโมดูล

String TEAR_DOWN_TIME

String TEST_TIME

เครื่องมือสร้างสาธารณะ

ModuleDefinition()
ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)

เครื่องมือสร้าง

ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)

เครื่องมือสร้าง

เมธอดสาธารณะ

int compareTo(ModuleDefinition moduleDef)

Set<Digest> getFilterDigests()

แสดงผลข้อมูลสรุปของตัวกรองที่เชื่อมโยงกับการทดสอบ

String getId()

แสดงชื่อโมดูลที่ไม่ซ้ำกัน

Integer getIntraModuleShardCount()
Integer getIntraModuleShardIndex()
IConfiguration getModuleConfiguration()
IInvocationContext getModuleInvocationContext()

แสดงผล IInvocationContext ที่เชื่อมโยงกับโมดูล

TestInformation getModuleTestInformation()
Set<TokenProperty> getRequiredTokens(TestInformation testInfo)
long getRuntimeHint()

แสดงเวลาโดยประมาณในการเรียกใช้การทดสอบทั้งหมดในโมดูล

boolean hasModuleFailed()

แสดงค่าเป็นจริงหากมีการเรียกใช้ testRunFailure ในโมดูล *

int neededDevices()

แสดงผลจำนวนอุปกรณ์ที่คาดว่าจะเรียกใช้การทดสอบนี้

int numTests()

แสดงผลจำนวน IRemoteTest ปัจจุบันที่รอการดำเนินการ

final void reportNotExecuted(ITestInvocationListener listener, String message)

รายงานโมดูลที่ไม่ได้ดำเนินการเลย

final void run(TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit)

เรียกใช้IRemoteTestทั้งหมดที่มีอยู่ในโมดูล และใช้ตัวเตรียมทั้งหมดก่อนและหลังเพื่อตั้งค่าและทำความสะอาดอุปกรณ์

final void run(TestInformation moduleInfo, ITestInvocationListener listener)

เรียกใช้IRemoteTestทั้งหมดที่มีอยู่ในโมดูล และใช้ตัวเตรียมทั้งหมดก่อนและหลังเพื่อตั้งค่าและทำความสะอาดอุปกรณ์

Throwable runPreparation(boolean includeSuitePreparers)

เรียกใช้เครื่องมือเตรียมการทดสอบ รวมถึงเครื่องมือเตรียมการระดับชุดทดสอบ หากมีการระบุ

void setBuild(IBuildInfo build)

แทรก IBuildInfo ที่จะใช้ระหว่างการทดสอบ

void setCollectKernelLog(boolean collectKernelLog)
void setCollectTestsOnly(boolean collectTestsOnly)

เปิดหรือปิดใช้โหมดการรวบรวมการทดสอบ

void setDefaultLogCollectors(List<IMetricCollector> collectors)
void setDevice(ITestDevice device)

แทรก ITestDevice ที่จะใช้ระหว่างการทดสอบ

void setEnableDynamicDownload(boolean enableDynamicDownload)

จะเปิดใช้การดาวน์โหลดแบบไดนามิกที่ระดับโมดูลหรือไม่

void setIntraModuleInformation(int shardCount, int shardIndex)
void setLogSaver(ILogSaver logSaver)

ส่งเครื่องมือบันทึกการเรียกใช้ไปยังโมดูลเพื่อให้โมดูลใช้เครื่องมือดังกล่าวได้หากจำเป็น

final void setMergeAttemps(boolean mergeAttempts)

กำหนดว่าเราควรผสานผลลัพธ์หรือไม่

void setMetricCollectors(List<IMetricCollector> collectors)

แทรกรายการ IMetricCollector ที่โมดูลจะใช้

void setRecoverVirtualDevice(boolean recoverVirtualDevice)

ชุดควรเรียกคืนอุปกรณ์เสมือนจริง

void setRemoveModuleBuffering(boolean removeModuleBuffering)
void setReportModuleEnd(boolean shouldReportModuleEnd)
void setReportModuleStart(boolean shouldReportModuleStart)
final void setRetryDecision(IRetryDecision decision)

ตั้งค่า IRetryDecision ที่จะใช้สำหรับการลองใหม่ภายในโมดูล

void setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
boolean shouldRecoverVirtualDevice()

แสดงว่าเราควรคืนค่าอุปกรณ์เสมือนจริงหรือไม่

String toString()

void transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)

คัดลอกการกำหนดค่าระดับชุดการทดสอบบางรายการ

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

boolean hasTests()

แสดงค่าเป็นจริงหากโมดูลยังมี IRemoteTest ที่จะเรียกใช้ในพูล

ค่าคงที่

ISOLATION_COST

public static final String ISOLATION_COST

ค่าคงที่ "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

ค่าคงที่: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากมีการแคชผลลัพธ์ของโมดูลทดสอบ

ค่าคงที่ "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

ค่าคงที่ "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

ค่าคงที่: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

รหัสโมดูลคือชื่อที่จะใช้เพื่อระบุโมดูลอย่างไม่ซ้ำกันในระหว่าง testRunStart โดยปกติจะเป็นการรวมกันของ MODULE_ABI + MODULE_NAME

ค่าคงที่ "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

ค่าคงที่: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากโมดูลทำงานในอุปกรณ์ที่เพิ่งเตรียมใหม่

ค่าคงที่: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

ชื่อโมดูลคือชื่อฐานที่เชื่อมโยงกับโมดูล ซึ่งโดยปกติจะมาจากไฟล์กำหนดค่า Xml TF ที่โหลดโมดูล

ค่าคงที่ "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

ค่าคงที่: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากข้ามโมดูลทดสอบ

ค่าคงที่: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

ค่าคงที่: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

ค่าคงที่: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

ค่าคงที่: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

ค่าคงที่: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

ค่าคงที่: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น "จริง" หากมีการรายงานเฉพาะเหตุการณ์ระดับโมดูล

ค่าคงที่ "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

ค่าคงที่: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

ค่าคงที่ "TEST_TIME"

เครื่องมือสร้างสาธารณะ

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

เครื่องมือสร้าง

พารามิเตอร์
name String: ชื่อที่ไม่ซ้ำกันของการกำหนดค่าการทดสอบ
tests Collection: รายการ IRemoteTest ที่ต้องเรียกใช้
preparersPerDevice Map: รายการ ITargetPreparer ที่จะใช้ในการตั้งค่าอุปกรณ์
multiPreparers List

moduleConfig IConfiguration: IConfiguration ของการกำหนดค่าโมดูลพื้นฐาน

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

เครื่องมือสร้าง

พารามิเตอร์
name String: ชื่อที่ไม่ซ้ำกันของการกำหนดค่าการทดสอบ
tests Collection: รายการ IRemoteTest ที่ต้องเรียกใช้
preparersPerDevice Map: รายการ ITargetPreparer ที่จะใช้ในการตั้งค่าอุปกรณ์
suitePreparersPerDevice Map

multiPreparers List

moduleConfig IConfiguration: IConfiguration ของการกำหนดค่าโมดูลพื้นฐาน

เมธอดสาธารณะ

compareTo

public int compareTo (ModuleDefinition moduleDef)

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

การคืนสินค้า
int

getFilterDigests

public Set<Digest> getFilterDigests ()

แสดงผลข้อมูลสรุปของตัวกรองที่เชื่อมโยงกับการทดสอบ

การคืนสินค้า
Set<Digest>

ส่ง
IOException

getId

public String getId ()

แสดงชื่อโมดูลที่ไม่ซ้ำกัน

การคืนสินค้า
String

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

การคืนสินค้า
Integer

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

การคืนสินค้า
Integer

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

การคืนสินค้า
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

แสดงผล IInvocationContext ที่เชื่อมโยงกับโมดูล

การคืนสินค้า
IInvocationContext

getModuleTestInformation

public TestInformation getModuleTestInformation ()

การคืนสินค้า
TestInformation

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

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

การคืนสินค้า
Set<TokenProperty>

getRuntimeHint

public long getRuntimeHint ()

แสดงเวลาโดยประมาณในการเรียกใช้การทดสอบทั้งหมดในโมดูล

การคืนสินค้า
long

hasModuleFailed

public boolean hasModuleFailed ()

แสดงค่าเป็นจริงหากมีการเรียกใช้ testRunFailure ในโมดูล *

การคืนสินค้า
boolean

neededDevices

public int neededDevices ()

แสดงผลจำนวนอุปกรณ์ที่คาดว่าจะเรียกใช้การทดสอบนี้

การคืนสินค้า
int

numTests

public int numTests ()

แสดงผลจำนวน IRemoteTest ปัจจุบันที่รอการดำเนินการ

การคืนสินค้า
int

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

รายงานโมดูลที่ไม่ได้ดำเนินการเลย

พารามิเตอร์
listener ITestInvocationListener

message String

โฮมรัน

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                int maxRunLimit)

เรียกใช้ IRemoteTest ทั้งหมดที่มีอยู่ในโมดูล และใช้ตัวเตรียมทั้งหมดก่อนและหลังเพื่อตั้งค่าและล้างข้อมูลในอุปกรณ์

พารามิเตอร์
moduleInfo TestInformation: TestInformation สำหรับโมดูล
listener ITestInvocationListener: ITestInvocationListener ที่ใช้รายงานผลลัพธ์
maxRunLimit int: จำนวนการเรียกใช้สูงสุดสำหรับกรณีทดสอบแต่ละรายการ
ส่ง
DeviceNotAvailableException ในกรณีที่อุปกรณ์ออฟไลน์

โฮมรัน

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

เรียกใช้IRemoteTestทั้งหมดที่มีอยู่ในโมดูล และใช้ตัวเตรียมทั้งหมดก่อนและหลังเพื่อตั้งค่าและทำความสะอาดอุปกรณ์

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

listener ITestInvocationListener: ITestInvocationListener ที่ใช้รายงานผลลัพธ์
ส่ง
DeviceNotAvailableException ในกรณีที่อุปกรณ์ออฟไลน์

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

เรียกใช้เครื่องมือเตรียมการทดสอบ รวมถึงเครื่องมือเตรียมการระดับชุดทดสอบ หากมีการระบุ

พารามิเตอร์
includeSuitePreparers boolean: ตั้งค่าเป็น true เพื่อเรียกใช้เครื่องมือเตรียมข้อมูลระดับชุดทดสอบด้วย
การคืนสินค้า
Throwable Throwable ของข้อยกเว้นที่เกิดขึ้นเมื่อเรียกใช้เครื่องมือเตรียมข้อมูล

setBuild

public void setBuild (IBuildInfo build)

แทรก IBuildInfo ที่จะใช้ระหว่างการทดสอบ

พารามิเตอร์
build IBuildInfo

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

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

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

เปิดหรือปิดใช้โหมดการรวบรวมการทดสอบ

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

พารามิเตอร์
collectors List

setDevice

public void setDevice (ITestDevice device)

แทรก ITestDevice ที่จะใช้ระหว่างการทดสอบ

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

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

จะเปิดใช้การดาวน์โหลดแบบไดนามิกที่ระดับโมดูลหรือไม่

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

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

พารามิเตอร์
shardCount int

shardIndex int

setLogSaver

public void setLogSaver (ILogSaver logSaver)

ส่งเครื่องมือบันทึกการเรียกใช้ไปยังโมดูลเพื่อให้โมดูลใช้เครื่องมือดังกล่าวได้หากจำเป็น

พารามิเตอร์
logSaver ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

กำหนดว่าเราควรผสานผลลัพธ์หรือไม่

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

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

แทรกรายการ IMetricCollector ที่โมดูลจะใช้

พารามิเตอร์
collectors List

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

ชุดควรเรียกคืนอุปกรณ์เสมือนจริง

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

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

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

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

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

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

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

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

ตั้งค่า IRetryDecision ที่จะใช้สำหรับการลองใหม่ภายในโมดูล

พารามิเตอร์
decision IRetryDecision

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

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

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

แสดงว่าเราควรคืนค่าอุปกรณ์เสมือนจริงหรือไม่

การคืนสินค้า
boolean

toString

public String toString ()

การคืนสินค้า
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

คัดลอกการกำหนดค่าระดับชุดการทดสอบบางรายการ

พารามิเตอร์
mSuiteConfiguration IConfiguration

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

hasTests

protected boolean hasTests ()

แสดงค่าเป็นจริงหากโมดูลยังมี IRemoteTest ที่จะเรียกใช้ในพูล มิเช่นนั้นจะเป็น "เท็จ"

การคืนสินค้า
boolean