تعریف ماژول

public class ModuleDefinition
extends Object implements Comparable< ModuleDefinition >, ITestCollector

شیء جاوا
↳ com.android.tradefed.testtype.suite.ModuleDefinition

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

خلاصه

ثابت‌ها

String ISOLATION_COST

String MODULE_ABI

String MODULE_CACHED

اگر نتایج ماژول تست ذخیره شده باشند، این ویژگی روی true تنظیم می‌شود.

String MODULE_CONTROLLER

String MODULE_EXTERNAL_DEPENDENCIES

String MODULE_ID

شناسه ماژول، نامی که برای شناسایی منحصر به فرد ماژول در طول testRunStart استفاده خواهد شد.

String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

String MODULE_ISOLATED

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

String MODULE_NAME

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

String MODULE_PARAMETERIZATION

String MODULE_SKIPPED

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

String MODULE_TEST_COUNT

String PREPARATION_TIME

String RETRY_FAIL_COUNT

String RETRY_SUCCESS_COUNT

String RETRY_TIME

String SPARSE_MODULE

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

String TEAR_DOWN_TIME

String TEST_TIME

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

ModuleDefinition ()
ModuleDefinition (String name, Collection< IRemoteTest > tests, Map<String, List< ITargetPreparer >> preparersPerDevice, List< IMultiTargetPreparer > multiPreparers, IConfiguration moduleConfig)

سازنده

ModuleDefinition (String name, Collection< IRemoteTest > tests, Map<String, List< ITargetPreparer >> preparersPerDevice, Map<String, List< ITargetPreparer >> suitePreparersPerDevice, List< IMultiTargetPreparer > multiPreparers, IConfiguration moduleConfig)

سازنده

روش‌های عمومی

int compareTo ( ModuleDefinition moduleDef)

Set<Digest> getFilterDigests ()

خلاصه فیلترهای مرتبط با تست‌ها را برگردانید.

String getId ()

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

Integer getIntraModuleShardCount ()
Integer getIntraModuleShardIndex ()
IConfiguration getModuleConfiguration ()
IInvocationContext getModuleInvocationContext ()

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

TestInformation getModuleTestInformation ()
Set< TokenProperty > 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 setCollectKernelLog (boolean collectKernelLog)
void setCollectTestsOnly (boolean collectTestsOnly)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

void setDefaultLogCollectors (List< IMetricCollector > collectors)
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 (List< IMetricCollector > collectors)

لیست IMetricCollector را که قرار است توسط ماژول استفاده شود، تزریق کنید.

void setRecoverVirtualDevice (boolean recoverVirtualDevice)

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

void setRemoveModuleBuffering (boolean removeModuleBuffering)
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 برای اجرا در مخزن خود دارد، مقدار True را برمی‌گرداند.

ثابت‌ها

هزینه جداسازی 

public static final String ISOLATION_COST

مقدار ثابت: "هزینه جداسازی"

ماژول_ABI 

public static final String MODULE_ABI

مقدار ثابت: "module-abi"

ماژول_حافظه_نگهدارنده 

public static final String MODULE_CACHED

اگر نتایج ماژول تست ذخیره شده باشند، این ویژگی روی true تنظیم می‌شود.

مقدار ثابت: "module-cached"

کنترل‌کننده ماژول 

public static final String MODULE_CONTROLLER

مقدار ثابت: "module_controller"

وابستگی‌های خارجی ماژول 

public static final String MODULE_EXTERNAL_DEPENDENCIES

مقدار ثابت: "وابستگی‌های خارجی ماژول"

شناسه ماژول 

public static final String MODULE_ID

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

مقدار ثابت: "module-id"

کلید میانبر ماژول فراخوانی ویژگی پرچم 

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

مقدار ثابت: "module-flag-overrides"

ماژول ایزوله 

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

مقدار ثابت: "MODULE_TEST_COUNT"

زمان آماده‌سازی 

public static final String PREPARATION_TIME

مقدار ثابت: "PREP_TIME"

تعداد تکرار ناموفق 

public static final String RETRY_FAIL_COUNT

مقدار ثابت: "MODULE_RETRY_FAILED"

شمارش موفقیت مجدد 

public static final String RETRY_SUCCESS_COUNT

مقدار ثابت: "MODULE_RETRY_SUCCESS"

زمان_تلاش مجدد 

public static final String RETRY_TIME

مقدار ثابت: "MODULE_RETRY_TIME"

ماژول پراکنده 

public static final String SPARSE_MODULE

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

مقدار ثابت: "sparse-module"

زمان اشک ریختن 

public static final String TEAR_DOWN_TIME

مقدار ثابت: "TEARDOWN_TIME"

زمان آزمون 

public static final String TEST_TIME

مقدار ثابت: "TEST_TIME"

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

تعریف ماژول 

public ModuleDefinition ()

تعریف ماژول 

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

سازنده

پارامترها
name String : نام منحصر به فرد پیکربندی آزمون.

tests Collection : فهرست IRemoteTest هایی که باید اجرا شوند.

preparersPerDevice Map : فهرستی از ITargetPreparer که برای راه‌اندازی دستگاه استفاده می‌شود.

multiPreparers List

moduleConfig IConfiguration : IConfiguration مربوط به پیکربندی ماژول مربوطه.

تعریف ماژول 

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

سازنده

پارامترها
name String : نام منحصر به فرد پیکربندی آزمون.

tests Collection : فهرست IRemoteTest هایی که باید اجرا شوند.

preparersPerDevice Map : فهرستی از ITargetPreparer که برای راه‌اندازی دستگاه استفاده می‌شود.

suitePreparersPerDevice Map

multiPreparers List

moduleConfig IConfiguration : IConfiguration مربوط به پیکربندی ماژول مربوطه.

روش‌های عمومی

مقایسه کنید 

public int compareTo (ModuleDefinition moduleDef)

پارامترها
moduleDef ModuleDefinition

بازگشت‌ها
int

دریافت فیلترها 

public Set<Digest> getFilterDigests ()

خلاصه فیلترهای مرتبط با تست‌ها را برگردانید.

بازگشت‌ها
Set<Digest>

پرتاب‌ها
IOException

دریافت شناسه 

public String getId ()

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

بازگشت‌ها
String

دریافت درون ماژولیShardCount 

public Integer getIntraModuleShardCount ()

بازگشت‌ها
Integer

دریافت درون ماژولیShardIndex 

public Integer getIntraModuleShardIndex ()

بازگشت‌ها
Integer

پیکربندی ماژول دریافت 

public IConfiguration getModuleConfiguration ()

بازگشت‌ها
IConfiguration

getModuleInvocationContext 

public IInvocationContext getModuleInvocationContext ()

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

بازگشت‌ها
IInvocationContext

اطلاعات آزمون ماژول را دریافت کنید 

public TestInformation getModuleTestInformation ()

بازگشت‌ها
TestInformation

دریافت توکن‌های مورد نیاز 

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

پارامترها
testInfo TestInformation

بازگشت‌ها
Set< TokenProperty >

getRuntimeHint 

public long getRuntimeHint ()

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

بازگشت‌ها
long

ماژول شکست خورده است 

public boolean hasModuleFailed ()

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

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

آماده‌سازی اجرا 

public Throwable runPreparation (boolean includeSuitePreparers)

آماده‌سازهای آزمون را اجرا کنید، از جمله آماده‌سازهای سطح مجموعه در صورت مشخص شدن.

پارامترها
includeSuitePreparers boolean : برای اجرای آماده‌سازهای سطح مجموعه، روی true تنظیم می‌شود.

بازگشت‌ها
Throwable Throwable از هرگونه استثنائی که هنگام اجرای آماده‌سازها ایجاد می‌شود.

مجموعه ساخت 

public void setBuild (IBuildInfo build)

IBuildInfo را برای استفاده در طول تست‌ها تزریق کنید.

پارامترها
build IBuildInfo

setCollectKernelLog 

public void setCollectKernelLog (boolean collectKernelLog)

پارامترها
collectKernelLog boolean

فقط تست‌های جمع‌آوری‌شده 

public void setCollectTestsOnly (boolean collectTestsOnly)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

مجموعه‌های پیش‌فرض ثبت وقایع 

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

پارامترها
collectors List

دستگاه تنظیم‌شده 

public void setDevice (ITestDevice device)

ITestDevice را که قرار است در طول آزمایش‌ها استفاده شود، تزریق کنید.

پارامترها
device ITestDevice

دانلود پویای setEnable 

public void setEnableDynamicDownload (boolean enableDynamicDownload)

فعال کردن یا نکردن دانلود پویا در سطح ماژول.

پارامترها
enableDynamicDownload boolean

اطلاعات درون ماژولی را تنظیم کنید 

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

پارامترها
shardCount int

shardIndex int

تنظیم لاگ سیور 

public void setLogSaver (ILogSaver logSaver)

ذخیره‌کننده‌ی گزارش فراخوانی را به ماژول ارسال کنید تا در صورت لزوم بتواند از آن استفاده کند.

پارامترها
logSaver ILogSaver

setMergeAttemps 

public final void setMergeAttemps (boolean mergeAttempts)

تعیین می‌کند که آیا باید نتایج را ادغام کنیم یا خیر.

پارامترها
mergeAttempts boolean

مجموعه‌جمع‌کننده‌های متریک 

public void setMetricCollectors (List<IMetricCollector> collectors)

لیست IMetricCollector را که قرار است توسط ماژول استفاده شود، تزریق کنید.

پارامترها
collectors List

setRecoverVirtualDevice 

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

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

پارامترها
recoverVirtualDevice boolean

بافرینگ setRemoveModule 

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

پارامترها
removeModuleBuffering boolean

پایان ماژول گزارش (setReportModuleEnd) 

public void setReportModuleEnd (boolean shouldReportModuleEnd)

پارامترها
shouldReportModuleEnd boolean

شروع ماژول گزارش 

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

shouldRecoverVirtualDevice 

public boolean shouldRecoverVirtualDevice ()

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

بازگشت‌ها
boolean

رشته‌ی دوتایی 

public String toString ()

بازگشت‌ها
String

transferSuiteLevelOptions 

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

پارامترها
mSuiteConfiguration IConfiguration

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

hasTests 

protected boolean hasTests ()

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

بازگشت‌ها
boolean