com.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. توفر هذه الفئة الأساس لكيفية تشغيل 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_END_TIME |
public static final String | MODULE_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
public static final String | MODULE_START_TIME |
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 | TEST_TYPE_KEY |
public static final String | TEST_TYPE_VALUE_PERFORMANCE |
public static final String | TOKEN_KEY |
protected boolean | mRecoverDeviceByCvd
|
المقاولين العامة | |
---|---|
ITestSuite () |
الأساليب العامة | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
void | cleanUpSuiteSetup () فرصة لتنظيف جميع الأشياء المطلوبة أثناء إعداد الأجنحة ولكنها غير مطلوبة لإجراء الاختبارات. |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) قم بتطبيق مرشح البيانات التعريفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين. |
getAbis ( ITestDevice device) الحصول على مجموعة واجهات برمجة التطبيقات (ABIs) التي يدعمها كل من اختبار التوافق | |
static | getAbisForBuildTargetArchFromSuite () إرجاع أبيس المحتملة من TestSuiteInfo. |
IBuildInfo | getBuildInfo () قد يتطلب تنفيذ |
final IConfiguration | getConfiguration () إرجاع استدعاء |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () قم بإخضاع الجهاز للاختبار. |
ModuleDefinition | getDirectModule () إرجاع |
IInvocationContext | getInvocationContext () إرجاع سياق الاستدعاء. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
ITestSuite.MultiDeviceModuleStrategy | getMultiDeviceStrategy () |
final String | getRequestedAbi () إرجاع أبي المطلوب مع الخيار -a أو --abi. |
getRequiredTokens ( TestInformation testInfo) إرجاع قائمة الرموز المطلوبة بواسطة الاختبار. | |
long | getRuntimeHint () قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية. |
File | getTestsDir () |
boolean | isSplitting () يُرجع صحيحًا إذا كنا حاليًا في |
abstract | loadTests () طريقة مجردة لتحميل تكوين الاختبارات التي سيتم تشغيلها. |
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 | setIntraModuleSharding (boolean intraModuleSharding) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) يقوم بتعيين قائمة |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
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 () إرجاع أبيس الجهاز المضيف. | |
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_END_TIME
public static final String MODULE_END_TIME
MODULE_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
MODULE_START_TIME
public static final String MODULE_START_TIME
PARAMETER_KEY
public static final String PARAMETER_KEY
القائمة التحضيرية_البيضاء
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
TEST_TYPE_KEY
public static final String TEST_TYPE_KEY
TEST_TYPE_VALUE_PERFORMANCE
public static final String TEST_TYPE_VALUE_PERFORMANCE
TOKEN_KEY
public static final String TOKEN_KEY
mRecoverDeviceByCvd
protected boolean mRecoverDeviceByCvd
المقاولين العامة
com.ITestSuite
public ITestSuite ()
الأساليب العامة
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
حدود | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
حدود | |
---|---|
filters | MultiMap |
CleanUpSuiteSetup
public void cleanUpSuiteSetup ()
فرصة لتنظيف جميع الأشياء المطلوبة أثناء إعداد الأجنحة ولكنها غير مطلوبة لإجراء الاختبارات.
filterByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
قم بتطبيق مرشح البيانات التعريفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين.
حدود | |
---|---|
config | IConfiguration : يتم تقييم IConfiguration . |
include | MultiMap : تتضمن البيانات الوصفية عامل التصفية |
exclude | MultiMap : البيانات الوصفية تستبعد عامل التصفية |
عائدات | |
---|---|
boolean | صحيح إذا كان يجب تشغيل الوحدة، وخطأ فيما عدا ذلك. |
com.getAbis
publicgetAbis (ITestDevice device)
الحصول على مجموعة واجهات برمجة التطبيقات (ABIs) التي يدعمها كل من اختبار التوافق AbiUtils.getAbisSupportedByCompatibility()
والجهاز قيد الاختبار.
حدود | |
---|---|
device | ITestDevice |
عائدات | |
---|---|
مجموعة واجهات ABI التي سيتم إجراء الاختبارات عليها |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
إرجاع أبيس المحتملة من TestSuiteInfo.
عائدات | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
قد يتطلب تنفيذ ITestSuite
معلومات البناء لتحميل الاختبارات.
عائدات | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
إرجاع استدعاء IConfiguration
.
عائدات | |
---|---|
IConfiguration |
com.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> |
getMultiDeviceStrategy
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
عائدات | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
getRequestedAbi
public final String getRequestedAbi ()
إرجاع أبي المطلوب مع الخيار -a أو --abi.
عائدات | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
إرجاع قائمة الرموز المطلوبة بواسطة الاختبار. يُرجع قيمة فارغة في حالة عدم وجود دعم رمزي.
حدود | |
---|---|
testInfo | TestInformation |
عائدات | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية. يتم استخدام الوقت لتحميل التنفيذ المجزأ
عائدات | |
---|---|
long |
getTestsDir
public File getTestsDir ()
عائدات | |
---|---|
File |
isSplitting
public boolean isSplitting ()
يُرجع صحيحًا إذا كنا حاليًا في IShardableTest.split(int)
.
عائدات | |
---|---|
boolean |
LoadTests
public abstractloadTests ()
طريقة مجردة لتحميل تكوين الاختبارات التي سيتم تشغيلها. يتم تعريف كل اختبار بواسطة 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 |
com.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 للاستخدام |
setIntraModuleSharding
public void setIntraModuleSharding (boolean intraModuleSharding)
حدود | |
---|---|
intraModuleSharding | boolean |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
حدود | |
---|---|
invocationContext | IInvocationContext |
setMetricCollectors
public void setMetricCollectors (collectors)
يقوم بتعيين قائمة IMetricCollector
المحددة للتشغيل التجريبي.
حدود | |
---|---|
collectors |
setMultiDeviceStrategy
public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
حدود | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
قم بتعيين قيمة mPrimaryAbiRun
حدود | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
عند القيام بالتقسيم الموزع، لا يمكن أن يكون لدينا ModuleDefinition الذي يشارك الاختبارات في التجمع وإلا فلن يعمل التقسيم داخل الوحدة، لذلك نسمح بتعطيله.
حدود | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
يقوم بتعيين ISystemStatusChecker
s من التكوين للاختبار.
حدود | |
---|---|
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
. سيتم إعادة استخدام هؤلاء المستمعين لكل وحدة، ولن يتم إعادة إنشاء مثيل لهم لذا لا يجب أن يتخذوا حالة داخلية.
عائدات | |
---|---|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
قم بتطبيق تصفية القائمة البيضاء للعداء، وإزالة أي عداء لم يتم إدراجه في القائمة البيضاء. إذا كان التكوين يحتوي على عدة برامج تشغيل، فقد تتم إزالة بعضها وسيظل التكوين قيد التشغيل.
حدود | |
---|---|
config | IConfiguration : يتم تقييم IConfiguration . |
allowedRunners |
عائدات | |
---|---|
boolean | صحيح إذا تم السماح بتشغيل وحدة التكوين، وخطأ فيما عدا ذلك. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
قم بإرجاع abis المدعوم من البنية المستهدفة لبناء المضيف. تعرض للاختبار.
عائدات | |
---|---|
com.getHostAbis
protectedgetHostAbis ()
إرجاع أبيس الجهاز المضيف.
عائدات | |
---|---|
this.shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
حدود | |
---|---|
module | ModuleDefinition |
عائدات | |
---|---|
boolean |