اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

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

ModuleDefinition

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_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` يتم ضبط هذه السمة على "صحيح" إذا تم تخطّي وحدة الاختبار.
`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

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

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

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

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

PREPARATION_TIME

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

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`

getId

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`

neededDevices

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)

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

setDevice

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`

setRetryDecision

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`