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)

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

getAbis(ITestDevice device)

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

static getAbisForBuildTargetArchFromSuite()

تعرض هذه السمة واجهات التطبيق الثنائية المحتملة من 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.

getRequiredTokens(TestInformation testInfo)

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

long getRuntimeHint()

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

File getTestsDir()
boolean isRemoveModuleBuffering()
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)
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)

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

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

اضبط قيمة mPrimaryAbiRun

void setShouldMakeDynamicModule(boolean dynamicModule)

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

void setSkipContext(SkipContext skipContext)
void setSystemStatusChecker( systemCheckers)

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

void setTestLogger(ITestLogger testLogger)

إدخال مثيل ITestLogger

split(Integer shardCountHint, TestInformation testInfo)

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

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

createModuleListeners()

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

boolean filterByRunnerType(IConfiguration config, allowedRunners)

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

getAbisForBuildTargetArch()

عرض abis المتوافقة مع بنية هدف الإصدار للمضيف

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

Constant 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  getAbis (ITestDevice device)

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

المعلمات
device ITestDevice

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

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

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

تعرض هذه السمة واجهات ABI المحتملة من 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

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  getRequiredTokens (TestInformation testInfo)

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

المعلمات
testInfo TestInformation

المرتجعات

getRuntimeHint

public long getRuntimeHint ()

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

المرتجعات
long

getTestsDir

public File getTestsDir ()

المرتجعات
File

isRemoveModuleBuffering

public boolean isRemoveModuleBuffering ()

المرتجعات
boolean

isSplitting

public boolean isSplitting ()

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

المرتجعات
boolean

loadTests

public abstract  loadTests ()

طريقة مجرّدة لتحميل إعدادات الاختبارات التي سيتم تنفيذها. يتم تحديد كل اختبار من خلال 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 ( 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)

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

المعلمات
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

setSkipContext

public void setSkipContext (SkipContext skipContext)

المعلمات
skipContext SkipContext

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. سيتم إعادة استخدام أدوات معالجة الأحداث هذه لكل وحدة، ولن تتم إعادة إنشاء مثيل لها، لذا يجب ألا تفترض حالة داخلية.

المرتجعات

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

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

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

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

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

المرتجعات

getHostAbis

protected  getHostAbis ()

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

المرتجعات

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

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

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

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

المعلمات
module ModuleDefinition

المرتجعات
boolean