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

تعريف الوحدة

public class ModuleDefinition
extends Object implements ITestCollector

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

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

ملخّص

الحقول
`public static final String`	`ISOLATION_COST`
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CACHED` يتم ضبط هذه السمة على true إذا تم تخزين نتائج وحدة الاختبار مؤقتًا.
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` رقم تعريف الوحدة هو الاسم الذي سيتم استخدامه لتحديد الوحدة بشكل فريد أثناء testRunStart.
`public static final String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`public static final String`	`MODULE_ISOLATED` يتم تعيين هذه الخاصية على "صحيح" إذا كانت الوحدة تعمل على جهاز تم إعداده حديثًا.
`public static final String`	`MODULE_NAME` اسم الوحدة هو الاسم الأساسي المرتبط بالوحدة، وعادةً ما يكون من ملف الإعدادات Xml TF الذي تم تحميل الوحدة منه.
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`MODULE_SKIPPED` يتم ضبط هذه السمة على true إذا تم تخطّي وحدة الاختبار.
`public static final String`	`MODULE_TEST_COUNT`
`public static final String`	`PREPARATION_TIME`
`public static final String`	`RETRY_FAIL_COUNT`
`public static final String`	`RETRY_SUCCESS_COUNT`
`public static final String`	`RETRY_TIME`
`public static final String`	`SPARSE_MODULE` يتم ضبط هذه السمة على "صحيح" إذا تم الإبلاغ عن الأحداث على مستوى الوحدة فقط.
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

وظائف الإنشاء العامة
`ModuleDefinition()`
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` طريقة وضع التصميم
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` طريقة وضع التصميم

الطرق العامة
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` عرض اسم الوحدة الفريد
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` تعرِض هذه السمة القيمة `IInvocationContext` المرتبطة بالوحدة.
	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` تعرِض هذه السمة الوقت التقريبي لتشغيل جميع الاختبارات في الوحدة.
`boolean`	`hasModuleFailed()` تعرِض هذه الدالة القيمة True إذا تمّ استدعاء testRunFailure في الوحدة.
`int`	`neededDevices()` تعرِض هذه السمة عدد الأجهزة المتوقّع أن تجرى عليها هذه الاختبار.
`int`	`numTests()` عرض العدد الحالي من `IRemoteTest` في انتظار التنفيذ
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` الإبلاغ عن الوحدات التي لم يتم تنفيذها بالكامل
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners)` شغِّل جميع `IRemoteTest` المضمَّنة في الوحدة واستخدِم جميع أدوات التجهيز قبل وبعد إعداد الجهاز وتنظيفه.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit)` شغِّل جميع `IRemoteTest` المضمَّنة في الوحدة واستخدِم جميع أدوات التجهيز قبل وبعد إعداد الجهاز وتنظيفه.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` شغِّل جميع `IRemoteTest` الواردة في الوحدة واستخدِم جميع أدوات الإعداد قبل الإجراء وبعده لإعداد الجهاز وتنظيفه.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` تشغيل مُعدّي الاختبار، بما في ذلك مُعدّي الاختبار على مستوى المجموعة إذا تم تحديدهم
`void`	`setBuild(IBuildInfo build)` أدخِل `IBuildInfo` لاستخدامه أثناء الاختبارات.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` تفعيل وضع جمع الاختبارات أو إيقافه
`void`	`setDevice(ITestDevice device)` أدخِل `ITestDevice` لاستخدامه أثناء الاختبارات.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` ما إذا كان سيتم تفعيل التنزيل الديناميكي على مستوى الوحدة أم لا
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` نقْل أداة حفظ سجلّات الاستدعاء إلى الوحدة حتى تتمكّن من استخدامها إذا لزم الأمر.
`final void`	`setMergeAttemps(boolean mergeAttempts)` لتحديد ما إذا كان علينا دمج النتائج أم لا.
`void`	`setMetricCollectors( collectors)` أدخِل قائمة `IMetricCollector` التي ستستخدمها الوحدة.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` من المفترض أن تستعيد المجموعات الجهاز الافتراضي.
`final void`	`setRetryDecision(IRetryDecision decision)` تحدِّد هذه السياسة السياسة `IRetryDecision` التي سيتم استخدامها لإعادة المحاولة داخل الوحدة.
`boolean`	`shouldRecoverVirtualDevice()` يعرض ما إذا كان علينا استرداد جهاز افتراضي.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` نسخ بعض الإعدادات على مستوى الحزمة

الطرق المحمية
`boolean`	`hasTests()` عرض True إذا كانت الوحدة لا تزال بحاجة إلى `IRemoteTest` لتشغيلها في المجموعة

الحقول

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

يتم ضبط هذه السمة على true إذا تم تخزين نتائج وحدة الاختبار مؤقتًا.

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

رقم تعريف الوحدة هو الاسم الذي سيتم استخدامه لتحديد الوحدة بشكل فريد أثناء testRunStart. ويتم ذلك عادةً من خلال مزيج من MODULE_ABI وMODULE_NAME.

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

MODULE_ISOLATED

public static final String MODULE_ISOLATED

يتم تعيين هذه الخاصية على "صحيح" إذا كانت الوحدة تعمل على جهاز تم إعداده حديثًا.

MODULE_NAME

public static final String MODULE_NAME

اسم الوحدة هو الاسم الأساسي المرتبط بالوحدة، وعادةً ما يكون من ملف الإعدادات Xml TF الذي تم تحميل الوحدة منه.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_SKIPPED

public static final String MODULE_SKIPPED

يتم ضبط هذه السمة على true إذا تم تخطّي وحدة الاختبار.

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

وقت التحضير

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

عدد مرات إعادة المحاولة

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

SPARSE_MODULE

public static final String SPARSE_MODULE

يتم ضبط هذه السمة على "صحيح" إذا تم الإبلاغ عن الأحداث على مستوى الوحدة فقط.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

وظائف الإنشاء العامة

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

طريقة وضع التصميم

المعلمات
`name`	`String`: الاسم الفريد لإعدادات الاختبار
`tests`	: قائمة تضم `IRemoteTest` المطلوب تشغيلها
`preparersPerDevice`	‫: قائمة `ITargetPreparer` التي سيتم استخدامها لإعداد الجهاز
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` لإعدادات الوحدة الأساسية.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

طريقة وضع التصميم

المعلمات
`name`	`String`: الاسم الفريد لإعدادات الاختبار
`tests`	: قائمة `IRemoteTest` التي يجب تنفيذها
`preparersPerDevice`	‫: قائمة `ITargetPreparer` التي سيتم استخدامها لإعداد الجهاز
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` لإعدادات الوحدة الأساسية.

الطرق العامة

compareTo

public int compareTo (ModuleDefinition moduleDef)

المعلمات
`moduleDef`	`ModuleDefinition`

المرتجعات
`int`

الحصول على معرّف

public String getId ()

عرض اسم الوحدة الفريد

المرتجعات
`String`

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

المرتجعات
`Integer`

أمر getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

المرتجعات
`Integer`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

المرتجعات
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

تعرِض هذه السمة القيمة IInvocationContext المرتبطة بالوحدة.

المرتجعات
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

المعلمات
`testInfo`	`TestInformation`

المرتجعات

getRuntimeHint

public long getRuntimeHint ()

تعرِض هذه السمة الوقت التقريبي لتشغيل جميع الاختبارات في الوحدة.

المرتجعات
`long`

hasModuleFailed

public boolean hasModuleFailed ()

تعرِض هذه الدالة القيمة True إذا تمّ استدعاء testRunFailure في الوحدة.

المرتجعات
`boolean`

الأجهزة المطلوبة

public int neededDevices ()

تعرِض هذه السمة عدد الأجهزة المتوقّع أن تجرى عليها هذه الاختبار.

المرتجعات
`int`

numTests

public int numTests ()

عرض العدد الحالي من IRemoteTest في انتظار التنفيذ

المرتجعات
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

الإبلاغ عن الوحدات التي لم يتم تنفيذها بالكامل

المعلمات
`listener`	`ITestInvocationListener`
`message`	`String`

ضربة طويلة

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners)

شغِّل جميع IRemoteTest الواردة في الوحدة واستخدِم جميع أدوات الإعداد قبل الإجراء وبعده لإعداد الجهاز وتنظيفه.

المعلمات
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener` حيث يتم الإبلاغ عن النتائج
`moduleLevelListeners`	‫: قائمة أدوات معالجة الأحداث على مستوى الوحدة

عمليات الرمي
`DeviceNotAvailableException`	في حال انقطاع اتصال الجهاز بالإنترنت

ضربة طويلة

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                int maxRunLimit)

شغِّل جميع IRemoteTest المضمَّنة في الوحدة واستخدِم جميع أدوات التجهيز قبل وبعد إعداد الجهاز وتنظيفه.

المعلمات
`moduleInfo`	`TestInformation`: السمة `TestInformation` للوحدة
`listener`	`ITestInvocationListener`: `ITestInvocationListener` حيث يتم الإبلاغ عن النتائج
`moduleLevelListeners`	: قائمة المستمعين على مستوى الوحدة
`maxRunLimit`	`int`: الحد الأقصى لعدد عمليات التشغيل لكل حالة اختبار.

عمليات الرمي
`DeviceNotAvailableException`	في حال انقطاع اتصال الجهاز بالإنترنت

ضربة طويلة

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

شغِّل جميع IRemoteTest المضمَّنة في الوحدة واستخدِم جميع أدوات التجهيز قبل وبعد إعداد الجهاز وتنظيفه.

المعلمات
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener` مكان الإبلاغ عن النتائج

عمليات الرمي
`DeviceNotAvailableException`	في حال انقطاع اتصال الجهاز بالإنترنت

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

تشغيل مُعدّي الاختبار، بما في ذلك مُعدّي الاختبار على مستوى المجموعة إذا تم تحديدهم

المعلمات
`includeSuitePreparers`	`boolean`: اضبط القيمة على `true` لتشغيل أدوات الإعداد على مستوى المجموعة أيضًا.

المرتجعات
`Throwable`	`Throwable` من أي استثناءات ظهرت عند تشغيل أدوات التجهيز.

setBuild

public void setBuild (IBuildInfo build)

أدخِل IBuildInfo لاستخدامه أثناء الاختبارات.

المعلمات
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

تفعيل وضع جمع الاختبارات أو إيقافه

ضبط الجهاز

public void setDevice (ITestDevice device)

أدخِل ITestDevice لاستخدامه أثناء الاختبارات.

المعلمات
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

لتحديد ما إذا كان سيتم تمكين التنزيل الديناميكي على مستوى الوحدة أم لا.

المعلمات
`enableDynamicDownload`	`boolean`

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

المعلمات
`shardCount`	`int`
`shardIndex`	`int`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

نقْل أداة حفظ سجلّات الاستدعاء إلى الوحدة حتى تتمكّن من استخدامها إذا لزم الأمر.

المعلمات
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

لتحديد ما إذا كان علينا دمج النتائج أم لا.

المعلمات
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

أدخِل قائمة IMetricCollector التي ستستخدمها الوحدة.

المعلمات
`collectors`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

من المفترض أن تستعيد المجموعات الجهاز الافتراضي.

المعلمات
`recoverVirtualDevice`	`boolean`

تعيين إعادة المحاولة

public final void setRetryDecision (IRetryDecision decision)

تُستخدَم لضبط IRetryDecision التي سيتم استخدامها لإعادة المحاولة داخل الوحدة.

المعلمات
`decision`	`IRetryDecision`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

يعرض ما إذا كان علينا استرداد جهاز افتراضي.

المرتجعات
`boolean`

toString

public String toString ()

المرتجعات
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

نسخ بعض الإعدادات على مستوى المجموعة

المعلمات
`mSuiteConfiguration`	`IConfiguration`

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

hasTests

protected boolean hasTests ()

عرض True إذا كانت الوحدة لا تزال بحاجة إلى IRemoteTest لتشغيلها في المجموعة خطأ بخلاف ذلك.

المرتجعات
`boolean`