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

AndroidBuildApiLogSaver

public class AndroidBuildApiLogSaver
extends Object implements ILogSaver

java.lang.Object
↳	com.google.android.tradefed.result.AndroidBuildApiLogSaver

فئة تحفظ ملفات السجلّ في Android Build API.

ملخّص

الإنشاءات العامة
`AndroidBuildApiLogSaver()`

الطُرق العامة
`LogFile`	`getLogReportDir()` احصل على `LogFile` الذي يحتوي على مسار و/أو عنوان URL للدليل الذي يتم حفظ السجلات فيه.
`void`	`init(IInvocationContext context)` إشعار مبكر بشأن عملية التهيئة، قبل توفّر أي معلومات عن الإصدار
`void`	`invocationEnded(long elapsedTime)` تشير إلى أنّ عملية الاستدعاء قد انتهت، سواء بنجاح أو بسبب بعض حالات الخطأ.
`void`	`invocationStarted(IInvocationContext context)` تسجّل هذه السمة بداية تنفيذ الاختبار.
`LogFile`	`saveLogData(String dataName, LogDataType dataType, InputStream dataStream)` احفظ بيانات السجلّ.
`LogFile`	`saveLogFile(String dataName, LogDataType dataType, File fileToLog)` احفظ ملف السجلّ.

الطُرق المحمية
`IInvocationContext`	`getInvocationContext()`
`void`	`runUpdate(Androidbuildinternal client, String filePath, String resourceId, String md5, FileContent fileContent, LogDataType type, String contentType)`

الإنشاءات العامة

AndroidBuildApiLogSaver

public AndroidBuildApiLogSaver ()

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

getLogReportDir

public LogFile getLogReportDir ()

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

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

init

public void init (IInvocationContext context)

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

تشير إلى أنّ عملية الاستدعاء قد انتهت، سواء بنجاح أو بسبب بعض حالات الخطأ.

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

saveLogData

public 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 الخاص به

saveLogFile

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

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

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

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

المرتجعات
`LogFile`	`LogFile` الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به

الطُرق المحمية

getInvocationContext

protected IInvocationContext getInvocationContext ()

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

runUpdate

protected void runUpdate (Androidbuildinternal client, 
                String filePath, 
                String resourceId, 
                String md5, 
                FileContent fileContent, 
                LogDataType type, 
                String contentType)

المعلمات
`client`	`Androidbuildinternal`
`filePath`	`String`
`resourceId`	`String`
`md5`	`String`
`fileContent`	`FileContent`
`type`	`LogDataType`
`contentType`	`String`