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

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

DeviceTraceCollector

public class DeviceTraceCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.DeviceTraceCollector

أداة تجميع ستبدأ تتبُّع Perfetto عند بدء تشغيل الاختبار وتسجيل ملف التتبُّع في النهاية.

ملخّص

الإنشاءات العامة
`DeviceTraceCollector()`

الطُرق العامة
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` يتم تنفيذ هذا الإجراء عند انتهاء حالة الاختبار.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار.
`void`	`onTestStart(DeviceMetricData testData)` يتم تنفيذ هذا الإجراء عند بدء حالة اختبار.
`void`	`rebootEnded(ITestDevice device)` تلقّي إشعار عند انتهاء عملية إعادة التشغيل على الجهاز
`void`	`rebootStarted(ITestDevice device)` تلقّي إشعار عند بدء إعادة التشغيل على الجهاز
`void`	`setInstrumentationPkgName(String packageName)`

الإنشاءات العامة

DeviceTraceCollector

public DeviceTraceCollector ()

الطُرق العامة

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

الرميات
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

يتم تنفيذ هذا الإجراء عند انتهاء حالة الاختبار. يجب أن يكون هذا هو وقت التنظيف.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`

الرميات
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار. يجب أن يكون هذا هو وقت التنظيف.

المعلمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على البيانات الخاصة بعملية التشغيل سيكون الكائن نفسه كما كان خلال `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ERROR(/#testRunEnded(long,Map))`

الرميات
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

يتم تنفيذ هذا الإجراء عند بدء حالة اختبار.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار

الرميات
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

تلقّي إشعار عند انتهاء عملية إعادة التشغيل على الجهاز

ملاحظة: يجب على أجهزة الاستقبال تجنُّب إعادة التشغيل أثناء معاودة الاتصال هذه. وسيتم تجاهل أي محاولة لإعادة التشغيل.

المعلمات
`device`	‫`ITestDevice`: `ITestDevice` حيث انتهت عملية إعادة التشغيل

الرميات
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

تلقّي إشعار عند بدء إعادة التشغيل على الجهاز

المعلمات
`device`	`ITestDevice`: `ITestDevice` حيث بدأت عملية إعادة التشغيل

الرميات
`DeviceNotAvailableException`

setInstrumentationPkgName

public void setInstrumentationPkgName (String packageName)

المعلمات
`packageName`	`String`