LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogSaverResultForwarder

الفئات الفرعية المباشرة المعروفة RetryLogSaverResultForwarder RetryLogSaverResultForwarder مُرسِل يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحاول إجراؤها

---

ResultForwarder لحفظ السجلات باستخدام أداة حفظ الملفات الشاملة

ملخّص

وظائف الإنشاء العامة
LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)

الطرق العامة
void	invocationEnded(long elapsedTime) تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.
void	invocationStarted(IInvocationContext context) الإبلاغ عن بدء استدعاء الاختبار
void	logAssociation(String dataName, LogFile logFile) في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).
static void	logFile( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type) تسجيل ملف نهائي قبل اكتمال العملية
static void	reportEndHostLog( listeners, ILogSaver saver, String name) الإبلاغ عن host_log من الجلسة الجارية
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) يوفّر بيانات السجلّ أو تصحيح الأخطاء المرتبطة من طلب الاختبار. عليك أيضًا حفظ ملف السجلّ الذي يتضمّن العنصر الشامل ILogSaver وILogSaverListener.testLogSaved(String, LogDataType, InputStreamSource, LogFile) للمستمعِين الذين ينفذون واجهة ILogSaverListener.
void	testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream) يمكنك إعادة توجيه testLog فقط بدلاً من حفظ السجلّ أولاً.
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) يتمّ استدعاء هذه الدالة عند حفظ سجلّ الاختبار. إذا كان LogSaverResultForwarder ملفًا مضمّنًا في ملف آخر، تأكَّد من إعادة توجيه callback testLogSaved إلى المستمعين ضمنه.

وظائف الإنشاء العامة

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

المعلمات
logSaver	ILogSaver
listeners
config	IConfiguration

الطرق العامة

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation. على مُرسِلي البلاغات إلغاء هذه الطريقة للسماح بإعداد تقارير عن أجهزة متعددة.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

logFile

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

تسجيل ملف نهائي قبل اكتمال العملية

المعلمات
listeners
saver	ILogSaver
source	InputStreamSource
name	String
type	LogDataType

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

الإبلاغ عن host_log من الجلسة الجارية

المعلمات
listeners
saver	ILogSaver
name	String

testLog

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

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

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

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

عليك أيضًا حفظ ملف السجلّ الذي يتضمّن العنصر الشامل ILogSaver وإجراء ILogSaverListener.testLogSaved(String, LogDataType, InputStreamSource, LogFile) للمستمعِين الذين ينفذون واجهة ILogSaverListener.

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

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

يمكنك إعادة توجيه testLog فقط بدلاً من حفظ السجلّ أولاً.

المعلمات
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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

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

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

إذا كان LogSaverResultForwarder ملفًا مضمّنًا في ملف آخر، تأكَّد من إعادة توجيه callback testLogSaved إلى المستمعين ضمنه.

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