اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

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

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

ملخّص

الثوابت
`String`	`ISOLATION_COST`
`String`	`MODULE_ABI`
`String`	`MODULE_CACHED` يتم ضبط هذه السمة على "صحيح" إذا تم تخزين نتائج وحدة الاختبار مؤقتًا.
`String`	`MODULE_CONTROLLER`
`String`	`MODULE_EXTERNAL_DEPENDENCIES`
`String`	`MODULE_ID` معرّف الوحدة هو الاسم الذي سيتم استخدامه لتحديد الوحدة بشكل فريد أثناء testRunStart.
`String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`String`	`MODULE_ISOLATED` يتم ضبط هذه السمة على "صحيح" إذا كان يتم تشغيل الوحدة على جهاز تم إعداده حديثًا.
`String`	`MODULE_NAME` اسم الوحدة هو الاسم الأساسي المرتبط بالوحدة، ويأتي عادةً من ملف إعدادات Xml TF الذي تم تحميل الوحدة منه.
`String`	`MODULE_PARAMETERIZATION`
`String`	`MODULE_SKIPPED` يتم ضبط هذه السمة على "صحيح" إذا تم تخطّي وحدة الاختبار
`String`	`MODULE_TEST_COUNT`
`String`	`PREPARATION_TIME`
`String`	`RETRY_FAIL_COUNT`
`String`	`RETRY_SUCCESS_COUNT`
`String`	`RETRY_TIME`
`String`	`SPARSE_MODULE` يتم ضبط هذه السمة على "صحيح" في حال الإبلاغ عن أحداث على مستوى الوحدة فقط.
`String`	`TEAR_DOWN_TIME`
`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` المرتبط بالوحدة.
`TestInformation`	`getModuleTestInformation()`
	`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, 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)` يجب أن تسترد المجموعات الجهاز الافتراضي.
`void`	`setRemoveModuleBuffering(boolean removeModuleBuffering)`
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` تضبط هذه السمة قيمة `IRetryDecision` التي سيتم استخدامها لإعادة المحاولة داخل الوحدة.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` تعرِض هذه السمة ما إذا كان يجب استرداد الجهاز الافتراضي.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` نسخ بعض إعدادات مستوى المجموعة

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

الثوابت

ISOLATION_COST

public static final String ISOLATION_COST

القيمة الثابتة: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Constant Value: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

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

القيمة الثابتة: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Constant Value: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

القيمة الثابتة: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

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

القيمة الثابتة: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Constant Value: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

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

القيمة الثابتة: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

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

القيمة الثابتة: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

القيمة الثابتة: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

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

القيمة الثابتة: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

القيمة الثابتة: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Constant Value: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

القيمة الثابتة: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

القيمة الثابتة: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

القيمة الثابتة: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

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

القيمة الثابتة: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

القيمة الثابتة: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

القيمة الثابتة: "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`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

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

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, 
                int maxRunLimit)

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

المعلمات
`moduleInfo`	`TestInformation`: `TestInformation` للوحدة
`listener`	`ITestInvocationListener`: `ITestInvocationListener` حيث يتم عرض النتائج.
`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`

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

المعلمات
`removeModuleBuffering`	`boolean`

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

المعلمات
`shouldReportModuleEnd`	`boolean`

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

المعلمات
`shouldReportModuleStart`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

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

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

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

المعلمات
`useModuleResultsForwarder`	`boolean`

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`