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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ExecutableBaseTest

public abstract class ExecutableBaseTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDiscoverDependencies, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.binary.ExecutableBaseTest

الفئات الفرعية المباشرة المعروفة

ExecutableHostTest، ExecutableTargetTest

ExecutableHostTest	أداة تشغيل الاختبارات لتنفيذ الملفات القابلة للتنفيذ على الجهاز المضيف
ExecutableTargetTest	أداة تشغيل الاختبارات لتنفيذ الملفات القابلة للتنفيذ على الجهاز المستهدف

الفئات الفرعية غير المباشرة المعروفة

‫KUnitModuleTest وKernelTargetTest

KUnitModuleTest	أداة تشغيل الاختبارات لتشغيل وحدات اختبار KUnit على الجهاز
KernelTargetTest	أداة تشغيل الاختبارات لتشغيل الملفات التنفيذية على الجهاز المستهدف وتحليل نتيجة اختبار النواة

صنف أساسي لنمط الاختبارات القابلة للتنفيذ على سبيل المثال: الملفات الثنائية، وبرامج shell النصية.

ملخّص

الثوابت
`String`	`NO_BINARY_ERROR`

طُرق وضع التصميم العامة
`ExecutableBaseTest()`

الإجراءات العامة
`void`	`addAllExcludeFilters(Set<String> filters)` تضيف هذه السمة `Set` الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.
`void`	`addAllIncludeFilters(Set<String> filters)` تضيف هذه السمة `Set` فلاتر الاختبارات التي سيتم تضمينها.
`void`	`addExcludeFilter(String filter)` تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب استبعادها.
`void`	`addIncludeFilter(String filter)` تضيف هذه السمة فلترًا لتحديد الاختبارات التي سيتم تضمينها.
`void`	`clearExcludeFilters()` احذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا.
`void`	`clearIncludeFilters()` احذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا.
`abstract String`	`findBinary(String binary)` ابحث عن الملف الثنائي لتتمكّن من تشغيله.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
`Set<String>`	`getExcludeFilters()` تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.`Set`
`Set<String>`	`getIncludeFilters()` تعرِض هذه السمة `Set` فلاتر التضمين الحالية.
`final long`	`getRuntimeHint()` عرض وقت التشغيل المتوقّع للاختبار بالملّي ثانية
`Set<String>`	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` تُجري الاختبارات وتُبلغ المستمع بالنتيجة.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` تنفيذ الملف الثنائي في المسار المحدّد
`final void`	`setAbi(IAbi abi)`
`final void`	`setCollectTestsOnly(boolean shouldCollectTest)` تفعيل وضع جمع الاختبارات أو إيقافه
`void`	`setConfiguration(IConfiguration configuration)` يُدرِج `IConfiguration` المستخدَم.
`FailureDescription`	`shouldAbortRun(TestDescription description)` تحقَّق ممّا إذا كان يجب إنهاء اختبار testRun مبكرًا.
`final Collection<IRemoteTest>`	`split(int shardHint)` نسخة بديلة من `split()` توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

طُرق محمية
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
`Map<String, String>`	`getAllTestCommands()` تحويل mBinaryPaths إلى mTestCommands للحفاظ على الاتساق
`IConfiguration`	`getConfiguration()` تعرض هذه السمة إعدادات الاختبار.
`TestDescription[]`	`getFilterDescriptions(Map<String, String> testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`
`boolean`	`isTestFailed(String testName)`

الثوابت

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Constant Value: "Binary %s does not exist."

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

ExecutableBaseTest

public ExecutableBaseTest ()

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

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

المعلَمات
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

تضيف هذه السمة Set فلاتر الاختبارات التي سيتم تضمينها.

المعلَمات
`filters`	`Set`

addExcludeFilter

public void addExcludeFilter (String filter)

تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب استبعادها.

المعلَمات
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

تضيف هذه السمة فلترًا لتحديد الاختبارات التي سيتم تضمينها.

المعلَمات
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

احذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا.

clearIncludeFilters

public void clearIncludeFilters ()

احذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا.

findBinary

public abstract String findBinary (String binary)

ابحث عن الملف الثنائي لتتمكّن من تشغيله.

المعلَمات
`binary`	‫`String`: مسار البرنامج الثنائي أو اسم البرنامج الثنائي فقط

المرتجعات
`String`	مسار الملف الثنائي أو قيمة فارغة في حال عدم العثور عليه

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

getAbi

public IAbi getAbi ()

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

getCollectTestsOnly

public boolean getCollectTestsOnly ()

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

getExcludeFilters

public Set<String> getExcludeFilters ()

تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.Set

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

getIncludeFilters

public Set<String> getIncludeFilters ()

تعرِض هذه السمة Set فلاتر التضمين الحالية.

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

getRuntimeHint

public final long getRuntimeHint ()

عرض وقت التشغيل المتوقّع للاختبار بالملّي ثانية يُستخدَم الوقت لموازنة الحمل في التنفيذ المجزّأ

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

reportDependencies

public Set<String> reportDependencies ()

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

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

تُجري الاختبارات وتُبلغ المستمع بالنتيجة.

المعلَمات
`testInfo`	`TestInformation`: عنصر `TestInformation` يحتوي على معلومات مفيدة لتنفيذ الاختبارات.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` نتائج الاختبار

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

runBinary

public abstract void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

تنفيذ الملف الثنائي في المسار المحدّد

المعلَمات
`binaryPath`	‫`String`: مسار الملف الثنائي
`listener`	‫`ITestInvocationListener`: برنامج تلقّي النتائج.
`description`	‫`TestDescription`: الاختبار قيد التقدّم.

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

setAbi

public final void setAbi (IAbi abi)

المعلَمات
`abi`	`IAbi`

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

المعلَمات
`configuration`	`IConfiguration`

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

تحقَّق ممّا إذا كان يجب إنهاء اختبار testRun مبكرًا.

المعلَمات
`description`	‫`TestDescription`: الاختبار قيد التقدّم.

المرتجعات
`FailureDescription`	FailureDescription إذا كان يجب إنهاء حلقة التنفيذ.

تقسيم

public final Collection<IRemoteTest> split (int shardHint)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه. ويكون ذلك مفيدًا لبعض أدوات تشغيل الاختبار التي لا يمكنها اتخاذ قرار بشكل عشوائي في بعض الأحيان.

المعلَمات
`shardHint`	`int`: عدد الأجزاء التي تمت محاولة إنشائها.

المرتجعات
`Collection<IRemoteTest>`	مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو `null` إذا كان الاختبار غير قابل للتجزئة حاليًا

طُرق محمية

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

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

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

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

getAllTestCommands

protected Map<String, String> getAllTestCommands ()

تحويل mBinaryPaths إلى mTestCommands للحفاظ على الاتساق

المرتجعات
`Map<String, String>`	خريطة`LinkedHashMap`<string, string=""> من testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

تعرض هذه السمة إعدادات الاختبار.

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

getFilterDescriptions

protected TestDescription[] getFilterDescriptions (Map<String, String> testCommands)

المعلَمات
`testCommands`	`Map`

المرتجعات
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

المعلَمات
`context`	`IInvocationContext`

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

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

المرتجعات
`long`	المهلة الزمنية المطبَّقة على كل برنامج ثنائي لتنفيذه

isTestFailed

protected boolean isTestFailed (String testName)

المعلَمات
`testName`	`String`

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