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) التي يتيحها كلّ من اختبار التوافق |
static
|
getAbisForBuildTargetArchFromSuite()
تعرض هذه السمة واجهات التطبيق الثنائية المحتملة من TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
قد يتطلّب تنفيذ |
final
IConfiguration
|
getConfiguration()
تعرض هذه السمة استدعاء الدالة |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
احصل على الجهاز الخاضع للاختبار. |
ModuleDefinition
|
getDirectModule()
تعرِض هذه السمة |
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()
تعرض هذه السمة القيمة "صحيح" إذا كنا حاليًا في |
abstract
|
loadTests()
طريقة مجرّدة لتحميل إعدادات الاختبارات التي سيتم تنفيذها. |
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
أبلِغ المستمع الرئيسي المقدَّم عن الاختبارات التي لم يتم تنفيذها. |
void
|
reportNotExecuted(ITestInvocationListener listener)
أبلِغ المستمع الرئيسي المقدَّم عن الاختبارات التي لم يتم تنفيذها. |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
طريقة تشغيل عامة لجميع الاختبارات التي تم تحميلها من |
void
|
setAbiName(String abiName)
ضبط قيمة mAbiName |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
تشغيل مجموعة الاختبار في وضع "الجامع فقط"، ويتطلّب ذلك أن تنفّذ جميع الاختبارات الفرعية هذه الواجهة أيضًا. |
void
|
setConfiguration(IConfiguration configuration)
يُدرِج |
void
|
setDevice(ITestDevice device)
أدخِل الجهاز قيد الاختبار. |
void
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
تضبط هذه السمة قائمة |
void
|
setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
|
void
|
setPrimaryAbiRun(boolean primaryAbiRun)
اضبط قيمة mPrimaryAbiRun |
void
|
setShouldMakeDynamicModule(boolean dynamicModule)
عند إجراء التقسيم الموزّع، لا يمكن أن يكون لدينا ModuleDefinition يشارك الاختبارات في مجموعة وإلا لن يعمل التقسيم داخل الوحدة، لذلك نسمح بإيقافه. |
void
|
setSkipContext(SkipContext skipContext)
|
void
|
setSystemStatusChecker(
يضبط هذا الحقل قيمة |
void
|
setTestLogger(ITestLogger testLogger)
إدخال مثيل |
|
split(Integer shardCountHint, TestInformation testInfo)
إصدار بديل من |
الطُرق المحمية | |
|---|---|
|
createModuleListeners()
تعرض هذه السمة قائمة |
boolean
|
filterByRunnerType(IConfiguration config,
تطبيق فلترة القائمة البيضاء الخاصة بـ 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"
ENABLE_RESOLVE_SYM_LINKS
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"
الحقول
mEnableResolveSymlinks
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
publicgetAbis (ITestDevice device)
تعرض هذه السمة مجموعة واجهات التطبيق الثنائية (ABI) التي يتيحها كلّ من اختبار التوافق AbiUtils.getAbisSupportedByCompatibility() والجهاز الخاضع للاختبار.
| المعلمات | |
|---|---|
device |
ITestDevice |
| المرتجعات | |
|---|---|
|
مجموعة واجهات التطبيق الثنائية (ABI) التي سيتم إجراء الاختبارات عليها |
| الرميات | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
تعرض هذه السمة واجهات ABI المحتملة من TestSuiteInfo.
| المرتجعات | |
|---|---|
|
|
getBuildInfo
public IBuildInfo getBuildInfo ()
قد يتطلّب تنفيذ ITestSuite تحميل معلومات الإصدار لتشغيل الاختبارات.
| المرتجعات | |
|---|---|
IBuildInfo |
|
getConfiguration
public final IConfiguration getConfiguration ()
تعرض هذه السمة استدعاء الدالة IConfiguration.
| المرتجعات | |
|---|---|
IConfiguration |
|
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
publicgetRequiredTokens (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 abstractloadTests ()
طريقة مجرّدة لتحميل إعدادات الاختبارات التي سيتم تنفيذها. يتم تحديد كل اختبار من خلال
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 |
|
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 |
تقسيم
publicsplit (Integer shardCountHint, TestInformation testInfo)
إصدار بديل من split(int) يوفّر أيضًا TestInformation
يحتوي على معلومات مبكرة من الأصل الذي أنشأ الأجزاء. ويكون ذلك مفيدًا إذا كان من الضروري الوصول إلى معلومات مثل معلومات الجهاز أو الإصدار أثناء التقسيم.
| المعلمات | |
|---|---|
shardCountHint |
Integer: عدد الأجزاء التي تمت محاولة إنشائها |
testInfo |
TestInformation: الفئة الرئيسية TestInformation |
| المرتجعات | |
|---|---|
|
مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا |
الطُرق المحمية
createModuleListeners
protectedcreateModuleListeners ()
تعرض هذه السمة قائمة ITestInvocationListener التي تنطبق على مستوى ModuleListener. سيتم إعادة استخدام أدوات معالجة الأحداث هذه لكل وحدة، ولن تتم إعادة إنشاء مثيل لها، لذا يجب ألا تفترض حالة داخلية.
| المرتجعات | |
|---|---|
|
|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
تطبيق فلترة القائمة البيضاء الخاصة بـ Runner، وإزالة أي Runner لم تتم إضافته إلى القائمة البيضاء إذا كان الإعداد يحتوي على عدة عمليات تشغيل، قد تتم إزالة بعضها وسيظل الإعداد يعمل.
| المعلمات | |
|---|---|
config |
IConfiguration: IConfiguration الذي يتم تقييمه. |
allowedRunners |
: القائمة البيضاء الحالية للمشغِّل. |
| المرتجعات | |
|---|---|
boolean |
"صحيح" إذا كان مسموحًا بتشغيل وحدة الإعداد، و"خطأ" في الحالات الأخرى |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع بنية هدف الإصدار على الجهاز المضيف. يتم عرضها لأغراض الاختبار.
| المرتجعات | |
|---|---|
|
|
getHostAbis
protectedgetHostAbis ()
تعرض هذه السمة واجهات التطبيق الثنائية (ABI) الخاصة بالجهاز المضيف.
| المرتجعات | |
|---|---|
|
|
setPrioritizeHostConfig
protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)
اضبط الخيار prioritize-host-config.
| المعلمات | |
|---|---|
prioritizeHostConfig |
boolean: true لتحديد أولوية إعدادات المضيف، أي تشغيل اختبار المضيف إذا كان ذلك ممكنًا. |
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
| المعلمات | |
|---|---|
module |
ModuleDefinition |
| المرتجعات | |
|---|---|
boolean |
|