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, List<ITestInvocationListener> listeners, IConfiguration config)
LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config, boolean setLogSaver)

الإجراءات العامة

void invocationEnded(long elapsedTime)

تعرض هذه السمة ما إذا تم إنهاء عملية الاستدعاء بنجاح أو بسبب حدوث خطأ.

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile logFile)

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

static void logFile(List<ITestInvocationListener> listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)

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

static void reportEndHostLog(List<ITestInvocationListener> listeners, ILogSaver saver, String name)

تعرض هذه السمة سجل المضيف من الجلسة الجارية.

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 يتضمّن عنصرًا آخر، تأكَّد من إعادة توجيه معاودة الاتصال testLogSaved إلى المستمعين ضمنه.

void testModuleEnded()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

void testModuleStarted(IInvocationContext moduleContext)

تسجّل هذه السمة بداية تشغيل وحدة.

طُرق وضع التصميم العامة

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config)

المعلَمات
logSaver ILogSaver

listeners List

config IConfiguration

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config, 
                boolean setLogSaver)

المعلَمات
logSaver ILogSaver

listeners List

config IConfiguration

setLogSaver boolean

الإجراءات العامة

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,LogDataType,InputStreamSource,LogFile). وبالتالي، يتيح هذا الإجراء الرجعي توفير ارتباط قوي بشكل صريح.

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

logFile

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

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

المعلَمات
listeners List

saver ILogSaver

source InputStreamSource

name String

type LogDataType

reportEndHostLog

public static void reportEndHostLog (List<ITestInvocationListener> listeners, 
                ILogSaver saver, 
                String name)

تعرض هذه السمة تقارير host_log من الجلسة الجارية.

المعلَمات
listeners List

saver ILogSaver

name String

testLog

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

تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار.

يجب الاتصال قبل ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) 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 يتضمّن عنصرًا آخر، تأكَّد من إعادة توجيه معاودة الاتصال testLogSaved إلى المستمعين ضمنه.

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

testModuleEnded

public void testModuleEnded ()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

المعلَمات
moduleContext IInvocationContext: IInvocationContext الخاص بالوحدة