מנהל התקן

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 מה- 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)

הוסף מכשיר למסך מהיר אתחול.

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

מחזיר את הנתיב ל-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 ()

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

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

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

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

public  listAllDevices (boolean shortDescriptor)

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

פרמטרים
shortDescriptor boolean : האם להגביל מתארים למינימום מידע

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

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

public  listAllDevices ()

מחזירה רשימה של 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 : סיבה אופציונלית שניתנה לסיום.

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

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

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

החזרות
boolean