برنامج ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest, IDeviceTest, IBuildReceiver, ISystemStatusCheckerReceiver, IShardableTest, ITestCollector, IInvocationContextReceiver, IRuntimeHintProvider, IMetricCollectorReceiver, IConfigurationReceiver, IReportNotExecuted, ITokenRequest, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.testtype.suite.ITestSuite

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

الفئات الفرعية المعروفة غير المباشرة 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	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

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>

استراتيجية الحصول على متعدد الأجهزة

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 المطلوب استخدامها

تعيين وحدة التحكم المباشر

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

تعيين ShouldMake DynamicModule

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