تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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` الذي سيحمّل الاختبارات من TF jars res / config / suite / folder.

الفئات الفرعية غير المباشرة المعروفة

AtestRunner ، TestMappingSuiteRunner

AtestRunner	تنفيذ `ITestSuite`
TestMappingSuiteRunner	تنفيذ `BaseTestSuite` لتشغيل الاختبارات المحددة بواسطة خيار include-filter ، أو ملفات TEST_MAPPING من الإنشاء ، كمجموعة.

تستخدم فئة الملخصات لتشغيل Test 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_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`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`	`TOKEN_KEY`

المنشأت العامة
`ITestSuite ()`

الأساليب العامة
`void`	`addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)`
`void`	`addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)`
`boolean`	`filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)` قم بتطبيق مرشح البيانات الوصفية على التكوين ومعرفة ما إذا كان يجب تشغيل التكوين.
	`getAbis ( ITestDevice device)` الحصول على مجموعة ABIs التي يدعمها اختبار التوافق `AbiUtils.getAbisSupportedByCompatibility()` والجهاز قيد الاختبار.
`static`	`getAbisForBuildTargetArchFromSuite ()` تُرجع abis المحتمل من TestSuiteInfo.
`IBuildInfo`	`getBuildInfo ()` قد يتطلب تنفيذ `ITestSuite` معلومات البناء لتحميل الاختبارات.
`final IConfiguration`	`getConfiguration ()` إرجاع `IConfiguration` الاستدعاء.
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` احصل على الجهاز قيد الاختبار.
`ModuleDefinition`	`getDirectModule ()` تُرجع `ModuleDefinition` ليتم تنفيذه مباشرةً ، أو يُعيد تعريفه فارغًا إذا لم يتم تجزئته بعد (عندما لم يتم تجزئة ITestSuite بعد).
`IInvocationContext`	`getInvocationContext ()` إرجاع سياق الاستدعاء.
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`final String`	`getRequestedAbi ()` لعرض abi المطلوب بالخيار -a أو --abi.
	`getRequiredTokens ( TestInformation testInfo)` تُرجع قائمة الرموز المطلوبة بواسطة الاختبار.
`long`	`getRuntimeHint ()` قم بإرجاع وقت التشغيل المتوقع للاختبار بالمللي ثانية.
`File`	`getTestsDir ()`
`boolean`	`isSplitting ()` يعود صحيحًا إذا كنا حاليًا في `IShardableTest.split(int)` .
`abstract`	`loadTests ()` طريقة Abstract لتحميل تكوين الاختبارات التي سيتم تشغيلها.
`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)` `setAbis ( abis)`
`void`	`setBuild ( IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` قم بتشغيل مجموعة الاختبار في وضع المجمع فقط ، وهذا يتطلب جميع الاختبارات الفرعية لتنفيذ هذه الواجهة أيضًا.
`void`	`setConfiguration ( IConfiguration configuration)` يُحقن رمز `IConfiguration` قيد الاستخدام.
`void`	`setDevice ( ITestDevice device)` احقن الجهاز قيد الاختبار.
`void`	`setDirectModule ( ModuleDefinition module)`
`void`	`setInvocationContext ( IInvocationContext invocationContext)`
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` يضبط قائمة `IMetricCollector` s المحددة للتشغيل التجريبي.
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` قم بتعيين قيمة mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` عند إجراء التجزئة الموزعة ، لا يمكننا الحصول على تعريف ModuleDefinition الذي يشارك الاختبارات في مجموعة وإلا فلن يعمل التجزئة داخل الوحدة النمطية ، لذلك نسمح بتعطيله.
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` يضبط `ISystemStatusChecker` من التكوين للاختبار.
`void`	`setTestLogger ( ITestLogger testLogger)` يقوم بإدخال مثيل `ITestLogger`
	`split (Integer shardCountHint, TestInformation testInfo)` إصدار بديل من `split(int)` والذي يوفر أيضًا `TestInformation` الذي يحتوي على معلومات مبكرة من الوالد الذي أنشأ الأجزاء.

الطرق المحمية
	`createModuleListeners ()` إرجاع قائمة `ITestInvocationListener` المطبقة على مستوى `ModuleListener` .
`boolean`	`filterByRunnerType ( IConfiguration config, allowedRunners)` `filterByRunnerType ( IConfiguration config, allowedRunners)` قم بتطبيق تصفية قائمة العداء البيضاء ، وإزالة أي عداء لم يتم إدراجه في القائمة البيضاء.
	`getAbisForBuildTargetArch ()` قم بإرجاع abis المدعوم من قبل البنية المستهدفة لبناء المضيف.
	`getHostAbis ()` إرجاع الجهاز المضيف abis.
`void`	`setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)`
`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_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

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

البذور عشوائي

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

TOKEN_KEY

public static final String TOKEN_KEY

المنشأت العامة

ITestSuite

public ITestSuite ()

الأساليب العامة

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

حدود
`filters`	`MultiMap`

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

حدود
`filters`	`MultiMap`

عامل التصفيةByConfigMetadata

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)

الحصول على مجموعة ABIs التي يدعمها اختبار التوافق AbiUtils.getAbisSupportedByCompatibility() والجهاز قيد الاختبار.

حدود
`device`	`ITestDevice`

عائدات
	مجموعة ABIs لتشغيل الاختبارات عليها

رميات
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

تُرجع abis المحتمل من 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`

getInvocationContext

public IInvocationContext getInvocationContext ()

إرجاع سياق الاستدعاء.

عائدات
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

عائدات
`MultiMap <String, String>`

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`

هو تقسيم

public boolean isSplitting ()

يعود صحيحًا إذا كنا حاليًا في IShardableTest.split(int) .

عائدات
`boolean`

الاختبارات

public abstract  loadTests ()

طريقة Abstract لتحميل تكوين الاختبارات التي سيتم تشغيلها. يتم تحديد كل اختبار من خلال IConfiguration رمز واسم فريد سيتم بموجبه تقرير النتائج.

عائدات

تقرير غير مُنفَّذ

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

قم بالإبلاغ عن الاختبارات غير المنفذة إلى المستمع الرئيسي المقدم. يجب الإبلاغ عنها على أنها فاشلة برسالة NOT_EXECUTED_FAILURE .

حدود
`listener`	`ITestInvocationListener` : المستمع الرئيسي حيث يتم الإبلاغ عن النتائج غير المنفذة.
`message`	`String` : الرسالة المراد إقرانها بالفشل الذي لم يتم تنفيذه.

تقرير غير مُنفَّذ

public void reportNotExecuted (ITestInvocationListener listener)

حدود
`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`

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

حدود
`invocationContext`	`IInvocationContext`

setMetricCollectors

public void setMetricCollectors ( collectors)

يضبط قائمة IMetricCollector s المحددة للتشغيل التجريبي.

حدود
`collectors`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

قم بتعيين قيمة mPrimaryAbiRun

حدود
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

حدود
`dynamicModule`	`boolean`

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 . ستتم إعادة استخدام هؤلاء المستمعين لكل وحدة نمطية ، ولن يتم إعادة تكوينهم لذا لا ينبغي أن يفترضوا حالة داخلية.

عائدات

عامل التصفية ByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

حدود
`config`	`IConfiguration` : يتم تقييم `IConfiguration` .
`allowedRunners`	: القائمة البيضاء للعداء الحالي.

عائدات
`boolean`	صحيح إذا تم السماح لوحدة التكوين بالعمل ، خطأ بخلاف ذلك.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

عائدات

getHostAbis

protected  getHostAbis ()

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

عائدات

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

حدود
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

حدود
`module`	`ModuleDefinition`

عائدات
`boolean`