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()
.
ملخص
فئات متداخلة | |
---|---|
enum | ITestSuite.MultiDeviceModuleStrategy
|
مجالات | |
---|---|
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_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
المنشأت العامة | |
---|---|
ITestSuite () |
الأساليب العامة | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
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) إصدار بديل من Split |
الطرق المحمية | |
---|---|
createModuleListeners () إرجاع قائمة | |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) قم بتطبيق مرشح البيانات الوصفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين. |
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_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 |
getAbis
publicgetAbis (ITestDevice device)
الحصول على مجموعة ABIs التي يدعمها اختبار التوافق AbiUtils.getAbisSupportedByCompatibility()
والجهاز قيد الاختبار.
المعلمات | |
---|---|
device | ITestDevice |
عائدات | |
---|---|
مجموعة ABIs لتشغيل الاختبارات عليها |
رميات | |
---|---|
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 المطلوب استخدامه |
setDirectModule
public void setDirectModule (ModuleDefinition module)
المعلمات | |
---|---|
module | ModuleDefinition |
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 split(int)
والذي يوفر أيضًا TestInformation
الذي يحتوي على معلومات مبكرة من الوالد الذي أنشأ الأجزاء. من المفيد الوصول إلى أشياء مثل الجهاز أو معلومات الإنشاء أثناء التجزئة.
المعلمات | |
---|---|
shardCountHint | Integer : محاولة عدد الأجزاء. |
testInfo | TestInformation : معلومات TestInformation الأم |
عائدات | |
---|---|
مجموعة من الاختبارات الفرعية يتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا |
الطرق المحمية
createModuleListeners
protectedcreateModuleListeners ()
إرجاع قائمة ITestInvocationListener
المطبقة على مستوى ModuleListener
. ستتم إعادة استخدام هؤلاء المستمعين لكل وحدة نمطية ، ولن يتم إعادة تكوينهم لذا لا ينبغي أن يفترضوا حالة داخلية.
عائدات | |
---|---|
عامل التصفيةByConfigMetadata
protected boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
قم بتطبيق مرشح البيانات الوصفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين.
المعلمات | |
---|---|
config | IConfiguration : يتم تقييم IConfiguration . |
include | MultiMap : تشمل البيانات الوصفية عامل التصفية |
exclude | MultiMap : يستبعد عامل التصفية البيانات الوصفية |
عائدات | |
---|---|
boolean | صحيح إذا كان يجب تشغيل الوحدة ، خطأ في خلاف ذلك. |
عامل التصفية 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 |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2022-11-07 UTC.