تعریف ماژول

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 اگر نتایج ماژول تست در حافظه پنهان باشد، این ویژگی روی true تنظیم می شود.
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 اگر ماژول بر روی یک دستگاه تازه آماده اجرا می شد، این ویژگی روی true تنظیم می شود.
public static final String	MODULE_NAME نام ماژول، نام پایه مرتبط با ماژول است، که معمولاً از فایل پیکربندی Xml TF که ماژول از آن بارگذاری شده است، می آید.
public static final String	MODULE_PARAMETERIZATION
public static final String	MODULE_SKIPPED اگر ماژول آزمایشی نادیده گرفته شود، این ویژگی روی true تنظیم می شود
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 اگر فقط رویدادهای سطح ماژول گزارش شوند، این ویژگی روی true تنظیم می شود.
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, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) سازنده
ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, 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 در ماژول فراخوانی شده باشد True را برمی گرداند *
int	neededDevices () تعداد دستگاه های مورد انتظار برای اجرای این آزمایش را برمی گرداند.
int	numTests () تعداد فعلی IRemoteTest در انتظار اجرا را برمی‌گرداند.
final void	reportNotExecuted ( ITestInvocationListener listener, String message) ماژول های اجرا نشده را گزارش دهید.
final void	run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners) run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners) تمام IRemoteTest موجود در ماژول را اجرا کنید و از همه آماده‌کننده‌ها قبل و بعد برای راه‌اندازی و تمیز کردن دستگاه استفاده کنید.
final void	run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit) 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) setMetricCollectors ( collectors) لیست IMetricCollector را برای استفاده توسط ماژول تزریق کنید.
void	setRecoverVirtualDevice (boolean recoverVirtualDevice) مجموعه ها باید دستگاه مجازی را بازیابی کنند.
final void	setRetryDecision ( IRetryDecision decision) IRetryDecision برای امتحان مجدد درون ماژول تنظیم می کند.
boolean	shouldRecoverVirtualDevice () اگر باید دستگاه مجازی را بازیابی کنیم، برمی‌گردد.
String	toString ()
void	transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration) تعدادی از تنظیمات سطح مجموعه را کپی کنید

روش های محافظت شده
boolean	hasTests () اگر ماژول هنوز IRemoteTest برای اجرا در Pool خود دارد، True را برگردانید.

فیلدها

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

اگر نتایج ماژول تست در حافظه پنهان باشد، این ویژگی روی true تنظیم می شود.

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

شناسه ماژول نامی که برای شناسایی منحصربه‌فرد ماژول در طول testRunStart استفاده می‌شود. معمولاً ترکیبی از MODULE_ABI + MODULE_NAME خواهد بود.

MODULE_ISOLATED

public static final String MODULE_ISOLATED

اگر ماژول بر روی یک دستگاه تازه آماده اجرا می شد، این ویژگی روی true تنظیم می شود.

MODULE_NAME

public static final String MODULE_NAME

نام ماژول، نام پایه مرتبط با ماژول است، که معمولاً از فایل پیکربندی Xml TF که ماژول از آن بارگذاری شده است، می آید.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_SKIPPED

public static final String MODULE_SKIPPED

اگر ماژول آزمایشی نادیده گرفته شود، این ویژگی روی true تنظیم می شود

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

PREPARATION_TIME

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

SPARSE_MODULE

public static final String SPARSE_MODULE

اگر فقط رویدادهای سطح ماژول گزارش شوند، این ویژگی روی true تنظیم می شود.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_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

hasModuleFailed

public boolean hasModuleFailed ()

اگر یک testRunFailure در ماژول فراخوانی شده باشد True را برمی گرداند *

برمی گرداند
boolean

دستگاه های مورد نیاز

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, 
                 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	در صورت آفلاین شدن دستگاه

run Preparation

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

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

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

IRetryDecision برای امتحان مجدد درون ماژول تنظیم می کند.

پارامترها
decision	IRetryDecision

باید RecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

اگر باید دستگاه مجازی را بازیابی کنیم، برمی‌گردد.

برمی گرداند
boolean

toString

public String toString ()

برمی گرداند
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

تعدادی از تنظیمات سطح مجموعه را کپی کنید

پارامترها
mSuiteConfiguration	IConfiguration

روش های محافظت شده

دارای تست ها

protected boolean hasTests ()

اگر ماژول هنوز IRemoteTest برای اجرا در Pool خود دارد، True را برگردانید. در غیر این صورت نادرست است.

برمی گرداند
boolean