اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

LogFileSaver

public class LogFileSaver
extends Object

java.lang.Object
↳	com.android.tradefed.result.LogFileSaver

أداة مساعدة لـ ITestInvocationListener تحفظ بيانات السجلّ في ملف

ملخّص

طُرق وضع التصميم العامة
`LogFileSaver(IBuildInfo buildInfo, File rootDir)` تنشئ هذه الدالة `LogFileSaver`.
`LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays)` تنشئ هذه الدالة `LogFileSaver`.
`LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays, Boolean containInvDir)` تنشئ هذه الدالة `LogFileSaver`.
`LogFileSaver(File rootDir)` دالة إنشاء بديلة `LogFileSaver` ستستخدم الدليل المحدّد فقط كدليل لتخزين السجلّات.

الإجراءات العامة
`File`	`createCompressedLogFile(String dataName, LogDataType origDataType)` تنشئ هذه السمة ملفًا فارغًا لتخزين بيانات السجلّ المضغوطة.
`OutputStream`	`createGZipLogStream(File logFile)` ينشئ دفق إخراج لكتابة البيانات المضغوطة بتنسيق GZIP في ملف
`InputStream`	`createInputStreamFromFile(File logFile)` طريقة مساعدة لإنشاء مصدر بيانات لقراءة محتوى ملف السجلّ المحدّد TODO: consider moving this method elsewhere.
`File`	`getFileDir()` الحصول على الدليل المستخدَم لتخزين الملفات
`List<String>`	`getInvocationLogPathSegments()`
`File`	`saveAndGZipLogData(String dataName, LogDataType dataType, InputStream dataStream)` حفظ بيانات السجلّ وضغطها، إذا لزم الأمر، في ملف gzip
`File`	`saveAndGZipLogFile(String dataName, LogDataType dataType, File fileToLog)` حفظ بيانات السجلّ وضغطها، إذا لزم الأمر، في ملف gzip
`File`	`saveLogData(String dataName, LogDataType dataType, InputStream dataStream)` حفظ بيانات السجلّ في ملف
`File`	`saveLogDataRaw(String dataName, String ext, InputStream dataStream)` حفظ البيانات الأولية في ملف
`File`	`saveLogFile(String dataName, LogDataType dataType, File fileToLog)` حفظ ملف سجلّ معيّن

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

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir)

تنشئ هذه الدالة LogFileSaver.

إنشاء دليل نظام ملفات فريد في rootDir/branch/build_id/uniqueDir

المعلَمات
`buildInfo`	`IBuildInfo`: `IBuildInfo`
`rootDir`	‫`File`: مسار نظام الملفات الجذر

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays)

تنشئ هذه الدالة LogFileSaver.

إنشاء دليل نظام ملفات فريد في rootDir/branch/build_id/testTag/uniqueDir

في حال تعذُّر إنشاء الدليل، سيتم استخدام دليل مؤقت.

المعلَمات
`buildInfo`	`IBuildInfo`: `IBuildInfo`
`rootDir`	‫`File`: مسار نظام الملفات الجذر
`logRetentionDays`	`Integer`: في حال توفير ملف ‎.retention، سيتم إنشاء ملف في دليل السجلّات يحتوي على طابع زمني يساوي الوقت الحالي + logRetentionDays. يمكن أن تستخدم نصوص التنظيف الخارجية هذا الملف لتحديد وقت حذف أدلة السجلّات.

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays, 
                Boolean containInvDir)

تنشئ هذه الدالة LogFileSaver.

إنشاء دليل نظام ملفات فريد في rootDir/branch/build_id/testTag/uniqueDir

في حال تعذُّر إنشاء الدليل، سيتم استخدام دليل مؤقت.

المعلَمات
`buildInfo`	`IBuildInfo`: `IBuildInfo`
`rootDir`	‫`File`: مسار نظام الملفات الجذر
`logRetentionDays`	`Integer`: في حال توفير ملف ‎.retention، سيتم إنشاء ملف في دليل السجلّات يحتوي على طابع زمني يساوي الوقت الحالي + logRetentionDays. يمكن أن تستخدم نصوص التنظيف الخارجية هذا الملف لتحديد وقت حذف أدلة السجلّات.
`containInvDir`	`Boolean`

LogFileSaver

public LogFileSaver (File rootDir)

دالة إنشاء بديلة LogFileSaver ستستخدم الدليل المحدّد فقط كدليل لتخزين السجلّات.

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

createCompressedLogFile

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

تنشئ هذه السمة ملفًا فارغًا لتخزين بيانات السجلّ المضغوطة.

المعلَمات
`dataName`	`String`: اسم وصفي `String` للبيانات التي سيتم تخزينها
`origDataType`	`LogDataType`: نوع `LogDataType` المطلوب تخزينه

المرتجعات
`File`	`File`

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

createGZipLogStream

public OutputStream createGZipLogStream (File logFile)

ينشئ دفق إخراج لكتابة البيانات المضغوطة بتنسيق GZIP في ملف

المعلَمات
`logFile`	‫`File`: `File` المطلوب الكتابة إليه

المرتجعات
`OutputStream`	`OutputStream` لضغط البيانات وكتابتها في الملف هذا البث عند اكتماله

عمليات الطرح
`IOException`	في حال تعذّر إنشاء البث

createInputStreamFromFile

public InputStream createInputStreamFromFile (File logFile)

طريقة مساعدة لإنشاء مصدر بيانات لقراءة محتوى ملف السجلّ المحدّد

TODO: consider moving this method elsewhere. تم وضعها هنا حاليًا حتى يتمكن مستخدمو هذه الفئة من محاكاتها.

المعلَمات
`logFile`	`File`: `File` الذي سيتم القراءة منه

المرتجعات
`InputStream`	`InputStream` مخزّن مؤقتًا لقراءة بيانات الملف على المتصلين استدعاء هذا البث عند اكتماله

عمليات الطرح
`IOException`	في حال تعذّر إنشاء البث

getFileDir

public File getFileDir ()

الحصول على الدليل المستخدَم لتخزين الملفات

المرتجعات
`File`	الدليل `File`

getInvocationLogPathSegments

public List<String> getInvocationLogPathSegments ()

المرتجعات
`List<String>`	أجزاء مسار سجلّ الاستدعاء الفريد

saveAndGZipLogData

public File saveAndGZipLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

حفظ بيانات السجلّ وضغطها، إذا لزم الأمر، في ملف gzip

المعلَمات
`dataName`	`String`: اسم وصفي للبيانات `String`
`dataType`	`LogDataType`: `LogDataType` الخاص بالملف بيانات السجلّ التي تكون (أي `LogDataType.isCompressed()` هي `true`)
`dataStream`	`InputStream`: `InputStream` الخاص بالبيانات

المرتجعات
`File`	ملف البيانات التي تم إنشاؤها

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

saveAndGZipLogFile

public File saveAndGZipLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

حفظ بيانات السجلّ وضغطها، إذا لزم الأمر، في ملف gzip

المعلَمات
`dataName`	`String`: اسم وصفي للبيانات `String`
`dataType`	`LogDataType`: `LogDataType` الخاص بالملف بيانات السجلّ التي تكون (أي `LogDataType.isCompressed()` هي `true`)
`fileToLog`	`File`: `File` المطلوب حفظه

المرتجعات
`File`	ملف البيانات التي تم إنشاؤها

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

saveLogData

public File saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

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

المعلَمات
`dataName`	`String`: اسم وصفي للبيانات `String`
`dataType`	`LogDataType`: `LogDataType` الخاص بالملف
`dataStream`	`InputStream`: `InputStream` الخاص بالبيانات

المرتجعات
`File`	ملف البيانات التي تم إنشاؤها

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

saveLogDataRaw

public File saveLogDataRaw (String dataName, 
                String ext, 
                InputStream dataStream)

حفظ البيانات الأولية في ملف

المعلَمات
`dataName`	`String`: اسم وصفي للبيانات `String`
`ext`	‫`String`: إضافة التاريخ
`dataStream`	`InputStream`: `InputStream` الخاص بالبيانات

المرتجعات
`File`	ملف البيانات التي تم إنشاؤها

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

saveLogFile

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

حفظ ملف سجلّ معيّن

المعلَمات
`dataName`	`String`: اسم وصفي للبيانات `String`
`dataType`	`LogDataType`: `LogDataType` الخاص بالملف
`fileToLog`	`File`: `File` المطلوب تسجيله

المرتجعات
`File`	ملف البيانات التي تم إنشاؤها

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