برنامج 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

الفئات الفرعية المباشرة المعروفة BaseTestSuite وTfSuiteRunner BaseTestSuite اختبار تشغيل "مجموعة اختبار التوافق" مع نظام الحزمة الجديد  TfSuiteRunner تنفيذ الدالة ITestSuite التي ستؤدي إلى تحميل الاختبارات من حافظات TF res/config/suite/ المجلد.

الفئات الفرعية المعروفة غير المباشرة AtestRunner، TestMappingSuiteRunner AtestRunner تنفيذ ITestSuite TestMappingSuiteRunner تنفيذ BaseTestSuite لإجراء الاختبارات المحددة بواسطة خيار فلتر التضمين TEST_MAPPING ملفات من الإصدار كمجموعة.

---

صف موجز يستخدم لإدارة Test Suite. يوفر هذا الصف الأساس لكيفية إدارة مجموعة Suite. ويمكن أن تحدِّد كل عملية تنفيذ قائمة الاختبارات من خلال طريقة loadTests().

ملخّص

الحقول
public static final String	ABI_OPTION
public static final String	ACTIVE_MAINLINE_PARAMETER_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() تعرض Abis المحتمل من 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() تعرض القيمة true إذا كنا في 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	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

تفعيل_إمكانية_التقييم_SYM_LINKS

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

اختبار_TYPE_KEY

public static final String TEST_TYPE_KEY

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

مفتاح_TOKEN

public static final String TOKEN_KEY

روابط mEnableChangeSymlinks

protected boolean mEnableResolveSymlinks

استعادة الجهاز من خلال Cvd

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

إعداد cleanUpSuite

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

تعرض Abis المحتمل من TestSuiteInfo.

المرتجعات

الحصول على معلومات

public IBuildInfo getBuildInfo ()

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

المرتجعات
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

تعرض الاستدعاء IConfiguration.

المرتجعات
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

المرتجعات
ITestLogger

الحصول على جهاز

public ITestDevice getDevice ()

اختبار الجهاز

المرتجعات
ITestDevice	ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

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

المرتجعات
ModuleDefinition

الحصول على تقسيم الوحدات

public boolean getIntraModuleSharding ()

المرتجعات
boolean

الحصول على InvocationContext

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

الحصول على رموز مطلوبة

public  getRequiredTokens (TestInformation testInfo)

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

المعلمات
testInfo	TestInformation

المرتجعات

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

public long getRuntimeHint ()

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

المرتجعات
long

الحصول على TestsDir

public File getTestsDir ()

المرتجعات
File

تقسيم

public boolean isSplitting ()

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

المرتجعات
boolean

اختبارات التحميل

public abstract  loadTests ()

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

المرتجعات

لم يتم تنفيذ التقرير

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

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

المعلمات
listener	ITestInvocationListener: المستمع الرئيسي الذي يتم من خلاله الإبلاغ عن النتائج التي لم يتم تنفيذها
message	String: الرسالة المطلوب ربطها بتعذُّر التنفيذ الذي لم يتم تنفيذه

لم يتم تنفيذ التقرير

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

تعيين AbiName

public void setAbiName (String abiName)

ضبط قيمة mAbiName

المعلمات
abiName	String

تعيين Abis

public final void setAbis ( abis)

المعلمات
abis

إنشاء مجموعة

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

الضبط على وحدات منفصلة للتقسيم

public void setIntraModuleSharding (boolean intraModuleSharding)

المعلمات
intraModuleSharding	boolean

تحديد السياق: setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

المعلمات
invocationContext	IInvocationContext

مجموعة مقاييسي

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

ضبط الوحدة النمطية الديناميكية

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

المعلمات
dynamicModule	boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

تضبط ISystemStatusChecker من الإعدادات الخاصة بالاختبار.

المعلمات
systemCheckers

ضبط مسجِّل الاختبار

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 للجهاز المضيف.

المرتجعات

يجب أن يتم تشغيل الوحدة

protected boolean shouldModuleRun (ModuleDefinition module)

المعلمات
module	ModuleDefinition

المرتجعات
boolean