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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

StubDevice

public class StubDevice
extends Object implements IDevice, Serializable

java.lang.Object
↳	com.android.tradefed.device.StubDevice

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

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

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

הטמעה של placeholder מסוג stub של IDevice.

סיכום

‫constructors ציבוריים
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

‫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)` השיטה הזו הוצאה משימוש. להשתמש ב-`executeShellCommand(String,IShellOutputReceiver,long,TimeUnit)`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` מריץ פקודת מעטפת במכשיר ושולח את התוצאה אל `receiver`.
`List<String>`	`getAbis()` מחזירה את ממשקי ה-ABI שנתמכים במכשיר הזה.
`String`	`getAvdName()` הפונקציה מחזירה את השם של AVD שבו האמולטור פועל.
`String`	`getAvdPath()` הפונקציה מחזירה את הנתיב המוחלט למכשיר הווירטואלי במערכת הקבצים.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`Future<Integer>`	`getBattery()` מחזירה את רמת הטעינה של הסוללה במכשיר, מ-0 עד 100 אחוזים.
`Integer`	`getBatteryLevel(long freshnessMs)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `getBattery(long,TimeUnit)`.
`Integer`	`getBatteryLevel()` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `getBattery()`.
`int`	`getDensity()` הפונקציה מחזירה את קטגוריית הצפיפות של מסך המכשיר על ידי קריאת הערך של מאפיין המערכת `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` מחזירה `FileListingService` למכשיר הזה.
`String`	`getLanguage()` הפונקציה מחזירה את השפה של המשתמש.
`String`	`getMountPoint(String name)` מחזירה נקודת טעינה.
`String`	`getName()` מחזירה שם (ידידותי) למכשיר הזה.
`Map<String, String>`	`getProperties()` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `getSystemProperty(String)`.
`String`	`getProperty(String name)` שיטת נוחות שמנסה לאחזר נכס באמצעות `getSystemProperty(String)` עם זמן המתנה קצר מאוד, ומבטלת חריגים.
`String`	`getPropertyCacheOrSync(String name)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `getProperty(String)`.
`int`	`getPropertyCount()` השיטה הזו הוצאה משימוש. הוצא משימוש בספריית ddmlib עם הסיבה 'פרטי הטמעה'.
`String`	`getPropertySync(String name)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `getProperty(String)`.
`String`	`getRegion()` הפונקציה מחזירה את האזור של המשתמש.
`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> apkFilePaths, boolean reinstall, List<String> extraArgs, long timeOutInMs, TimeUnit timeunit)` מתקין אפליקציה ל-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)` הפקודה מתקינה את חבילת האפליקציה שנשלחה למיקום זמני במכשיר.
`boolean`	`isBootLoader()` מחזיר אם המכשיר נמצא במצב של תוכנת אתחול.
`boolean`	`isEmulator()` הפונקציה מחזירה `true` אם המכשיר הוא אמולטור.
`boolean`	`isOffline()` הפונקציה מחזירה ערך אם המכשיר אופליין.
`boolean`	`isOnline()` הפונקציה מחזירה ערך אם המכשיר מוכן.
`boolean`	`isRoot()` שאילתה לגבי סטטוס הבסיס הנוכחי של המכשיר.
`void`	`pullFile(String remote, String local)` שליפת קובץ יחיד.
`void`	`pushFile(String local, String remote)` העברה של קובץ יחיד.
`void`	`reboot(String into)` מפעילים מחדש את המכשיר.
`void`	`removeForward(int localPort)` מסירה העברה ליציאה אחרת בין יציאה מקומית ליציאה מרוחקת.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` הסרת קובץ מהמכשיר.
`void`	`removeReverse(int remotePort)` מסיר היפוך של יציאה בין יציאה מרוחקת ליציאה מקומית.
`boolean`	`root()` שולחים בקשה לדימון (daemon) של adb להפוך להרמה הבסיסית (root) במכשיר.
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` מתחילה הקלטת מסך במכשיר אם המכשיר תומך ב-`Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` הפונקציה מחזירה אם המכשיר תומך בתכונת החומרה שצוינה.
`boolean`	`supportsFeature(IDevice.Feature feature)` הפונקציה מחזירה את הערך true אם המכשיר תומך בתכונת התוכנה שצוינה, אחרת היא מחזירה את הערך false.
`String`	`syncPackageToDevice(String localFilePath)` העברת קובץ למכשיר
`String`	`uninstallApp(String applicationID, String... extraArgs)` הסרת התקנה של אפליקציה מהמכשיר.
`String`	`uninstallPackage(String packageName)` הסרת חבילה מהמכשיר.

‫constructors ציבוריים

StubDevice

public StubDevice (String serial)

פרמטרים
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

פרמטרים
`serial`	`String`
`isEmulator`	`boolean`

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

השיטה הזו הוצאה משימוש.
אפשר להשתמש ב-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 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)

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

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

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

getAbis

public List<String> getAbis ()

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

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

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)

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

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

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

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

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

החזרות
`FileListingService`

getLanguage

public String getLanguage ()

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

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

getMountPoint

public String getMountPoint (String name)

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

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

החזרות
`String`

getName

public String getName ()

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

החזרות
`String`

getProperties

public Map<String, String> getProperties ()

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

הפונקציה מחזירה את מאפייני המכשיר שנשמרו במטמון. הוא מכיל את כל הפלט של 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).

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

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

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

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

getPropertyCount

public int getPropertyCount ()

השיטה הזו הוצאה משימוש.
deprecated in ddmlib with "implementation detail" as reason.

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

החזרות
`int`

getPropertySync

public String getPropertySync (String name)

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

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

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

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

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

getRegion

public String getRegion ()

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

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

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> apkFilePaths, 
                boolean reinstall, 
                List<String> extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

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

פרמטרים
`apkFilePaths`	‫`List`: רשימה של קובצי APK להתקנה (קובץ APK ראשי אחד + 0 עד n קובצי APK מפוצלים)
`reinstall`	‫`boolean`: מוגדר ל-`true` אם צריך לבצע התקנה מחדש של האפליקציה
`extraArgs`	‫`List`: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm install --help.
`timeOutInMs`	`long`: פסק זמן להתקנה
`timeunit`	‫`TimeUnit`: `TimeUnit` שמתאים לפרמטר timeout

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

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`

pullFile

public void pullFile (String remote, 
                String local)

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

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

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

pushFile

public void pushFile (String local, 
                String remote)

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

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

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

removeForward

public void removeForward (int localPort, 
                int remotePort)

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

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

removeForward

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

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

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

setSerial

public void setSerial (String serial)

פרמטרים
`serial`	`String`

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

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

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

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`