DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
   ↳ com.android.tradefed.device.DeviceManager

סיכום

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

class DeviceManager.FastbootDevice

ייצוג של מכשיר במצב אתחול מהיר (Fastboot mode). 

ערכים קבועים

String UNKNOWN_DISPLAY_STRING

מחרוזת להצגה של מאפיינים לא ידועים

שדות

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

‫constructors ציבוריים

DeviceManager()

צריך לאחזר את DeviceManager מ-GlobalConfiguration

‫methods ציבוריים

void addAvailableDevice(IDevice stubDevice)
void addAvailableNativeDevice(IDevice stubDevice)
void addDeviceMonitor(IDeviceMonitor mon)

הוספה של IDeviceMonitor

void addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener(IDeviceManager.IFastbootListener listener)

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

void addMonitoringTcpFastbootDevice(String serial, String fastbootSerial)

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

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice(IDeviceSelection options)

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

ITestDevice allocateDevice()

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

ITestDevice connectToTcpDevice(String ipAndPort)

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

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

ה-ITestDevice שיוחזר יהיה אונליין, אבל יכול להיות שלא יגיב.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

void displayDevicesInfo(PrintWriter stream, boolean includeStub)

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

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

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

String executeGlobalAdbCommand(String... cmdArgs)

מריצים פקודת adb שלא מטרגטת מכשיר מסוים, למשל:

ITestDevice forceAllocateDevice(String serial)

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

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

החזרת מכשיר למאגר

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

String getAdbPath()

מחזירה את הנתיב לקובץ הבינארי של adb שבו צריך להשתמש.

String getAdbVersion()

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

DeviceDescriptor getDeviceDescriptor(String serial)

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

String getFastbootPath()

הפונקציה מחזירה את הנתיב לקובץ הבינארי של fastboot שבו צריך להשתמש.

long getShellCheckCmdTime()

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

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

מאתחלים את מנהל המכשירים.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors)

מאתחלים את מנהל המכשירים.

void init()

מאתחלים את מנהל המכשירים.

boolean isEmulator(String serial)

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

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

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

void killEmulator(ITestDevice device)

כיבוי האמולטור שצוין.

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

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

List<DeviceDescriptor> listAllDevices(boolean shortDescriptor)

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

List<DeviceDescriptor> listAllDevices()

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

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

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

void removeDeviceMonitor(IDeviceMonitor mon)

הסרת IDeviceMonitor שנוסף בעבר.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void removeMonitoringTcpFastbootDevice(String serial)

void restartAdbBridge()

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

void stopAdbBridge()

הפסקת adb bridge ושירותים שתלויים בחיבורי adb.

void terminate()

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

void terminateDeviceMonitor()

מפסיקים את המעקב אחרי המכשירים.

void terminateDeviceRecovery()

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

void terminateHard(String reason)

כמו terminateHard().

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

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

ערכים קבועים

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

מחרוזת להצגה של מאפיינים לא ידועים

ערך קבוע: "unknown"

שדות

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

‫constructors ציבוריים

DeviceManager

public DeviceManager ()

צריך לאחזר את DeviceManager מ-GlobalConfiguration

‫methods ציבוריים

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

פרמטרים
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

פרמטרים
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

הוספה של IDeviceMonitor

פרמטרים
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

פרמטרים
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addSubnetwork

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

מוסיפים מכשיר ל-fastboot monitor. הכלי fastboot monitor ישתמש ב-fastboot_serial כדי לתקשר עם המכשיר.

פרמטרים
serial ‫String: המספר הסידורי של המכשיר.
fastbootSerial ‫String: המספר הסידורי של המכשיר במצב Fastboot.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

פרמטרים
options ‫IDeviceSelection: IDeviceSelection שהמכשיר צריך לעמוד בה.
isTemporary ‫boolean: האם ליצור NullDevice זמני.
החזרות
ITestDevice ‫ITestDevice לבדיקה, או null אם אין כזה

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

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

פרמטרים
options ‫IDeviceSelection: IDeviceSelection שהמכשיר צריך לעמוד בה.
החזרות
ITestDevice ‫ITestDevice לבדיקה, או null אם אין כזה

allocateDevice

public ITestDevice allocateDevice ()

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

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

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

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

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

ה-ITestDevice שיוחזר יהיה אונליין, אבל יכול להיות שלא יגיב.

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

פרמטרים
ipAndPort ‫String: כתובת ה-IP והיציאה המקוריות של המכשיר שאליו רוצים להתחבר
החזרות
ITestDevice ‫ITestDevice או null אם לא ניתן ליצור חיבור TCP

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

הפקודה מחזירה את המכשיר למצב USB ומשחררת אותו.

פרמטרים
tcpDevice ‫ITestDevice: המכשיר שנמצא כרגע במצב tcp, שהוקצה קודם באמצעות connectToTcpDevice(String)
החזרות
boolean ‫true אם המעבר למצב USB הצליח

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

פרמטרים
stream ‫PrintWriter: PrintWriter שאליו יוצא התיאור
includeStub ‫boolean: האם להציג גם מכשירי stub.

executeCmdOnAvailableDevice

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

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

פרמטרים
serial ‫String: המספר הסידורי של המכשיר.
command String: פקודת ה-Shell.
timeout ‫long: משך הזמן עד לסיום הפקודה.
timeUnit ‫TimeUnit: היחידה של הזמן הקצוב לתפוגה.
החזרות
CommandResult CommandResult.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

מריצים פקודת adb שלא מטרגטת מכשיר מסוים, למשל: ‫'adb connect'

החזרות
String פלט רגיל אם הפקודה מצליחה, אחרת null.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

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

פרמטרים
serial String: המספר הסידורי של המכשיר להקצאה
החזרות
ITestDevice ‫ITestDevice או null אם לא ניתן להקצות אותו

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

החזרת מכשיר למאגר

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

פרמטרים
device ‫ITestDevice: ITestDevice פנויים
deviceState ‫FreeDeviceState: FreeDeviceState. המאפיין הזה משמש כדי לקבוע אם המכשיר יוחזר למאגר המכשירים הזמינים.

getAdbPath

public String getAdbPath ()

מחזירה את הנתיב לקובץ הבינארי של adb שבו צריך להשתמש.

החזרות
String

getAdbVersion

public String getAdbVersion ()

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

החזרות
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

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

פרמטרים
serial ‫String: המספר הסידורי של המכשיר שרוצים לקבל
החזרות
DeviceDescriptor ‫DeviceDescriptor של המכשיר שנבחר, או null אם המספר הסידורי לא תואם למכשיר מוכר.

getFastbootPath

public String getFastbootPath ()

הפונקציה מחזירה את הנתיב לקובץ הבינארי של fastboot שבו צריך להשתמש.

החזרות
String

getShellCheckCmdTime

public long getShellCheckCmdTime ()

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

החזרות
long

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

פרמטרים
globalDeviceFilter IDeviceSelection

globalDeviceMonitors List

deviceFactory IManagedTestDeviceFactory

init

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

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

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

init

public void init ()

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

isEmulator

public boolean isEmulator (String serial)

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

פרמטרים
serial String

החזרות
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

החזרות
boolean

isNullDevice

public boolean isNullDevice (String serial)

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

פרמטרים
serial String

החזרות
boolean

killEmulator

public void killEmulator (ITestDevice device)

כיבוי האמולטור שצוין.

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

פרמטרים
device ‫ITestDevice: ITestDevice שמייצג את האמולטור שרוצים לסגור
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

launchEmulator

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

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

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

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

listAllDevices

public List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

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

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

listAllDevices

public List<DeviceDescriptor> listAllDevices ()

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

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

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

פרמטרים
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

פרמטרים
serial String

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

הפסקת adb bridge ושירותים שתלויים בחיבורי adb.

סגירת חשבון

public void terminate ()

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

צריך להפעיל את הפונקציה הזו כשמפסיקים את האפליקציה.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

מפסיקים את המעקב אחרי המכשירים.

terminateDeviceRecovery

public void terminateDeviceRecovery ()

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

terminateHard

public void terminateHard (String reason)

כמו terminateHard().

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

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

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

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