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

ResultAndLogForwarder

public class ResultAndLogForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.ResultAndLogForwarder

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

‫GranularRetriableTestWrapper.StartEndCollector وModuleResultsAndMetricsForwarder وRemoteTestTimeOutEnforcer

GranularRetriableTestWrapper.StartEndCollector	فئة مساعدة لرصد حالات عدم توفّر وقتَي بدء التشغيل وإنهائه
ModuleResultsAndMetricsForwarder	هي امتداد لـ `ResultAndLogForwarder` يضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.
RemoteTestTimeOutEnforcer	أدوات معالجة تتيح التحقّق من وقت تنفيذ إعداد اختبار معيّن وإيقافه إذا تجاوز المهلة المحدّدة.

أداة إعادة توجيه النتائج وأحداث السجلّ

ملخّص

الإنشاءات العامة
`ResultAndLogForwarder(ITestInvocationListener... listeners)`
`ResultAndLogForwarder( listeners)` Ctor

الطُرق العامة
`void`	`invocationEnded(long elapsedTime)` تشير إلى أنّ عملية الاستدعاء قد انتهت، سواء بنجاح أو بسبب بعض حالات الخطأ.
`void`	`invocationStarted(IInvocationContext context)` تسجّل هذه السمة بداية تنفيذ الاختبار.
`void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`void`	`setLogSaver(ILogSaver logSaver)` اضبط `ILogSaver` للسماح للمنفِّذ بحفظ الملفات.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` يتم استدعاء هذه الطريقة عند حفظ سجلّ الاختبار.

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

ResultAndLogForwarder

public ResultAndLogForwarder (ITestInvocationListener... listeners)

المعلمات
`listeners`	`ITestInvocationListener`

ResultAndLogForwarder

public ResultAndLogForwarder ( listeners)

Ctor

المعلمات
`listeners`

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation. على مقدّمي التقارير إلغاء هذه الطريقة لتفعيل إعداد التقارير على أجهزة متعددة.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). وبالتالي، يتيح هذا الإجراء الرجعي تقديم ارتباط قوي بشكل صريح.

المعلمات
`dataName`	‫`String`: اسم البيانات
`logFile`	`LogFile`: `LogFile` الذي تم تسجيله من قبل ويجب ربطه بحالة الاختبار.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

المعلمات
`logSaver`	`ILogSaver`: `ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

يتم استدعاء هذه الطريقة عند حفظ سجلّ الاختبار.

يجب استخدامها بدلاً من ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

المعلمات
`dataName`	`String`: اسم وصفي `String` للبيانات، مثل "device_logcat". ملاحظة قد لا يكون dataName فريدًا لكل استدعاء، أي يجب أن يتمكّن المنفّذون من التعامل مع عمليات استدعاء متعدّدة باستخدام dataName نفسه.
`dataType`	‫`LogDataType`: `LogDataType` البيانات
`dataStream`	`InputStreamSource`: `InputStreamSource` البيانات على المنفّذين استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند الانتهاء.
`logFile`	`LogFile`: `LogFile` الذي يحتوي على البيانات الوصفية للملف المحفوظ