تعریف ماژول

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_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

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, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)

سازنده

روش های عمومی

int compareTo ( ModuleDefinition moduleDef)

String getId ()

نام ماژول منحصر به فرد را برگردانید.

Integer getIntraModuleShardCount ()
Integer getIntraModuleShardIndex ()
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, 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 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 برای اجرا در 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_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY 

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

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

getIntraModuleShardCount 

public Integer getIntraModuleShardCount ()

برمی گرداند
Integer

getIntraModuleShardIndex 

public Integer getIntraModuleShardIndex ()

برمی گرداند
Integer

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

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

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

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

باید RecoverVirtualDevice 

public boolean shouldRecoverVirtualDevice ()

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

برمی گرداند
boolean

toString 

public String toString ()

برمی گرداند
String

transferSuiteLevelOptions 

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

پارامترها
mSuiteConfiguration IConfiguration

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

hasTests 

protected boolean hasTests ()

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

برمی گرداند
boolean