BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector , IDeviceActionReceiver

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

الفئات الفرعية المباشرة المعروفة AtraceCollector ، BugreportzOnFailureCollector ، BugreportzOnTestCaseFailureCollector ، ClangCodeCoverageCollector ، CountTestCasesCollector ، DebugHostLogOnFailureCollector ، DeviceTraceCollector ، FilePullerDevlector . odeCoverageCollector ، HostStatsdMetricCollector ، JavaCodeCoverageCollector ، LogcatOnFailureCollector ، LogcatTimingMetricCollector ، RebootReasonCollector ، RuntimeRestartCollector ، ScreenshotOnFailureCollector ، LogcatTimingMetricCollector ، RebootReasonCollector ، RuntimeRestartCollector ، ScreenshotOnFailureCollector جامع أتراس IMetricCollector يقوم بتشغيل atrace أثناء الاختبار ويجمع النتيجة ويسجلها في الاستدعاء. جامع BugreportzOnFailure اجمع تقرير الأخطاء عند فشل حالة الاختبار. BugreportzOnTestCaseFailureCollector اجمع تقرير bugreportz عند فشل حالة الاختبار في التشغيل. ClangCodeCoverageCollector BaseDeviceMetricCollector الذي سيسحب قياسات تغطية Clang من الجهاز ويسجلها كعناصر اختبار. CountTestCasesCollector قم بحساب عدد حالات الاختبار الخاصة باختبار IRemoteTest المحدد والإبلاغ عنها. DebugHostLogOnFailureCollector المُجمع الذي سيقوم بجمع وتسجيل سجلات جانب المضيف عند حدوث فشل في حالة الاختبار. DeviceTraceCollector المُجمع الذي سيبدأ تتبع perfetto عند بدء تشغيل اختباري وتسجيل ملف التتبع في النهاية. FilePullerDeviceMetricCollector BaseDeviceMetricCollector الذي يستمع لمفتاح المقاييس القادم من الجهاز ويسحبها كملف من الجهاز. جامع GcovCodeCoverage BaseDeviceMetricCollector الذي سيسحب قياسات تغطية gcov من الجهاز ويسجلها كعناصر اختبار. جامع GcovKernelCodeCodeCoverage BaseDeviceMetricCollector الذي سيسحب قياسات تغطية gcov kernel من debugfs وإخراجها من الجهاز ثم يسجلها أخيرًا كعناصر اختبار. HostStatsdMetricCollector IMetricCollector يجمع مقاييس statsd من جانب المضيف باستخدام أوامر الأداة المساعدة statsd. JavaCodeCoverageCollector BaseDeviceMetricCollector الذي سيسحب قياسات تغطية Java من الجهاز ويسجلها كعناصر اختبار. جامع LogcatOnFailure المُجمع الذي سيقوم بالتقاط وتسجيل logcat عند فشل حالة الاختبار. LogcatTimingMetricCollector أداة تجميع المقاييس التي تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدة اختبارات متكررة باستخدام أنماط regex معينة لتحليل إشارات البداية والنهاية لحدث ما من خطوط logcat. RebootReasonCollector أداة التجميع التي تجمع إعادة تشغيل الجهاز أثناء التشغيل التجريبي والإبلاغ عنها حسب السبب والأهم. وقت التشغيل المُجمع الذي يجمع الطوابع الزمنية لإعادة تشغيل وقت التشغيل (تعطل خادم النظام) أثناء التشغيل التجريبي ، إن وجد. لقطة شاشة OnFailureCollector المُجمع الذي سيقوم بالتقاط وتسجيل لقطة شاشة عند فشل حالة الاختبار.

الفئات الفرعية غير المباشرة المعروفة AtraceRunMetricCollector ، BluetoothConnectionLatencyCollector ، BluetoothConnection StateCollector ، BluetoothHciSnoopLogCollector ، FilePullerLogCollector ، ModuleLogcatCollector ، PerfettoPullerMetricCollector ، ShowmapPullerMetricCollector ، TramapPullerMetricCollector جامع AtraceRunMetric يجمع التتبع من كل دليل الاختبار ضمن الدليل المحدد من جهاز الاختبار ، ويسجل دليل الاختبار ويعالج ملفات التتبع تحت دليل الاختبار ويجمع المقاييس. BluetoothConnectionLatencyCollector سيقوم المُجمع بدفع تكوين قياس المدة statsd المحدد مسبقًا إلى الأجهزة ويجمع مدة اتصال Bluetooth لكل ملف تعريف. BluetoothConnectionStateCollector سيجمع هذا المجمع مقاييس BluetoothConnectionStateChanged ويسجل رقم حالة الاتصال لكل ملف تعريف. جامع BluetoothHciSnoopLogCollector أداة التجميع لتمكين تسجيل التطفل عبر Bluetooth HCI على DUT وتجميع السجل لكل اختبار. FilePullerLogCollector مسجل الملف المبلغ عنه من جانب الجهاز. الوحدة النمطية LogcatCollector إصدار جامع logcat لكن للوحدة النمطية. PerfettoPullerMetricCollector التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه. ShowmapPullerMetricCollector. العرض التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه. TraceCmdCollector IMetricCollector يقوم بتجميع التتبع أثناء الاختبار باستخدام trace-cmd ، ويسجلها في الاستدعاء.

---

التنفيذ الأساسي لـ IMetricCollector الذي يسمح ببدء وإيقاف التجميع على onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) و ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .

ملخص

مجالات
public static final String	TEST_CASE_EXCLUDE_GROUP_OPTION
public static final String	TEST_CASE_INCLUDE_GROUP_OPTION

المنشأت العامة
BaseDeviceMetricCollector ()

الأساليب العامة
void	extraInit ( IInvocationContext context, ITestInvocationListener listener)
final	getBuildInfos () إرجاع قائمة معلومات البناء المتوفرة في الاستدعاء.
final	getDevices () إرجاع قائمة الأجهزة المتوفرة في الاستدعاء.
File	getFileFromTestArtifacts (String fileName) استرجع الملف من أدوات الاختبار أو عناصر الوحدة النمطية وقم بتخزينه مؤقتًا في خريطة للمكالمات اللاحقة.
final ITestInvocationListener	getInvocationListener () إرجاع ITestInvocationListener الأصلي حيث نقوم بإعادة توجيه النتائج.
String	getModuleName ()
final	getRealDevices () تُرجع جميع الأجهزة التي لا تحتوي على كعب روتين من قائمة getDevices() .
String	getRunName () تُرجع اسم التشغيل التجريبي mRunName الذي يقوم بتشغيل المُجمع.
final ITestInvocationListener	init ( IInvocationContext context, ITestInvocationListener listener) تهيئة المُجمع مع السياق الحالي ومكان إعادة توجيه النتائج.
final void	invocationEnded (long elapsedTime) التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.
final void	invocationFailed ( FailureDescription failure) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.
final void	invocationFailed (Throwable cause) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.
final void	invocationStarted ( IInvocationContext context) مستمعي الدعاء لإعادة التوجيه
final boolean	isDisabled () إرجاع True إذا تم تعطيل الكائن بالكامل (تخطي كل من الإعداد والتفكيك).
boolean	isDisabledReceiver () ما إذا كان IDeviceActionReceiver معطلاً أم لا.
final void	logAssociation (String dataName, LogFile logFile) لا تستخدم داخل تنفيذ المجمع المتري.
void	onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test) رد الاتصال عندما تفشل حالة الاختبار مع فشل الافتراض.
void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) رد الاتصال عند انتهاء حالة الاختبار.
void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) رد الاتصال عند انتهاء حالة الاختبار.
void	onTestFail ( DeviceMetricData testData, TestDescription test) رد الاتصال عند فشل حالة الاختبار.
void	onTestModuleEnded () يسمح بالتقاط وحدة الحدث المنتهية.
void	onTestModuleStarted () يسمح بالتقاط حدث بدء الوحدة النمطية.
void	onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) رد عند انتهاء تشغيل اختباري.
void	onTestRunFailed ( DeviceMetricData testData, FailureDescription failure) رد الاتصال لأحداث testRunFailed
void	onTestRunStart ( DeviceMetricData runData) رد الاتصال عند بدء تشغيل اختباري.
void	onTestStart ( DeviceMetricData testData) رد الاتصال عند بدء حالة الاختبار.
void	rebootEnded ( ITestDevice device) يحصل على إشعار عند انتهاء إعادة التشغيل في الجهاز.
void	rebootStarted ( ITestDevice device) يحصل على إشعار عند بدء إعادة التشغيل في الجهاز.
final void	setDisable (boolean isDisabled) يحدد ما إذا كان يجب تعطيل الكائن.
void	setDisableReceiver (boolean isDisabled) يحدد ما إذا كان يجب تعطيل IDeviceActionReceiver .
final void	setLogSaver ( ILogSaver logSaver) لا تستخدم داخل تنفيذ المجمع المتري.
final void	testAssumptionFailure ( TestDescription test, String trace) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
final void	testAssumptionFailure ( TestDescription test, FailureDescription failure) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
final void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) بديل لـ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرة.
final void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) يُبلغ عن نهاية تنفيذ حالة اختبار فردية.
final void	testFailed ( TestDescription test, FailureDescription failure) يبلغ عن فشل حالة الاختبار الفردية.
final void	testFailed ( TestDescription test, String trace) يبلغ عن فشل حالة الاختبار الفردية.
final void	testIgnored ( TestDescription test) يتم استدعاؤه في حالة عدم إجراء اختبار ، بشكل عام بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.
final void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) يوفر السجل المرتبط أو بيانات التصحيح من استدعاء الاختبار.
final void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) لا تستخدم داخل تنفيذ المجمع المتري.
final void	testModuleEnded () تقارير نهاية تشغيل الوحدة النمطية.
final void	testModuleStarted ( IInvocationContext moduleContext) تقارير بداية تشغيل وحدة نمطية.
final void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) يبلغ عن نهاية التشغيل التجريبي.
final void	testRunFailed ( FailureDescription failure) فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription .
final void	testRunFailed (String errorMessage) تقارير فشل التشغيل الاختباري بسبب خطأ فادح.
final void	testRunStarted (String runName, int testCount, int attemptNumber) يعلن عن بدء تشغيل اختباري.
final void	testRunStarted (String runName, int testCount) اختبار تشغيل عمليات الاسترجاعات
final void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) يعلن عن بدء تشغيل اختباري.
final void	testRunStopped (long elapsedTime) تم إيقاف تشغيل اختبار التقارير قبل الإكمال بناءً على طلب المستخدم.
final void	testStarted ( TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت بدء الاختبار ، جنبًا إلى جنب مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لقياس دقيق .
final void	testStarted ( TestDescription test) حالات الاختبار

مجالات

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

المنشأت العامة

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

الأساليب العامة

إكستراينت

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

رميات
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

إرجاع قائمة معلومات البناء المتوفرة في الاستدعاء.

عائدات

getDevices

public final  getDevices ()

إرجاع قائمة الأجهزة المتوفرة في الاستدعاء.

عائدات

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

استرجع الملف من أدوات الاختبار أو عناصر الوحدة النمطية وقم بتخزينه مؤقتًا في خريطة للمكالمات اللاحقة.

حدود
fileName	String : اسم الملف المراد البحث عنه في القطع الأثرية.

عائدات
File	ملف من قطعة أثرية للاختبار أو قطعة أثرية للوحدة. ترجع فارغة إذا لم يتم العثور على الملف.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

إرجاع ITestInvocationListener الأصلي حيث نقوم بإعادة توجيه النتائج.

عائدات
ITestInvocationListener

getModuleName

public String getModuleName ()

عائدات
String

getRealDevices

public final  getRealDevices ()

تُرجع جميع الأجهزة التي لا تحتوي على كعب روتين من قائمة getDevices() .

عائدات

getRunName

public String getRunName ()

تُرجع اسم التشغيل التجريبي mRunName الذي يقوم بتشغيل المُجمع.

عائدات
String	mRunName ، اسم التشغيل التجريبي الحالي.

فيه

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

لا تتجاوز ما لم تكن تعرف ما تفعله.

حدود
context	IInvocationContext : IInvocationContext للاستدعاء قيد التقدم.
listener	ITestInvocationListener : ITestInvocationListener حيث يتم وضع النتائج.

عائدات
ITestInvocationListener	المستمع الجديد يلتف الأصلي.

رميات
DeviceNotAvailableException

انتهى الدعاء

public final void invocationEnded (long elapsedTime)

التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

حدود
elapsedTime	long : الوقت المنقضي للاستدعاء بالمللي ثانية

الدعاء فشل

public final void invocationFailed (FailureDescription failure)

يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

حدود
failure	FailureDescription : FailureDescription في وصف سبب الفشل

الدعاء فشل

public final void invocationFailed (Throwable cause)

يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

حدود
cause	Throwable : سبب ERROR(/Throwable) للفشل

بدأ الاحتجاج

public final void invocationStarted (IInvocationContext context)

مستمعي الدعاء لإعادة التوجيه

حدود
context	IInvocationContext : معلومات حول الاستدعاء

معطل

public final boolean isDisabled ()

إرجاع True إذا تم تعطيل الكائن بالكامل (تخطي كل من الإعداد والتفكيك). خطأ خلاف ذلك.

عائدات
boolean

المتلقي

public boolean isDisabledReceiver ()

ما إذا كان IDeviceActionReceiver معطلاً أم لا.

عائدات
boolean	إرجاع صحيح إذا تم تعطيل ، خطأ خلاف ذلك.

جمعية السجل

public final void logAssociation (String dataName, 
                LogFile logFile)

لا تستخدم داخل تنفيذ المجمع المتري. هذا محض إعادة توجيه.

حدود
dataName	String : اسم البيانات
logFile	LogFile : LogFile الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

رد الاتصال عندما تفشل حالة الاختبار مع فشل الافتراض.

حدود
testData	DeviceMetricData : يحتفظ DeviceMetricData ببيانات حالة الاختبار.
test	TestDescription : TestDescription لحالة الاختبار قيد التقدم.

رميات
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

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

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

رميات
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

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

رد الاتصال عند فشل حالة الاختبار.

حدود
testData	DeviceMetricData : يحتفظ DeviceMetricData ببيانات حالة الاختبار.
test	TestDescription : TestDescription لحالة الاختبار قيد التقدم.

رميات
DeviceNotAvailableException

انتهى onTestModule

public void onTestModuleEnded ()

يسمح بالتقاط وحدة الحدث المنتهية.

رميات
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

يسمح بالتقاط حدث بدء الوحدة النمطية.

رميات
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

رميات
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

رد الاتصال لأحداث testRunFailed

رميات
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

رد الاتصال عند بدء تشغيل اختباري.

حدود
runData	DeviceMetricData : يحتفظ DeviceMetricData بالبيانات للتشغيل.

رميات
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

رد الاتصال عند بدء حالة الاختبار.

حدود
testData	DeviceMetricData : يحتفظ DeviceMetricData ببيانات حالة الاختبار.

رميات
DeviceNotAvailableException

انتهى

public void rebootEnded (ITestDevice device)

يحصل على إشعار عند انتهاء إعادة التشغيل في الجهاز.

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

حدود
device	ITestDevice : ITestDevice الذي انتهت فيه إعادة التشغيل.

رميات
DeviceNotAvailableException

إعادة التشغيل

public void rebootStarted (ITestDevice device)

يحصل على إشعار عند بدء إعادة التشغيل في الجهاز.

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

حدود
device	ITestDevice : ITestDevice الذي بدأت منه إعادة التشغيل.

رميات
DeviceNotAvailableException

تعيين تعطيل

public final void setDisable (boolean isDisabled)

يحدد ما إذا كان يجب تعطيل الكائن. معطل يعني أنه يجب تخطي كل من خطوات الإعداد والتفكيك. يمكن استخدامه لتعطيل كائن افتراضيًا في المُنشئ الافتراضي.

حدود
isDisabled	boolean : الحالة التي يجب وضع الكائن فيها.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

يحدد ما إذا كان يجب تعطيل IDeviceActionReceiver . يعني التعطيل أنه لن يتم تسجيله على الجهاز لاستقبال أحداث إجراءات الجهاز.

حدود
isDisabled	boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

لا تستخدم داخل تنفيذ المجمع المتري. هذا محض إعادة توجيه.

حدود
logSaver	ILogSaver : ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ

حدود
test	TestDescription : يحدد الاختبار
trace	String : كومة تتبع الفشل

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ

حدود
test	TestDescription : يحدد الاختبار
failure	FailureDescription : FailureDescription يصف الفشل وسياقه.

انتهى الاختبار

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

بديل لـ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرة. ادمج مع testStarted(com.android.tradefed.result.TestDescription, long) لقياس دقيق.

حدود
test	TestDescription : يحدد الاختبار
endTime	long : الوقت الذي انتهى فيه الاختبار ، تم قياسه عبر ERROR(/System#currentTimeMillis())
testMetrics	: ERROR(/Map) المقاييس المنبعثة

انتهى الاختبار

public final void testEnded (TestDescription test, 
                 testMetrics)

يُبلغ عن نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription) ، فإن هذا الاختبار نجح. يُرجع أيضًا أي مقاييس مفتاح / قيمة قد تكون انبعثت أثناء تنفيذ حالة الاختبار.

حدود
test	TestDescription : يحدد الاختبار
testMetrics	: ERROR(/Map) المقاييس المنبعثة

فشل الاختبار

public final void testFailed (TestDescription test, 
                FailureDescription failure)

يبلغ عن فشل حالة الاختبار الفردية.

سيتم استدعاؤه بين testStarted و testEnded.

حدود
test	TestDescription : يحدد الاختبار
failure	FailureDescription : FailureDescription يصف الفشل وسياقه.

فشل الاختبار

public final void testFailed (TestDescription test, 
                String trace)

يبلغ عن فشل حالة الاختبار الفردية.

سيتم استدعاؤه بين testStarted و testEnded.

حدود
test	TestDescription : يحدد الاختبار
trace	String : كومة تتبع الفشل

test تم تجاهله

public final void testIgnored (TestDescription test)

يتم استدعاؤه في حالة عدم إجراء اختبار ، بشكل عام بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.

حدود
test	TestDescription : يحدد الاختبار

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

يوفر السجل المرتبط أو بيانات التصحيح من استدعاء الاختبار.

يجب استدعاء قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيقوم إطار عمل TradeFederation باستدعاء هذه الطريقة تلقائيًا ، مع توفير سجل المضيف وإذا أمكن ، تسجيل الجهاز.

حدود
dataName	String : ERROR(/String) اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم dataName فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات
dataType	LogDataType : LogDataType للبيانات
dataStream	InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog.

testLog تم الحفظ

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

لا تستخدم داخل تنفيذ المجمع المتري. هذا محض إعادة توجيه.

حدود
dataName	String : ERROR(/String) اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم dataName فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات
dataType	LogDataType : LogDataType للبيانات
dataStream	InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء.
logFile	LogFile : LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ.

انتهى الاختبار

public final void testModuleEnded ()

تقارير نهاية تشغيل الوحدة النمطية.

testModule بدأ

public final void testModuleStarted (IInvocationContext moduleContext)

تقارير بداية تشغيل وحدة نمطية. ترتبط رد الاتصال هذا بـ testModuleEnded() وهي اختيارية في التسلسل. يتم استخدامه فقط أثناء الجري الذي يستخدم الوحدات النمطية: المتسابقون القائمون على الجناح.

حدود
moduleContext	IInvocationContext : IInvocationContext للوحدة النمطية.

انتهى الاختبار

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.

حدود
elapsedTime	long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية
runMetrics	: تم الإبلاغ عن أزواج المفتاح والقيمة في نهاية تشغيل اختباري باستخدام Metric .

testRunFailed

public final void testRunFailed (FailureDescription failure)

فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription .

حدود
failure	FailureDescription : FailureDescription يصف الفشل وسياقه.

testRunFailed

public final void testRunFailed (String errorMessage)

تقارير فشل التشغيل الاختباري بسبب خطأ فادح.

حدود
errorMessage	String : ERROR(/String) تصف سبب فشل التشغيل.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

يعلن عن بدء تشغيل اختباري.

حدود
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي
attemptNumber	int : رقم الطلب ، يحدد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

اختبار تشغيل عمليات الاسترجاعات

حدود
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

يعلن عن بدء تشغيل اختباري.

حدود
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي
attemptNumber	int : رقم الطلب ، يحدد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.
startTime	long : الوقت الذي بدأ فيه التشغيل ، تم قياسه عبر ERROR(/System#currentTimeMillis())

testRunStopped

public final void testRunStopped (long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل الإكمال بناءً على طلب المستخدم.

TODO: غير مستخدم حاليًا ، جرب الإزالة

حدود
elapsedTime	long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية

اختبار

public final void testStarted (TestDescription test, 
                long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت بدء الاختبار ، جنبًا إلى جنب مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لقياس دقيق .

حدود
test	TestDescription : يحدد الاختبار
startTime	long : الوقت الذي بدأ فيه الاختبار ، تم قياسه عبر ERROR(/System#currentTimeMillis())

اختبار

public final void testStarted (TestDescription test)

حالات الاختبار

حدود
test	TestDescription : يحدد الاختبار