מנהל התקן
public class DeviceManager
extends Object
implements IDeviceManager
java.lang.Object | |
↳ | com.android.tradefed.device.DeviceManager |
סיכום
כיתות מקוננות | |
---|---|
class | DeviceManager.FastbootDevice ייצוג של מכשיר במצב Fastboot. |
שדות | |
---|---|
public static final String | UNKNOWN_DISPLAY_STRING הצגת מחרוזת עבור מאפיינים לא ידועים |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
בנאים ציבוריים | |
---|---|
DeviceManager () יש לאחזר את DeviceManager מה- |
שיטות ציבוריות | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) מוסיף |
void | addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice) |
void | addFastbootListener ( IDeviceManager.IFastbootListener listener) מודיע למנהל שמאזין מעוניין בשינויי מצב אתחול מהיר. |
void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) הוסף מכשיר למסך מהיר אתחול. |
ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים. |
ITestDevice | allocateDevice ( IDeviceSelection options) בקש מכשיר לבדיקה שעומד בקריטריונים מסוימים. |
ITestDevice | allocateDevice () בקש מכשיר פיזי לבדיקה |
ITestDevice | connectToTcpDevice (String ipAndPort) התחבר למכשיר עם adb-over-tcp שיטה זו מקצה מכשיר חדש, שאמור להשתחרר בסופו של דבר באמצעות ה- |
boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) התנתק ממכשיר המחובר adb-over-tcp. |
void | displayDevicesInfo (PrintWriter stream, boolean includeStub) פלט תיאור ידידותי למשתמש המכיל רשימה של מכשירים ידועים, מצבם וערכים עבור אפשרויות |
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 הבינארי לשימוש. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) אתחל את מנהל ההתקנים. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) אתחל את מנהל ההתקנים. |
void | init () אתחל את מנהל ההתקנים. |
boolean | isEmulator (String serial) קבע אם סדרה נתונה מייצגת אמולטור |
boolean | isFileSystemMountCheckEnabled () מחזירה האם עלינו לבדוק ב- |
boolean | isNullDevice (String serial) קבע אם הסדרה הנתונה מייצגת התקן null |
void | killEmulator ( ITestDevice device) כבה את האמולטור הנתון. |
void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) שיטת עוזר להפעלת אמולטור. |
listAllDevices (boolean shortDescriptor) מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים | |
listAllDevices () מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים | |
ITestDevice | reconnectDeviceToTcp ( ITestDevice usbDevice) שיטת עוזר שמעבירה את מכשיר ה-USB הנתון למצב adb-over-tcp, ולאחר מכן מתחברת אליו באמצעות |
void | removeDeviceMonitor ( IDeviceMonitor mon) מסיר |
void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) מודיע למנהל שמאזין אינו מעוניין עוד בשינויי מצב אתחול מהיר. |
void | restartAdbBridge () הפעל מחדש (אם |
void | stopAdbBridge () עצור את גשר adb והשירותים תלויים בחיבורי adb. |
void | terminate () מפסיק שירותי ניטור מכשירים ומסיים את ספריית ddm. |
void | terminateDeviceMonitor () עצור את צגי ההתקן. |
void | terminateDeviceRecovery () עוצר את שרשור שחזור המכשיר. |
void | terminateHard (String reason) כמו |
void | terminateHard () כמו |
boolean | waitForFirstDeviceAdded (long timeout) המתן עד לחיבור מכשיר פיזי ראשון. |
שדות
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
הצגת מחרוזת עבור מאפיינים לא ידועים
mDvcMon
protected DeviceMonitorMultiplexer mDvcMon
mFastbootEnabled
protected boolean mFastbootEnabled
בנאים ציבוריים
שיטות ציבוריות
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 רק אם יש מאזין פעיל אחד או יותר.
TODO: זה קצת פריצה - מצא פתרון טוב יותר
addMonitoringTcpFastbootDevice
public void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
הוסף מכשיר למסך מהיר אתחול. צג fastboot ישתמש ב-'fastboot_serial' כדי לתקשר עם המכשיר.
פרמטרים | |
---|---|
serial | String : המספר הסידורי של המכשיר. |
fastboot_serial | String : המספר הסידורי של מצב האתחול המהיר של המכשיר. |
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(com.android.tradefed.device.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 : ה- ERROR(/PrintWriter) שאליו יש פלט של התיאור |
includeStub | boolean : האם להציג גם התקני סטאב או לא. |
executeCmdOnAvailableDevice
public CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
שיטת עוזר לביצוע פקודת מעטפת במכשיר זמין.
פרמטרים | |
---|---|
serial | String : סדרת המכשיר. |
command | String : פקודת המעטפת. |
timeout | long : משך הזמן להשלמת הפקודה. |
timeUnit | TimeUnit : היחידה לזמן קצוב. |
החזרות | |
---|---|
CommandResult | תוצאה של CommandResult . |
executeGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
בצע פקודת adb שאינה ממוקדת למכשיר מסוים, למשל. 'adb connect'
החזרות | |
---|---|
String | פלט std אם הפקודה succeedm 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 |
init
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
אתחל את מנהל ההתקנים. יש לקרוא לזה פעם אחת ורק פעם אחת לפני שקוראים לשיטות אחרות.
פרמטרים | |
---|---|
globalDeviceFilter | IDeviceSelection |
globalDeviceMonitors | |
deviceFactory | IManagedTestDeviceFactory |
init
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
אתחל את מנהל ההתקנים. יש לקרוא לזה פעם אחת ורק פעם אחת לפני שקוראים לשיטות אחרות.
פרמטרים | |
---|---|
globalDeviceFilter | IDeviceSelection : מסנן המכשיר |
globalDeviceMonitors |
init
public void init ()
אתחל את מנהל ההתקנים. יש לקרוא לזה פעם אחת ורק פעם אחת לפני שקוראים לשיטות אחרות.
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 לכיבוי |
זורק | |
---|---|
DeviceNotAvailableException |
הפעל אמולטור
public void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
שיטת עוזר להפעלת אמולטור.
יפעיל את האמולטור כפי שצוין על ידי המתקשר
פרמטרים | |
---|---|
device | ITestDevice : מציין המיקום ITestDevice המייצג מכשיר אמולטור שהוקצה |
bootTimeout | long : הזמן ב-ms להמתין לאתחול האמולטור |
emulatorArgs |
זורק | |
---|---|
DeviceNotAvailableException |
רשימת כל המכשירים
publiclistAllDevices (boolean shortDescriptor)
מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים
פרמטרים | |
---|---|
shortDescriptor | boolean : האם להגביל מתארים למינימום מידע |
החזרות | |
---|---|
רשימה של DeviceDescriptor עבור כל המכשירים המוכרים |
רשימת כל המכשירים
publiclistAllDevices ()
מחזירה רשימה של DeviceDescriptors עבור כל המכשירים המוכרים
החזרות | |
---|---|
רשימה של DeviceDescriptor עבור כל המכשירים המוכרים |
reconnectDeviceToTcp
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 לא התווסף.
פרמטרים | |
---|---|
mon | IDeviceMonitor |
הסר את FastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
מודיע למנהל שמאזין אינו מעוניין עוד בשינויי מצב אתחול מהיר.
הפעל מחדש את AdbBridge
public void restartAdbBridge ()
הפעל מחדש (אם stopAdbBridge()
נקרא) גשר adb והשירותים תלויים בחיבורי adb.
stopAdbBridge
public void stopAdbBridge ()
עצור את גשר adb והשירותים תלויים בחיבורי adb.
לבטל, לסיים
public void terminate ()
מפסיק שירותי ניטור מכשירים ומסיים את ספריית ddm.
יש להפעיל זאת עם סיום הבקשה.
terminateDeviceMonitor
public void terminateDeviceMonitor ()
עצור את צגי ההתקן.
terminateDeviceRecovery
public void terminateDeviceRecovery ()
עוצר את שרשור שחזור המכשיר.
terminateHard
public void terminateHard (String reason)
כמו terminateHard()
.
פרמטרים | |
---|---|
reason | String : סיבה אופציונלית שניתנה לסיום. |
waitForFirstDeviceAdded
public boolean waitForFirstDeviceAdded (long timeout)
המתן עד לחיבור מכשיר פיזי ראשון. אם מכשיר היה מחובר בעבר, הוא מחזיר ישירות True. אם לא התווסף מכשיר, הוא מחזיר false לאחר פסק הזמן הקצוב.
פרמטרים | |
---|---|
timeout | long : זמן המתנה באלפית שניות לפני החזרת false. |
החזרות | |
---|---|
boolean |
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-03-30 (שעון UTC).