החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

מחלקות משנה לא ישירות ידועות

‫DeviceImpl, ‏ DeviceManager.FastbootDevice, ‏ NullDevice, ‏ RemoteAvdIDevice, ‏ StubDevice, ‏ StubLocalAndroidVirtualDevice, ‏ VmRemoteDevice

‫DeviceImpl	מכשיר.
DeviceManager.FastbootDevice	ייצוג של מכשיר במצב אתחול מהיר (Fastboot mode).
NullDevice	ערך placeholder‏ `IDevice` שמשמש את `DeviceManager` להקצאה כש-`IDeviceSelection.nullDeviceRequested()` הוא `true`
RemoteAvdIDevice	ערך placeholder‏ `IDevice` שמשמש את `DeviceManager` להקצאה כש-`DeviceSelectionOptions.gceDeviceRequested()` הוא `true`
StubDevice	הטמעה של פלייסהולדר של stub של `IDevice`.
StubLocalAndroidVirtualDevice	ערך placeholder‏ `IDevice` שמשמש את `DeviceManager` להקצאה כש-`DeviceSelectionOptions.localVirtualDeviceRequested()` הוא `true`
VmRemoteDevice	מכשיר וירטואלי מרוחק שאנחנו ננהל מתוך המכונה הווירטואלית.

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

סיכום

ערכים קבועים
`int`	`CHANGE_BUILD_INFO` מסיכת סיביות של שינוי המכשיר: שינוי פרטי ה-Build.
`int`	`CHANGE_CLIENT_LIST` מסיכת סיביות של שינוי המכשיר: `Client` שינוי הרשימה.
`int`	`CHANGE_PROFILEABLE_CLIENT_LIST` מסיכת סיביות של שינוי המכשיר: `ProfileableClient` שינוי הרשימה.
`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.
`default void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` גרסה של הפקודה executeShell שיכולה לקבל זרם קלט לשליחה דרך stdin.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מבצע פקודת מעטפת במכשיר ושולח את התוצאה אל `receiver` היא דומה לקריאה לפונקציה `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` השיטה הזו הוצאה משימוש. שימוש בחשבון `IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`default void`	`forceStop(String applicationName)` סגירה ידנית של אפליקציה לפי שם האפליקציה.
`abstract`	`getAbis()` מחזירה את ממשקי ה-ABI שנתמכים במכשיר הזה.
`default ListenableFuture<AvdData>`	`getAvdData()` מחזירה מידע על ה-AVD שבו האמולטור פועל.
`abstract String`	`getAvdName()` הפונקציה מחזירה את השם של ה-AVD שבו האמולטור פועל.
`abstract String`	`getAvdPath()` מחזירה את הנתיב המוחלט למכשיר הווירטואלי במערכת הקבצים.
`abstract`	`getBattery(long freshnessTime, TimeUnit timeUnit)` הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`abstract`	`getBattery()` הפונקציה מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`abstract Integer`	`getBatteryLevel(long freshnessMs)` השיטה הזו הוצאה משימוש. להשתמש ב-`getBattery(long, TimeUnit)`
`abstract Integer`	`getBatteryLevel()` השיטה הזו הוצאה משימוש. להשתמש ב-`getBattery()`
`abstract Client`	`getClient(String applicationName)` מחזירה `Client` לפי שם האפליקציה.
`abstract String`	`getClientName(int pid)` הפונקציה מחזירה את שם הלקוח לפי pid או `null` אם ה-pid לא ידוע
`abstract Client[]`	`getClients()` מחזירה את מערך הלקוחות.
`abstract int`	`getDensity()` הפונקציה מחזירה את סיווג הצפיפות של מסך המכשיר על ידי קריאת הערך של מאפיין המערכת `PROP_DEVICE_DENSITY`.
`abstract FileListingService`	`getFileListingService()` מחזירה `FileListingService` למכשיר הזה.
`default`	`getHardwareCharacteristics()` הפונקציה מחזירה תכונות שהתקבלו מקריאת מאפיין מאפייני הבנייה.
`abstract String`	`getLanguage()` הפונקציה מחזירה את השפה של המשתמש.
`default InstallMetrics`	`getLastInstallMetrics()` מקבל את המידע על ההתקנה האחרונה במכשיר הזה.
`abstract String`	`getMountPoint(String name)` מחזירה נקודת טעינה.
`default ProfileableClient[]`	`getProfileableClients()` מחזירה את המערך של לקוחות שאפשר ליצור להם פרופיל.
`abstract`	`getProperties()` השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`IShellEnabledDevice.getSystemProperty(String)`
`abstract String`	`getProperty(String name)` שיטת נוחות שמנסה לאחזר נכס באמצעות `IShellEnabledDevice.getSystemProperty(String)` עם זמן המתנה קצר מאוד, ומבטלת חריגים.
`abstract String`	`getPropertyCacheOrSync(String name)` השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`IShellEnabledDevice.getSystemProperty(String)`
`abstract int`	`getPropertyCount()` השיטה הזו הוצאה משימוש. פרטי ההטמעה
`abstract String`	`getPropertySync(String name)` השיטה הזו הוצאה משימוש. להשתמש ב-`IShellEnabledDevice.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 boolean`	`hasClients()` הפונקציה מחזירה תשובה אם `IDevice` מכיל `Client`.
`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, InstallReceiver receiver, String... extraArgs)` הפקודה מתקינה אפליקציית Android במכשיר.
`abstract void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` הפקודה מתקינה אפליקציית Android במכשיר.
`default void`	`installPackages( apks, boolean reinstall, installOptions)` הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי אחד ו-0 עד n חבילות מפוצלות) עם הגדרת זמן קצוב לתפוגה שמוגדרת כברירת מחדל
`abstract void`	`installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` הפקודה מתקינה אפליקציית 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( remoteApks, boolean reinstall, installOptions)` הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל
`default void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` התקנה של אפליקציית 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()` שולחים בקשה לשד adb להפוך ל-root במכשיר.
`abstract void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` מתחילה הקלטת מסך במכשיר אם המכשיר תומך ב-`IDevice.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_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

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

ערך קבוע: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

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

ערך קבוע: 8 (0x00000008)

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

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

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

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

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

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

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

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

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

מידע נוסף:

DdmPreferences.getTimeOut()

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 abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

מידע נוסף:

executeShellCommand

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

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

פרמטרים
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

זריקות
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract  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 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  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

פרמטרים
`freshnessTime`	‫`long`: רמת הטעינה הרצויה של הסוללה
`timeUnit`	‫`TimeUnit`: הערך `ERROR(/TimeUnit)` של freshnessTime

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

getBattery

public abstract  getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

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

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

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

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

זריקות
	com.android.ddmlib.ShellCommandUnresponsiveException
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public abstract Integer getBatteryLevel ()

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

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

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

זריקות
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public abstract Client getClient (String applicationName)

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

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

החזרות
`Client`	האובייקט `Client` או `null` אם לא נמצאה התאמה.

getClientName

public abstract String getClientName (int pid)

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

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

החזרות
`String`

getClients

public abstract Client[] getClients ()

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

החזרות
`Client[]`

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

החזרות
`FileListingService`

getHardwareCharacteristics

public  getHardwareCharacteristics ()

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

החזרות

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public abstract String getMountPoint (String name)

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

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

החזרות
`String`

מידע נוסף:

getProfileableClients

public ProfileableClient[] getProfileableClients ()

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

החזרות
`ProfileableClient[]`

getProperties

public abstract  getProperties ()

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

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

החזרות

getProperty

public abstract String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

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

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

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

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

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

getPropertyCount

public abstract int getPropertyCount ()

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

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

החזרות
`int`

getPropertySync

public abstract String getPropertySync (String name)

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

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

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

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

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

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

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

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

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

פרמטרים
`timeout`	`long`
`unit`	`TimeUnit`

החזרות
`RawImage`

זריקות
`AdbCommandRejectedException`
`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` לא תקין (או שהחיבור נותק).

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

hasClients

public abstract boolean hasClients ()

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

החזרות
`boolean`

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.

זריקות
`InstallException`	אם ההתקנה נכשלת.

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.

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

זריקות
`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 abstract 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 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.

זריקות
`InstallException`	אם ההתקנה נכשלת.

מידע נוסף:

installRemotePackage(String, boolean, InstallReceiver, long, long, TimeUnit, String)

installRemotePackage

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

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

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

זריקות
`InstallException`	אם ההתקנה נכשלת.

מידע נוסף:

installRemotePackage(String, boolean, InstallReceiver, long, long, TimeUnit, String)

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.

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

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

הריגה

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

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

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

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

דחיפה

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

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

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

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

pushFile

public abstract void pushFile (String local, 
                String remote)

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

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

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

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 abstract void reboot (String into)

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

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

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

removeForward

public void removeForward (int localPort)

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

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

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

removeForward

public void removeForward (int localPort, 
                int remotePort)

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

פרמטרים
`localPort`	`int`
`remotePort`	`int`

זריקות
`AdbCommandRejectedException`
`TimeoutException`

removeForward

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

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

פרמטרים
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

זריקות
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

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

זריקות
`InstallException`	אם ההתקנה נכשלת.

removeReverse

public void removeReverse (int remotePort)

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

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

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

שורש

public abstract boolean root ()

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

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

זריקות
`TimeoutException`	במקרה שהזמן הקצוב לתפוגה של החיבור פג.
`AdbCommandRejectedException`	אם adb דוחה את הפקודה.
`ShellCommandUnresponsiveException`	אם אי אפשר לשלוח שאילתה לגבי סטטוס הבסיס.
	IOException

startScreenRecorder

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

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

פרמטרים
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

זריקות
`AdbCommandRejectedException`
`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` נתיב היעד במכשיר לקובץ

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

uninstallApp

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

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

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

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

זריקות
`InstallException`	אם ההסרה נכשלת.

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

זריקות
`InstallException`	אם ההסרה נכשלת.