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

ملخّص

الحقول

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String ENABLE_RESOLVE_SYM_LINKS

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 STAGE_MODULE_ARTIFACTS

public static final String TEST_TYPE_KEY

public static final String TEST_TYPE_VALUE_PERFORMANCE

public static final 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 المطلوب تنفيذه مباشرةً، أو قيمة فارغة إذا لم يكن هناك أي اختبار بعد (عندما لم يتم تقسيم ملف IDETestSuite بعد).

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

تُستخدَم لضبط قائمة IMetricCollector المحدّدة لتشغيل الاختبار.

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)

طبِّق فلترة القائمة البيضاء الخاصة بالركض، مع إزالة أيّ عداء لم يتم إدراجه في القائمة البيضاء.

getAbisForBuildTargetArch()

عرض واجهات برمجة التطبيقات المتوافقة مع بنية هدف إنشاء المضيف

getHostAbis()

عرض الجهاز المضيف abis

void setPrioritizeHostConfig(boolean prioritizeHostConfig)

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

boolean shouldModuleRun(ModuleDefinition module)

الحقول

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY
 

public static final String ENABLE_RESOLVE_SYM_LINKS

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

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RANDOM_SEED

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

STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

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
 

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

المرتجعات
مجموعة واجهات برمجة التطبيقات لتشغيل الاختبارات عليها
عمليات الرمي
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

getDevice

public ITestDevice getDevice ()

احصل على الجهاز الذي يتم اختباره.

المرتجعات
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

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

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

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)

تُستخدَم لضبط قائمة 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

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)

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

المعلمات
config IConfiguration: IConfiguration التي يتم تقييمها
allowedRunners : القائمة البيضاء الحالية للمشغّلين
المرتجعات
boolean صحيح إذا كان يُسمح بتشغيل وحدة الضبط، وخطأ في الحالات الأخرى.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

المرتجعات

getHostAbis

protected  getHostAbis ()

عرض الجهاز المضيف abis

المرتجعات

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

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

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

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

المعلمات
module ModuleDefinition

المرتجعات
boolean