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

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, 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, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` طريقة وضع التصميم
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` طريقة وضع التصميم

الإجراءات العامة
`int`	`compareTo(ModuleDefinition moduleDef)`
`Set<Digest>`	`getFilterDigests()` عرض ملخّصات الفلاتر المرتبطة بالاختبارات
`String`	`getId()` لعرض اسم الوحدة الفريد
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` تعرض هذه السمة `IInvocationContext` المرتبط بالوحدة.
`TestInformation`	`getModuleTestInformation()`
`Set<TokenProperty>`	`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`	`setCollectKernelLog(boolean collectKernelLog)`
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` تفعيل وضع جمع الاختبارات أو إيقافه
`void`	`setDefaultLogCollectors(List<IMetricCollector> collectors)`
`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(List<IMetricCollector> 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

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

Constant Value: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Constant Value: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

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

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

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

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

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

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

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

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

الإجراءات العامة

compareTo

public int compareTo (ModuleDefinition moduleDef)

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

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

getFilterDigests

public Set<Digest> getFilterDigests ()

عرض ملخّصات الفلاتر المرتبطة بالاختبارات

المرتجعات
`Set<Digest>`

عمليات الطرح
`IOException`

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 Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

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

المرتجعات
`Set<TokenProperty>`

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`

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

المعلَمات
`collectKernelLog`	`boolean`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

المعلَمات
`collectors`	`List`

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 (List<IMetricCollector> collectors)

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

المعلَمات
`collectors`	`List`

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`