IDevice
public
interface
IDevice
implements
IShellEnabledDevice
| com.android.ddmlib.IDevice |
מכשיר. יכול להיות שמדובר במכשיר פיזי או באמולטור.
סיכום
ערכים קבועים | |
|---|---|
int |
CHANGE_BUILD_INFO
מסיכת סיביות של שינוי המכשיר: שינוי פרטי ה-Build. |
int |
CHANGE_STATE
מסיכת סיביות של שינוי מכשיר: |
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
הקבוע הזה הוצא משימוש.
שימוש בחשבון |
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()
הפונקציה מחזירה את הערך |
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 |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל receiver היא דומה לקריאה לפונקציה |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)
השיטה הזו הוצאה משימוש.
שימוש בחשבון |
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)
השיטה הזו הוצאה משימוש.
להשתמש ב- |
abstract
Integer
|
getBatteryLevel()
השיטה הזו הוצאה משימוש.
להשתמש ב- |
abstract
int
|
getDensity()
הפונקציה מחזירה את קטגוריית הצפיפות של מסך המכשיר על ידי קריאת הערך של מאפיין המערכת
|
abstract
FileListingService
|
getFileListingService()
מחזירה |
default
Set<String>
|
getHardwareCharacteristics()
מחזירה תכונות שהתקבלו מקריאת מאפיין מאפייני הבנייה. |
abstract
String
|
getLanguage()
הפונקציה מחזירה את השפה של המשתמש. |
default
InstallMetrics
|
getLastInstallMetrics()
מקבל את המידע על ההתקנה האחרונה במכשיר הזה. |
abstract
String
|
getMountPoint(String name)
מחזירה נקודת טעינה. |
abstract
Map<String, String>
|
getProperties()
השיטה הזו הוצאה משימוש.
במקום זאת, אפשר להשתמש ב- |
abstract
String
|
getProperty(String name)
שיטת נוחות שמנסה לאחזר נכס באמצעות |
abstract
String
|
getPropertyCacheOrSync(String name)
השיטה הזו הוצאה משימוש.
במקום זאת, אפשר להשתמש ב- |
abstract
int
|
getPropertyCount()
השיטה הזו הוצאה משימוש. פרטי ההטמעה |
abstract
String
|
getPropertySync(String name)
השיטה הזו הוצאה משימוש.
להשתמש ב- |
abstract
String
|
getRegion()
הפונקציה מחזירה את האזור של המשתמש. |
abstract
RawImage
|
getScreenshot()
מצלם צילום מסך של המכשיר ומחזיר אותו כ- |
abstract
RawImage
|
getScreenshot(long timeout, TimeUnit unit)
|
abstract
String
|
getSerialNumber()
מחזירה את המספר הסידורי של המכשיר. |
abstract
IDevice.DeviceState
|
getState()
מחזירה את מצב המכשיר. |
abstract
SyncService
|
getSyncService()
מחזירה אובייקט |
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()
הפונקציה מחזירה |
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)
השיטה הזו הוצאה משימוש.
שימוש ב- |
default
void
|
removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)
השיטה הזו הוצאה משימוש.
שימוש ב- |
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)
מתחילה הקלטת מסך במכשיר אם המכשיר תומך ב- |
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
| פרמטרים | |
|---|---|
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 |
אם ההסרה נכשלת. |