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

‫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, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` طلب ردّ عند انتهاء حالة اختبار.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> 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, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

المعلَمات
`testData`	`DeviceMetricData`: ‏`DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار. سيكون هو الكائن نفسه الذي تم استخدامه أثناء `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testEnded(TestDescription,Map)`.

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

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

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

المعلَمات
`runData`	`DeviceMetricData`: ‏`DeviceMetricData` الذي يحتوي على بيانات التشغيل. سيكون هو الكائن نفسه الذي تم استخدامه أثناء `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `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`