تمت ترجمة هذه الصفحة بواسطة 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` يتم تعيين هذه الخاصية على "صحيح" إذا تم تخزين نتائج وحدة الاختبار مؤقتًا.
`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`	`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, 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 ()` إرجاع True إذا تم استدعاء 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` التي ستستخدمها الوحدة.
`void`	`setRecoverVirtualDevice (boolean recoverVirtualDevice)` يجب أن تقوم المجموعات باستعادة الجهاز الظاهري.
`final void`	`setRetryDecision ( IRetryDecision decision)` يقوم بتعيين `IRetryDecision` ليتم استخدامه لإعادة المحاولة داخل الوحدة النمطية.
`boolean`	`shouldRecoverVirtualDevice ()` يعود إذا كان علينا استعادة الجهاز الظاهري.
`String`	`toString ()`
`void`	`transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)` انسخ القليل من التكوين على مستوى الجناح

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

مجالات

العزلة_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

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

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

SPARSE_MODULE

public static final String SPARSE_MODULE

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

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

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

عائدات
`boolean`

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

public int neededDevices ()

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

عائدات
`int`

numTests

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` : الحد الأقصى لعدد مرات التشغيل لكل حالة اختبار.

رميات
`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`	في حالة عدم اتصال الجهاز بالإنترنت.

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)

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

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`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

يجب أن تقوم المجموعات باستعادة الجهاز الظاهري.

حدود
`recoverVirtualDevice`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

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

حدود
`decision`	`IRetryDecision`

يجب أن يكون RecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

يعود إذا كان علينا استعادة الجهاز الظاهري.

عائدات
`boolean`

إلى سلسلة

public String toString ()

عائدات
`String`

TransferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

حدود
`mSuiteConfiguration`	`IConfiguration`

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

hasTests

protected boolean hasTests ()

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

عائدات
`boolean`