BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

الفئات الفرعية المباشرة المعروفة AtraceCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector وCountTestCasesCollector وDebugHostLogOnFailureCollector وDeviceTraceCollector وFilePullerDeviceMetricCollector وGcovCodeCoverageCollector وGcovKernelCodeCoverageCollector وHostStatsdMetricCollector وJavaCodeCoverageCollector وLogcatOnFailureCollector وLogcatTimingMetricCollector وRebootReasonCollector وRuntimeRestartCollector وScreenshotOnFailureCollector AtraceCollector IMetricCollector التي تُجري عملية تتبُّع أثناء الاختبار وتجمع النتيجة وتُسجّلها في الطلب  BugreportzOnFailureCollector جمع تقرير أخطاء عند تعذُّر اختبار حالة  BugreportzOnTestCaseFailureCollector جمع تقرير أخطاء عند تعذُّر تنفيذ حالة اختبار في إحدى عمليات التشغيل  ClangCodeCoverageCollector BaseDeviceMetricCollector الذي سيستخرج قياسات تغطية Clang من الجهاز ويُسجّلها كعناصر اختبار  CodeCoverageCollector BaseDeviceMetricCollector لسحب قياسات التغطية الأصلية من Java و من الجهاز وتسجيلها كعناصر اختبار  CountTestCasesCollector احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ IRemoteTest معيّن  DebugHostLogOnFailureCollector أداة جمع ستجمع السجلات من جهة المضيف وتسجّلها عند حدوث خطأ في نموذج الاختبار.  DeviceTraceCollector أداة جمع البيانات التي ستبدأ عملية تتبُّع perfetto عند بدء عملية تشغيل الاختبار وستسجِّل ملف تتبُّع في النهاية.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.  GcovCodeCoverageCollector BaseDeviceMetricCollector الذي سيستخرج قياسات تغطية gcov من الجهاز ويُسجّلها كعناصر اختبار  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector التي ستسحب قياسات تغطية ملف kernel باستخدام gcov من debugfs وخارج الجهاز، ثم تسجّلها أخيرًا كعناصر اختبار  HostStatsdMetricCollector IMetricCollector تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd  JavaCodeCoverageCollector BaseDeviceMetricCollector التي ستسحب قياسات تغطية Java من الجهاز وتُسجّلها كعناصر اختبار  LogcatOnFailureCollector أداة جمع ستسجِّل logcat وتُسجِّله عند تعذُّر اختبار حالة معيّنة.  LogcatTimingMetricCollector أداة جمع مقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدّة اختبارات متكرّرة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والنهاية لحدث من أسطر logcat  RebootReasonCollector أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار وتُبلغ عنها حسب السبب والعدد.  RuntimeRestartCollector أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء التشغيل (أعطال خادم النظام) أثناء تنفيذ الاختبار ، إن وجدت.  ScreenshotOnFailureCollector أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.

الفئات الفرعية غير المباشرة المعروفة AtraceRunMetricCollector وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothHciSnoopLogCollector وFilePullerLogCollector وModuleLogcatCollector وPerfettoPullerMetricCollector وShowmapPullerMetricCollector وTraceCmdCollector AtraceRunMetricCollector يتم جمع عمليات التتبّع من جميع الدليل التجريبي ضمن الدليل المحدّد من الجهاز التجريبي، وتسجيل الدليل التجريبي ومعالجة ملفات التتبّع بعد تسجيلها ضمن الدليل التجريبي وتجميع المقاييس.  BluetoothConnectionLatencyCollector سيُرسِل أداة جمع البيانات إعدادات مقياس مدّة statsd المحدّدة مسبقًا إلى الأجهزة وسيجمع مدّة اتصال البلوتوث لكل ملف شخصي.  BluetoothConnectionStateCollector سيجمع هذا المجمّع مقاييس BluetoothConnectionStateChanged ويُسجّل حالة الاتصال رقمًا لكل ملف شخصي.  BluetoothHciSnoopLogCollector أداة جمع لتسجيل التطفل على واجهة وحدة تحكّم المضيف في بلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار  FilePullerLogCollector أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز  ModuleLogcatCollector إصدار أداة جمع سجلّات 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) الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ
void	invocationSkipped(SkipReason reason) الإبلاغ عن طلب استدعاء كطلب تم تخطّيه
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) يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.
void	onTestFail(DeviceMetricData testData, TestDescription test) يتمّ إجراء طلب إعادة الاتصال عند تعذُّر اختبار حالة معيّنة.
void	onTestModuleEnded() يسمح بتسجيل حدث انتهاء الوحدة.
void	onTestModuleStarted() يسمح بتسجيل حدث بدء الوحدة.
void	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) بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
final void	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.Ignore.
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) الإبلاغ عن نهاية عملية الاختبار
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	testSkipped(TestDescription test, SkipReason reason) يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
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 ()

الطرق العامة

extraInit

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، اسم عملية الاختبار الحالية.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

لا تلغي الإعدادات إلا إذا كنت متأكدًا من أنّك تعرف ما تفعله.

المعلمات
context	‫IInvocationContext: IInvocationContext للطلب قيد التنفيذ
listener	‫ITestInvocationListener: ITestInvocationListener حيث يتم وضع النتائج

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

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

invocationEnded

public final void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
elapsedTime	‫long: الوقت المنقضي منذ بدء الطلب بالملي ثانية

invocationFailed

public final void invocationFailed (FailureDescription failure)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
failure	FailureDescription: FailureDescription الذي يصف سبب تعذُّر التنفيذ

invocationFailed

public final void invocationFailed (Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
cause	Throwable: Throwable سبب الخطأ

invocationSkipped

public void invocationSkipped (SkipReason reason)

الإبلاغ عن طلب استدعاء كطلب تم تخطّيه

المعلمات
reason	SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

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

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

isDisabled

public final boolean isDisabled ()

تعرِض هذه الدالة القيمة True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك). خطأ بخلاف ذلك.

المرتجعات
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

ما إذا كان IDeviceActionReceiver غير مفعَّل أم لا

المرتجعات
boolean	عرض "صحيح" إذا كان غير مفعّل، و"خطأ" في الحالات الأخرى

logAssociation

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

onTestModuleEnded

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

rebootEnded

public void rebootEnded (ITestDevice device)

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

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

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

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

rebootStarted

public void rebootStarted (ITestDevice device)

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

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

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

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

setDisable

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 لوصف الخطأ وسياقه

testEnded

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: وقت انتهاء الاختبار، يتم قياسه من خلال System.currentTimeMillis()
testMetrics	: ERROR(/Map) من المقاييس التي تمّ قياسها

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.

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

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

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن تعذُّر اختبار فردي

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

المعلمات
test	TestDescription: لتحديد الاختبار
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testFailed

public final void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر اختبار فردي

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

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public final void testIgnored (TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

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

testLog

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

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

يجب الاتصال به قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

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

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

testLogSaved

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

لا تستخدِم داخل عملية جمع المقاييس. وهذا هو إعادة التوجيه الخالص.

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

testModuleEnded

public final void testModuleEnded ()

الإبلاغ عن نهاية تشغيل وحدة

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
moduleContext	IInvocationContext: IInvocationContext الوحدة

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

الإبلاغ عن نهاية عملية الاختبار

المعلمات
elapsedTime	‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية
runMetrics	: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

المعلمات
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testRunFailed

public final void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

المعلمات
errorMessage	String: String يصف سبب تعذُّر التنفيذ

testRunStarted

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

الإبلاغ عن بدء عملية اختبار

المعلمات
runName	String: اسم اختبار التنفيذ
testCount	int: إجمالي عدد الاختبارات في اختبار التنفيذ
attemptNumber	int: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة تتم فيها عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عدد عمليات التشغيل 4 عمليات ضمن اسم التشغيل نفسه وأن تتراوح مَعلمة attemptNumber بين 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: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة يتمّ فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عمليات التشغيل التي تمّ إجراؤها 4 مرّات ضمن اسم التشغيل نفسه، ويجب أن تتراوح مَعلمة attemptNumber بين 0 و3.
startTime	long: وقت بدء التنفيذ، يتم قياسه من خلال System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.

TODO: currently unused, consider removing

المعلمات
elapsedTime	‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة إجراء هذه الاختبارات لمحاولة تنفيذها بشكلٍ سليم.

المعلمات
test	TestDescription: لتحديد الاختبار
reason	SkipReason: SkipReason

testStarted

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: وقت بدء الاختبار، يتم قياسه من خلال System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

طلبات معاودة الاتصال لحالات الاختبار

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