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

GoogleBenchmarkTest

public class GoogleBenchmarkTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.GoogleBenchmarkTest

اختبار يشغّل حزمة اختبار قياس الأداء من Google على جهاز معيّن

ملخّص

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

الإجراءات العامة
`void`	`addAllExcludeFilters(Set<String> filters)` تضيف هذه السمة `Set` الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.
`void`	`addAllIncludeFilters(Set<String> filters)` تضيف هذه السمة `Set` فلاتر الاختبارات التي سيتم تضمينها.
`void`	`addExcludeFilter(String filter)` تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب استبعادها.
`void`	`addIncludeFilter(String filter)` تضيف هذه السمة فلترًا لتحديد الاختبارات التي سيتم تضمينها.
`void`	`addModuleName(String moduleName)` أضِف وحدة اختبار قياس الأداء الأصلية لنظام التشغيل Android لتشغيلها.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` احذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا.
`void`	`clearIncludeFilters()` احذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا.
`ITestDevice`	`getDevice()` احصل على الجهاز الخاضع للاختبار.
`Set<String>`	`getExcludeFilters()` تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.`Set`
`Set<String>`	`getIncludeFilters()` تعرِض هذه السمة `Set` فلاتر التضمين الحالية.
`List<String>`	`getModuleNames()` احصل على وحدة اختبار الأداء المدمجة في Android لتشغيلها.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` تُجري الاختبارات وتُبلغ المستمع بالنتيجة.
`void`	`setDevice(ITestDevice device)` أدخِل الجهاز الخاضع للاختبار.
`void`	`setReportRunName(String reportRunName)`

طُرق محمية
`CommandResult`	`executeCommand(ITestDevice testDevice, String cmd)` طريقة مساعدة لتنفيذ أمر اختبار قياس الأداء.
`String`	`getFilterFlagForFilters(Set<String> filters)`
`String`	`getFilterFlagForTests(Set<String> fitlererTests)`
`boolean`	`shouldSkipFile(String fullPath)` طريقة مساعدة لتحديد ما إذا كان يجب تخطّي تنفيذ ملف معيّن.

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

GoogleBenchmarkTest

public GoogleBenchmarkTest ()

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

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`

addModuleName

public void addModuleName (String moduleName)

أضِف وحدة اختبار قياس الأداء الأصلية لنظام التشغيل Android لتشغيلها.

المعلَمات
`moduleName`	`String`: اسم وحدة الاختبار المدمجة مع المحتوى التي سيتم تنفيذها

cleanFilter

public String cleanFilter (String filter)

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

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

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getDevice

public ITestDevice getDevice ()

احصل على الجهاز الخاضع للاختبار.

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

getExcludeFilters

public Set<String> getExcludeFilters ()

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

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

getIncludeFilters

public Set<String> getIncludeFilters ()

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

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

getModuleNames

public List<String> getModuleNames ()

احصل على وحدة اختبار الأداء المدمجة في Android لتشغيلها.

المرتجعات
`List<String>`	اسم وحدة الاختبار الأصلية التي سيتم تشغيلها، أو قيمة فارغة إذا لم يتم ضبطها

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

setDevice

public void setDevice (ITestDevice device)

أدخِل الجهاز الخاضع للاختبار.

المعلَمات
`device`	`ITestDevice`: `ITestDevice` المطلوب استخدامه

setReportRunName

public void setReportRunName (String reportRunName)

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

طُرق محمية

executeCommand

protected CommandResult executeCommand (ITestDevice testDevice, 
                String cmd)

طريقة مساعدة لتنفيذ أمر اختبار قياس الأداء. إذا كان الأمر طويلاً جدًا بحيث لا يمكن تنفيذه مباشرةً باستخدام adb، سيتم تنفيذه من خلال نص برمجي مؤقت.

المعلَمات
`testDevice`	‫`ITestDevice`: الجهاز الذي سيتم تنفيذ الأمر عليه
`cmd`	‫`String`: سلسلة الأوامر المطلوب تنفيذها

المرتجعات
`CommandResult`	ناتج shell إذا كان outputReceiver فارغًا

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

getFilterFlagForFilters

protected String getFilterFlagForFilters (Set<String> filters)

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

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

getFilterFlagForTests

protected String getFilterFlagForTests (Set<String> fitlererTests)

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

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

shouldSkipFile

protected boolean shouldSkipFile (String fullPath)

طريقة مساعدة لتحديد ما إذا كان يجب تخطّي تنفيذ ملف معيّن.

المعلَمات
`fullPath`	`String`: المسار الكامل للملف المعنيّ

المرتجعات
`boolean`	يتم ضبط القيمة على "true" إذا كان يجب تخطّي الملف المذكور.