ModuleDefinition

public class ModuleDefinition
extends Object implements 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, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)

ผู้ผลิต

ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)

ผู้ผลิต

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

int compareTo(ModuleDefinition moduleDef)

String getId()

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

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

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

TestInformation getModuleTestInformation()
getRequiredTokens(TestInformation testInfo)
long getRuntimeHint()

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

boolean hasModuleFailed()

แสดงค่า True หากมีการเรียก 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 setCollectTestsOnly(boolean collectTestsOnly)

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

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

แสดงค่า True หากโมดูลยังมี 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, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

ผู้ผลิต

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

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

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

ผู้ผลิต

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

multiPreparers

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

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

compareTo

public int compareTo (ModuleDefinition moduleDef)

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

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

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  getRequiredTokens (TestInformation testInfo)

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

คิกรีเทิร์น

getRuntimeHint

public long getRuntimeHint ()

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

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

hasModuleFailed

public boolean hasModuleFailed ()

แสดงค่า True หากมีการเรียกใช้ 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

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

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

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

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

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

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

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