اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

GoogleBenchmarkTest

public class GoogleBenchmarkTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

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

ملخّص

وظائف الإنشاء العامة
`GoogleBenchmarkTest()`

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

الطرق المحمية
`CommandResult`	`executeCommand(ITestDevice testDevice, String cmd)` طريقة مساعدة لتشغيل أمر benchmarktest
`String`	`getFilterFlagForFilters( filters)`
`String`	`getFilterFlagForTests( fitlererTests)`
`boolean`	`shouldSkipFile(String fullPath)` طريقة مساعدة لتحديد ما إذا كان علينا تخطّي تنفيذ ملف معيّن.

وظائف الإنشاء العامة

GoogleBenchmarkTest

public GoogleBenchmarkTest ()

الطرق العامة

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`

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

عرض ERROR(/Set) الحالي لفلاتر الاستبعاد

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

عرض ERROR(/Set) الحالي لفلاتر التضمين

المرتجعات

getModuleNames

public  getModuleNames ()

شغِّل وحدة اختبار الأداء الأصلي على Android.

المرتجعات
	اسم وحدة الاختبار الأصلية المطلوب تشغيلها، أو قيمة فارغة في حال عدم ضبطها

ضربة طويلة

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)

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

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

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

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

getFilterFlagForFilters

protected String getFilterFlagForFilters ( filters)

المعلمات
`filters`

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

getFilterFlagForTests

protected String getFilterFlagForTests ( fitlererTests)

المعلمات
`fitlererTests`

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

shouldSkipFile

protected boolean shouldSkipFile (String fullPath)

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

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

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