StubDevice

public class StubDevice
extends Object implements IDevice

java.lang.Object
   ↳ com.android.tradefed.device.StubDevice

הטמעה של פלייסהולדר של stub של IDevice.

סיכום

‫constructors ציבוריים

StubDevice(String serial)
StubDevice(String serial, boolean isEmulator)

‫methods ציבוריים

boolean arePropertiesSet()

הפונקציה מחזירה true אם הנכסים נשמרו במטמון

void createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)

יוצרת העברת פורטים בין פורט TCP מקומי לבין שקע דומיין Unix מרוחק.

void createForward(int localPort, int remotePort)

יוצרת העברת יציאה בין יציאה מקומית ליציאה מרוחקת.

void createReverse(int remotePort, int localPort)

יוצרת היפוך יציאות בין יציאה מרוחקת ליציאה מקומית.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.

void executeShellCommand(String command, IShellOutputReceiver receiver)

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

היא דומה לקריאה לפונקציה executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

void executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)

השיטה הזו הוצאה משימוש. להשתמש ב-executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.

getAbis()

מחזירה את ממשקי ה-ABI שנתמכים במכשיר הזה.

String getAvdName()

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

String getAvdPath()

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

getBattery(long freshnessTime, TimeUnit timeUnit)

הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.

getBattery()

הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.

Integer getBatteryLevel(long freshnessMs)

השיטה הזו הוצאה משימוש. במקומה צריך להשתמש ב-getBattery(long, TimeUnit).

Integer getBatteryLevel()

השיטה הזו הוצאה משימוש. במקומה צריך להשתמש ב-getBattery().

Client getClient(String applicationName)

מחזירה Client לפי שם האפליקציה.

String getClientName(int pid)

הפונקציה מחזירה את שם הלקוח לפי pid או null אם ה-pid לא ידוע

Client[] getClients()

מחזירה את מערך הלקוחות.

int getDensity()

הפונקציה מחזירה את סיווג הצפיפות של מסך המכשיר על ידי קריאת הערך של מאפיין המערכת PROP_DEVICE_DENSITY.

FileListingService getFileListingService()

מחזירה FileListingService למכשיר הזה.

String getLanguage()

הפונקציה מחזירה את השפה של המשתמש.

String getMountPoint(String name)

מחזירה נקודת טעינה.

String getName()

מחזירה שם (שקל לבני אדם להבין) של המכשיר.

getProperties()

השיטה הזו הוצאה משימוש. במקומה צריך להשתמש ב-getSystemProperty(String).

String getProperty(String name)

שיטת נוחות שמנסה לאחזר נכס באמצעות IShellEnabledDevice.getSystemProperty(String) עם זמן המתנה קצר מאוד, ומבטלת חריגים.

String getPropertyCacheOrSync(String name)

השיטה הזו הוצאה משימוש. במקומה צריך להשתמש ב-getProperty(String).

int getPropertyCount()

השיטה הזו הוצאה משימוש. הוצא משימוש ב-ddmlib עם הסיבה 'פרטי הטמעה'.

String getPropertySync(String name)

השיטה הזו הוצאה משימוש. במקומה צריך להשתמש ב-getProperty(String).

String getRegion()

הפונקציה מחזירה את האזור של המשתמש.

RawImage getScreenshot()

מצלם צילום מסך של המכשיר ומחזיר אותו כ-RawImage.

RawImage getScreenshot(long timeout, TimeUnit unit)
String getSerialNumber()

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

IDevice.DeviceState getState()

מחזירה את מצב המכשיר.

SyncService getSyncService()

מחזירה אובייקט SyncService כדי לדחוף קבצים למכשיר ולמשוך קבצים מהמכשיר.

ListenableFuture<String> getSystemProperty(String name)

ביצוע שאילתה אסינכרונית פוטנציאלית לגבי מאפיין מערכת.

boolean hasClients()

הפונקציה מחזירה תשובה אם IDevice מכיל Client.

void installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)

הפקודה מתקינה אפליקציית Android במכשיר.

void installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)

הפקודה מתקינה אפליקציית Android במכשיר.

void installPackage(String packageFilePath, boolean reinstall, String... extraArgs)

הפקודה מתקינה אפליקציית Android במכשיר.

void installPackages( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)

הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי אחד ו-0 עד n חבילות מפוצלות)

void installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)

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

void installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)

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

void installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)

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

boolean isBootLoader()

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

boolean isEmulator()

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

boolean isOffline()

הפונקציה מחזירה ערך אם המכשיר אופליין.

boolean isOnline()

הפונקציה מחזירה ערך אם המכשיר מוכן.

boolean isRoot()

שאילתה לגבי סטטוס הבסיס הנוכחי של המכשיר.

void pullFile(String remote, String local)

שליפה של קובץ יחיד.

void pushFile(String local, String remote)

העברה של קובץ יחיד.

void reboot(String into)

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

void removeForward(int localPort)

מסיר העברת יציאה בין יציאה מקומית ליציאה מרוחקת.

void removeForward(int localPort, int remotePort)

void removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)

void removeRemotePackage(String remoteFilePath)

הסרת קובץ מהמכשיר.

void removeReverse(int remotePort)

מסיר היפוך של יציאה בין יציאה מרוחקת ליציאה מקומית.

boolean root()

שולחים בקשה לשד adb להפוך ל-root במכשיר.

void setSerial(String serial)
void startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)

מתחילה הקלטת מסך במכשיר אם המכשיר תומך ב-IDevice.Feature.SCREEN_RECORD.

boolean supportsFeature(IDevice.HardwareFeature arg0)

הפונקציה מחזירה אם המכשיר תומך בתכונת החומרה שצוינה.

boolean supportsFeature(IDevice.Feature feature)

הפונקציה מחזירה את הערך True אם המכשיר תומך בתכונת התוכנה שצוינה, אחרת היא מחזירה את הערך False.

String syncPackageToDevice(String localFilePath)

העברת קובץ למכשיר

String uninstallApp(String applicationID, String... extraArgs)

הסרת התקנה של אפליקציה מהמכשיר.

String uninstallPackage(String packageName)

הסרת חבילה מהמכשיר.

Constructors ציבוריים

StubDevice

public StubDevice (String serial)

פרמטרים
serial String

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

פרמטרים
serial String

isEmulator boolean

‫methods ציבוריים

arePropertiesSet

public boolean arePropertiesSet ()

הפונקציה מחזירה true אם הנכסים נשמרו במטמון

החזרות
boolean

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

יוצרת העברת פורטים בין פורט TCP מקומי לבין שקע דומיין Unix מרוחק.

פרמטרים
localPort ‫int: היציאה המקומית להעברה
remoteSocketName ‫String: השם של שקע הדומיין של Unix שנוצר במכשיר
namespace ‫IDevice.DeviceUnixSocketNamespace: מרחב השמות שבו נוצר שקע דומיין של Unix
זריקות
AdbCommandRejectedException
TimeoutException

createForward

public void createForward (int localPort, 
                int remotePort)

יוצרת העברת יציאה בין יציאה מקומית ליציאה מרוחקת.

פרמטרים
localPort ‫int: היציאה המקומית להעברה
remotePort ‫int: היציאה המרוחקת.
זריקות
AdbCommandRejectedException
TimeoutException

createReverse

public void createReverse (int remotePort, 
                int localPort)

יוצרת היפוך יציאות בין יציאה מרוחקת ליציאה מקומית.

פרמטרים
remotePort ‫int: היציאה המרוחקת להפוך.
localPort ‫int: היציאה המקומית
זריקות
AdbCommandRejectedException
TimeoutException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.

‫maxTimeToOutputResponse משמש כזמן המתנה המקסימלי כשמצפים לפלט של הפקודה מהמכשיר.
בכל שלב, אם פקודת ה-Shell לא מוציאה פלט למשך תקופה ארוכה יותר מ- maxTimeToOutputResponse, השיטה תזרוק ShellCommandUnresponsiveException.

לפקודות כמו פלט יומן, צריך להשתמש בערך maxTimeToOutputResponse של 0, כלומר השיטה אף פעם לא תזרוק ותיחסם עד שהמקבל IShellOutputReceiver.isCancelled() יחזיר true.

פרמטרים
command ‫String: פקודת המעטפת להרצה
receiver ‫IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-Shell
maxTimeToOutputResponse ‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits ‫TimeUnit: יחידות לערכים של maxTimeToOutputResponse שאינם אפס.
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

היא דומה לקריאה לפונקציה executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

פרמטרים
command ‫String: פקודת המעטפת להרצה
receiver ‫IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-Shell
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

השיטה הזו הוצאה משימוש.
אפשר להשתמש ב-executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

פרמטרים
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver.

‫maxTimeToOutputResponse משמש כזמן המתנה המקסימלי כשמצפים לפלט של הפקודה מהמכשיר.
בכל שלב, אם פקודת ה-Shell לא מוציאה פלט למשך תקופה ארוכה יותר מ- maxTimeToOutputResponse, השיטה תזרוק ShellCommandUnresponsiveException.

לפקודות כמו פלט יומן, צריך להשתמש בערך maxTimeToOutputResponse של 0, כלומר השיטה אף פעם לא תזרוק ותיחסם עד שהמקבל IShellOutputReceiver.isCancelled() יחזיר true.

פרמטרים
command ‫String: פקודת המעטפת להרצה
receiver ‫IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-Shell
maxTimeout ‫long: הזמן המקסימלי להמתנה עד שהפקודה תחזיר ערך. הערך 0 מציין שלא יחול זמן קצוב מקסימלי לתפוגה.
maxTimeToOutputResponse ‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits ‫TimeUnit: יחידות לערכים שונים מאפס של maxTimeout ו-maxTimeToOutputResponse.
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getAbis

public  getAbis ()

מחזירה את ממשקי ה-ABI שנתמכים במכשיר הזה. ממשקי ה-ABI מסודרים לפי סדר מועדף, כאשר ממשק ה-ABI הראשון הוא המועדף ביותר.

החזרות
רשימת ממשקי ה-ABI.

getAvdName

public String getAvdName ()

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

ההגדרה הזו תקפה רק אם הפונקציה isEmulator() מחזירה את הערך True.

אם האמולטור לא מריץ אף AVD (לדוגמה, אם הוא מורץ מתוך בנייה של עץ מקור של Android), השיטה הזו תחזיר את הערך <build>.

הערה: מומלץ להשתמש ב-getAvdData() אם רוצים לשלוט בערך הזמן הקצוב לתפוגה.

החזרות
String השם של ה-AVD או null אם אין שם.

getAvdPath

public String getAvdPath ()

מחזירה את הנתיב המוחלט למכשיר הווירטואלי במערכת הקבצים. הנתיב תלוי במערכת ההפעלה. ב-Linux, מפרידי השמות יהיו / וב-Windows, מפרידי השמות יהיו \.

הערה: מומלץ להשתמש ב-getAvdData() אם רוצים לשלוט בערך הזמן הקצוב לתפוגה.

החזרות
String נתיב ה-AVD או null אם זה מכשיר פיזי, פקודת המשנה של מסוף האמולטור נכשלה, או שגרסת האמולטור ישנה יותר מ-30.0.18

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.

יכול להיות שרמת הטעינה של הסוללה נשמרה במטמון. השאילתה לגבי רמת הטעינה של הסוללה מופעלת רק אם תוקף ה- freshnessTime פג מאז השאילתה האחרונה שהושלמה בהצלחה.

פרמטרים
freshnessTime ‫long: רמת הטעינה הרצויה של הסוללה
timeUnit ‫TimeUnit: הערך ERROR(/TimeUnit) של freshnessTime
החזרות
‫ERROR(/Future) שאפשר להשתמש בו כדי לשלוח שאילתה לגבי רמת הטעינה של הסוללה. הפונקציה Future תחזיר את הערך ERROR(/ExecutionException) אם לא ניתן לאחזר את רמת הטעינה של הסוללה.

getBattery

public  getBattery ()

הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.

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

החזרות
‫ERROR(/Future) שאפשר להשתמש בו כדי לשלוח שאילתה לגבי רמת הטעינה של הסוללה. הפונקציה Future תחזיר את הערך ERROR(/ExecutionException) אם לא ניתן לאחזר את רמת הטעינה של הסוללה.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-getBattery(long, TimeUnit).

הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.

יכול להיות שרמת הטעינה של הסוללה נשמרה במטמון. השאילתה לגבי רמת הסוללה של המכשיר מתבצעת רק אם חלפו freshnessMs אלפיות השנייה מאז השאילתה האחרונה שהושלמה בהצלחה.

החזרות
Integer רמת הטעינה של הסוללה או null אם לא ניתן לאחזר אותה
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public Integer getBatteryLevel ()

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-getBattery().

הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.

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

החזרות
Integer רמת הטעינה של הסוללה או null אם לא ניתן לאחזר אותה
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getClient

public Client getClient (String applicationName)

מחזירה Client לפי שם האפליקציה.

פרמטרים
applicationName ‫String: שם האפליקציה
החזרות
Client האובייקט Client או null אם לא נמצאה התאמה.

getClientName

public String getClientName (int pid)

הפונקציה מחזירה את שם הלקוח לפי pid או null אם ה-pid לא ידוע

פרמטרים
pid ‫int: מזהה התהליך של הלקוח.
החזרות
String

getClients

public Client[] getClients ()

מחזירה את מערך הלקוחות.

החזרות
Client[]

getDensity

public int getDensity ()

הפונקציה מחזירה את סיווג הצפיפות של מסך המכשיר על ידי קריאת הערך של מאפיין המערכת PROP_DEVICE_DENSITY.

החזרות
int הצפיפות, או -1 אם אי אפשר לקבוע אותה.

getFileListingService

public FileListingService getFileListingService ()

מחזירה FileListingService למכשיר הזה.

החזרות
FileListingService

getLanguage

public String getLanguage ()

הפונקציה מחזירה את השפה של המשתמש.

החזרות
String השפה של המשתמש, או null אם היא לא ידועה

getMountPoint

public String getMountPoint (String name)

מחזירה נקודת טעינה.

פרמטרים
name ‫String: השם של נקודת הטעינה להחזרה
החזרות
String

getName

public String getName ()

מחזירה שם (שקל לבני אדם להבין) של המכשיר. בדרך כלל זה שם ה-AVD עבור מכשירי AVD, ושילוב של שם היצרן, שם הדגם והמספר הסידורי עבור מכשירים.

החזרות
String

getProperties

public  getProperties ()

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-getSystemProperty(String).

מחזירה את מאפייני המכשיר שנשמרו במטמון. הוא מכיל את כל הפלט של getprop

החזרות

getProperty

public String getProperty (String name)

שיטת נוחות שמנסה לאחזר נכס באמצעות IShellEnabledDevice.getSystemProperty(String) עם זמן המתנה קצר מאוד, ומבטלת חריגים.

הערה: מומלץ להשתמש ב-IShellEnabledDevice.getSystemProperty(String) אם רוצים לשלוט בערך הזמן הקצוב לתפוגה.

פרמטרים
name ‫String: השם של הערך שרוצים להחזיר.
החזרות
String הערך או null אם ערך המאפיין לא היה זמין באופן מיידי

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-getProperty(String).

שילוב של getProperty(String) ו-getPropertySync(String) שינסה לאחזר את המאפיין מהמטמון. אם לא נמצא, המערכת תנסה באופן סינכרוני לשלוח שאילתה ישירות למכשיר ולאכלס מחדש את המטמון אם הפעולה תצליח.

פרמטרים
name ‫String: השם של הערך שרוצים להחזיר.
החזרות
String הערך או null אם המאפיין לא קיים
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getPropertyCount

public int getPropertyCount ()

השיטה הזו הוצאה משימוש.
deprecated in ddmlib with "implementation detail" as reason.

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

החזרות
int

getPropertySync

public String getPropertySync (String name)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-getProperty(String).

וריאציה של getProperty(String) שתנסה לאחזר את המאפיין שצוין ישירות מהמכשיר, בלי להשתמש במטמון. השיטה הזו מיועדת (רק) לנכסים שערכם משתנה במהירות.

פרמטרים
name ‫String: השם של הערך שרוצים להחזיר.
החזרות
String הערך או null אם המאפיין לא קיים
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getRegion

public String getRegion ()

הפונקציה מחזירה את האזור של המשתמש.

החזרות
String האזור של המשתמש, או null אם האזור לא ידוע

getScreenshot

public RawImage getScreenshot ()

מצלם צילום מסך של המכשיר ומחזיר אותו כ-RawImage.

החזרות
RawImage צילום המסך כקובץ RawImage או null אם משהו השתבש.
זריקות
AdbCommandRejectedException
TimeoutException

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

פרמטרים
timeout long

unit TimeUnit

החזרות
RawImage

זריקות
AdbCommandRejectedException
TimeoutException

getSerialNumber

public String getSerialNumber ()

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

החזרות
String

getState

public IDevice.DeviceState getState ()

מחזירה את מצב המכשיר.

החזרות
IDevice.DeviceState

getSyncService

public SyncService getSyncService ()

מחזירה אובייקט SyncService כדי לדחוף קבצים למכשיר ולמשוך קבצים מהמכשיר.

החזרות
SyncService ‫null אם לא הייתה אפשרות ליצור את SyncService. זה יכול לקרות אם adb מסרב לפתוח את החיבור כי IDevice לא תקין (או שהחיבור נותק).
זריקות
AdbCommandRejectedException
TimeoutException

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

ביצוע שאילתה אסינכרונית פוטנציאלית לגבי מאפיין מערכת.

פרמטרים
name ‫String: השם של הערך שרוצים להחזיר.
החזרות
ListenableFuture<String> ‫ListenableFuture. ERROR(get/Future#get() get) עשוי להחזיר null.

hasClients

public boolean hasClients ()

הפונקציה מחזירה תשובה אם IDevice מכיל Client.

החזרות
boolean

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

הפקודה מתקינה אפליקציית Android במכשיר. זוהי שיטת עזר שמשלבת את השלבים syncPackageToDevice,‏ installRemotePackage ו-removePackage

פרמטרים
packageFilePath ‫String: הנתיב המוחלט במערכת הקבצים לקובץ במארח המקומי להתקנה
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
receiver ‫InstallReceiver: ה-InstallReceiver שישמש למעקב אחרי ההתקנה ולקבלת הסטטוס הסופי.
maxTimeout ‫long: הזמן המקסימלי להמתנה עד שהפקודה תחזיר ערך. הערך 0 מציין שלא יחול זמן קצוב מקסימלי לתפוגה.
maxTimeToOutputResponse ‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits ‫TimeUnit: יחידות לערכים שונים מאפס של maxTimeout ו-maxTimeToOutputResponse.
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
זריקות
InstallException

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

הפקודה מתקינה אפליקציית Android במכשיר. זוהי שיטת עזר שמשלבת את השלבים syncPackageToDevice,‏ installRemotePackage ו-removePackage

פרמטרים
packageFilePath ‫String: הנתיב המוחלט במערכת הקבצים לקובץ במארח המקומי להתקנה
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
receiver ‫InstallReceiver: ה-InstallReceiver שישמש למעקב אחרי ההתקנה ולקבלת הסטטוס הסופי.
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
זריקות
InstallException

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

הפקודה מתקינה אפליקציית Android במכשיר. זוהי שיטת עזר שמשלבת את השלבים syncPackageToDevice,‏ installRemotePackage ו-removePackage

פרמטרים
packageFilePath ‫String: הנתיב המוחלט במערכת הקבצים לקובץ במארח המקומי להתקנה
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
זריקות
InstallException

installPackages

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי אחד ו-0 עד n חבילות מפוצלות)

פרמטרים
apkFilePaths ‫: רשימה של קובצי APK להתקנה (קובץ APK ראשי אחד + 0 עד n קובצי APK מפוצלים)
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
extraArgs ‫: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
timeOutInMs long: פסק זמן להתקנה
timeunit ‫TimeUnit: ERROR(/TimeUnit) שמתאים לפרמטר timeout
זריקות
InstallException

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

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

פרמטרים
remoteFilePath ‫String: נתיב קובץ מוחלט לקובץ החבילה במכשיר
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
receiver ‫InstallReceiver: ה-InstallReceiver שישמש למעקב אחרי ההתקנה ולקבלת הסטטוס הסופי.
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
זריקות
InstallException

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

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

פרמטרים
remoteFilePath ‫String: נתיב קובץ מוחלט לקובץ החבילה במכשיר
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
זריקות
InstallException

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

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

פרמטרים
remoteFilePath ‫String: נתיב קובץ מוחלט לקובץ החבילה במכשיר
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
receiver ‫InstallReceiver: ה-InstallReceiver שישמש למעקב אחרי ההתקנה ולקבלת הסטטוס הסופי.
maxTimeout ‫long: הזמן המקסימלי להמתנה עד שהפקודה תחזיר ערך. הערך 0 מציין שלא יחול זמן קצוב מקסימלי לתפוגה.
maxTimeToOutputResponse ‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits ‫TimeUnit: יחידות לערכים שונים מאפס של maxTimeout ו-maxTimeToOutputResponse.
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
זריקות
InstallException

isBootLoader

public boolean isBootLoader ()

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

החזרות
boolean ‫true if getState() מחזירה DeviceState.BOOTLOADER.

isEmulator

public boolean isEmulator ()

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

החזרות
boolean

isOffline

public boolean isOffline ()

הפונקציה מחזירה ערך אם המכשיר אופליין.

החזרות
boolean ‫true if getState() מחזירה DeviceState.OFFLINE.

isOnline

public boolean isOnline ()

הפונקציה מחזירה ערך אם המכשיר מוכן.

החזרות
boolean ‫true if getState() מחזירה DeviceState.ONLINE.

isRoot

public boolean isRoot ()

שאילתה לגבי סטטוס הבסיס הנוכחי של המכשיר. מידע נוסף זמין במאמר בנושא adb root.

החזרות
boolean ‫true אם הדימון של adb פועל כ-root, אחרת false.
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

pullFile

public void pullFile (String remote, 
                String local)

שליפה של קובץ יחיד.

פרמטרים
remote ‫String: הנתיב המלא לקובץ המרוחק
local ‫String: היעד המקומי.
זריקות
AdbCommandRejectedException
SyncException
TimeoutException

pushFile

public void pushFile (String local, 
                String remote)

העברה של קובץ יחיד.

פרמטרים
local ‫String: הנתיב המקומי של הקובץ.
remote ‫String: הנתיב של הקובץ המרוחק
זריקות
AdbCommandRejectedException
SyncException
TimeoutException

הפעלה מחדש

public void reboot (String into)

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

פרמטרים
into ‫String: שם תוכנת האתחול להפעלה מחדש, או null להפעלה מחדש של המכשיר.
זריקות
AdbCommandRejectedException
TimeoutException

removeForward

public void removeForward (int localPort)

מסיר העברת יציאה בין יציאה מקומית ליציאה מרוחקת.

פרמטרים
localPort ‫int: היציאה המקומית להעברה
זריקות
AdbCommandRejectedException
TimeoutException

removeForward

public void removeForward (int localPort, 
                int remotePort)

פרמטרים
localPort int

remotePort int

זריקות
AdbCommandRejectedException
TimeoutException

removeForward

public void removeForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

פרמטרים
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

זריקות
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

הסרת קובץ מהמכשיר.

פרמטרים
remoteFilePath ‫String: הנתיב במכשיר של הקובץ שרוצים להסיר
זריקות
InstallException

removeReverse

public void removeReverse (int remotePort)

מסיר היפוך של יציאה בין יציאה מרוחקת ליציאה מקומית.

פרמטרים
remotePort ‫int: היציאה המרוחקת.
זריקות
AdbCommandRejectedException
TimeoutException

שורש

public boolean root ()

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

החזרות
boolean ‫true אם הדימון של adb פועל כ-root, אחרת false.
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setSerial

public void setSerial (String serial)

פרמטרים
serial String

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

מתחילה הקלטת מסך במכשיר אם המכשיר תומך ב-IDevice.Feature.SCREEN_RECORD.

פרמטרים
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature arg0)

הפונקציה מחזירה אם המכשיר תומך בתכונת החומרה שצוינה.

פרמטרים
arg0 IDevice.HardwareFeature

החזרות
boolean

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

הפונקציה מחזירה את הערך True אם המכשיר תומך בתכונת התוכנה שצוינה, אחרת היא מחזירה את הערך False.

פרמטרים
feature IDevice.Feature

החזרות
boolean

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

העברת קובץ למכשיר

פרמטרים
localFilePath ‫String: הנתיב המוחלט לקובץ במארח המקומי
החזרות
String String נתיב היעד במכשיר לקובץ
זריקות
AdbCommandRejectedException
SyncException
TimeoutException

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

הסרת התקנה של אפליקציה מהמכשיר.

פרמטרים
applicationID ‫String: מזהה האפליקציה ל-Android שרוצים להסיר
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
InstallException

uninstallPackage

public String uninstallPackage (String packageName)

הסרת חבילה מהמכשיר.

פרמטרים
packageName ‫String: מזהה האפליקציה ל-Android שרוצים להסיר
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
InstallException