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

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 אם יש מאזין פעיל אחד או יותר.

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

addMonitoringTcpFastbootDevice

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(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: פקודת ה-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

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