IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
ממשק לניהול מערך המכשירים הזמינים לבדיקה.
סיכום
כיתות מקוננות | |
---|---|
interface | IDeviceManager.IFastbootListener מאזין לשינויי מצב אתחול מהיר. |
שיטות ציבוריות | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) מוסיף |
abstract void | addFastbootListener ( IDeviceManager.IFastbootListener listener) מודיע למנהל שמאזין מעוניין בשינויי מצב אתחול מהיר. |
abstract void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) הוסף מכשיר למסך מהיר אתחול. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options) בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים. |
abstract ITestDevice | allocateDevice () בקש מכשיר פיזי לבדיקה |
abstract ITestDevice | connectToTcpDevice (String ipAndPort) התחבר למכשיר עם adb-over-tcp שיטה זו מקצה מכשיר חדש, שאמור להשתחרר בסופו של דבר באמצעות ה- |
abstract boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) התנתק ממכשיר המחובר adb-over-tcp. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) פלט תיאור ידידותי למשתמש המכיל רשימה של מכשירים ידועים, מצבם וערכים עבור אפשרויות |
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) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) אתחל את מנהל ההתקנים עם מסנן התקנים. |
abstract void | init () אתחל את מנהל ההתקנים. |
abstract boolean | isEmulator (String serial) קבע אם סדרה נתונה מייצגת אמולטור |
default boolean | isFileSystemMountCheckEnabled () מחזירה האם עלינו לבדוק ב- |
abstract boolean | isNullDevice (String serial) קבע אם הסדרה הנתונה מייצגת התקן null |
abstract void | killEmulator ( ITestDevice device) כבה את האמולטור הנתון. |
abstract void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) 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, ולאחר מכן מתחברת אליו באמצעות |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) מסיר |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) מודיע למנהל שמאזין אינו מעוניין עוד בשינויי מצב אתחול מהיר. |
abstract void | restartAdbBridge () הפעל מחדש (אם |
abstract void | stopAdbBridge () עצור את גשר adb והשירותים תלויים בחיבורי adb. |
abstract void | terminate () מפסיק שירותי ניטור מכשירים ומסיים את ספריית ddm. |
abstract void | terminateDeviceMonitor () עצור את צגי ההתקן. |
abstract void | terminateDeviceRecovery () עוצר את שרשור שחזור המכשיר. |
default void | terminateHard (String reason) כמו |
abstract void | terminateHard () כמו |
abstract boolean | waitForFirstDeviceAdded (long timeout) המתן עד לחיבור מכשיר פיזי ראשון. |
שיטות ציבוריות
addDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
מוסיף IDeviceMonitor
פרמטרים | |
---|---|
mon | IDeviceMonitor |
addFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
מודיע למנהל שמאזין מעוניין בשינויי מצב אתחול מהיר.
נכון לעכשיו IDeviceManager
ינטר מכשירים ב-fastboot רק אם יש מאזין פעיל אחד או יותר.
TODO: זה קצת פריצה - מצא פתרון טוב יותר
addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
הוסף מכשיר למסך מהיר אתחול. צג fastboot ישתמש ב-'fastboot_serial' כדי לתקשר עם המכשיר.
פרמטרים | |
---|---|
serial | String : המספר הסידורי של המכשיר. |
fastboot_serial | String : המספר הסידורי של מצב האתחול המהיר של המכשיר. |
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 : האם להציג גם התקני סטאב או לא. |
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)
אתחל את מנהל ההתקנים עם מסנן התקנים. ניתן להשתמש במסנן זה כדי להורות למנהל ההתקנים להתעלם מהתקנים מחוברים מסוימים.
פרמטרים | |
---|---|
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 | אם האמולטור לא מצליח לכבות |
הפעל אמולטור
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
שיטת עוזר להפעלת אמולטור.
יפעיל את האמולטור כפי שצוין על ידי המתקשר
פרמטרים | |
---|---|
device | ITestDevice : מציין המיקום ITestDevice המייצג מכשיר אמולטור שהוקצה |
bootTimeout | long : הזמן ב-ms להמתין לאתחול האמולטור |
emulatorArgs |
זורק | |
---|---|
DeviceNotAvailableException | אם האמולטור לא מצליח לאתחל או להתחבר לאינטרנט |
רשימת כל המכשירים
public abstractlistAllDevices (boolean shortDescriptor)
מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים
פרמטרים | |
---|---|
shortDescriptor | boolean : האם להגביל מתארים למינימום מידע |
החזרות | |
---|---|
רשימה של DeviceDescriptor עבור כל המכשירים המוכרים |
רשימת כל המכשירים
public abstractlistAllDevices ()
מחזירה רשימה של 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 אבד ולא ניתן היה לשחזר אותו |
הסר את DeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
מסיר IDeviceMonitor
שנוסף בעבר. אין השפעה אם mon לא התווסף.
פרמטרים | |
---|---|
mon | IDeviceMonitor |
הסר את FastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
מודיע למנהל שמאזין אינו מעוניין עוד בשינויי מצב אתחול מהיר.
הפעל מחדש את AdbBridge
public abstract void restartAdbBridge ()
הפעל מחדש (אם stopAdbBridge()
נקרא) גשר adb והשירותים תלויים בחיבורי adb.
stopAdbBridge
public abstract void stopAdbBridge ()
עצור את גשר adb והשירותים תלויים בחיבורי 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 |
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-03-30 (שעון UTC).