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

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( filters)` تضيف هذه السمة `ERROR(/Set)` الفلاتر التي يجب استبعاد الاختبارات التي تتطابق معها.
`void`	`addAllIncludeFilters( filters)` تضيف هذه السمة `ERROR(/Set)` فلاتر الاختبارات التي سيتم تضمينها.
`void`	`addExcludeFilter(String filter)` تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب استبعادها.
`void`	`addIncludeFilter(String filter)` تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب تضمينها.
`void`	`clearExcludeFilters()` حذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا
`void`	`clearIncludeFilters()` احذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا.
`abstract String`	`findBinary(String binary)` ابحث عن الملف الثنائي لتتمكّن من تشغيله.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` تعرِض هذه السمة `ERROR(/Set)` فلاتر الاستبعاد الحالية.
	`getIncludeFilters()` تعرِض هذه السمة `ERROR(/Set)` فلاتر التضمين الحالية.
`final long`	`getRuntimeHint()` عرض وقت التشغيل المتوقّع للاختبار بالملي ثانية
	`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`	`split(int shardHint)` نسخة بديلة من `split()` توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

الطُرق المحمية
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` تحويل mBinaryPaths إلى mTestCommands للحفاظ على الاتساق
`IConfiguration`	`getConfiguration()` تعرض هذه الطريقة إعدادات الاختبار.
`TestDescription[]`	`getFilterDescriptions( 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 ( filters)

تضيف هذه السمة ERROR(/Set) الفلاتر التي يجب استبعاد الاختبارات التي تتطابق معها.

المعلمات
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

المعلمات
`filters`

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

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

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

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

المرتجعات

getRuntimeHint

public final long getRuntimeHint ()

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

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

reportDependencies

public  reportDependencies ()

المرتجعات

ضربة طويلة

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`

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  split (int shardHint)

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

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

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

الطُرق المحمية

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

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

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

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

getAllTestCommands

protected  getAllTestCommands ()

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

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

getConfiguration

protected IConfiguration getConfiguration ()

تعرض هذه الطريقة إعدادات الاختبار.

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

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

المعلمات
`testCommands`

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

getModuleId

protected String getModuleId (IInvocationContext context)

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

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

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

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

isTestFailed

protected boolean isTestFailed (String testName)

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

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