IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

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

סיכום

‫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.
במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

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.
במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

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.