IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

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

סיכום

כיתות מוטמעות

interface IDeviceManager.IFastbootListener

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

‫methods ציבוריים

abstract void addDeviceMonitor(IDeviceMonitor mon)

הוספה של IDeviceMonitor

abstract void addFastbootListener(IDeviceManager.IFastbootListener listener)

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

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

מוסיפים מכשיר ל-fastboot monitor.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice(IDeviceSelection options)

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

abstract ITestDevice allocateDevice()

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

abstract ITestDevice connectToTcpDevice(String ipAndPort)

התחברות למכשיר באמצעות adb-over-tcp

בשיטה הזו מוקצה מכשיר חדש, שאמור להתפנות בסופו של דבר באמצעות disconnectFromTcpDevice(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 long getShellCheckCmdTime()

מקבל את הזמן הקצוב לתפוגה במילישניות של פקודת בדיקת הזמינות של המעטפת.

abstract void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> 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, List<String> emulatorArgs)

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

abstract List<DeviceDescriptor> listAllDevices(boolean shortDescriptor)

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

abstract List<DeviceDescriptor> 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.

default void removeMonitoringTcpFastbootDevice(String serial)
abstract void restartAdbBridge()

מפעילים מחדש (אם בוצעה קריאה ל-stopAdbBridge()) את גשר adb ואת השירותים שתלויים בחיבורי 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)

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

‫methods ציבוריים

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

הוספה של IDeviceMonitor

פרמטרים
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

לא לשכוח: זה קצת פתרון מאולתר – צריך למצוא פתרון טוב יותר

addSubnetwork

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

מוסיפים מכשיר ל-fastboot monitor. הכלי fastboot monitor ישתמש ב-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(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: PrintWriter שאליו יוצא התיאור
includeStub ‫boolean: האם להציג גם מכשירי stub.

executeCmdOnAvailableDevice

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

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

פרמטרים
serial ‫String: המספר הסידורי של המכשיר.
command String: פקודת ה-Shell.
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

getShellCheckCmdTime

public abstract long getShellCheckCmdTime ()

מקבל את הזמן הקצוב לתפוגה במילישניות של פקודת בדיקת הזמינות של המעטפת.

החזרות
long

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> deviceMonitors)

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

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

init

public abstract void init ()

מאתחלים את מנהל המכשירים. צריך להפעיל את ה-method הזו פעם אחת בלבד לפני שמפעילים methods אחרות.

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 שמייצג את האמולטור שרוצים לסגור
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם האמולטור לא נסגר

launchEmulator

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                List<String> emulatorArgs)

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

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

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

listAllDevices

public abstract List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

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

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

listAllDevices

public abstract List<DeviceDescriptor> listAllDevices ()

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

החזרות
List<DeviceDescriptor> רשימה של DeviceDescriptor לכל המכשירים הידועים

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

פרמטרים
usbDevice ‫ITestDevice: המכשיר שנמצא כרגע במצב USB
החזרות
ITestDevice הערך ITestDevice שהוקצה לאחרונה במצב tcp או null אם לא ניתן היה ליצור חיבור tcp

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם החיבור עם usbDevice נותק ולא ניתן לשחזר אותו

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

פרמטרים
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

פרמטרים
serial String

restartAdbBridge

public abstract void restartAdbBridge ()

מפעילים מחדש (אם בוצעה קריאה ל-stopAdbBridge()) את גשר adb ואת השירותים שתלויים בחיבורי 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