การกำหนดโมดูล

public class ModuleDefinition
extends Object implements ITestCollector

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

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

สรุป

ช่อง

public static final String ISOLATION_COST

public static final String MODULE_ABI

public static final String MODULE_CACHED

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

public static final String MODULE_CONTROLLER

public static final String MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_ID

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

public static final String MODULE_ISOLATED

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

public static final String MODULE_NAME

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

public static final String MODULE_PARAMETERIZATION

public static final String MODULE_SKIPPED

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

public static final String MODULE_TEST_COUNT

public static final String PREPARATION_TIME

public static final String RETRY_FAIL_COUNT

public static final String RETRY_SUCCESS_COUNT

public static final String RETRY_TIME

public static final String SPARSE_MODULE

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

public static final String TEAR_DOWN_TIME

public static final 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()

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

IConfiguration getModuleConfiguration()
IInvocationContext getModuleInvocationContext()

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

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, moduleLevelListeners)

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

final void run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, 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 setLogSaver(ILogSaver logSaver)

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

final void setMergeAttemps(boolean mergeAttempts)

ตั้งค่าว่าเราควรรวมผลลัพธ์หรือไม่

void setMetricCollectors( collectors)

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

void setRecoverVirtualDevice(boolean recoverVirtualDevice)

ชุดควรกู้คืนอุปกรณ์เสมือน

final void setRetryDecision(IRetryDecision decision)

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

boolean shouldRecoverVirtualDevice()

แสดงผลหากเราควรกู้คืนอุปกรณ์เสมือน

String toString()

void transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)

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

วิธีการป้องกัน

boolean hasTests()

แสดงค่า "จริง" หากโมดูลยังคงมี IRemoteTest ที่จะทำงานในกลุ่ม

ช่อง

มูลค่า ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

แคชโมดูลแล้ว

public static final String MODULE_CACHED

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

MODULE_ControlLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

รหัสโมดูล

public static final String MODULE_ID

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

MODULE_ISOLATED

public static final String MODULE_ISOLATED

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

MODULE_NAME

public static final String MODULE_NAME

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

พารามิเตอร์โมดูล

public static final String MODULE_PARAMETERIZATION

ข้ามโมดูล

public static final String MODULE_SKIPPED

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

MODULE_TEST_COUNT รายการ

public static final String MODULE_TEST_COUNT

PREPARATION_TIME

public static final String PREPARATION_TIME

ลองใหม่ไม่สำเร็จ COUNT ครั้ง

public static final String RETRY_FAIL_COUNT

ลองใหม่สำเร็จ_COUNT

public static final String RETRY_SUCCESS_COUNT

เวลาซ้ำ

public static final String RETRY_TIME

แยกโมดูล

public static final String SPARSE_MODULE

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

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

เวลาทดสอบ

public static final String TEST_TIME

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

การกำหนดโมดูล

public ModuleDefinition ()

การกำหนดโมดูล

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

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

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

moduleConfig IConfiguration: IConfiguration ของการกำหนดค่าโมดูลที่สำคัญ

การกำหนดโมดูล

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

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

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

multiPreparers

moduleConfig IConfiguration: IConfiguration ของการกำหนดค่าโมดูลที่สำคัญ

วิธีการสาธารณะ

เปรียบเทียบกับ

public int compareTo (ModuleDefinition moduleDef)

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

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

getId

public String getId ()

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

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

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

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

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

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

getrequiredTokens

public  getRequiredTokens (TestInformation testInfo)

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

คิกรีเทิร์น

getRuntimeHint

public long getRuntimeHint ()

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

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

โมดูลล้มเหลว

public boolean hasModuleFailed ()

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

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

อุปกรณ์ที่จำเป็น

public int neededDevices ()

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

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

numTests

public int numTests ()

แสดงผลจำนวนปัจจุบันของ IRemoteTest ที่รอเรียกใช้

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

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

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

รายงานโมดูลที่ไม่ได้ดำเนินการอย่างสมบูรณ์

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

message String

โฮมรัน

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners)

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

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

listener ITestInvocationListener: ITestInvocationListener ตำแหน่งที่ต้องการรายงานผลลัพธ์
moduleLevelListeners : รายชื่อผู้ฟังในระดับโมดูล
การขว้าง
DeviceNotAvailableException ในกรณีที่อุปกรณ์ออฟไลน์

โฮมรัน

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

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

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

โฮมรัน

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

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

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

listener ITestInvocationListener: ITestInvocationListener ตำแหน่งที่ต้องการรายงานผลลัพธ์
การขว้าง
DeviceNotAvailableException ในกรณีที่อุปกรณ์ออฟไลน์

การเตรียมการรัน

public Throwable runPreparation (boolean includeSuitePreparers)

เรียกใช้ผู้เตรียมการทดสอบ รวมถึงผู้เตรียมพร้อมระดับชุดโปรแกรม (หากระบุ)

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

ตั้งค่าบิลด์

public void setBuild (IBuildInfo build)

แทรก IBuildInfo เพื่อใช้ระหว่างการทดสอบ

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

ตั้งค่า CollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

เปิดหรือปิดใช้โหมดคอลเล็กชันทดสอบ

ตั้งค่าอุปกรณ์

public void setDevice (ITestDevice device)

แทรก ITestDevice เพื่อใช้ระหว่างการทดสอบ

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

setEnabledDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

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

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

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

ตั้งค่าความพยายามผสานรวม

public final void setMergeAttemps (boolean mergeAttempts)

ตั้งค่าว่าเราควรรวมผลลัพธ์หรือไม่

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

setMetricCollectors

public void setMetricCollectors ( collectors)

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

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

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

ชุดควรกู้คืนอุปกรณ์เสมือน

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

setลองอีกครั้ง Decision

public final void setRetryDecision (IRetryDecision decision)

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

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

คุณควรกู้คืนอุปกรณ์เสมือน

public boolean shouldRecoverVirtualDevice ()

แสดงผลหากเราควรกู้คืนอุปกรณ์เสมือน

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

toString

public String toString ()

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

ตัวเลือกชุดการโอน

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

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

วิธีการป้องกัน

hasTests

protected boolean hasTests ()

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

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