מנהל מכשירים

public class DeviceManager
extends Object implements IDeviceManager

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

סיכום

מחלקות מקוננות

class DeviceManager.FastbootDevice

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

שדות

public static final String UNKNOWN_DISPLAY_STRING

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

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

בנאים ציבוריים

DeviceManager()

יש לאחזר את DeviceManager מה-GlobalConfiguration

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

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

הוספת IDeviceMonitor

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

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

void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

הוספת מכשיר לצג לאתחול מהיר (fastboot).

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice(IDeviceSelection options)

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

ITestDevice allocateDevice()

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

ITestDevice connectToTcpDevice(String ipAndPort)

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

השיטה הזו מקצה מכשיר חדש, שבסופו של דבר ישוחרר דרך disconnectFromTcpDevice(com.android.tradefed.device.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()

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

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

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

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

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

void init()

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

boolean isEmulator(String serial)

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

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

החליטו אם המספר הסידורי הנתון מייצג מכשיר אפס

void killEmulator(ITestDevice device)

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

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

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

listAllDevices(boolean shortDescriptor)

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

listAllDevices()

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

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

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

void removeDeviceMonitor(IDeviceMonitor mon)

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

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge()

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

void stopAdbBridge()

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

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

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

בנאים ציבוריים

מנהל מכשירים

public DeviceManager ()

יש לאחזר את DeviceManager מה-GlobalConfiguration

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

addAvailableDevice

public void addAvailableDevice (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)

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

בשלב הזה, IDeviceManager יעקוב אחר מכשירים בתהליך אתחול מהיר (fastboot) רק אם יש אחד כזה או מאזינים פעילים יותר.

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

הקצאת מכשיר

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

הקצאת מכשיר

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

הקצאת מכשיר

public ITestDevice allocateDevice ()

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

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

ConnectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

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

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

התנתקות מ-TcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

נתוני displaydeviceInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

פרמטרים
stream PrintWriter: ה-ERROR(/PrintWriter) שאליו צריך לשלוח את התיאור
includeStub boolean: האם להציג גם מכשירי סטודנטים.

substituteCmdOnAvailableDevice

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

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

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

ActivateGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

להריץ פקודת adb שאינה מטורגטת למכשיר מסוים, למשל: adb Connect

החזרות
String פלט std אם הפקודה מצליחה ללא ערך null.

PowerAllocateDevice

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 ()

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

החזרות
String

להתחיל

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

פרמטרים
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

להתחיל

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

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

להתחיל

public void init ()

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

isEmulator

public boolean isEmulator (String serial)

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

פרמטרים
serial String

החזרות
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

החזרות
boolean

isNullDevice

public boolean isNullDevice (String serial)

החליטו אם המספר הסידורי הנתון מייצג מכשיר אפס

פרמטרים
serial String

החזרות
boolean

killEmulator

public void killEmulator (ITestDevice device)

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

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

פרמטרים
device ITestDevice: ה-ITestDevice שמייצג את האמולטור לכיבוי
קליעות
DeviceNotAvailableException

השקה אמולטור

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

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

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

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

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

public  listAllDevices (boolean shortDescriptor)

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

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

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

public  listAllDevices ()

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

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

ConnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

הסרתDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

פרמטרים
mon IDeviceMonitor

הסרת אתחול מהיר (FastbootListener)

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

הפעלה מחדש של AdbBiger

public void restartAdbBridge ()

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

stopAdbBiger

public void stopAdbBridge ()

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

לסגור

public void terminate ()

הפסקת שירותי המעקב של המכשיר וסגירה של ספריית ה-ddm.

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

offsetDeviceMonitor

public void terminateDeviceMonitor ()

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

סגירה של שחזור המכשיר

public void terminateDeviceRecovery ()

הפסקת השרשור של שחזור המכשיר.

סגירה

public void terminateHard (String reason)

כמו terminateHard().

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

סגירה

public void terminateHard ()

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

pendingForFirstDevice added

public boolean waitForFirstDeviceAdded (long timeout)

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

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