برنامج 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 |
صف موجز يستخدم لإدارة 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) المتوافقة مع كل من اختبار التوافق |
static
|
getAbisForBuildTargetArchFromSuite()
تعرض Abis المحتمل من TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
قد يتطلب تنفيذ " |
final
IConfiguration
|
getConfiguration()
تعرض الاستدعاء |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
اختبار الجهاز |
ModuleDefinition
|
getDirectModule()
يعرض |
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 إذا كنا في |
abstract
|
loadTests()
طريقة مختصرة لتحميل إعدادات الاختبارات التي سيتم تنفيذها |
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
إبلاغ المستمع الرئيسي الذي تم تقديمه عن الاختبارات التي لم يتم تنفيذها |
void
|
reportNotExecuted(ITestInvocationListener listener)
إبلاغ المستمع الرئيسي الذي تم تقديمه عن الاختبارات التي لم يتم تنفيذها |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
طريقة تشغيل عامة لجميع الاختبارات التي تم تحميلها من |
void
|
setAbiName(String abiName)
ضبط قيمة mAbiName |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
تشغيل مجموعة الاختبار في وضع المجمِّع فقط، يتطلب ذلك تنفيذ جميع الاختبارات الفرعية لتنفيذ هذه الواجهة أيضًا. |
void
|
setConfiguration(IConfiguration configuration)
إدخال |
void
|
setDevice(ITestDevice device)
أدخِل الجهاز تحت الاختبار. |
void
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
تحدِّد هذه السياسة قائمة |
void
|
setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
|
void
|
setPrimaryAbiRun(boolean primaryAbiRun)
ضبط قيمة mPrimaryAbiRun |
void
|
setShouldMakeDynamicModule(boolean dynamicModule)
عند إجراء التقسيم الموزع، لا يمكننا استخدام ModuleDefinition الذي يشارك الاختبارات في مجموعة وإلا لن ينجح التقسيم داخل الوحدة، لذلك نسمح بإيقافه. |
void
|
setSystemStatusChecker(
تضبط |
void
|
setTestLogger(ITestLogger testLogger)
إدخال مثيل |
|
split(Integer shardCountHint, TestInformation testInfo)
إصدار بديل من |
الطرق المحمية | |
---|---|
|
createModuleListeners()
تعرض قائمة |
boolean
|
filterByRunnerType(IConfiguration config,
يمكنك تطبيق فلترة القائمة البيضاء في "عدّاء" وإزالة أي عداء لم يكن مدرَجًا في القائمة البيضاء. |
|
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
publicgetAbis (ITestDevice device)
الحصول على مجموعة واجهات التطبيق الثنائية (ABI) المتوافقة مع كل من اختبار التوافق AbiUtils.getAbisSupportedByCompatibility()
والجهاز قيد الاختبار
المعلّمات | |
---|---|
device |
ITestDevice |
الركلات المردودة | |
---|---|
|
مجموعة واجهات التطبيق الثنائية (ABI) لتنفيذ الاختبارات على |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
تعرض Abis المحتمل من TestSuiteInfo.
الركلات المردودة | |
---|---|
|
الحصول على معلومات
public IBuildInfo getBuildInfo ()
قد يتطلب تنفيذ "ITestSuite
" الحصول على معلومات الإصدار لتحميل الاختبارات.
الركلات المردودة | |
---|---|
IBuildInfo |
GetConfiguration
public final IConfiguration getConfiguration ()
تعرض الاستدعاء IConfiguration
.
الركلات المردودة | |
---|---|
IConfiguration |
الحصول على جهاز
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 |
الحصول على رموز مطلوبة
publicgetRequiredTokens (TestInformation testInfo)
تعرض قائمة الرموز المميّزة المطلوبة من خلال الاختبار. يعرض قيمة خالية في حال عدم دعم الرمز المميز.
المعلّمات | |
---|---|
testInfo |
TestInformation |
الركلات المردودة | |
---|---|
|
الحصول على تلميح وقت التشغيل
public long getRuntimeHint ()
عرض وقت التشغيل المتوقّع للاختبار بالمللي ثانية يتم استخدام الوقت لتحميل التنفيذ المجزأ للتوازن.
الركلات المردودة | |
---|---|
long |
الحصول على TestsDir
public File getTestsDir ()
الركلات المردودة | |
---|---|
File |
تقسيم
public boolean isSplitting ()
تعرض القيمة true إذا كنا في IShardableTest.split(int)
حاليًا.
الركلات المردودة | |
---|---|
boolean |
اختبارات التحميل
public abstractloadTests ()
طريقة مختصرة لتحميل إعدادات الاختبارات التي سيتم تنفيذها يتم تحديد كل اختبار من خلال
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 |
|
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 |
تقسيم
publicsplit (Integer shardCountHint, TestInformation testInfo)
إصدار بديل من split(int)
يوفّر أيضًا TestInformation
يحتوي على معلومات أولية من أحد الوالدَين الذي ينشئ الأجزاء وهو مفيد إذا كانت هناك حاجة للوصول إلى عناصر مثل
الجهاز أو معلومات الإصدار أثناء عملية التقسيم إلى أجزاء.
المعلّمات | |
---|---|
shardCountHint |
Integer : عدد الأجزاء التي تمت محاولة إجرائها. |
testInfo |
TestInformation : العنصر الرئيسي TestInformation |
الركلات المردودة | |
---|---|
|
مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا لم يكن الاختبار
قابلاً للتقسيم في الوقت الحالي |
الطرق المحمية
إنشاء وحدة إعلانية على شكل وحدة
protectedcreateModuleListeners ()
تعرض قائمة ITestInvocationListener
السارية على مستوى ModuleListener
. ستتم إعادة استخدام أدوات معالجة الحدث هذه لكل وحدة، ولن تتم إعادة إنشائها، وبالتالي
يجب ألا تفترض حالة داخلية.
الركلات المردودة | |
---|---|
|
نوع الفلتر
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
يمكنك تطبيق فلترة القائمة البيضاء في "عدّاء" وإزالة أي عداء لم يكن مدرَجًا في القائمة البيضاء. إذا كانت الإعدادات تحتوي على عدة عوامل تشغيل، قد تتم إزالة بعضها وسيستمر تنفيذ عملية الإعداد.
المعلّمات | |
---|---|
config |
IConfiguration : تمثّل هذه السمة IConfiguration التي يتم تقييمها. |
allowedRunners |
: القائمة البيضاء الحالية للعدّاء |
الركلات المردودة | |
---|---|
boolean |
صحيح في حال السماح بتشغيل وحدة الضبط، أو القيمة "خطأ" في الحالات الأخرى |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
عرض Abis الذي تدعمه بنية هدف إصدار المضيف. معرض للاختبار.
الركلات المردودة | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
تعرض abis للجهاز المضيف.
الركلات المردودة | |
---|---|
|
يجب أن يتم تشغيل الوحدة
protected boolean shouldModuleRun (ModuleDefinition module)
المعلّمات | |
---|---|
module |
ModuleDefinition |
الركلات المردودة | |
---|---|
boolean |