IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

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

ملخّص

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, 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 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 غير الصفرية.
الرميات
TimeoutException في حال انتهاء المهلة أثناء الاتصال عند إرسال الأمر
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات لفترة أطول من maxTimeToOutputResponse.
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

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

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
الرميات
TimeoutException في حال انتهاء المهلة أثناء الاتصال عند إرسال الأمر
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات لفترة أطول من maxTimeToOutputResponse.
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

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

getName

public abstract String getName ()

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

المرتجعات
String

getSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

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

المعلمات
name ‫String: اسم القيمة المطلوب عرضها
المرتجعات
ListenableFuture<String> قد تعرض السمة ListenableFuture. ERROR(get/Future#get() get) القيمة null.