IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

الفئات الفرعية غير المباشرة المعروفة ‫AdbShimDevice وDeviceImpl وDeviceManager.FastbootDevice وIDevice وNullDevice وRemoteAvdIDevice وStubDevice وStubLocalAndroidVirtualDevice وVmRemoteDevice AdbShimDevice تنفيذ العنصر النائب AdbShimDevice لـ IDevice  DeviceImpl جهاز  DeviceManager.FastbootDevice تمثيل لجهاز في وضع Fastboot  IDevice جهاز  NullDevice عنصر نائب IDevice تستخدمه DeviceManager لتحديد وقت true IDeviceSelection.nullDeviceRequested() RemoteAvdIDevice عنصر نائب IDevice تستخدمه DeviceManager لتحديد وقت true DeviceSelectionOptions.gceDeviceRequested() StubDevice تنفيذ عنصر نائب لـ IDevice  StubLocalAndroidVirtualDevice عنصر نائب IDevice تستخدمه DeviceManager لتحديد وقت true DeviceSelectionOptions.localVirtualDeviceRequested() VmRemoteDevice جهاز افتراضي بعيد ستتم إدارته من داخل الجهاز الافتراضي

---

جهاز مجرّد يمكنه تلقّي أوامر shell.

ملخّص

الإجراءات العامة
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver.
abstract String	getName() تعرِض هذه السمة اسمًا (مفهومًا) لهذا الجهاز.
abstract ListenableFuture<String>	getSystemProperty(String name) تنفيذ طلب بحث غير متزامن محتمل عن سمة نظام

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver.

يُستخدَم maxTimeToOutputResponse كحد أقصى لوقت الانتظار عند توقُّع تلقّي ناتج الأمر من الجهاز.
في أي وقت، إذا لم يعرض أمر shell أي نتائج لمدة تزيد عن maxTimeToOutputResponse، سيؤدي ذلك إلى طرح ShellCommandUnresponsiveException.

بالنسبة إلى أوامر مثل إخراج السجلّ، يجب استخدام القيمة maxTimeToOutputResponse التي تساوي 0، ما يعني أنّ الطريقة لن تعرض أي خطأ وسيتم حظرها إلى أن تعرض IShellOutputReceiver.isCancelled() الخاصة بالمستلِم القيمة true.

المعلَمات
command	‫String: أمر shell المطلوب تنفيذه
receiver	‫IShellOutputReceiver: IShellOutputReceiver الذي سيتلقّى نتيجة أمر shell
maxTimeout	‫long: الحد الأقصى لمهلة انتهاء صلاحية الأمر. تعني القيمة 0 أنّه لن يتم تطبيق أي حد أقصى للمهلة.
maxTimeToOutputResponse	‫long: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي receiver التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
maxTimeUnits	‫TimeUnit: وحدات القيم غير الصفرية maxTimeout وmaxTimeToOutputResponse

عمليات الطرح
AdbCommandRejectedException	إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException	في حال عدم إرسال أمر shell أي مخرجات لفترة أطول من maxTimeToOutputResponse
TimeoutException	في حال انتهاء المهلة أثناء الاتصال عند إرسال الأمر
IOException	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

يُرجى الاطّلاع أيضًا على:

• DdmPreferences.getTimeOut()

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver.

يُستخدَم maxTimeToOutputResponse كحد أقصى لوقت الانتظار عند توقُّع تلقّي ناتج الأمر من الجهاز.
في أي وقت، إذا لم يعرض أمر shell أي نتائج لمدة تزيد عن maxTimeToOutputResponse، سيؤدي ذلك إلى طرح ShellCommandUnresponsiveException.

بالنسبة إلى أوامر مثل إخراج السجلّ، يجب استخدام القيمة maxTimeToOutputResponse التي تساوي 0، ما يعني أنّ الطريقة لن تعرض أي خطأ وسيتم حظرها إلى أن تعرض IShellOutputReceiver.isCancelled() الخاصة بالمستلِم القيمة true.

المعلَمات
command	‫String: أمر shell المطلوب تنفيذه
receiver	‫IShellOutputReceiver: IShellOutputReceiver الذي سيتلقّى نتيجة أمر shell
maxTimeToOutputResponse	‫long: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي receiver التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
maxTimeUnits	TimeUnit: وحدات قيم maxTimeToOutputResponse غير الصفرية.

عمليات الطرح
AdbCommandRejectedException	إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException	في حال عدم إرسال أمر shell أي مخرجات لفترة أطول من maxTimeToOutputResponse
TimeoutException	في حال انتهاء المهلة أثناء الاتصال عند إرسال الأمر
IOException	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

يُرجى الاطّلاع أيضًا على:

• DdmPreferences.getTimeOut()

getName

public abstract String getName ()

تعرِض هذه السمة اسمًا (مفهومًا) لهذا الجهاز. عادةً ما يكون هذا هو اسم المحاكي الافتراضي لنظام Android (AVD) بالنسبة إلى المحاكيات الافتراضية، ومزيجًا من اسم الشركة المصنّعة واسم الطراز والرقم التسلسلي بالنسبة إلى الأجهزة.

المرتجعات
String

getSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

تنفيذ طلب بحث غير متزامن محتمل عن سمة نظام

المعلَمات
name	‫String: اسم القيمة المطلوب عرضها

المرتجعات
ListenableFuture<String>	قد تعرض السمة ListenableFuture. get القيمة null.