IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice


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

סיכום

ערכים קבועים

int CHANGE_BUILD_INFO

מסיכת סיביות של שינוי המכשיר: שינוי פרטי ה-Build.

int CHANGE_STATE

מסיכת סיביות של שינוי מכשיר: DeviceState שינוי.

String FIRST_EMULATOR_SN

המספר הסידורי של האמולטור הראשון שמחובר.

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

הקבוע הזה הוצא משימוש. שימוש בחשבון PROP_BUILD_API_LEVEL.

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

ביטוי רגולרי של מספר סידורי של אמולטור.

String UNKNOWN_PACKAGE

‫methods ציבוריים

abstract boolean arePropertiesSet()

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

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

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

abstract void createForward(int localPort, int remotePort)

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

default void createReverse(int remotePort, int localPort)

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

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

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

השיטה הזו הוצאה משימוש. שימוש בחשבון executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).

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

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

default void forceStop(String applicationName)

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

abstract List<String> getAbis()

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

default ListenableFuture<AvdData> getAvdData()

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

abstract String getAvdName()

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

abstract String getAvdPath()

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

abstract Future<Integer> getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract Future<Integer> getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

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

abstract int getDensity()

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

abstract FileListingService getFileListingService()

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

default Set<String> getHardwareCharacteristics()

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

abstract String getLanguage()

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

default InstallMetrics getLastInstallMetrics()

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

abstract String getMountPoint(String name)

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

abstract Map<String, String> getProperties()

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

abstract String getProperty(String name)

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

abstract String getPropertyCacheOrSync(String name)

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

abstract int getPropertyCount()

השיטה הזו הוצאה משימוש. פרטי ההטמעה

abstract String getPropertySync(String name)

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

abstract String getRegion()

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

abstract RawImage getScreenshot()

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

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

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

abstract IDevice.DeviceState getState()

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

abstract SyncService getSyncService()

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

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

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

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

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

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

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

abstract void installPackages(List<File> apks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)

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

default void installPackages(List<File> apks, boolean reinstall, List<String> installOptions)

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

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

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

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

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

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

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

default void installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)

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

default void installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions)

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

abstract boolean isBootLoader()

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

abstract boolean isEmulator()

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

abstract boolean isOffline()

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

abstract boolean isOnline()

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

abstract boolean isRoot()

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

default void kill(String applicationName)

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

abstract void pullFile(String remote, String local)

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

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

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

abstract void pushFile(String local, String remote)

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

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

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

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

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

abstract void reboot(String into)

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

default void removeForward(int localPort)

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

default void removeForward(int localPort, int remotePort)

השיטה הזו הוצאה משימוש. שימוש ב-removeForward(int)

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

השיטה הזו הוצאה משימוש. שימוש ב-removeForward(int)

abstract void removeRemotePackage(String remoteFilePath)

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

default void removeReverse(int remotePort)

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

abstract boolean root()

שולחים בקשה לדימון (daemon) של adb להפוך להרמה הבסיסית (root) במכשיר.

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

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

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature(IDevice.Feature feature)

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

abstract String syncPackageToDevice(String localFilePath)

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

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

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

abstract String uninstallPackage(String packageName)

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

ערכים קבועים

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

מסיכת סיביות של שינוי המכשיר: שינוי פרטי ה-Build.

ערך קבוע: 4 (0x00000004)

CHANGE_STATE

public static final int CHANGE_STATE

מסיכת סיביות של שינוי מכשיר: DeviceState שינוי.

ערך קבוע: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

המספר הסידורי של האמולטור הראשון שמחובר.

ערך קבוע: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

ערך קבוע: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

ערך קבוע: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

ערך קבוע: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

ערך קבוע: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

ערך קבוע: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

ערך קבוע: ‎"ro.build.version.codename"‎

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

ערך קבוע: "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

ערך קבוע: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

ערך קבוע: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

הקבוע הזה הוצא משימוש.
אפשר להשתמש ב-PROP_BUILD_API_LEVEL.

ערך קבוע: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

ערך קבוע: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

ערך קבוע: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

ערך קבוע: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

ערך קבוע: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

ערך קבוע: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

ערך קבוע: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

ערך קבוע: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

ערך קבוע: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

ערך קבוע: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

ערך קבוע: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

ביטוי רגולרי של מספר סידורי של אמולטור.

ערך קבוע: "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

ערך קבוע: ""

‫methods ציבוריים

arePropertiesSet

public abstract boolean arePropertiesSet ()

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

החזרות
boolean

createForward

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

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

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

remoteSocketName String: השם של שקע הדומיין של Unix שנוצר במכשיר

namespace IDevice.DeviceUnixSocketNamespace: מרחב השמות שבו נוצר שקע דומיין של Unix

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

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

remotePort int: היציאה המרוחקת.

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

פרמטרים
remotePort int: היציאה המרוחקת להפיכה.

localPort int: היציאה המקומית

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
ShellCommandUnresponsiveException אם פקודת ה-binder לא שולחת פלט במשך זמן מסוים.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

מידע נוסף:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

פרמטרים
command String: פקודת המעטפת להרצה

receiver IShellOutputReceiver: ה-IShellOutputReceiver שיקבל את הפלט של פקודת ה-Shell

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
ShellCommandUnresponsiveException אם פקודת ה-Shell לא שולחת פלט למשך זמן מסוים.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

executeShellCommand

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

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

פרמטרים
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract List<String> getAbis ()

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

החזרות
List<String> רשימת ממשקי ה-ABI.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

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

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

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

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

getAvdName

public abstract String getAvdName ()

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

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

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

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

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

getAvdPath

public abstract String getAvdPath ()

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

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

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

getBattery

public abstract Future<Integer> getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

פרמטרים
freshnessTime long: רמת הטעינה הרצויה של הסוללה

timeUnit TimeUnit: הערך TimeUnit של freshnessTime

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

getBattery

public abstract Future<Integer> getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

השיטה הזו הוצאה משימוש.
use getBattery(long,TimeUnit)

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

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

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

הקפצת הודעות שגיאה (throw)
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

השיטה הזו הוצאה משימוש.
use getBattery()

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

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

החזרות
FileListingService

getHardwareCharacteristics

public Set<String> getHardwareCharacteristics ()

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

החזרות
Set<String>

הקפצת הודעות שגיאה (throw)
Exception

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public abstract String getMountPoint (String name)

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

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

החזרות
String

getProperties

public abstract Map<String, String> getProperties ()

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

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

החזרות
Map<String, String>

getProperty

public abstract String getProperty (String name)

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

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

פרמטרים
name String: השם של הערך שרוצים להחזיר.

החזרות
String הערך או null אם ערך המאפיין לא היה זמין באופן מיידי

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

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

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

פרמטרים
name String: השם של הערך שרוצים להחזיר.

החזרות
String הערך או null אם המאפיין לא קיים

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
ShellCommandUnresponsiveException אם פקודת ה-Shell לא שולחת פלט למשך זמן מסוים.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

getPropertyCount

public abstract int getPropertyCount ()

השיטה הזו הוצאה משימוש.
פרטי הטמעה

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

החזרות
int

getPropertySync

public abstract String getPropertySync (String name)

השיטה הזו הוצאה משימוש.
use getSystemProperty(String)

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

פרמטרים
name String: השם של הערך שרוצים להחזיר.

החזרות
String הערך או null אם המאפיין לא קיים

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
ShellCommandUnresponsiveException אם פקודת ה-Shell לא שולחת פלט למשך זמן מסוים.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

פרמטרים
timeout long

unit TimeUnit

החזרות
RawImage

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

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

החזרות
String

getState

public abstract IDevice.DeviceState getState ()

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

החזרות
IDevice.DeviceState

getSyncService

public abstract SyncService getSyncService ()

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException אם החיבור ל-adb נכשל.

installPackage

public abstract 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.

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installPackage

public abstract 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.

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installPackage

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

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

פרמטרים
packageFilePath String: הנתיב המוחלט במערכת הקבצים לקובץ במארח המקומי להתקנה

reinstall boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה

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

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installPackages

public abstract void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

פרמטרים
apks List: רשימה של קובצי APK להתקנה (קובץ APK ראשי אחד + 0 עד n קובצי APK מפוצלים)

reinstall boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה

installOptions List: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.

timeout long: פסק זמן להתקנה

timeoutUnit TimeUnit: TimeUnit שמתאים לפרמטר timeout

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions)

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

פרמטרים
apks List: רשימה של קובצי APK להתקנה (קובץ APK ראשי אחד + 0 עד n קובצי APK מפוצלים)

reinstall boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה

installOptions List: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installRemotePackage

public abstract 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.

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installRemotePackage

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

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

פרמטרים
remoteFilePath String: נתיב קובץ מוחלט לקובץ החבילה במכשיר

reinstall boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה

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

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installRemotePackage

public abstract 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.

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

פרמטרים
remoteApks List: רשימת נתיבי קובצי ה-APK ששמורים במכשיר וצריך להתקין

reinstall boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה

installOptions List: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.

timeout long: פסק זמן להתקנה

timeoutUnit TimeUnit: TimeUnit שמתאים לפרמטר timeout

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions)

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

פרמטרים
remoteApks List: רשימת נתיבים לקובצי APK במכשיר להתקנה

reinstall boolean: מוגדר ל-true אם צריך לבצע התקנה מחדש של האפליקציה

installOptions List: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

isBootLoader

public abstract boolean isBootLoader ()

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

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

isEmulator

public abstract boolean isEmulator ()

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

החזרות
boolean

isOffline

public abstract boolean isOffline ()

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

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

isOnline

public abstract boolean isOnline ()

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

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

isRoot

public abstract boolean isRoot ()

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException
ShellCommandUnresponsiveException

הרג

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

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

פרמטרים
remote String: הנתיב המלא לקובץ המרוחק

local String: היעד המקומי.

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
SyncException במקרה של חריגה בסנכרון.
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר.
IOException במקרה של חריגת קלט/פלט.

דחיפת הודעות

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

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

פרמטרים
local String: הקבצים המקומיים להעלאה

remote String: הנתיב המרוחק שמייצג ספרייה

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
SyncException אם לא ניתן לדחוף חלק מהקבצים
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר
IOException במקרה של שגיאת קלט/פלט בחיבור

pushFile

public abstract void pushFile (String local, 
                String remote)

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

פרמטרים
local String: נתיב הקובץ המקומי.

remote String: הנתיב של הקובץ המרוחק

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
SyncException אם אי אפשר לדחוף את הקובץ
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר
IOException במקרה של שגיאת קלט/פלט בחיבור

rawBinder

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

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

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

פרמטרים
service String: השם של שירות Android שאליו רוצים להתחבר

parameters String: הפרמטרים של פקודת ה-binder

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
TimeoutException

rawExec

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

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

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

פרמטרים
executable String

parameters String

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
TimeoutException

הפעל מחדש

public abstract void reboot (String into)

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
java.io.IOException
IOException

removeForward

public void removeForward (int localPort)

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

removeForward

public void removeForward (int localPort, 
                int remotePort)

השיטה הזו הוצאה משימוש.
שימוש ב-removeForward(int)

פרמטרים
localPort int

remotePort int

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
TimeoutException

removeForward

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

השיטה הזו הוצאה משימוש.
שימוש ב-removeForward(int)

פרמטרים
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

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

הקפצת הודעות שגיאה (throw)
InstallException אם ההתקנה נכשלת.

removeReverse

public void removeReverse (int remotePort)

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

הרמה הבסיסית (root)

public abstract boolean root ()

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

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException אם אי אפשר לשלוח שאילתה לגבי סטטוס הבסיס.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
java.io.IOException
IOException

startScreenRecorder

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

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

פרמטרים
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

supportsFeature

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

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

פרמטרים
feature IDevice.HardwareFeature

החזרות
boolean

supportsFeature

public abstract boolean supportsFeature (IDevice.Feature feature)

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

פרמטרים
feature IDevice.Feature

החזרות
boolean

syncPackageToDevice

public abstract String syncPackageToDevice (String localFilePath)

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

פרמטרים
localFilePath String: הנתיב המוחלט לקובץ במארח המקומי

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

הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה
SyncException אם מתרחשת שגיאה במהלך שליחת החבילה למכשיר.
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
IOException במקרה של שגיאת קלט/פלט בחיבור.

uninstallApp

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

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

פרמטרים
applicationID String: מזהה האפליקציה ל-Android שרוצים להסיר

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

החזרות
String קוד שגיאה String או null אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
InstallException אם ההסרה נכשלת.

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

פרמטרים
packageName String: מזהה האפליקציה ל-Android שרוצים להסיר

החזרות
String קוד שגיאה String או null אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
InstallException אם ההסרה נכשלת.