ITestSuite
public abstract class ITestSuite
extends Object
implements IRemoteTest , IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest , ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ITestSuite |
تستخدم فئة الملخصات لتشغيل Test Suite. توفر هذه الفئة الأساس لكيفية تشغيل الجناح. يمكن لكل تطبيق تحديد قائمة الاختبارات عبر طريقة loadTests()
.
ملخص
مجالات | |
---|---|
public static final String | ABI_OPTION |
public static final String | ACTIVE_MAINLINE_PARAMETER_KEY |
public static final String | MAINLINE_PARAMETER_KEY |
public static final String | MODULE_CHECKER_POST |
public static final String | MODULE_CHECKER_PRE |
public static final String | MODULE_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
public static final String | PARAMETER_KEY |
public static final String | PREPARER_WHITELIST |
public static final String | PRIMARY_ABI_RUN |
public static final String | RANDOM_SEED |
public static final String | RUNNER_WHITELIST |
public static final String | SKIP_HOST_ARCH_CHECK |
public static final String | SKIP_STAGING_ARTIFACTS |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
المنشأت العامة | |
---|---|
ITestSuite () |
الأساليب العامة | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) قم بتطبيق مرشح البيانات الوصفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين. |
getAbis ( ITestDevice device) الحصول على مجموعة ABIs التي يدعمها اختبار التوافق | |
static | getAbisForBuildTargetArchFromSuite () تُرجع abis المحتمل من TestSuiteInfo. |
IBuildInfo | getBuildInfo () قد يتطلب تنفيذ |
final IConfiguration | getConfiguration () إرجاع |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () احصل على الجهاز قيد الاختبار. |
ModuleDefinition | getDirectModule () تُرجع |
IInvocationContext | getInvocationContext () إرجاع سياق الاستدعاء. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
final String | getRequestedAbi () لعرض abi المطلوب بالخيار -a أو --abi. |
getRequiredTokens ( TestInformation testInfo) تُرجع قائمة الرموز المطلوبة بواسطة الاختبار. | |
long | getRuntimeHint () قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية. |
File | getTestsDir () |
boolean | isSplitting () يعود صحيحًا إذا كنا حاليًا في |
abstract | loadTests () طريقة Abstract لتحميل تكوين الاختبارات التي سيتم تشغيلها. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم. |
void | reportNotExecuted ( ITestInvocationListener listener) قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) طريقة التشغيل العامة لجميع الاختبارات التي تم تحميلها من |
void | setAbiName (String abiName) قم بتعيين قيمة mAbiName |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) قم بتشغيل مجموعة الاختبار في وضع المجمع فقط ، وهذا يتطلب جميع الاختبارات الفرعية لتنفيذ هذه الواجهة أيضًا. |
void | setConfiguration ( IConfiguration configuration) يُحقن رمز |
void | setDevice ( ITestDevice device) احقن الجهاز قيد الاختبار. |
void | setDirectModule ( ModuleDefinition module) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) يضبط قائمة |
void | setPrimaryAbiRun (boolean primaryAbiRun) قم بتعيين قيمة mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) عند إجراء التجزئة الموزعة ، لا يمكننا الحصول على تعريف ModuleDefinition الذي يشارك الاختبارات في مجموعة وإلا فلن يعمل التجزئة داخل الوحدة النمطية ، لذلك نسمح بتعطيله. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) يضبط |
void | setTestLogger ( ITestLogger testLogger) يقوم بإدخال مثيل |
split (Integer shardCountHint, TestInformation testInfo) إصدار بديل من |
الطرق المحمية | |
---|---|
createModuleListeners () إرجاع قائمة | |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) قم بتطبيق تصفية قائمة العداء البيضاء ، وإزالة أي عداء لم يتم إدراجه في القائمة البيضاء. |
getAbisForBuildTargetArch () قم بإرجاع abis المدعوم من قبل البنية المستهدفة لبناء المضيف. | |
getHostAbis () إرجاع الجهاز المضيف abis. | |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
boolean | shouldModuleRun ( ModuleDefinition module) |
مجالات
ABI_OPTION
public static final String ABI_OPTION
ACTIVE_MAINLINE_PARAMETER_KEY
public static final String ACTIVE_MAINLINE_PARAMETER_KEY
MAINLINE_PARAMETER_KEY
public static final String MAINLINE_PARAMETER_KEY
MODULE_CHECKER_POST
public static final String MODULE_CHECKER_POST
MODULE_CHECKER_PRE
public static final String MODULE_CHECKER_PRE
MODULE_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
PARAMETER_KEY
public static final String PARAMETER_KEY
PREPARER_WHITELIST
public static final String PREPARER_WHITELIST
PRIMARY_ABI_RUN
public static final String PRIMARY_ABI_RUN
البذور عشوائي
public static final String RANDOM_SEED
RUNNER_WHITELIST
public static final String RUNNER_WHITELIST
SKIP_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
SKIP_STAGING_ARTIFACTS
public static final String SKIP_STAGING_ARTIFACTS
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
المنشأت العامة
ITestSuite
public ITestSuite ()
الأساليب العامة
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
حدود | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
حدود | |
---|---|
filters | MultiMap |
عامل التصفيةByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
قم بتطبيق مرشح البيانات الوصفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين.
حدود | |
---|---|
config | IConfiguration : يتم تقييم IConfiguration . |
include | MultiMap : تشمل البيانات الوصفية عامل التصفية |
exclude | MultiMap : يستبعد عامل التصفية البيانات الوصفية |
عائدات | |
---|---|
boolean | صحيح إذا كان يجب تشغيل الوحدة ، خطأ في خلاف ذلك. |
getAbis
publicgetAbis (ITestDevice device)
الحصول على مجموعة ABIs التي يدعمها اختبار التوافق AbiUtils.getAbisSupportedByCompatibility()
والجهاز قيد الاختبار.
حدود | |
---|---|
device | ITestDevice |
عائدات | |
---|---|
مجموعة ABIs لتشغيل الاختبارات عليها |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
تُرجع abis المحتمل من TestSuiteInfo.
عائدات | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
قد يتطلب تنفيذ ITestSuite
معلومات البناء لتحميل الاختبارات.
عائدات | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
إرجاع IConfiguration
الاستدعاء.
عائدات | |
---|---|
IConfiguration |
getDevice
public ITestDevice getDevice ()
احصل على الجهاز قيد الاختبار.
عائدات | |
---|---|
ITestDevice | ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
تُرجع ModuleDefinition
ليتم تنفيذه مباشرةً ، أو يُعيد تعريفه فارغًا إذا لم يتم تجزئته بعد (عندما لم يتم تجزئة ITestSuite بعد).
عائدات | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
إرجاع سياق الاستدعاء.
عائدات | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
عائدات | |
---|---|
MultiMap <String, String> |
getRequestedAbi
public final String getRequestedAbi ()
لعرض abi المطلوب بالخيار -a أو --abi.
عائدات | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
تُرجع قائمة الرموز المطلوبة بواسطة الاختبار. يعود فارغًا إذا لم يكن هناك دعم رمزي.
حدود | |
---|---|
testInfo | TestInformation |
عائدات | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية. يتم استخدام الوقت لتحميل تنفيذ الرصيد المقسم
عائدات | |
---|---|
long |
getTestsDir
public File getTestsDir ()
عائدات | |
---|---|
File |
هو تقسيم
public boolean isSplitting ()
يعود صحيحًا إذا كنا حاليًا في IShardableTest.split(int)
.
عائدات | |
---|---|
boolean |
الاختبارات
public abstractloadTests ()
طريقة Abstract لتحميل تكوين الاختبارات التي سيتم تشغيلها. يتم تحديد كل اختبار من خلال IConfiguration
رمز واسم فريد سيتم بموجبه تقرير النتائج.
عائدات | |
---|---|
تقرير غير مُنفَّذ
public void reportNotExecuted (ITestInvocationListener listener, String message)
قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم. يجب الإبلاغ عنها على أنها فاشلة برسالة NOT_EXECUTED_FAILURE
.
حدود | |
---|---|
listener | ITestInvocationListener : المستمع الرئيسي حيث يتم الإبلاغ عن النتائج غير المنفذة. |
message | String : الرسالة المراد إقرانها بالفشل الذي لم يتم تنفيذه. |
تقرير غير مُنفَّذ
public void reportNotExecuted (ITestInvocationListener listener)
قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم. يجب الإبلاغ عنها على أنها فاشلة برسالة NOT_EXECUTED_FAILURE
.
حدود | |
---|---|
listener | ITestInvocationListener : المستمع الرئيسي حيث يتم الإبلاغ عن النتائج غير المنفذة. |
يجري
public final void run (TestInformation testInfo, ITestInvocationListener listener)
طريقة التشغيل العامة لجميع الاختبارات التي تم تحميلها من loadTests()
.
حدود | |
---|---|
testInfo | TestInformation : يحتوي كائن TestInformation على معلومات مفيدة لتشغيل الاختبارات. |
listener | ITestInvocationListener : ITestInvocationListener لنتائج الاختبار |
رميات | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
قم بتعيين قيمة mAbiName
حدود | |
---|---|
abiName | String |
setAbis
public final void setAbis (abis)
حدود | |
---|---|
abis |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
قم بتشغيل مجموعة الاختبار في وضع المجمع فقط ، وهذا يتطلب جميع الاختبارات الفرعية لتنفيذ هذه الواجهة أيضًا.
setConfiguration
public void setConfiguration (IConfiguration configuration)
يُحقن رمز IConfiguration
قيد الاستخدام.
حدود | |
---|---|
configuration | IConfiguration |
setDevice
public void setDevice (ITestDevice device)
احقن الجهاز قيد الاختبار.
حدود | |
---|---|
device | ITestDevice : جهاز ITestDevice المطلوب استخدامه |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
حدود | |
---|---|
invocationContext | IInvocationContext |
setMetricCollectors
public void setMetricCollectors (collectors)
يضبط قائمة IMetricCollector
s المحددة للتشغيل التجريبي.
حدود | |
---|---|
collectors |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
قم بتعيين قيمة mPrimaryAbiRun
حدود | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
عند إجراء التجزئة الموزعة ، لا يمكننا الحصول على تعريف ModuleDefinition الذي يشارك الاختبارات في مجموعة وإلا فلن يعمل التجزئة داخل الوحدة النمطية ، لذلك نسمح بتعطيله.
حدود | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
يضبط ISystemStatusChecker
من التكوين للاختبار.
حدود | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
يقوم بإدخال مثيل ITestLogger
حدود | |
---|---|
testLogger | ITestLogger |
ينقسم
publicsplit (Integer shardCountHint, TestInformation testInfo)
إصدار بديل من split(int)
والذي يوفر أيضًا TestInformation
الذي يحتوي على معلومات مبكرة من الوالد الذي أنشأ الأجزاء. من المفيد الوصول إلى أشياء مثل الجهاز أو معلومات الإنشاء أثناء التجزئة.
حدود | |
---|---|
shardCountHint | Integer : محاولة عدد الأجزاء. |
testInfo | TestInformation : TestInformation الأم |
عائدات | |
---|---|
مجموعة من الاختبارات الفرعية يتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا |
الطرق المحمية
createModuleListeners
protectedcreateModuleListeners ()
إرجاع قائمة ITestInvocationListener
المطبقة على مستوى ModuleListener
. ستتم إعادة استخدام هؤلاء المستمعين لكل وحدة نمطية ، ولن يتم إعادة تكوينهم لذا لا ينبغي أن يفترضوا حالة داخلية.
عائدات | |
---|---|
عامل التصفية ByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
قم بتطبيق تصفية قائمة العداء البيضاء ، وإزالة أي عداء لم يتم إدراجه في القائمة البيضاء. إذا كان للتهيئة العديد من المتسابقين ، فقد تتم إزالة بعضها وسيستمر تشغيل التكوين.
حدود | |
---|---|
config | IConfiguration : يتم تقييم IConfiguration . |
allowedRunners |
عائدات | |
---|---|
boolean | صحيح إذا تم السماح لوحدة التكوين بالعمل ، خطأ بخلاف ذلك. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
قم بإرجاع abis المدعوم من قبل البنية المستهدفة لبناء المضيف. يتعرض للاختبار.
عائدات | |
---|---|
getHostAbis
protectedgetHostAbis ()
إرجاع الجهاز المضيف abis.
عائدات | |
---|---|
setMultiDeviceStrategy
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
حدود | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
حدود | |
---|---|
module | ModuleDefinition |
عائدات | |
---|---|
boolean |