IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


ממשק לניהול מערך המכשירים הזמינים לבדיקה.

סיכום

כיתות מקוננות

interface IDeviceManager.IFastbootListener

מאזין לשינויי מצב אתחול מהיר.

שיטות ציבוריות

abstract void addDeviceMonitor ( IDeviceMonitor mon)

מוסיף IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

מודיע למנהל שמאזין מעוניין בשינויי מצב אתחול מהיר.

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

הוסף מכשיר למסך מהיר אתחול.

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים.

abstract ITestDevice allocateDevice ( IDeviceSelection options)

בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים.

abstract ITestDevice allocateDevice ()

בקש מכשיר פיזי לבדיקה

abstract ITestDevice connectToTcpDevice (String ipAndPort)

התחבר למכשיר עם adb-over-tcp

שיטה זו מקצה מכשיר חדש, שאמור להשתחרר בסופו של דבר באמצעות disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

ה- ITestDevice המוחזר יהיה מקוון, אך עשוי שלא להגיב.

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

התנתק ממכשיר המחובר adb-over-tcp.

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

פלט תיאור ידידותי למשתמש המכיל רשימה של מכשירים ידועים, מצבם וערכים עבור אפשרויות IDeviceSelection הנפוצות.

abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)

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

abstract ITestDevice forceAllocateDevice (String serial)

הקצו בגסות מכשיר, גם אם הוא אינו זמין כעת.

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

החזר מכשיר לבריכה

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

abstract String getAdbPath ()

מחזיר את הנתיב ל-ADB הבינארי לשימוש.

abstract String getAdbVersion ()

קבל את גרסת ה-ADB שנמצאת בשימוש כעת על ידי מנהל ההתקנים.

abstract DeviceDescriptor getDeviceDescriptor (String serial)

מחזיר את DeviceDescriptor עם הסידור הנתון.

abstract String getFastbootPath ()

מחזיר את הנתיב ל-fastboot הבינארי לשימוש.

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

אתחל את מנהל ההתקנים עם מסנן התקנים.

abstract void init ()

אתחל את מנהל ההתקנים.

abstract boolean isEmulator (String serial)

קבע אם סדרה נתונה מייצגת אמולטור

default boolean isFileSystemMountCheckEnabled ()

מחזירה האם עלינו לבדוק ב- NativeDeviceStateMonitor שמערכת הקבצים מותאמת כהלכה.

abstract boolean isNullDevice (String serial)

קבע אם הסדרה הנתונה מייצגת התקן null

abstract void killEmulator ( ITestDevice device)

כבה את האמולטור הנתון.

abstract void launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

שיטת עוזר להפעלת אמולטור.

abstract listAllDevices (boolean shortDescriptor)

מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים

abstract listAllDevices ()

מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים

abstract ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

שיטת עוזר שמעבירה את מכשיר ה-USB הנתון למצב adb-over-tcp, ולאחר מכן מתחברת אליו באמצעות connectToTcpDevice(String) .

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

מסיר IDeviceMonitor שנוסף בעבר.

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

מודיע למנהל שמאזין אינו מעוניין עוד בשינויי מצב אתחול מהיר.

abstract void restartAdbBridge ()

הפעל מחדש (אם stopAdbBridge() נקרא) גשר adb והשירותים תלויים בחיבורי adb.

abstract void stopAdbBridge ()

עצור את גשר adb והשירותים תלויים בחיבורי adb.

abstract void terminate ()

מפסיק שירותי ניטור מכשירים ומסיים את ספריית ddm.

abstract void terminateDeviceMonitor ()

עצור את צגי ההתקן.

abstract void terminateDeviceRecovery ()

עוצר את שרשור שחזור המכשיר.

default void terminateHard (String reason)

כמו terminateHard() .

abstract void terminateHard ()

כמו terminate() , אבל מנסה לכבות בכוח גם את adb.

abstract boolean waitForFirstDeviceAdded (long timeout)

המתן עד לחיבור מכשיר פיזי ראשון.

שיטות ציבוריות

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

מוסיף IDeviceMonitor

פרמטרים
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

מודיע למנהל שמאזין מעוניין בשינויי מצב אתחול מהיר.

נכון לעכשיו IDeviceManager ינטר מכשירים ב-fastboot רק אם יש מאזין פעיל אחד או יותר.

TODO: זה קצת פריצה - מצא פתרון טוב יותר

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

הוסף מכשיר למסך מהיר אתחול. צג fastboot ישתמש ב-'fastboot_serial' כדי לתקשר עם המכשיר.

פרמטרים
serial String : המספר הסידורי של המכשיר.

fastboot_serial String : המספר הסידורי של מצב האתחול המהיר של המכשיר.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים.

פרמטרים
options IDeviceSelection : ה- IDeviceSelection שהמכשיר צריך לעמוד בו.

isTemporary boolean : האם יש ליצור NullDevice זמני או לא.

החזרות
ITestDevice ITestDevice לבדיקה, או null אם אחד לא זמין

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים.

פרמטרים
options IDeviceSelection : ה- IDeviceSelection שהמכשיר צריך לעמוד בו.

החזרות
ITestDevice ITestDevice לבדיקה, או null אם אחד לא זמין

allocateDevice

public abstract ITestDevice allocateDevice ()

בקש מכשיר פיזי לבדיקה

החזרות
ITestDevice ITestDevice לבדיקה, או null אם אחד לא זמין

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

התחבר למכשיר עם adb-over-tcp

שיטה זו מקצה מכשיר חדש, שאמור להשתחרר בסופו של דבר באמצעות disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

ה- ITestDevice המוחזר יהיה מקוון, אך עשוי שלא להגיב.

שים לב שביצוע פעולה כגון אתחול מחדש במכשיר המחובר ל-tcp, תנתק את חיבור ה-tcp למכשיר, ויגרום ל- DeviceNotAvailableException

פרמטרים
ipAndPort String : כתובת ה-IP המקורית והיציאה של המכשיר שאליו יש להתחבר

החזרות
ITestDevice ה- ITestDevice או null אם לא ניתן היה ליצור חיבור tcp

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

התנתק ממכשיר המחובר adb-over-tcp.

מחזיר את המכשיר למצב usb ומשחרר אותו.

פרמטרים
tcpDevice ITestDevice : המכשיר שנמצא כרגע במצב tcp, שהוקצה בעבר באמצעות connectToTcpDevice(String)

החזרות
boolean true אם המעבר למצב usb הצליח

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

פלט תיאור ידידותי למשתמש המכיל רשימה של מכשירים ידועים, מצבם וערכים עבור אפשרויות IDeviceSelection הנפוצות.

פרמטרים
printWriter PrintWriter : ה- ERROR(/PrintWriter) שאליו יש פלט של התיאור

includeStub boolean : האם להציג גם התקני סטאב או לא.

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

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

פרמטרים
serial String : סדרת המכשיר.

command String : פקודת המעטפת.

timeout long : משך הזמן להשלמת הפקודה.

timeUnit TimeUnit : היחידה לזמן קצוב.

החזרות
CommandResult תוצאה של CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

הקצו בגסות מכשיר, גם אם הוא אינו זמין כעת.

לא תהיה השפעה אם המכשיר כבר הוקצה.

פרמטרים
serial String : סדרת המכשיר להקצאה

החזרות
ITestDevice ה- ITestDevice , או null אם לא ניתן היה להקצות אותו

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

החזר מכשיר לבריכה

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

פרמטרים
device ITestDevice : ה- ITestDevice לחופשי

state FreeDeviceState : FreeDeviceState . משמש כדי לקבוע אם המכשיר יוחזר למאגר המכשירים הזמין.

getAdbPath

public abstract String getAdbPath ()

מחזיר את הנתיב ל-ADB הבינארי לשימוש.

החזרות
String

getAdbVersion

public abstract String getAdbVersion ()

קבל את גרסת ה-ADB שנמצאת בשימוש כעת על ידי מנהל ההתקנים.

החזרות
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

מחזיר את DeviceDescriptor עם הסידור הנתון.

פרמטרים
serial String : מספר סידורי שניתן לקבל את המכשיר

החזרות
DeviceDescriptor ה- DeviceDescriptor עבור ההתקן הנבחר, או null אם הסדרתי לא תואם למכשיר מוכר.

getFastbootPath

public abstract String getFastbootPath ()

מחזיר את הנתיב ל-fastboot הבינארי לשימוש.

החזרות
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

אתחל את מנהל ההתקנים עם מסנן התקנים. ניתן להשתמש במסנן זה כדי להורות למנהל ההתקנים להתעלם מהתקנים מחוברים מסוימים.

פרמטרים
globalDeviceFilter IDeviceSelection : מסנן המכשיר

deviceMonitors

init

public abstract void init ()

אתחל את מנהל ההתקנים. יש לקרוא לזה פעם אחת ורק פעם אחת לפני שקוראים לשיטות אחרות.

isEmulator

public abstract boolean isEmulator (String serial)

קבע אם סדרה נתונה מייצגת אמולטור

פרמטרים
serial String

החזרות
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

מחזירה האם עלינו לבדוק ב- NativeDeviceStateMonitor שמערכת הקבצים מותאמת כהלכה.

החזרות
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

קבע אם הסדרה הנתונה מייצגת התקן null

פרמטרים
serial String

החזרות
boolean

KillEmulator

public abstract void killEmulator (ITestDevice device)

כבה את האמולטור הנתון.

חוסם עד שהאמולטור ייעלם מ-adb. לא תהיה השפעה אם האמולטור כבר לא זמין.

פרמטרים
device ITestDevice : אמולטור המייצג ITestDevice לכיבוי

זורק
DeviceNotAvailableException אם האמולטור לא מצליח לכבות

הפעל אמולטור

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

שיטת עוזר להפעלת אמולטור.

יפעיל את האמולטור כפי שצוין על ידי המתקשר

פרמטרים
device ITestDevice : מציין המיקום ITestDevice המייצג מכשיר אמולטור שהוקצה

bootTimeout long : הזמן ב-ms להמתין לאתחול האמולטור

emulatorArgs : ארגומנטים של שורת הפקודה להפעלת האמולטור

זורק
DeviceNotAvailableException אם האמולטור לא מצליח לאתחל או להתחבר לאינטרנט

רשימת כל המכשירים

public abstract  listAllDevices (boolean shortDescriptor)

מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים

פרמטרים
shortDescriptor boolean : האם להגביל מתארים למינימום מידע

החזרות
רשימה של DeviceDescriptor עבור כל המכשירים המוכרים

רשימת כל המכשירים

public abstract  listAllDevices ()

מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים

החזרות
רשימה של DeviceDescriptor עבור כל המכשירים המוכרים

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

שיטת עוזר שמעבירה את מכשיר ה-USB הנתון למצב adb-over-tcp, ולאחר מכן מתחברת אליו באמצעות connectToTcpDevice(String) .

פרמטרים
usbDevice ITestDevice : המכשיר נמצא כעת במצב usb

החזרות
ITestDevice ה- ITestDevice שהוקצה לאחרונה במצב tcp או null אם לא ניתן היה ליצור חיבור tcp

זורק
DeviceNotAvailableException אם החיבור עם usbDevice אבד ולא ניתן היה לשחזר אותו

הסר את DeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

מסיר IDeviceMonitor שנוסף בעבר. אין השפעה אם mon לא התווסף.

פרמטרים
mon IDeviceMonitor

הסר את FastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

מודיע למנהל שמאזין אינו מעוניין עוד בשינויי מצב אתחול מהיר.

הפעל מחדש את AdbBridge

public abstract void restartAdbBridge ()

הפעל מחדש (אם stopAdbBridge() נקרא) גשר adb והשירותים תלויים בחיבורי adb.

stopAdbBridge

public abstract void stopAdbBridge ()

עצור את גשר adb והשירותים תלויים בחיבורי adb.

לבטל, לסיים

public abstract void terminate ()

מפסיק שירותי ניטור מכשירים ומסיים את ספריית ddm.

יש להפעיל זאת עם סיום הבקשה.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

עצור את צגי ההתקן.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

עוצר את שרשור שחזור המכשיר.

terminateHard

public void terminateHard (String reason)

כמו terminateHard() .

פרמטרים
reason String : סיבה אופציונלית שניתנה לסיום.

terminateHard

public abstract void terminateHard ()

כמו terminate() , אבל מנסה לכבות בכוח גם את adb.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

המתן עד לחיבור מכשיר פיזי ראשון. אם מכשיר היה מחובר בעבר, הוא מחזיר ישירות True. אם לא התווסף מכשיר, הוא מחזיר false לאחר פסק הזמן הקצוב.

פרמטרים
timeout long : זמן המתנה באלפית שניות לפני החזרת false.

החזרות
boolean