החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

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

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

סיכום

‫constructors ציבוריים
`DeviceImpl(String serialNumber, IDevice.DeviceState deviceState)`

‫methods ציבוריים
`boolean`	`arePropertiesSet()` הפונקציה מחזירה את הערך `true` אם הנכסים נשמרו במטמון
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` יצירת העברת יציאות בין יציאת TCP מקומית לבין שקע דומיין של Unix מרוחק.
`void`	`createForward(int localPort, int remotePort)` יוצרת העברת יציאה בין יציאה מקומית ליציאה מרוחקת.
`void`	`createReverse(int remotePort, int localPort)` יוצרת היפוך יציאות בין יציאה מרוחקת ליציאה מקומית.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל `receiver` היא דומה לקריאה לפונקציה `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` גרסה של הפקודה executeShell שיכולה לקבל זרם קלט לשליחה דרך stdin.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל `receiver`.
`void`	`forceStop(String applicationName)` סוגרים ידנית אפליקציה לפי שם האפליקציה.
`List<String>`	`getAbis()` מחזירה את ממשקי ה-ABI שנתמכים במכשיר הזה.
`ListenableFuture<AvdData>`	`getAvdData()` מחזירה מידע על ה-AVD שבו האמולטור פועל.
`String`	`getAvdName()` הפונקציה מחזירה את השם של AVD שבו האמולטור פועל.
`String`	`getAvdPath()` הפונקציה מחזירה את הנתיב המוחלט למכשיר הווירטואלי במערכת הקבצים.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`Future<Integer>`	`getBattery()` מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`Integer`	`getBatteryLevel(long freshnessMs)` מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`Integer`	`getBatteryLevel()` מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`int`	`getDensity()` הפונקציה מחזירה את קטגוריית הצפיפות של מסך המכשיר על ידי קריאת הערך של מאפיין המערכת `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` מחזירה `FileListingService` למכשיר הזה.
`String`	`getLanguage()` הפונקציה מחזירה את השפה של המשתמש.
`InstallMetrics`	`getLastInstallMetrics()` מקבל את המידע על ההתקנה האחרונה במכשיר הזה.
`String`	`getMountPoint(String name)` מחזירה נקודת טעינה.
`String`	`getName()` מחזירה שם (ידידותי) למכשיר הזה.
`Map<String, String>`	`getProperties()` הפונקציה מחזירה את מאפייני המכשיר שנשמרו במטמון.
`String`	`getProperty(String name)` שיטת נוחות שמנסה לאחזר נכס באמצעות `getSystemProperty(String)` עם זמן המתנה קצר מאוד, ומבטלת חריגים.
`String`	`getPropertyCacheOrSync(String name)` שילוב של `getProperty(String)` ו-`getPropertySync(String)` שינסה לאחזר את המאפיין מהמטמון.
`int`	`getPropertyCount()` מחזירה את מספר הנכס של המכשיר הזה.
`String`	`getPropertySync(String name)` וריאציה של `getProperty(String)` שתנסה לאחזר את המאפיין שצוין ישירות מהמכשיר, בלי להשתמש במטמון.
`String`	`getRegion()` הפונקציה מחזירה את האזור של המשתמש.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`RawImage`	`getScreenshot()` מצלם צילום מסך של המכשיר ומחזיר אותו כ-`RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` מחזירה את המספר הסידורי של המכשיר.
`IDevice.DeviceState`	`getState()` מחזירה את מצב המכשיר.
`SyncService`	`getSyncService()` מחזירה אובייקט `SyncService` כדי לדחוף קבצים למכשיר ולמשוך קבצים מהמכשיר.
`ListenableFuture<String>`	`getSystemProperty(String name)` שליחת שאילתה אסינכרונית פוטנציאלית לקבלת מאפיין מערכת.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` הפקודה מתקינה אפליקציה ל-Android במכשיר.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` הפקודה מתקינה אפליקציה ל-Android במכשיר.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` הפקודה מתקינה אפליקציה ל-Android במכשיר.
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` מתקין אפליקציה ל-Android שמורכבת מכמה קובצי APK (קובץ אחד ראשי ו-0 עד n חבילות מפוצלות)
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions)` מתקין אפליקציה ל-Android שמורכבת מכמה קובצי APK (קובץ ראשי אחד ו-0 עד n חבילות מפוצלות) עם הגדרת זמן קצוב לתפוגה שמוגדרת כברירת מחדל
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` הפקודה מתקינה את חבילת האפליקציה שנשלחה למיקום זמני במכשיר.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` הפקודה מתקינה את חבילת האפליקציה שנשלחה למיקום זמני במכשיר.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` הפקודה מתקינה את חבילת האפליקציה שנשלחה למיקום זמני במכשיר.
`void`	`installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר
`void`	`installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions)` הפקודה מתקינה אפליקציית Android שמורכבת מכמה קובצי APK שנמצאים באופן מקומי במכשיר עם פסק זמן שמוגדר כברירת מחדל
`boolean`	`isBootLoader()` מחזיר אם המכשיר נמצא במצב של תוכנת אתחול.
`boolean`	`isEmulator()` הפונקציה מחזירה `true` אם המכשיר הוא אמולטור.
`boolean`	`isOffline()` הפונקציה מחזירה ערך אם המכשיר אופליין.
`boolean`	`isOnline()` הפונקציה מחזירה ערך אם המכשיר מוכן.
`boolean`	`isRoot()` שאילתה לגבי סטטוס הבסיס הנוכחי של המכשיר.
`void`	`kill(String applicationName)` הפקודה מסיימת אפליקציה לפי שם האפליקציה.
`void`	`pullFile(String remote, String local)` שליפת קובץ יחיד.
`void`	`push(String[] local, String remote)` העברה של כמה קבצים או ספריות.
`void`	`pushFile(String local, String remote)` העברה של קובץ יחיד.
`SocketChannel`	`rawBinder(String service, String[] parameters)` מפעילים את שירות Android Binder Bridge במכשיר שמחובר לרשת אחרת.
`SocketChannel`	`rawExec(String executable, String[] parameters)` הפעלת השירות host:exec במכשיר שמחובר לרשת אחרת.
`void`	`reboot(String into)` מפעילים מחדש את המכשיר.
`void`	`removeForward(int localPort)` מסירה העברה ליציאה אחרת בין יציאה מקומית ליציאה מרוחקת.
`void`	`removeRemotePackage(String remoteFilePath)` הסרת קובץ מהמכשיר.
`void`	`removeReverse(int remotePort)` מסיר היפוך של יציאה בין יציאה מרוחקת ליציאה מקומית.
`boolean`	`root()` שולחים בקשה לדימון (daemon) של adb להפוך להרמה הבסיסית (root) במכשיר.
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` מתחילה הקלטת מסך במכשיר אם המכשיר תומך ב-`Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` הפונקציה מחזירה אם המכשיר תומך בתכונת החומרה שצוינה.
`boolean`	`supportsFeature(IDevice.Feature feature)` הפונקציה מחזירה את הערך true אם המכשיר תומך בתכונת התוכנה שצוינה, אחרת היא מחזירה את הערך false.
`String`	`syncPackageToDevice(String localFilePath)` העברת קובץ למכשיר
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` הסרת התקנה של אפליקציה מהמכשיר.
`String`	`uninstallPackage(String packageName)` הסרת חבילה מהמכשיר.

‫constructors ציבוריים

DeviceImpl

public DeviceImpl (String serialNumber, 
                IDevice.DeviceState deviceState)

פרמטרים
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

‫methods ציבוריים

arePropertiesSet

public boolean arePropertiesSet ()

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

החזרות
`boolean`

createForward

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

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

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

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

createForward

public void createForward (int localPort, 
                int remotePort)

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

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

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

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

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

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellCommand

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

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

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

executeShellCommand

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

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

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

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

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

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

executeShellCommand

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

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

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

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

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public 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 String getAvdName ()

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

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

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

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

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

getAvdPath

public String getAvdPath ()

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

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

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

getBattery

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

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

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

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

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

getBattery

public Future<Integer> getBattery ()

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

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

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

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

החזרות
`FileListingService`

getLanguage

public String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public String getMountPoint (String name)

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

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

החזרות
`String`

getName

public String getName ()

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

החזרות
`String`

getProperties

public Map<String, String> getProperties ()

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

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

getProperty

public String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

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

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

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

getPropertyCount

public int getPropertyCount ()

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

החזרות
`int`

getPropertySync

public String getPropertySync (String name)

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

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

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

getRegion

public String getRegion ()

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

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

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

החזרות
`String`

getScreenshot

public RawImage getScreenshot ()

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

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

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

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

החזרות
`RawImage`

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

getSerialNumber

public String getSerialNumber ()

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

החזרות
`String`

getState

public IDevice.DeviceState getState ()

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

החזרות
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

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

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

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

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

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

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

החזרות
`ListenableFuture<String>`	‫`ListenableFuture.` `get` עשוי להחזיר null.

installPackage

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

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

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

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

installPackage

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

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

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

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

installPackage

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

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

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

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

installPackages

public 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 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 void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

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

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

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

installRemotePackage

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

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

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

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

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

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

isEmulator

public boolean isEmulator ()

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

החזרות
`boolean`

isOffline

public boolean isOffline ()

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

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

isOnline

public boolean isOnline ()

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

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

isRoot

public boolean isRoot ()

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

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

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

הרג

public void kill (String applicationName)

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

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

pullFile

public void pullFile (String remote, 
                String local)

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

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

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

דחיפת הודעות

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

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

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

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

pushFile

public void pushFile (String local, 
                String remote)

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

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

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

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

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

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

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

removeForward

public void removeForward (int localPort)

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

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

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

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

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

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

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

removeReverse

public void removeReverse (int remotePort)

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

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

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

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

public boolean root ()

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

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

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

startScreenRecorder

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

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

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

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

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature feature)

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

פרמטרים
`feature`	`IDevice.HardwareFeature`

החזרות
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

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

פרמטרים
`feature`	`IDevice.Feature`

החזרות
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

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

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

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

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

toString

public String toString ()

החזרות
`String`

uninstallApp

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

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

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

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

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

uninstallPackage

public String uninstallPackage (String packageName)

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

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

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

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