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_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 التي يدعمها اختبار التوافق AbiUtils.getAbisSupportedByCompatibility() والجهاز قيد الاختبار.

static getAbisForBuildTargetArchFromSuite ()

تُرجع abis المحتمل من TestSuiteInfo.

IBuildInfo getBuildInfo ()

قد يتطلب تنفيذ ITestSuite معلومات البناء لتحميل الاختبارات.

final IConfiguration getConfiguration ()

إرجاع IConfiguration الاستدعاء.

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

احصل على الجهاز قيد الاختبار.

ModuleDefinition getDirectModule ()

تُرجع ModuleDefinition ليتم تنفيذه مباشرةً ، أو يُعيد تعريفه فارغًا إذا لم يتم تجزئته بعد (عندما لم يتم تجزئة ITestSuite بعد).

IInvocationContext getInvocationContext ()

إرجاع سياق الاستدعاء.

MultiMap <String, String> getModuleMetadataIncludeFilters ()
final String getRequestedAbi ()

لعرض abi المطلوب بالخيار -a أو --abi.

getRequiredTokens ( TestInformation testInfo)

تُرجع قائمة الرموز المطلوبة بواسطة الاختبار.

long getRuntimeHint ()

قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية.

File getTestsDir ()
boolean isSplitting ()

يعود صحيحًا إذا كنا حاليًا في IShardableTest.split(int) .

abstract loadTests ()

طريقة Abstract لتحميل تكوين الاختبارات التي سيتم تشغيلها.

void reportNotExecuted ( ITestInvocationListener listener, String message)

قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم.

void reportNotExecuted ( ITestInvocationListener listener)

قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم.

final void run ( TestInformation testInfo, ITestInvocationListener listener)

طريقة التشغيل العامة لجميع الاختبارات التي تم تحميلها من loadTests() .

void setAbiName (String abiName)

قم بتعيين قيمة mAbiName

final void setAbis ( abis) setAbis ( abis)
void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

قم بتشغيل مجموعة الاختبار في وضع المجمع فقط ، وهذا يتطلب جميع الاختبارات الفرعية لتنفيذ هذه الواجهة أيضًا.

void setConfiguration ( IConfiguration configuration)

يُحقن رمز IConfiguration قيد الاستخدام.

void setDevice ( ITestDevice device)

احقن الجهاز قيد الاختبار.

void setDirectModule ( ModuleDefinition module)
void setInvocationContext ( IInvocationContext invocationContext)

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

يضبط قائمة IMetricCollector s المحددة للتشغيل التجريبي.

void setPrimaryAbiRun (boolean primaryAbiRun)

قم بتعيين قيمة mPrimaryAbiRun

void setShouldMakeDynamicModule (boolean dynamicModule)

عند إجراء التجزئة الموزعة ، لا يمكننا الحصول على تعريف ModuleDefinition الذي يشارك الاختبارات في مجموعة وإلا فلن يعمل التجزئة داخل الوحدة النمطية ، لذلك نسمح بتعطيله.

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

يضبط ISystemStatusChecker من التكوين للاختبار.

void setTestLogger ( ITestLogger testLogger)

يقوم بإدخال مثيل ITestLogger

split (Integer shardCountHint, TestInformation testInfo)

إصدار بديل من split(int) والذي يوفر أيضًا TestInformation الذي يحتوي على معلومات مبكرة من الوالد الذي أنشأ الأجزاء.

الطرق المحمية

createModuleListeners ()

إرجاع قائمة ITestInvocationListener المطبقة على مستوى ModuleListener .

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

public  getAbis (ITestDevice device)

الحصول على مجموعة ABIs التي يدعمها اختبار التوافق AbiUtils.getAbisSupportedByCompatibility() والجهاز قيد الاختبار.

حدود
device ITestDevice

عائدات
مجموعة ABIs لتشغيل الاختبارات عليها

رميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

تُرجع abis المحتمل من TestSuiteInfo.

عائدات

getBuildInfo

public IBuildInfo getBuildInfo ()

قد يتطلب تنفيذ ITestSuite معلومات البناء لتحميل الاختبارات.

عائدات
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

إرجاع IConfiguration الاستدعاء.

عائدات
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

عائدات
ITestLogger

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

public  getRequiredTokens (TestInformation testInfo)

تُرجع قائمة الرموز المطلوبة بواسطة الاختبار. يعود فارغًا إذا لم يكن هناك دعم رمزي.

حدود
testInfo TestInformation

عائدات

getRuntimeHint

public long getRuntimeHint ()

قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية. يتم استخدام الوقت لتحميل تنفيذ الرصيد المقسم

عائدات
long

getTestsDir

public File getTestsDir ()

عائدات
File

هو تقسيم

public boolean isSplitting ()

يعود صحيحًا إذا كنا حاليًا في IShardableTest.split(int) .

عائدات
boolean

الاختبارات

public abstract  loadTests ()

طريقة 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

setBuild

public void setBuild (IBuildInfo buildInfo)

حدود
buildInfo IBuildInfo

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

ينقسم

public  split (Integer shardCountHint, 
                TestInformation testInfo)

إصدار بديل من split(int) والذي يوفر أيضًا TestInformation الذي يحتوي على معلومات مبكرة من الوالد الذي أنشأ الأجزاء. من المفيد الوصول إلى أشياء مثل الجهاز أو معلومات الإنشاء أثناء التجزئة.

حدود
shardCountHint Integer : محاولة عدد الأجزاء.

testInfo TestInformation : TestInformation الأم

عائدات
مجموعة من الاختبارات الفرعية يتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا

الطرق المحمية

createModuleListeners

protected  createModuleListeners ()

إرجاع قائمة 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

protected  getAbisForBuildTargetArch ()

قم بإرجاع abis المدعوم من قبل البنية المستهدفة لبناء المضيف. يتعرض للاختبار.

عائدات

getHostAbis

protected  getHostAbis ()

إرجاع الجهاز المضيف abis.

عائدات

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

حدود
strategy ITestSuite.MultiDeviceModuleStrategy

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

حدود
module ModuleDefinition

عائدات
boolean