ITestSuite

public abstract class ITestSuite
extends Object implements IBuildReceiver, IConfigurationReceiver, IDeviceTest, IInvocationContextReceiver, IMetricCollectorReceiver, IRemoteTest, IReportNotExecuted, IRuntimeHintProvider, IShardableTest, ISystemStatusCheckerReceiver, ITestCollector, ITestLoggerReceiver, ITokenRequest

java.lang.Object
   ↳ com.android.tradefed.testtype.suite.ITestSuite


فئة مجرّدة تُستخدَم لتشغيل "مجموعة الاختبارات". يوفر هذا الصف أساس طريقة تشغيل "الحزمة". يمكن لكل عملية تنفيذ تحديد قائمة الاختبارات من خلال طريقة loadTests().

ملخّص

الثوابت

String ABI_OPTION

String ACTIVE_MAINLINE_PARAMETER_KEY

String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

String ENABLE_RESOLVE_SYM_LINKS

String MAINLINE_PARAMETER_KEY

String MODULE_CHECKER_POST

String MODULE_CHECKER_PRE

String MODULE_END_TIME

String MODULE_METADATA_EXCLUDE_FILTER

String MODULE_METADATA_INCLUDE_FILTER

String MODULE_START_TIME

String PARAMETER_KEY

String PREPARER_WHITELIST

String PRIMARY_ABI_RUN

String RANDOM_SEED

String RUNNER_WHITELIST

String SKIP_HOST_ARCH_CHECK

String SKIP_STAGING_ARTIFACTS

String SKIP_SYSTEM_STATUS_CHECKER

String STAGE_MODULE_ARTIFACTS

String TEST_TYPE_KEY

String TEST_TYPE_VALUE_PERFORMANCE

String TOKEN_KEY

الحقول

protected boolean mEnableResolveSymlinks

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)

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

Set<IAbi> getAbis(ITestDevice device)

تعرض هذه السمة مجموعة واجهات التطبيق الثنائية (ABI) التي يتيحها كلّ من AbiUtils.getAbisSupportedByCompatibility() اختبار التوافق والجهاز الذي يتم اختباره.

static Set<String> getAbisForBuildTargetArchFromSuite()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المحتملة من TestSuiteInfo.

IBuildInfo getBuildInfo()

قد يتطلّب تنفيذ ITestSuite تحميل معلومات الإصدار لتشغيل الاختبارات.

final IConfiguration getConfiguration()

تعرض هذه السمة IConfiguration الخاصة بعملية الاستدعاء.

ITestLogger getCurrentTestLogger()
ITestDevice getDevice()

احصل على الجهاز الخاضع للاختبار.

ModuleDefinition getDirectModule()

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

boolean getIntraModuleSharding()
IInvocationContext getInvocationContext()

تعرِض هذه السمة سياق الاستدعاء.

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

تعرض هذه السمة واجهة التطبيق الثنائية (ABI) المطلوبة باستخدام الخيار -a أو --abi.

Set<TokenProperty> getRequiredTokens(TestInformation testInfo)

تعرض هذه السمة قائمة بالرموز المميزة المطلوبة للاختبار.

long getRuntimeHint()

عرض وقت التشغيل المتوقّع للاختبار بالملّي ثانية

File getTestsDir()
boolean isRemoveModuleBuffering()
boolean isSplitting()

تعرض هذه السمة القيمة "صحيح" إذا كنا حاليًا في IShardableTest.split(int).

abstract LinkedHashMap<String, IConfiguration> 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(Set<IAbi> abis)
void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setConfiguration(IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

void setDevice(ITestDevice device)

أدخِل الجهاز الخاضع للاختبار.

void setDirectModule(ModuleDefinition module)
void setInLocalRetry(boolean inLocalRetry)
void setIntraModuleSharding(boolean intraModuleSharding)
void setInvocationContext(IInvocationContext invocationContext)

void setMetricCollectors(List<IMetricCollector> collectors)

تضبط هذه السمة قائمة IMetricCollector المحدّدة للتشغيل التجريبي.

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

اضبط قيمة mPrimaryAbiRun

void setShouldMakeDynamicModule(boolean dynamicModule)

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

void setSkipContext(SkipContext skipContext)
void setSystemStatusChecker(List<ISystemStatusChecker> systemCheckers)

يضبط هذا الحقل قيمة ISystemStatusChecker من إعدادات الاختبار.

void setTestLogger(ITestLogger testLogger)

إدخال مثيل ITestLogger

Collection<IRemoteTest> split(Integer shardCountHint, TestInformation testInfo)

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

طُرق محمية

List<ITestInvocationListener> createModuleListeners()

تعرِض هذه السمة قائمة ITestInvocationListener التي تنطبق على مستوى ModuleListener.

boolean filterByRunnerType(IConfiguration config, Set<String> allowedRunners)

طبِّق فلترة القائمة البيضاء الخاصة بـ Runner، وأزِل أي Runner لم تتم إضافته إلى القائمة البيضاء.

Set<String> getAbisForBuildTargetArch()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع بنية هدف إنشاء المضيف.

Set<String> getHostAbis()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) للجهاز المضيف.

void setPrioritizeHostConfig(boolean prioritizeHostConfig)

اضبط الخيار prioritize-host-config.

boolean shouldModuleRun(ModuleDefinition module)

الثوابت

ABI_OPTION

public static final String ABI_OPTION

Constant Value: "abi"

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

القيمة الثابتة: "active-mainline-parameter"

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

Constant Value: "flag-overrides"

public static final String ENABLE_RESOLVE_SYM_LINKS

القيمة الثابتة: "enable-resolve-sym-links"

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

القيمة الثابتة: "mainline-param"

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

Constant Value: "PostModuleChecker"

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

القيمة الثابتة: "PreModuleChecker"

MODULE_END_TIME

public static final String MODULE_END_TIME

Constant Value: "MODULE_END_TIME"

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

Constant Value: "module-metadata-exclude-filter"

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

Constant Value: "module-metadata-include-filter"

MODULE_START_TIME

public static final String MODULE_START_TIME

Constant Value: "MODULE_START_TIME"

PARAMETER_KEY

public static final String PARAMETER_KEY

القيمة الثابتة: "parameter"

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

Constant Value: "preparer-whitelist"

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

Constant Value: "primary-abi-only"

RANDOM_SEED

public static final String RANDOM_SEED

Constant Value: "random-seed"

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

Constant Value: "runner-whitelist"

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

Constant Value: "skip-host-arch-check"

SKIP_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

Constant Value: "skip-staging-artifacts"

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

القيمة الثابتة: "skip-system-status-check"

STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

القيمة الثابتة: "stage-module-artifacts"

TEST_TYPE_KEY

public static final String TEST_TYPE_KEY

القيمة الثابتة: "test-type"

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

القيمة الثابتة: "الأداء"

TOKEN_KEY

public static final String TOKEN_KEY

القيمة الثابتة: "token"

الحقول

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

طُرق وضع التصميم العامة

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 "صحيح" إذا كان يجب تشغيل الوحدة، و"خطأ" في الحالات الأخرى

getAbis

public Set<IAbi> getAbis (ITestDevice device)

تعرض هذه السمة مجموعة واجهات التطبيق الثنائية (ABI) التي يتيحها كلّ من AbiUtils.getAbisSupportedByCompatibility() اختبار التوافق والجهاز الذي يتم اختباره.

المعلَمات
device ITestDevice

المرتجعات
Set<IAbi> مجموعة واجهات التطبيق الثنائية (ABI) التي سيتم إجراء الاختبارات عليها

عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static Set<String> getAbisForBuildTargetArchFromSuite ()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المحتملة من TestSuiteInfo.

المرتجعات
Set<String>

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

getIntraModuleSharding

public boolean getIntraModuleSharding ()

المرتجعات
boolean

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

تعرض هذه السمة واجهة التطبيق الثنائية (ABI) المطلوبة باستخدام الخيار -a أو --abi.

المرتجعات
String

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

تعرض هذه السمة قائمة بالرموز المميزة المطلوبة للاختبار. تعرِض قيمة فارغة إذا لم يكن الرمز المميّز متاحًا.

المعلَمات
testInfo TestInformation

المرتجعات
Set<TokenProperty>

getRuntimeHint

public long getRuntimeHint ()

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

المرتجعات
long

getTestsDir

public File getTestsDir ()

المرتجعات
File

عمليات الطرح
FileNotFoundException

isRemoveModuleBuffering

public boolean isRemoveModuleBuffering ()

المرتجعات
boolean

isSplitting

public boolean isSplitting ()

تعرض هذه السمة القيمة "صحيح" إذا كنا حاليًا في IShardableTest.split(int).

المرتجعات
boolean

loadTests

public abstract LinkedHashMap<String, IConfiguration> loadTests ()

طريقة مجرّدة لتحميل إعدادات الاختبار التي سيتم تنفيذها. يتم تحديد كل اختبار من خلال IConfiguration واسم فريد يتم بموجبه تسجيل النتائج.

المرتجعات
LinkedHashMap<String, IConfiguration>

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

أبلِغ المستمع الرئيسي المقدَّم عن الاختبارات التي لم يتم تنفيذها. يجب الإبلاغ عنها على أنّها تعذّر نقلها مع الرسالة NOT_EXECUTED_FAILURE.

المعلَمات
listener ITestInvocationListener: المستمع الرئيسي الذي سيتم إبلاغه بالنتائج غير المنفَّذة.

message String: الرسالة التي سيتم ربطها بخطأ عدم التنفيذ.

reportNotExecuted

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 (Set<IAbi> abis)

المعلَمات
abis Set

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

setInLocalRetry

public void setInLocalRetry (boolean inLocalRetry)

المعلَمات
inLocalRetry boolean

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

المعلَمات
intraModuleSharding boolean

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

المعلَمات
invocationContext IInvocationContext

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

تضبط هذه السمة قائمة IMetricCollector المحدّدة للتشغيل التجريبي.

المعلَمات
collectors List

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

setSkipContext

public void setSkipContext (SkipContext skipContext)

المعلَمات
skipContext SkipContext

setSystemStatusChecker

public void setSystemStatusChecker (List<ISystemStatusChecker> systemCheckers)

يضبط هذا الحقل قيمة ISystemStatusChecker من إعدادات الاختبار.

المعلَمات
systemCheckers List

setTestLogger

public void setTestLogger (ITestLogger testLogger)

إدخال مثيل ITestLogger

المعلَمات
testLogger ITestLogger

تقسيم

public Collection<IRemoteTest> split (Integer shardCountHint, 
                TestInformation testInfo)

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

المعلَمات
shardCountHint Integer: عدد الأجزاء التي تمت محاولة إنشائها.

testInfo TestInformation: الفئة الرئيسية TestInformation

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

طُرق محمية

createModuleListeners

protected List<ITestInvocationListener> createModuleListeners ()

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

المرتجعات
List<ITestInvocationListener>

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                Set<String> allowedRunners)

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

المعلَمات
config IConfiguration: IConfiguration الذي يتم تقييمه

allowedRunners Set: القائمة البيضاء الحالية للمشغِّل.

المرتجعات
boolean تكون القيمة "صحيح" إذا كان مسموحًا بتشغيل وحدة الإعداد، و"خطأ" في الحالات الأخرى.

getAbisForBuildTargetArch

protected Set<String> getAbisForBuildTargetArch ()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع بنية هدف إنشاء المضيف. يتم عرضها للاختبار.

المرتجعات
Set<String>

getHostAbis

protected Set<String> getHostAbis ()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) للجهاز المضيف.

المرتجعات
Set<String>

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

اضبط الخيار prioritize-host-config.

المعلَمات
prioritizeHostConfig boolean: true لتحديد أولوية إعدادات المضيف، أي تشغيل اختبار المضيف إذا كان ذلك ممكنًا.

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

المعلَمات
module ModuleDefinition

المرتجعات
boolean