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

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