IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

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

---

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

סיכום

‫methods ציבוריים
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, 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 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.

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException	אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException	במקרה שפקודת ה-Shell לא שולחת פלט במשך יותר מ-maxTimeToOutputResponse.
TimeoutException	אם חלף הזמן הקצוב לחיבור כששולחים את הפקודה.
IOException	במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

• DdmPreferences.getTimeOut()

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 שאינם אפס.

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException	אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException	במקרה שפקודת ה-Shell לא שולחת פלט במשך יותר מ-maxTimeToOutputResponse.
TimeoutException	אם חלף הזמן הקצוב לחיבור כששולחים את הפקודה.
IOException	במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

• DdmPreferences.getTimeOut()

getName

public abstract String getName ()

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

החזרות
String

getSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

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

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

החזרות
ListenableFuture<String>	‫ListenableFuture. get עשוי להחזיר null.