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

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

LargeOutputReceiver

public class LargeOutputReceiver
extends Object implements IShellOutputReceiver

java.lang.Object
↳	com.android.tradefed.device.LargeOutputReceiver

فئة مصمَّمة للمساعدة في تنفيذ الأوامر التي تستغرق وقتًا طويلاً لجمع النتائج

يقتصر الحد الأقصى لحجم ملف tmp على maxFileSize تقريبًا. لمنع فقدان البيانات عند بلوغ الحد الأقصى، يحتفظ هذا الملف بمجموعة من ملفات tmp host.

ملخّص

الإنشاءات العامة
`LargeOutputReceiver(String descriptor, String serialNumber, long maxDataSize)` تنشئ هذه الدالة `LargeOutputReceiver`.

الطُرق العامة
`void`	`addOutput(byte[] data, int offset, int length)` يتم استدعاء هذه الدالة في كل مرة تتوفّر فيها بعض البيانات الجديدة.
`void`	`cancel()` لإلغاء الأمر
`void`	`clear()` احذف البيانات المتراكمة حاليًا، ثم أعِد إنشاء ملف جديد.
`void`	`delete()` احذف جميع البيانات المتراكمة.
`void`	`flush()` يتم استدعاؤها في نهاية تنفيذ العملية (ما لم يتم إلغاء العملية).
`InputStreamSource`	`getData()` يحصل على الناتج الذي تم جمعه كـ `InputStreamSource`.
`InputStreamSource`	`getData(int maxBytes)` تعرض آخر `maxBytes` من الناتج الذي تم جمعه كـ `InputStreamSource`.
`InputStreamSource`	`getData(int maxBytes, int offset)` يحصل على آخر `maxBytes` من الناتج الذي تم جمعه كـ `InputStreamSource`.
`boolean`	`isCancelled()` طريقة الإلغاء لإيقاف تنفيذ أمر shell عن بُعد

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

LargeOutputReceiver

public LargeOutputReceiver (String descriptor, 
                String serialNumber, 
                long maxDataSize)

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

المعلمات
`descriptor`	‫`String`: واصف الأمر المطلوب تنفيذه. لأغراض التسجيل فقط.
`serialNumber`	‫`String`: الرقم التسلسلي للجهاز لأغراض التسجيل فقط.
`maxDataSize`	‫`long`: الحد الأقصى التقريبي لمقدار البيانات التي يجب الاحتفاظ بها

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

addOutput

public void addOutput (byte[] data, 
                int offset, 
                int length)

يتم استدعاء هذه الدالة في كل مرة تتوفّر فيها بعض البيانات الجديدة.

المعلمات
`data`	‫`byte`: البيانات الجديدة
`offset`	`int`: الإزاحة التي تبدأ عندها البيانات الجديدة.
`length`	`int`: طول البيانات الجديدة.

إلغاء

public void cancel ()

لإلغاء الأمر

محو

public void clear ()

احذف البيانات المتراكمة حاليًا، ثم أعِد إنشاء ملف جديد.

حذف

public void delete ()

احذف جميع البيانات المتراكمة.

flush

public void flush ()

يتم استدعاؤها في نهاية تنفيذ العملية (ما لم يتم إلغاء العملية). ويتيح ذلك للمستلِم إنهاء أي بيانات لم تتم معالجتها بعد وإزالتها.

getData

public InputStreamSource getData ()

يحصل على الناتج الذي تم جمعه كـ InputStreamSource.

المرتجعات
`InputStreamSource`	الناتج الذي تم جمعه من الأمر

getData

public InputStreamSource getData (int maxBytes)

يحصل على آخر maxBytes من الناتج الذي تم جمعه كـ InputStreamSource.

المعلمات
`maxBytes`	`int`: الحد الأقصى لمقدار البيانات المطلوب إرجاعها يجب أن تكون القيمة مقدارًا يمكن استيعابه بسهولة في الذاكرة

المرتجعات
`InputStreamSource`	الناتج الذي تم جمعه من الأمر، والمخزّن في الذاكرة

getData

public InputStreamSource getData (int maxBytes, 
                int offset)

يحصل على آخر maxBytes من الناتج الذي تم جمعه كـ InputStreamSource.

المعلمات
`maxBytes`	`int`: الحد الأقصى لمقدار البيانات المطلوب إرجاعها يجب أن يكون مقدارًا يمكن استيعابه بسهولة في الذاكرة
`offset`	‫`int`: إزاحة وقت بدء الحصول على البيانات من المخزن المؤقت.

المرتجعات
`InputStreamSource`	الناتج الذي تم جمعه من الأمر، والمخزّن في الذاكرة

isCancelled

public boolean isCancelled ()

طريقة الإلغاء لإيقاف تنفيذ أمر shell عن بُعد

المرتجعات
`boolean`	يجب ضبط القيمة على "صحيح" لإلغاء تنفيذ الأمر.