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, com.android.tradefed.result.LogDataType, InputStream) بدلاً من ذلك

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

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

الطُرق العامة

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 كلما تم استدعاء ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource). ويمكن استخدامها أيضًا كطريقة مساعدة لحفظ بيانات سجلّ إضافية.

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

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

saveLogDataRaw

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

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

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

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

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

saveLogFile

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

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

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

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

المعلمات
dataName String: اسم وصفي String للبيانات، مثل "device_logcat"
dataType LogDataType: LogDataType الملف
fileToLog File: ERROR(/File) المطلوب حفظه
المرتجعات
LogFile LogFile الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به
الرميات
في حال تعذّر إنشاء ملف السجلّ