برنامج 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 ليتم تنفيذه مباشرةً، أو لا يعرضه إذا لم يتم تنفيذه بعد (في حال عدم تجزئة 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 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)

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

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

عرض Abis الذي تدعمه بنية هدف إصدار المضيف.

getHostAbis()

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

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

قائمة التحضير المسبق

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

الطرق العامة

addModuleMetadataاستبعادFilters

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 ليتم تنفيذه مباشرةً، أو لا يعرضه إذا لم يتم تنفيذه بعد (في حال عدم تجزئة ITestSuite بعد).

المرتجعات
ModuleDefinition

getIntraModuleSharding

public boolean getIntraModuleSharding ()

المرتجعات
boolean

getInvocationContext

public IInvocationContext getInvocationContext ()

تعرض سياق الاستدعاء.

المرتجعات
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

المرتجعات
MultiMap<String, String>

استراتيجية الحصول على MultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

المرتجعات
ITestSuite.MultiDeviceModuleStrategy

cannot translate

public final String getRequestedAbi ()

عرض معلومات abi المطلوبة باستخدام الخيار -a أو --abi

المرتجعات
String

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

لعرض قائمة الرموز المميّزة المطلوبة من خلال الاختبار. تعرِض قيمة فارغة في حال عدم توفّر رمز مميّز.

المعلمات
testInfo TestInformation

المرتجعات

الحصول على تلميح وقت التشغيل

public long getRuntimeHint ()

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

المرتجعات
long

الحصول على TestsDir

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: الرسالة التي سيتم ربطها بالخطأ الذي لم يتم تنفيذه.

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)

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

ضبط الإعدادات

public void setConfiguration (IConfiguration configuration)

تحقِّق من استخدام IConfiguration.

المعلمات
configuration IConfiguration

ضبط الجهاز

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

ضبطالسياق

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 إذا كان الاختبار غير قابل للتقسيم حاليًا

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

إنشاء وحدة إعلانية على شكل وحدة

protected  createModuleListeners ()

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

المرتجعات

نوع الفلتر

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

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

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

عرض Abis الذي تدعمه بنية هدف إصدار المضيف. تمّ عرضها للاختبار.

المرتجعات

getHostAbis

protected  getHostAbis ()

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

المرتجعات

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

المعلمات
module ModuleDefinition

المرتجعات
boolean