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

ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.proto.ProtoResultReporter

الفئات الفرعية المباشرة المعروفة

FileProtoResultReporter، StreamProtoResultReporter

FileProtoResultReporter	مُبلِّغ Proto الذي يملأ `TestRecord` في ملف.
StreamProtoResultReporter	تنفيذ `ProtoResultReporter`

أنشأ الشخص الذي أبلغ عن النتائج نموذجًا أوّليًا لـ TestRecord يحتوي على جميع النتائج بداخلها. يجب أن يكون تم تمديده ليتعامل مع ما يجب فعله بالنموذج الأولي في processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord).

ملخّص

شركة إنشاءات عامة
`ProtoResultReporter()`

الطرق العامة
`final void`	`invocationEnded(long elapsedTime)` البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.
`void`	`invocationFailed(FailureDescription failure)` تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
`void`	`invocationFailed(Throwable cause)` تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
`void`	`invocationSkipped(SkipReason reason)` يتم الإبلاغ عن استدعاء على أنّه تم تخطّيه.
`final void`	`invocationStarted(IInvocationContext context)` يبلِّغ عن بدء الاستدعاء للاختبار.
`final void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` المباشر لا يمكن معاودة الاتصال.
`void`	`processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)` استخدِم سجلّ الاستدعاء لإرسال جميع السجلّات النهائية للاستدعاء الواحد تلو الآخر.
`void`	`processFinalProto(TestRecordProto.TestRecord finalRecord)` التعامل مع النموذج الأولي مع جميع النتائج.
`void`	`processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)` التعامل مع النموذج الأوّلي لسجلّ اختبار الاستدعاء الجزئي بعد حدوث `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
`void`	`processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)` التعامل مع النموذج الأولي لسجل حالة الاختبار النهائي بعد حدوث `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))`.
`void`	`processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)` التعامل مع النموذج الأولي لسجل حالة الاختبار الجزئي بعد حدوث `testStarted(com.android.tradefed.result.TestDescription, long)`.
`void`	`processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)` التعامل مع النموذج الأولي لسجل الوحدة النهائي بعد حدوث `testModuleEnded()`.
`void`	`processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)` التعامل مع النموذج الأولي لسجل الوحدة الجزئي بعد حدوث `testModuleStarted(com.android.tradefed.invoker.IInvocationContext)`.
`void`	`processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)` التعامل مع النموذج الأولي لسجلّ التشغيل النهائي بعد `ERROR(/#testRunEnded(long,HashMap))` حدث.
`void`	`processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)` التعامل مع النموذج الأوّلي لسجلّ إجراء الاختبار الجزئي بعد `testRunStarted(String, int)` حدث.
`void`	`setGranularResults(boolean granularResults)`
`void`	`setInlineRecordOfChildren(boolean inline)`
`boolean`	`supportGranularResults()` عرض "صحيح" إذا كان المبلِّغ يدعم النتائج الدقيقة، أو يعرض "خطأ" في الحالات الأخرى.
`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))` حيث يمكننا تحديد وقت الانتهاء مباشرةً.
`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.تجاهل.
`final void`	`testModuleEnded()` تقدم تقريرًا بنهاية تشغيل وحدة.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` تبلغ عن بداية وحدة قيد التشغيل.
`final void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` نهاية تشغيل اختبار التقارير
`final void`	`testRunFailed(FailureDescription failure)` تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` تعذّر إكمال عملية اختبار التقارير بسبب خطأ فادح.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` تبلّغ عن بدء إجراء اختبار.
`final void`	`testRunStarted(String runName, int testCount)` تبلّغ عن بدء إجراء اختبار.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` تبلّغ عن بدء إجراء اختبار.
`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)` تعمل على الإبلاغ عن بداية حالة اختبار فردية.

الطرق المحمية
`TestRecordProto.ChildReference`	`createModuleChildReference(TestRecordProto.TestRecord record)` تنشئ مرجعًا فرعيًا لوحدة معيّنة.

شركة إنشاءات عامة

ProtoResultReporter

public ProtoResultReporter ()

الطرق العامة

تم إنهاء الاستدعاء

public final void invocationEnded (long elapsedTime)

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

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

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

تعذّر الاستدعاء

public void invocationFailed (FailureDescription failure)

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

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

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

تعذّر الاستدعاء

public void invocationFailed (Throwable cause)

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

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

المعلمات
`cause`	`Throwable`: السبب `Throwable` للتعذُّر

تم تخطّي الاستدعاء

public void invocationSkipped (SkipReason reason)

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

المعلمات
`reason`	`SkipReason`

تم بدء الاستدعاء

public final void invocationStarted (IInvocationContext context)

يبلِّغ عن بدء الاستدعاء للاختبار.

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

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

مؤسسة Log Association

public final void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) المباشر لا يمكن معاودة الاتصال. وبالتالي، تسمح معاودة الاتصال هذه بتوفير ارتباط قوي بشكل صريح.

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

ProcessFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

استخدِم سجلّ الاستدعاء لإرسال جميع السجلّات النهائية للاستدعاء الواحد تلو الآخر.

المعلمات
`invocationLogs`	`TestRecordProto.TestRecord`: النموذج النهائي الذي يمثل الاستدعاء.

ProcessFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

التعامل مع النموذج الأولي مع جميع النتائج.

المعلمات
`finalRecord`	`TestRecordProto.TestRecord`: النموذج النهائي الذي يتضمّن جميع نتائج الاستدعاء

استدعاء بدء العملية

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

التعامل مع النموذج الأوّلي لسجلّ اختبار الاستدعاء الجزئي بعد حدوث invocationStarted(com.android.tradefed.invoker.IInvocationContext).

المعلمات
`invocationStartRecord`	`TestRecordProto.TestRecord`: النموذج الأوّلي الجزئي الذي تمت تعبئته بعد invocationStart.
`invocationContext`	`IInvocationContext`: الاستدعاء `IInvocationContext`

ProcessTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

التعامل مع النموذج الأولي لسجل حالة الاختبار النهائي بعد حدوث ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).

المعلمات
`testCaseRecord`	`TestRecordProto.TestRecord`: النموذج النهائي الذي يمثل حالة اختبار.

ProcessTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

التعامل مع النموذج الأولي لسجل حالة الاختبار الجزئي بعد حدوث testStarted(com.android.tradefed.result.TestDescription, long).

المعلمات
`testCaseStartedRecord`	`TestRecordProto.TestRecord`: النموذج الأوّلي الجزئي الذي يمثل حالة الاختبار.

ProcessTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

التعامل مع النموذج الأولي لسجل الوحدة النهائي بعد حدوث testModuleEnded().

المعلمات
`moduleRecord`	`TestRecordProto.TestRecord`: النموذج النهائي الذي يمثل الوحدة.

عمليةProcessTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

التعامل مع النموذج الأولي لسجل الوحدة الجزئي بعد حدوث testModuleStarted(com.android.tradefed.invoker.IInvocationContext).

المعلمات
`moduleStartRecord`	`TestRecordProto.TestRecord`: النموذج الأولي الجزئي الذي يمثل الوحدة.

ProcessTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

التعامل مع النموذج الأولي لسجلّ التشغيل النهائي بعد ERROR(/#testRunEnded(long,HashMap)) حدث.

المعلمات
`runRecord`	`TestRecordProto.TestRecord`: النموذج النهائي الذي يمثّل الجري
`moduleInProgress`	`boolean`: ما إذا كانت الوحدة قيد التنفيذ أم لا.

ProcessTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

التعامل مع النموذج الأوّلي لسجلّ إجراء الاختبار الجزئي بعد testRunStarted(String, int) حدث.

المعلمات
`runStartedRecord`	`TestRecordProto.TestRecord`: النموذج الأولي الجزئي الذي يمثل الجري.

setGranularResults

public void setGranularResults (boolean granularResults)

المعلمات
`granularResults`	`boolean`

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

المعلمات
`inline`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

عرض "صحيح" إذا كان المبلِّغ يدعم النتائج الدقيقة، أو يعرض "خطأ" في الحالات الأخرى.

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

تعذُّر اختبار الافتراض

public final void testAssumptionFailure (TestDescription test, 
                String trace)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

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

تعذُّر اختبار الافتراض

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

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

public 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`: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تم تجاهل الاختبار

public final void testIgnored (TestDescription test)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

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

وحدة اختبار انتهت

public final void testModuleEnded ()

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

تم بدء الاختبار

public final void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
`moduleContext`	`IInvocationContext`: السمة `IInvocationContext` في الوحدة

اختبار RunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

اختبار التشغيل فاشل

public final void testRunFailed (FailureDescription failure)

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

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

اختبار التشغيل فاشل

public final void testRunFailed (String errorMessage)

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

المعلمات
`errorMessage`	`String`: `String` يصف سبب تعذُّر التشغيل.

أمر testRunStarted

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

تبلّغ عن بدء إجراء اختبار.

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

أمر testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

تبلّغ عن بدء إجراء اختبار.

المعلمات
`runName`	`String`: اسم إجراء الاختبار
`testCount`	`int`: إجمالي عدد الاختبارات أثناء إجراء الاختبار

أمر testRunStarted

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

تبلّغ عن بدء إجراء اختبار.

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

تم تخطي الاختبار

public final void testSkipped (TestDescription test, 
                SkipReason reason)

يتم طلبه عند تخطي الاختبار وعدم تنفيذه لسبب غير متوقَّع عادةً. ستتم محاولة إعادة إجراء هذه الاختبارات من أجل إجراء التنفيذ الصحيح.

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

تم بدء الاختبار

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()`

تم بدء الاختبار

public final void testStarted (TestDescription test)

تعمل على الإبلاغ عن بداية حالة اختبار فردية. واجهة قديمة، ويجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

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

الطرق المحمية

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

تنشئ مرجعًا فرعيًا لوحدة معيّنة.

المعلمات
`record`	`TestRecordProto.TestRecord`

المرتجعات
`TestRecordProto.ChildReference`