تمت ترجمة هذه الصفحة بواسطة 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_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` معرف الوحدة النمطية هو الاسم الذي سيتم استخدامه لتعريف الوحدة بشكل فريد أثناء testRunStart.
`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_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`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

المنشأت العامة
`ModuleDefinition ()`
`ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` البناء
`ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` البناء

الأساليب العامة
`int`	`compareTo ( ModuleDefinition moduleDef)`
`String`	`getId ()` قم بإرجاع اسم الوحدة الفريد.
`IConfiguration`	`getModuleConfiguration ()`
`IInvocationContext`	`getModuleInvocationContext ()` إرجاع `IInvocationContext` المرتبط بالوحدة النمطية.
	`getRequiredTokens ( TestInformation testInfo)`
`long`	`getRuntimeHint ()` تُرجع الوقت التقريبي لتشغيل كافة الاختبارات في الوحدة النمطية.
`boolean`	`hasModuleFailed ()` إرجاع صحيح إذا تم استدعاء testRunFailure في الوحدة النمطية *
`int`	`neededDevices ()` تُرجع عدد الأجهزة المتوقع تشغيل هذا الاختبار.
`int`	`numTests ()` تُرجع العدد الحالي لاختبار `IRemoteTest` الذي ينتظر التنفيذ.
`final void`	`reportNotExecuted ( ITestInvocationListener listener, String message)` تقرير لم يتم تنفيذ الوحدات النمطية تمامًا.
`final void`	`run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` `run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` قم بتشغيل كل اختبار `IRemoteTest` الموجود في الوحدة النمطية واستخدم جميع المُعِدين قبل وبعد لإعداد الجهاز وتنظيفه.
`final void`	`run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` `run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` قم بتشغيل كل اختبار `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`	`setLogSaver ( ILogSaver logSaver)` قم بتمرير حفظ سجل الاستدعاء إلى الوحدة النمطية حتى تتمكن من استخدامه إذا لزم الأمر.
`final void`	`setMergeAttemps (boolean mergeAttempts)` يحدد ما إذا كان ينبغي علينا دمج النتائج أم لا.
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` قم بإدخال قائمة `IMetricCollector` التي سيتم استخدامها بواسطة الوحدة النمطية.
`final void`	`setRetryDecision ( IRetryDecision decision)` يعين `IRetryDecision` ليتم استخدامه لإعادة المحاولة داخل الوحدة النمطية.
`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_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_ISOLATED

public static final String MODULE_ISOLATED

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

اسم وحدة

public static final String MODULE_NAME

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

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

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

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

وقت الاختبار

public static final String TEST_TIME

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

تعريف الوحدة النمطية

public ModuleDefinition ()

تعريف الوحدة النمطية

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

البناء

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

تعريف الوحدة النمطية

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

البناء

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

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

قارن ب

public int compareTo (ModuleDefinition moduleDef)

حدود
`moduleDef`	`ModuleDefinition`

عائدات
`int`

getId

public String getId ()

قم بإرجاع اسم الوحدة الفريد.

عائدات
`String`

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

إرجاع صحيح إذا تم استدعاء testRunFailure في الوحدة النمطية *

عائدات
`boolean`

الأجهزة

public int neededDevices ()

تُرجع عدد الأجهزة المتوقع تشغيل هذا الاختبار.

عائدات
`int`

عدد الاختبارات

public int numTests ()

تُرجع العدد الحالي لاختبار IRemoteTest الذي ينتظر التنفيذ.

عائدات
`int`

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

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

تقرير لم يتم تنفيذ الوحدات النمطية تمامًا.

حدود
`listener`	`ITestInvocationListener`
`message`	`String`

يجري

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

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

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

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

يجري

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

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

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

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

يجري

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

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

حدود
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener` : `ITestInvocationListener` حيث يتم الإبلاغ عن النتائج.

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

تشغيل

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)

يمكّن أو يعطل وضع مجموعة الاختبار

setDevice

public void setDevice (ITestDevice device)

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

حدود
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

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

حدود
`enableDynamicDownload`	`boolean`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

حدود
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

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

حدود
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

قم بإدخال قائمة IMetricCollector التي سيتم استخدامها بواسطة الوحدة النمطية.

حدود
`collectors`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

يعين IRetryDecision ليتم استخدامه لإعادة المحاولة داخل الوحدة النمطية.

حدود
`decision`	`IRetryDecision`

إلى سلسلة

public String toString ()

عائدات
`String`

TransferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

انسخ القليل من تكوين مستوى المجموعة

حدود
`mSuiteConfiguration`	`IConfiguration`

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

hasTests

protected boolean hasTests ()

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

عائدات
`boolean`