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

static getAbisForBuildTargetArchFromSuite ()

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

IBuildInfo getBuildInfo ()

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

final IConfiguration getConfiguration ()

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

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

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

ModuleDefinition getDirectModule ()

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

IInvocationContext getInvocationContext ()

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

MultiMap <String, String> getModuleMetadataIncludeFilters ()
ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
final String getRequestedAbi ()

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

getRequiredTokens ( TestInformation testInfo)

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

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 setDirectModule ( ModuleDefinition module)
void setIntraModuleSharding (boolean intraModuleSharding)
void setInvocationContext ( IInvocationContext invocationContext)

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

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

void setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
void setPrimaryAbiRun (boolean primaryAbiRun)

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

void setShouldMakeDynamicModule (boolean dynamicModule)

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

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

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

void setTestLogger ( ITestLogger testLogger)

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

split (Integer shardCountHint, TestInformation testInfo)

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

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

createModuleListeners ()

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

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

public  getAbis (ITestDevice device)

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

حدود
device ITestDevice

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

رميات
com.android.tradefed.device.DeviceNotAvailableException
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

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

public  getRequiredTokens (TestInformation testInfo)

إرجاع قائمة الرموز المطلوبة بواسطة الاختبار. يُرجع قيمة فارغة في حالة عدم وجود دعم رمزي.

حدود
testInfo TestInformation

عائدات

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 : كائن TestInformation الذي يحتوي على معلومات مفيدة لإجراء الاختبارات.

listener ITestInvocationListener : 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 للاستخدام

setDirectModule

public void setDirectModule (ModuleDefinition module)

حدود
module ModuleDefinition

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

ينقسم

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

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

testInfo TestInformation : TestInformation الأصلية

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

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

createModuleListeners

protected  createModuleListeners ()

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

عائدات

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