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_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 REBOOT_BEFORE_TEST

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)
final void enableRebootBeforeTest ()

يضبط إعادة التشغيل قبل الاختبار على صحيح.

getAbis (ITestDevice device)

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

static getAbisForBuildTargetArchFromSuite ()

إرجاع أبيس المحتملة من TestSuiteInfo.

IBuildInfo getBuildInfo ()

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

final IConfiguration getConfiguration ()

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

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

قم بإخضاع الجهاز للاختبار.

ModuleDefinition getDirectModule ()

إرجاع ModuleDefinition ليتم تنفيذه مباشرة، أو إرجاعه فارغًا إذا لم يكن هناك أي شيء بعد (عندما لم يتم تقسيم ITestSuite بعد).

IInvocationContext getInvocationContext ()

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

final String getRequestedAbi ()

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

getRequiredTokens ()
long getRuntimeHint ()

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

File getTestsDir ()
boolean isSplitting ()

يُرجع صحيحًا إذا كنا حاليًا في IShardableTest.split(int) .

abstract loadTests ()

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

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 setInvocationContext (IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

احصل على Guice Injector الحالي من الاستدعاء.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

يقوم بتعيين قائمة IMetricCollector المحددة للتشغيل التجريبي.

void setPrimaryAbiRun (boolean primaryAbiRun)

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

void setShouldMakeDynamicModule (boolean dynamicModule)

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

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

يقوم بتعيين ISystemStatusChecker s من التكوين للاختبار.

void setTestLogger (ITestLogger testLogger)

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 ()

إرجاع أبيس الجهاز المضيف.

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

القائمة التحضيرية_البيضاء

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

البذور عشوائي

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

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

المقاولين العامة

com.ITestSuite

public ITestSuite ()

الأساليب العامة

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

حدود
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

حدود
filters MultiMap

تمكينRebootBeforeTest

public final void enableRebootBeforeTest ()

يضبط إعادة التشغيل قبل الاختبار على صحيح.

com.getAbis

public  getAbis (ITestDevice device)

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

حدود
device ITestDevice

عائدات
مجموعة واجهات ABI التي سيتم إجراء الاختبارات عليها

رميات
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

إرجاع أبيس المحتملة من TestSuiteInfo.

عائدات

getBuildInfo

public IBuildInfo getBuildInfo ()

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

عائدات
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

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

عائدات
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

عائدات
ITestLogger

com.getDevice

public ITestDevice getDevice ()

قم بإخضاع الجهاز للاختبار.

عائدات
ITestDevice جهاز ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

إرجاع ModuleDefinition ليتم تنفيذه مباشرة، أو إرجاعه فارغًا إذا لم يكن هناك أي شيء بعد (عندما لم يتم تقسيم ITestSuite بعد).

عائدات
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

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

عائدات
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

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

عائدات
String

getRequiredTokens

public  getRequiredTokens ()

عائدات

getRuntimeHint

public long getRuntimeHint ()

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

عائدات
long

getTestsDir

public File getTestsDir ()

عائدات
File

isSplitting

public boolean isSplitting ()

يُرجع صحيحًا إذا كنا حاليًا في IShardableTest.split(int) .

عائدات
boolean

LoadTests

public abstract  loadTests ()

طريقة مجردة لتحميل تكوين الاختبارات التي سيتم تشغيلها. يتم تعريف كل اختبار بواسطة 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

listener ITestInvocationListener

رميات
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

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

حدود
abiName String

com.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 للاستخدام

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

حدود
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

احصل على Guice Injector الحالي من الاستدعاء. يجب أن يسمح لنا بمواصلة حقن الوحدات النمطية.

حدود
injector Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

يقوم بتعيين قائمة IMetricCollector المحددة للتشغيل التجريبي.

حدود
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 s من التكوين للاختبار.

حدود
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

حدود
testLogger ITestLogger

ينقسم

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

حدود
shardCountHint Integer : عدد الشظايا التي تمت محاولتها.

testInfo TestInformation : TestInformation الأصلية

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

الأساليب المحمية

createModuleListeners

protected  createModuleListeners ()

إرجاع قائمة ITestInvocationListener المطبقة على مستوى ModuleListener . سيتم إعادة استخدام هؤلاء المستمعين لكل وحدة، ولن يتم إعادة إنشاء مثيل لهم لذا لا يجب أن يتخذوا حالة داخلية.

عائدات

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

قم بتطبيق مرشح البيانات التعريفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين.

حدود
config IConfiguration : يتم تقييم IConfiguration .

include MultiMap : تتضمن البيانات الوصفية عامل التصفية

exclude MultiMap : البيانات الوصفية تستبعد عامل التصفية

عائدات
boolean صحيح إذا كان يجب تشغيل الوحدة، وخطأ فيما عدا ذلك.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

حدود
config IConfiguration : يتم تقييم IConfiguration .

allowedRunners : القائمة البيضاء للعداء الحالي.

عائدات
boolean صحيح إذا تم السماح بتشغيل وحدة التكوين، وخطأ فيما عدا ذلك.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

عائدات

com.getHostAbis

protected  getHostAbis ()

إرجاع أبيس الجهاز المضيف.

عائدات

this.shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

حدود
module ModuleDefinition

عائدات
boolean