ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener


السماح لتطبيقات ITestInvocationListener بالاستماع إلى عمليات حفظ ملفات السجلّ

يتيح ذلك لاستخدام ITestInvocationListener متعددة ملف السجلّ المحفوظ نفسه عند إنشاء التقارير، ويتجنّب أن يحفظ كل مستمع الملف بشكلٍ فردي عند استدعاء ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

يجب أن تكون الفِرق التي تنفّذ هذه الواجهة على دراية بأنّه سيتم استدعاء testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) عند استدعاء ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

وتُمرِّر هذه الفئة أيضًا مثيل ILogSaver الشامل حتى تتمكّن ITestInvocationListener من حفظ ملفات إضافية في الموقع نفسه.

ملخّص

الطرق العامة

default void logAssociation(String dataName, LogFile logFile)

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

default void setLogSaver(ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

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

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

الطرق العامة

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

المعلمات
dataName String: اسم البيانات

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

المعلمات
logSaver ILogSaver: ILogSaver

testLogSaved

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

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

يجب استخدامه بدلاً من ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

المعلمات
dataName String: اسم String وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدّة طلبات باستخدام dataName نفسه.

dataType LogDataType: LogDataType البيانات

dataStream InputStreamSource: InputStreamSource للبيانات على مُنفِّذي الإجراء استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية.

logFile LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ