ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

توفر الفئات التي تنفّذ هذه الواجهة طرقًا لتخزين السجلات في موقع مركزي.

يتم تعريف ILogSaver في الإعدادات وهو المسؤول عن تخزين السجلات في موقع مركزي. ويوفّر أيضًا طرقًا تتيح لتطبيقات ILogSaverListener حفظ ملفات إضافية في الموقع الجغرافي نفسه.

ملخّص

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

abstract LogFile getLogReportDir()

احصل على LogFile الذي يحتوي على مسار و/أو عنوان URL للدليل الذي يتم فيه حفظ السجلات.

default void init(IInvocationContext context)

إشعار مبكر بشأن عملية التهيئة، قبل توفّر أي معلومات عن الإصدار

abstract void invocationEnded(long elapsedTime)

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

abstract void invocationStarted(IInvocationContext context)

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

abstract LogFile saveLogData(String dataName, LogDataType dataType, InputStream dataStream)

احفظ بيانات السجلّ.

default LogFile saveLogDataRaw(String dataName, LogDataType dataType, InputStream dataStream)

تم إيقاف هذه الطريقة نهائيًا. استخدام saveLogData(String,LogDataType,InputStream) بدلاً من ذلك

default LogFile saveLogFile(String dataName, LogDataType dataType, File fileToLog)

احفظ ملف السجلّ.

default void testModuleEnded()

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

default void testModuleStarted(IInvocationContext context)

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

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

getLogReportDir

public abstract LogFile getLogReportDir ()

احصل على LogFile الذي يحتوي على مسار و/أو عنوان URL للدليل الذي يتم فيه حفظ السجلات.

المرتجعات
LogFile LogFile

init

public void init (IInvocationContext context)

إشعار مبكر بشأن عملية التهيئة، قبل توفّر أي معلومات عن الإصدار يتيح ذلك إعداد أي متطلبات لتلقّي السجلّات.

المعلَمات
context ‫IInvocationContext: معلومات حول عملية الاستدعاء

invocationEnded

public abstract void invocationEnded (long elapsedTime)

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

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation بعد استدعاء ITestInvocationListener.invocationEnded(long).

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

invocationStarted

public abstract void invocationStarted (IInvocationContext context)

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

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation قبل استدعاء ITestInvocationListener.invocationStarted(IInvocationContext).

المعلَمات
context ‫IInvocationContext: معلومات حول عملية الاستدعاء

saveLogData

public abstract LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

احفظ بيانات السجلّ.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation كلما تم استدعاء ITestInvocationListener.testLog(String,LogDataType,InputStreamSource). ويمكن استخدامها أيضًا كطريقة مساعدة لحفظ بيانات سجلّ إضافية.

استنادًا إلى التنفيذ والسياسة، قد يتم حفظ السجلّات في شكل مضغوط. قد يتم أيضًا تخزين السجلات في موقع لا يمكن الوصول إليه من خلال Tradefed.

المعلَمات
dataName String: اسم وصفي String للبيانات، مثل "device_logcat"
dataType LogDataType: LogDataType الخاص بالملف
dataStream InputStream: InputStream الخاص بالبيانات
المرتجعات
LogFile LogFile الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به
عمليات الطرح
IOException في حال تعذّر إنشاء ملف السجلّ

saveLogDataRaw

public LogFile saveLogDataRaw (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

تم إيقاف هذا الإجراء نهائيًا.
استخدِم saveLogData(String,LogDataType,InputStream) بدلاً من ذلك

طريقة مساعدة لحفظ بيانات السجلّ بدون تعديل

قد يتم تخزين السجلات في موقع جغرافي لا يمكن الوصول إليه من خلال Tradefed.

المعلَمات
dataName String: اسم وصفي String للبيانات، مثل "device_logcat".
dataType LogDataType: LogDataType يحتوي على نوع الملف وامتداده
dataStream InputStream: InputStream الخاص بالبيانات
المرتجعات
LogFile LogFile الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به
عمليات الطرح
IOException في حال تعذّر إنشاء ملف السجلّ

saveLogFile

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

احفظ ملف السجلّ.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation كلما تم استدعاء ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) وكان البث يشير إلى ملف.

استنادًا إلى التنفيذ والسياسة، قد يتم حفظ السجلّات في شكل مضغوط. قد يتم أيضًا تخزين السجلات في موقع لا يمكن الوصول إليه من خلال Tradefed.

المعلَمات
dataName String: اسم وصفي String للبيانات، مثل "device_logcat"
dataType LogDataType: LogDataType الخاص بالملف
fileToLog استبدِل File بـ File لحفظها.
المرتجعات
LogFile LogFile الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به
عمليات الطرح
IOException في حال تعذّر إنشاء ملف السجلّ

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext context)

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

المعلَمات
context ‫IInvocationContext: معلومات حول الوحدة