IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

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

סיכום

כיתות בתצוגת עץ

interface IDeviceManager.IFastbootListener

מאזין לשינויים במצב fastboot. 

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

abstract void addDeviceMonitor(IDeviceMonitor mon)

הוספה של IDeviceMonitor

abstract void addFastbootListener(IDeviceManager.IFastbootListener listener)

הודעה למנהל על כך שמאזין מעוניין לקבל עדכונים על שינויים במצב fastboot.

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

הוספת מכשיר למעקב אחר Fastboot.

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)

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

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)

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

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)

הודעה למנהל על כך שהמאזין לא מעוניין יותר בשינויים במצב fastboot.

abstract void restartAdbBridge()

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

abstract void stopAdbBridge()

עצירת adb bridge והשירותים תלויים בחיבורי 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)

הודעה למנהל על כך שמאזין מעוניין לקבל עדכונים על שינויים במצב fastboot.

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

TODO: this is a bit of a hack - find a better solution

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

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: האם להציג גם מכשירי stub.

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)

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

פרמטרים
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 אם הסימולטור לא נכבה

launchEmulator

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

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

ההפעלה של הסימולטור תתבצע לפי ההגדרה של מבצע הקריאה החוזרת

פרמטרים
device ITestDevice: placeholder‏ ITestDevice שמייצג את מכשיר האמולטור שהוקצה
bootTimeout long: משך הזמן באלפיות שנייה להמתנה להפעלה של הסימולטור
emulatorArgs : ארגומנטים בשורת הפקודה להפעלת האמולטור
זריקות
DeviceNotAvailableException אם לא ניתן להפעיל את הסימולטור או לחבר אותו לאינטרנט

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

הפונקציה מחזירה רשימה של DeviceDescriptors לכל המכשירים הידועים

פרמטרים
shortDescriptor boolean: האם להגביל את התיאורים למידע מינימלי
החזרות
רשימה של DeviceDescriptor לכל המכשירים הידועים

listAllDevices

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 התנתק ולא ניתן היה לשחזר אותו

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

פרמטרים
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

הודעה למנהל על כך שהמאזין לא מעוניין יותר בשינויים במצב fastboot.

restartAdbBridge

public abstract void restartAdbBridge ()

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

stopAdbBridge

public abstract void stopAdbBridge ()

עצירת adb bridge והשירותים תלויים בחיבורי 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