تعریف ماژول

public class ModuleDefinition
extends Object implements ITestCollector

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

ظرف برای پیکربندی اجرای آزمایشی. این کلاس کمکی برای آماده سازی و اجرای تست ها می باشد.

خلاصه

فیلدها

public static final String MODULE_ABI

public static final String MODULE_CONTROLLER

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 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 TEAR_DOWN_TIME

public static final String TEST_TIME

سازندگان عمومی

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

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

IInvocationContext getModuleInvocationContext ()

IInvocationContext مرتبط با ماژول را برمی گرداند.

getRequiredTokens ()
long getRuntimeHint ()

زمان تقریبی اجرای تمام تست‌های ماژول را برمی‌گرداند.

boolean hasModuleFailed ()

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

int numTests ()

تعداد فعلی IRemoteTest در انتظار اجرا را برمی‌گرداند.

final void reportNotExecuted (ITestInvocationListener listener, String message)

گزارش ماژول های اجرا نشده کاملا

final void run (TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener) run (TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)

تمام IRemoteTest موجود در ماژول را اجرا کنید و از همه آماده‌کننده‌ها قبل و بعد برای راه‌اندازی و تمیز کردن دستگاه استفاده کنید.

final void run (TestInformation moduleInfo, ITestInvocationListener listener)

تمام IRemoteTest موجود در ماژول را اجرا کنید و از همه آماده‌کننده‌ها قبل و بعد برای راه‌اندازی و تمیز کردن دستگاه استفاده کنید.

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

تمام 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 را برای استفاده توسط ماژول تزریق کنید.

final void setRetryDecision ( IRetryDecision decision)

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

String toString ()

void transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)

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

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

boolean hasTests ()

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

فیلدها

MODULE_ABI 

public static final String MODULE_ABI

MODULE_CONTROLLER 

public static final String MODULE_CONTROLLER

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

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

TEAR_DOWN_TIME 

public static final String TEAR_DOWN_TIME

TEST_TIME 

public static final String TEST_TIME

سازندگان عمومی

تعریف ماژول 

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

getModuleInvocationContext 

public IInvocationContext getModuleInvocationContext ()

IInvocationContext مرتبط با ماژول را برمی گرداند.

برمی گرداند
IInvocationContext

getRequiredTokens 

public  getRequiredTokens ()

برمی گرداند

getRuntimeHint 

public long getRuntimeHint ()

زمان تقریبی اجرای تمام تست‌های ماژول را برمی‌گرداند.

برمی گرداند
long

hasModuleFailed 

public boolean hasModuleFailed ()

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

برمی گرداند
boolean

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, 
                TestFailureListener failureListener)

تمام IRemoteTest موجود در ماژول را اجرا کنید و از همه آماده‌کننده‌ها قبل و بعد برای راه‌اندازی و تمیز کردن دستگاه استفاده کنید.

پارامترها
moduleInfo TestInformation

listener ITestInvocationListener : ITestInvocationListener که در آن نتایج را گزارش کنید.

moduleLevelListeners : لیست شنوندگان در سطح ماژول.

failureListener TestFailureListener : یک شنونده خاص برای جمع آوری گزارش ها در testFail. می تواند پوچ باشد.

پرتاب می کند
DeviceNotAvailableException در صورت آفلاین شدن دستگاه

اجرا کنید 

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

تمام IRemoteTest موجود در ماژول را اجرا کنید و از همه آماده‌کننده‌ها قبل و بعد برای راه‌اندازی و تمیز کردن دستگاه استفاده کنید.

پارامترها
moduleInfo TestInformation

listener ITestInvocationListener : ITestInvocationListener که در آن نتایج را گزارش کنید.

پرتاب می کند
DeviceNotAvailableException در صورت آفلاین شدن دستگاه

اجرا کنید 

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

تمام IRemoteTest موجود در ماژول را اجرا کنید و از همه آماده‌کننده‌ها قبل و بعد برای راه‌اندازی و تمیز کردن دستگاه استفاده کنید.

پارامترها
moduleInfo TestInformation : TestInformation برای ماژول.

listener ITestInvocationListener : ITestInvocationListener که در آن نتایج را گزارش کنید.

moduleLevelListeners : لیست شنوندگان در سطح ماژول.

failureListener TestFailureListener : یک شنونده خاص برای جمع آوری گزارش ها در testFail. می تواند پوچ باشد.

maxRunLimit int : حداکثر تعداد اجراها برای هر تست.

پرتاب می کند
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

setRetryDecision 

public final void setRetryDecision (IRetryDecision decision)

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

پارامترها
decision IRetryDecision

toString 

public String toString ()

برمی گرداند
String

transferSuiteLevelOptions 

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

پارامترها
mSuiteConfiguration IConfiguration

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

hasTests 

protected boolean hasTests ()

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

برمی گرداند
boolean