LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

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

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

ملخّص

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

LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)

الطرق العامة

void invocationEnded(long elapsedTime)

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

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile logFile)

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

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)

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

المعلمات
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 الذي يحتوي على البيانات الوصفية للملف المحفوظ