اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

الفئات الفرعية غير المباشرة المعروفة

ATestFileSystemLogSaver وClusterLogSaver وFileSystemLogSaver

ATestFileSystemLogSaver	تستخدم فئة LogSaver هذه من قِبل ATest لحفظ السجلات في مسار معيّن.
ClusterLogSaver	فئة `ILogSaver` لتحميل نتائج الاختبار إلى TFC
FileSystemLogSaver	حفظ السجلّات في نظام ملفات

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

يتمّ الإعلان عن 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)

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

المعلمات
`dataName`	`String`: `String` اسم وصفي للبيانات، مثل "device_logcat"
`dataType`	`LogDataType`: `LogDataType` الملف
`fileToLog`	‫`File`: `ERROR(/File)` المطلوب حفظه

المرتجعات
`LogFile`	`LogFile` التي تحتوي على مسار الملف المحفوظ وعنوان URL

عمليات الرمي
	إذا تعذّر إنشاء ملف السجلّ