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

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

MetricUtility

public class MetricUtility
extends Object

java.lang.Object
↳	com.android.tradefed.util.MetricUtility

يحتوي على طُرق أدوات شائعة لتخزين مقاييس الاختبار وتجميع المقاييس في اختبارات مشابهة وكتابة المقاييس في ملف.

ملخّص

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

الطرق العامة
	`aggregateMetrics( rawMetrics)` تجميع المقاييس المفصولة بفواصل
`File`	`aggregateStoredTestMetricsAndWriteToFile(String runName)` تجميع المقاييس التي تم جمعها من عدّة تكرارات للاختبار وكتابة المقاييس المجمّعة في ملف نتائج الاختبار
`static`	`getStats( values, percentiles)` احتساب الإحصاءات من قائمة القيم المحدّدة
	`getStoredTestMetric()`
`static boolean`	`isAllDoubleValues( rawValues)` عرض القيمة "صحيح" إذا كان بالإمكان تحليل جميع القيم إلى قيمة مزدوجة
`void`	`setIterationSeparator(String separator)`
`void`	`setPercentiles( percentiles)`
`void`	`storeTestMetrics(TestDescription testDescription, testMetrics)` يُستخدَم لتخزين مقاييس الاختبار الفردية واستخدامها للتجميع.
`File`	`writeResultsToFile(String testFileSuffix, String testHeaderName, metrics, File resultsFile)` كتابة المقاييس في ملف

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

MetricUtility

public MetricUtility ()

الطرق العامة

aggregateMetrics

public  aggregateMetrics ( rawMetrics)

تجميع المقاييس المفصولة بفواصل

المعلمات
`rawMetrics`	: المقاييس التي تم جمعها أثناء إجراء الاختبار

المرتجعات
	المقاييس المجمّعة

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String runName)

تجميع المقاييس التي تم جمعها من عدّة تكرارات للاختبار وكتابة المقاييس المجمّعة في ملف نتائج الاختبار

المعلمات
`runName`	`String`: اسم اختبار التنفيذ

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

getStats

public static  getStats ( values, 
                 percentiles)

احتساب الإحصاءات من قائمة القيم المحدّدة

المعلمات
`values`	: القيم الأوّلية لاحتساب التجميع.
`percentiles`	: الإحصاءات المطلوب تضمينها في المقاييس النهائية

المرتجعات
	القيم المجمّعة

getStoredTestMetric

public  getStoredTestMetric ()

المرتجعات

isAllDoubleValues

public static boolean isAllDoubleValues ( rawValues)

عرض القيمة "صحيح" إذا كان بالإمكان تحليل جميع القيم إلى قيمة مزدوجة بخلاف ذلك، يتم عرض القيمة false.

المعلمات
`rawValues`	: قائمة يتم التحقّق من قيمها.

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

setIterationSeparator

public void setIterationSeparator (String separator)

المعلمات
`separator`	`String`

setPercentiles

public void setPercentiles ( percentiles)

المعلمات
`percentiles`

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                 testMetrics)

يُستخدَم لتخزين مقاييس الاختبار الفردية واستخدامها للتجميع.

المعلمات
`testDescription`	‫`TestDescription`: يحتوي على تفاصيل الاختبار، مثل اسم الفئة واسم الاختبار.
`testMetrics`	: المقاييس التي تم جمعها للاختبار

writeResultsToFile

public File writeResultsToFile (String testFileSuffix, 
                String testHeaderName, 
                 metrics, 
                File resultsFile)

كتابة المقاييس في ملف

المعلمات
`testFileSuffix`	`String`: تُستخدَم كلاحقة في اسم ملف مقياس الاختبار.
`testHeaderName`	`String`: سيتمّ كتابة المقاييس ضمن اسم عنوان الاختبار.
`metrics`	‫: للكتابة في الملف
`resultsFile`	`File`: إذا كان القيمة فارغة، أنشئ ملفًا جديدًا واكتب المقاييس، وإلا أضِف اسم رأس الاختبار ومقاييسه إلى الملف.

المرتجعات
`File`	ملف يحتوي على المقياس