IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

מחלקות משנה לא ישירות ידועות ‫DeviceImpl, ‏ DeviceManager.FastbootDevice, ‏ IDevice, ‏ NullDevice, ‏ RemoteAvdIDevice, ‏ StubDevice, ‏ StubLocalAndroidVirtualDevice, ‏ VmRemoteDevice ‫DeviceImpl מכשיר.  DeviceManager.FastbootDevice ייצוג של מכשיר במצב אתחול מהיר (Fastboot mode).  IDevice מכשיר.  NullDevice ערך placeholder‏ IDevice שמשמש את DeviceManager להקצאה כש-IDeviceSelection.nullDeviceRequested() הוא true  RemoteAvdIDevice ערך placeholder‏ IDevice שמשמש את DeviceManager להקצאה כש-DeviceSelectionOptions.gceDeviceRequested() הוא true  StubDevice הטמעה של פלייסהולדר של stub של IDevice.  StubLocalAndroidVirtualDevice ערך placeholder‏ IDevice שמשמש את DeviceManager להקצאה כש-DeviceSelectionOptions.localVirtualDeviceRequested() הוא true  VmRemoteDevice מכשיר וירטואלי מרוחק שאנחנו ננהל מתוך המכונה הווירטואלית.

---

מכשיר מופשט שיכול לקבל פקודות של מעטפת.

סיכום

‫methods ציבוריים
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.
abstract String	getName() מחזירה שם (שקל לבני אדם להבין) של המכשיר.
abstract ListenableFuture<String>	getSystemProperty(String name) ביצוע שאילתה אסינכרונית פוטנציאלית לגבי מאפיין מערכת.

‫methods ציבוריים

executeShellCommand

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

מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.

‫maxTimeToOutputResponse משמש כזמן המתנה המקסימלי כשמצפים לפלט של הפקודה מהמכשיר.
בכל שלב, אם פקודת ה-Shell לא מוציאה פלט למשך תקופה ארוכה יותר מ- maxTimeToOutputResponse, השיטה תזרוק ShellCommandUnresponsiveException.

לפקודות כמו פלט יומן, צריך להשתמש בערך maxTimeToOutputResponse של 0, כלומר השיטה אף פעם לא תזרוק ותיחסם עד שהמקבל IShellOutputReceiver.isCancelled() יחזיר true.

פרמטרים
command	‫String: פקודת המעטפת להרצה
receiver	‫IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-Shell
maxTimeToOutputResponse	‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits	‫TimeUnit: יחידות לערכים של maxTimeToOutputResponse שאינם אפס.

זריקות
TimeoutException	במקרה של פסק זמן בחיבור כששולחים את הפקודה.
AdbCommandRejectedException	אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException	במקרה שפקודת ה-Shell לא שולחת פלט במשך תקופה ארוכה מ-maxTimeToOutputResponse.
	במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

• DdmPreferences.getTimeOut()

executeShellCommand

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

מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.

‫maxTimeToOutputResponse משמש כזמן המתנה המקסימלי כשמצפים לפלט של הפקודה מהמכשיר.
בכל שלב, אם פקודת ה-Shell לא מוציאה פלט למשך תקופה ארוכה יותר מ- maxTimeToOutputResponse, השיטה תזרוק ShellCommandUnresponsiveException.

לפקודות כמו פלט יומן, צריך להשתמש בערך maxTimeToOutputResponse של 0, כלומר השיטה אף פעם לא תזרוק ותיחסם עד שהמקבל IShellOutputReceiver.isCancelled() יחזיר true.

פרמטרים
command	‫String: פקודת המעטפת להרצה
receiver	‫IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-Shell
maxTimeout	‫long: הזמן המקסימלי להמתנה עד שהפקודה תחזיר ערך. הערך 0 מציין שלא יחול זמן קצוב מקסימלי לתפוגה.
maxTimeToOutputResponse	‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits	‫TimeUnit: יחידות לערכים שונים מאפס של maxTimeout ו-maxTimeToOutputResponse.

זריקות
TimeoutException	במקרה של פסק זמן בחיבור כששולחים את הפקודה.
AdbCommandRejectedException	אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException	במקרה שפקודת ה-Shell לא שולחת פלט במשך תקופה ארוכה מ-maxTimeToOutputResponse.
	במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

• DdmPreferences.getTimeOut()

getName

public abstract String getName ()

מחזירה שם (שקל לבני אדם להבין) של המכשיר. בדרך כלל זה שם ה-AVD עבור מכשירי AVD, ושילוב של שם היצרן, שם הדגם והמספר הסידורי עבור מכשירים.

החזרות
String

getSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

ביצוע שאילתה אסינכרונית פוטנציאלית לגבי מאפיין מערכת.

פרמטרים
name	‫String: השם של הערך שרוצים להחזיר.

החזרות
ListenableFuture<String>	‫ListenableFuture. ERROR(get/Future#get() get) עשוי להחזיר null.