DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
   ↳ com.android.tradefed.device.server.DeviceImpl

מכשיר. יכול להיות שמדובר במכשיר פיזי או באמולטור.

סיכום

‫constructors ציבוריים

DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)

‫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 executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

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

הפעולה הזו משתמשת בקריאה exec:cmd או ב-abb_exec: מהירה יותר אם מערכת ההפעלה של המכשיר ושרת ה-ADB של המארח תומכים בתכונת ההפעלה של Android Binder Bridge.

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

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

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

גרסה של הפקודה executeShell שיכולה לקבל זרם קלט לשליחה דרך stdin.

void executeShellCommand(String command, IShellOutputReceiver receiver)

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

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

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

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

void forceStop(String applicationName)

סגירה ידנית של אפליקציה לפי שם האפליקציה.

getAbis()

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

ListenableFuture<AvdData> getAvdData()

מחזירה מידע על ה-AVD שבו האמולטור פועל.

String getAvdName()

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

String getAvdPath()

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

getBattery(long freshnessTime, TimeUnit timeUnit)

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

getBattery()

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

Integer getBatteryLevel(long freshnessMs)

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

Integer getBatteryLevel()

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

ClientImpl getClient(String applicationName)

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

String getClientName(int pid)

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

ClientTracker getClientTracker()
ClientImpl[] getClients()

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

int getDensity()

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

FileListingService getFileListingService()

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

String getLanguage()

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

InstallMetrics getLastInstallMetrics()

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

String getMountPoint(String name)

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

String getName()

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

ClientImpl[] getNativeClients()
ClientImpl getNativeClients(String applicationName)
ProfileableClientImpl[] getProfileableClients()

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

getProperties()

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

String getProperty(String name)

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

String getPropertyCacheOrSync(String name)

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

int getPropertyCount()

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

String getPropertySync(String name)

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

String getRegion()

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

static String getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)
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( apks, boolean reinstall, installOptions)

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

void installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

הפקודה מתקינה אפליקציית 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)

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

void installRemotePackages( remoteApks, boolean reinstall, installOptions)

הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל

void installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר

boolean isBootLoader()

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

boolean isEmulator()

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

boolean isOffline()

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

boolean isOnline()

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

boolean isRoot()

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

void kill(String applicationName)

הפקודה מסיימת אפליקציה לפי שם האפליקציה.

void pullFile(String remote, String local)

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

void push(String[] local, String remote)

העברה של כמה קבצים או ספריות.

void pushFile(String local, String remote)

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

SocketChannel rawBinder(String service, String[] parameters)

מפעילים את שירות Android Binder Bridge במכשיר מרוחק.

SocketChannel rawExec(String executable, String[] parameters)

הפעלת שירות host:exec במכשיר מרוחק.

void reboot(String into)

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

void removeForward(int localPort)

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

void removeRemotePackage(String remoteFilePath)

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

void removeReverse(int remotePort)

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

boolean root()

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

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

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

boolean supportsFeature(IDevice.HardwareFeature feature)

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

boolean supportsFeature(IDevice.Feature feature)

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

String syncPackageToDevice(String localFilePath)

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

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

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

String uninstallPackage(String packageName)

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

Constructors ציבוריים

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

פרמטרים
clientTracer ClientTracker

serialNumber String

deviceState IDevice.DeviceState

‫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

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

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

הפעולה הזו משתמשת בקריאה exec:cmd או ב-abb_exec: מהירה יותר אם מערכת ההפעלה של המכשיר ושרת ה-ADB של המארח תומכים בתכונת ההפעלה של Android Binder Bridge.

פרמטרים
parameters ‫String: פקודת ה-binder להפעלה
receiver ‫IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-binder
maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is ‫InputStream: זרם קלט אופציונלי לשליחה דרך stdin
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
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, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

גרסה של הפקודה executeShell שיכולה לקבל זרם קלט לשליחה דרך stdin.

פרמטרים
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

זריקות
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)

פרמטרים
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

forceStop

public void forceStop (String applicationName)

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

פרמטרים
applicationName ‫String: שם האפליקציה

getAbis

public  getAbis ()

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

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

getAvdData

public ListenableFuture<AvdData> getAvdData ()

מחזירה מידע על ה-AVD שבו האמולטור פועל.

‫AvdData.getName הוא השם של ה-AVD או null אם אין שם.

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

החזרות
ListenableFuture<AvdData> AvdData של המכשיר.

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)

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

getClient

public ClientImpl getClient (String applicationName)

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

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

getClientName

public String getClientName (int pid)

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

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

getClientTracker

public ClientTracker getClientTracker ()

החזרות
ClientTracker

getClients

public ClientImpl[] getClients ()

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

החזרות
ClientImpl[]

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

החזרות
FileListingService

getLanguage

public String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

החזרות
InstallMetrics InstallMetrics מדדים שמתארים את ההתקנה.

getMountPoint

public String getMountPoint (String name)

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

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

getName

public String getName ()

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

החזרות
String

getNativeClients

public ClientImpl[] getNativeClients ()

החזרות
ClientImpl[]

getNativeClients

public ClientImpl getNativeClients (String applicationName)

פרמטרים
applicationName String

החזרות
ClientImpl

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

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

החזרות
ProfileableClientImpl[]

getProperties

public  getProperties ()

הפונקציה מחזירה את מאפייני המכשיר שנשמרו במטמון. הוא מכיל את כל הפלט של 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) ו-getPropertySync(String) שינסה לאחזר את המאפיין מהמטמון. אם לא נמצא, המערכת תנסה באופן סינכרוני לשלוח שאילתה ישירות למכשיר ולאכלס מחדש את המטמון אם הפעולה תצליח.

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

getPropertyCount

public int getPropertyCount ()

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

החזרות
int

getPropertySync

public String getPropertySync (String name)

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

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

getRegion

public String getRegion ()

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

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

פרמטרים
remoteFilePath String

options ScreenRecorderOptions

החזרות
String

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 ( apks, 
                boolean reinstall, 
                 installOptions)

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

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

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

פרמטרים
apks ‫: רשימה של קובצי APK להתקנה (קובץ APK ראשי אחד + 0 עד n קובצי APK מפוצלים)
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
installOptions ‫: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
timeout long: פסק זמן להתקנה
timeoutUnit ‫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

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל

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

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר

פרמטרים
remoteApks ‫: רשימת נתיבים לקובצי APK ששמורים במכשיר להתקנה
reinstall ‫boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה
installOptions ‫: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
timeout long: פסק זמן להתקנה
timeoutUnit ‫TimeUnit: ERROR(/TimeUnit) שמתאים לפרמטר timeout
זריקות
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

הריגה

public void kill (String applicationName)

הפקודה מסיימת אפליקציה לפי שם האפליקציה. הפעולה הזו רק משמידה את הפעילויות, והמצב שלהן נשאר רק במערכת Android.

פרמטרים
applicationName ‫String: שם האפליקציה

pullFile

public void pullFile (String remote, 
                String local)

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

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

דחיפה

public void push (String[] local, 
                String remote)

העברה של כמה קבצים או ספריות.

פרמטרים
local ‫String: הקבצים המקומיים להעלאה
remote ‫String: הנתיב המרוחק שמייצג ספרייה
זריקות
AdbCommandRejectedException
SyncException
TimeoutException

pushFile

public void pushFile (String local, 
                String remote)

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

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

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

מפעילים את שירות Android Binder Bridge במכשיר מרוחק. מחזירה ערוץ socket שמחובר לפקודת binder של המכשיר.

הבעלות על SocketChannel מועברת למתקשר, והוא חייב לסגור אותו באופן מפורש אחרי השימוש.

פרמטרים
service ‫String: השם של שירות Android שאליו רוצים להתחבר
parameters ‫String: הפרמטרים של פקודת ה-binder
החזרות
SocketChannel ‫SocketChannel שמחובר לתהליך ההפעלה במכשיר. אחרי השימוש.
זריקות
AdbCommandRejectedException
TimeoutException

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

הפעלת שירות host:exec במכשיר מרוחק. מחזירה ערוץ socket שמחובר לתהליך הפעיל. הערה: שירות exec לא מבחין בין stdout לבין stderr, ולכן כל מה שנקרא מהסוקט יכול להגיע מכל אחד מהפלט ולעבור שזירה.

הבעלות על SocketChannel מועברת למתקשר, והוא חייב לסגור אותו באופן מפורש אחרי השימוש.

פרמטרים
executable String

parameters String

החזרות
SocketChannel ‫SocketChannel שמחובר לתהליך ההפעלה במכשיר. אחרי השימוש.
זריקות
AdbCommandRejectedException
TimeoutException

הפעלה מחדש

public void reboot (String into)

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

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

removeForward

public void removeForward (int localPort)

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

פרמטרים
localPort ‫int: היציאה המקומית להעברה
זריקות
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

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

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

פרמטרים
feature 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

toString

public String toString ()

החזרות
String

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