اعتبارًا من عام 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.

HostUtils

public final class HostUtils
extends Object

java.lang.Object
↳	com.android.tradefed.lite.HostUtils

تنفِّذ هذه الفئة بعض طرق الأدوات المساعدة المفيدة لتشغيل اختبارات المضيف.

ينفّذ هذا الرمز بعض الطرق للعثور على الاختبارات على الجهاز المضيف وتنفيذ اختبارات JUnit بشكل وهمي حتى نتمكّن من "تشغيلها بدون تنفيذ".

ملخّص

الإجراءات العامة
`static List<Class<?>>`	`getJUnitClasses(Set<String> classNames, Set<String> jarAbsPaths, ClassLoader pcl)`
`static List<Class<?>>`	`getJUnitClasses(Set<String> classNames, Set<String> jarAbsPaths, List<String> excludePaths, ClassLoader pcl)` يحصل على حالات اختبار JUnit4 من أسماء الفئات ومسارات ملفات JAR المتوفّرة.
`static boolean`	`hasJUnitAnnotation(Class<?> classObj)` تتحقّق هذه السمة مما إذا كان الصف يشبه اختبار JUnit أم لا.
`static boolean`	`testLoadClass(String className, URLClassLoader cl, String jarName)` تختبر هذه السمة ما إذا كانت الفئة فئة اختبار مناسبة أم لا.

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

getJUnitClasses

public static List<Class<?>> getJUnitClasses (Set<String> classNames, 
                Set<String> jarAbsPaths, 
                ClassLoader pcl)

المعلَمات
`classNames`	`Set`
`jarAbsPaths`	`Set`
`pcl`	`ClassLoader`

القيم المُعادة
`List<Class<?>>`

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

getJUnitClasses

public static List<Class<?>> getJUnitClasses (Set<String> classNames, 
                Set<String> jarAbsPaths, 
                List<String> excludePaths, 
                ClassLoader pcl)

يحصل على حالات اختبار JUnit4 من أسماء الفئات ومسارات ملفات JAR المتوفّرة.

المعلَمات
`classNames`	‫`Set`: الفئات المتوفّرة في مسار الفئة الحالي للبحث عن اختبارات JUnit
`jarAbsPaths`	`Set`: ملفات JAR للبحث عن الفئات التي تتضمّن التعليقات التوضيحية للاختبار
`excludePaths`	`List`
`pcl`	`ClassLoader`

المرتجعات
`List<Class<?>>`	قائمة بكائنات الفئات التي تمثّل فئات اختبار سيتم تنفيذها.

عمليات الطرح
	java.lang.IllegalArgumentException
`IllegalArgumentException`

hasJUnitAnnotation

public static boolean hasJUnitAnnotation (Class<?> classObj)

تتحقّق هذه السمة مما إذا كان الصف يبدو كاختبار JUnit أم لا.

المعلَمات
`classObj`	`Class`: الفئة التي سيتم فحصها بحثًا عن التعليق التوضيحي

المرتجعات
`boolean`	ما إذا كان عنصر الفئة يحتوي على تعليق توضيحي لاختبار JUnit4

testLoadClass

public static boolean testLoadClass (String className, 
                URLClassLoader cl, 
                String jarName)

تختبر هذه السمة ما إذا كانت الفئة فئة اختبار مناسبة أم لا.

في هذه الحالة، تعني كلمة "مناسب" أنّها فئة اختبار JUnit صالحة تستخدم أحد برامج التشغيل العادية أو فئة فرعية منها. يجب أيضًا تحميل الصف، بالطبع.

المرتجعات
`boolean`	صحيح إذا كان يجب اعتبار هذا الصف صف اختبار، خطأ في الحالات الأخرى

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