ITestDevice | Android Open Source Project

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

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

תת-מחלקות עקיפות ידועות

IManagedTestDevice , LocalAndroidVirtualDevice , ManagedRemoteDevice , NativeDevice , NestedRemoteDevice , RemoteAndroidDevice , RemoteAndroidVirtualDevice , TestDevice

IManagedTestDevice	ITestDevice שמחזור החיים שלו מנוהל.
LocalAndroidVirtualDevice	המחלקה למכשירים וירטואליים מקומיים הפועלים על מארח TradeFed.
ManagedRemoteDevice	מכשיר הפועל בתוך מכונה וירטואלית שאנו מנהלים מרחוק באמצעות מופע Tradefed בתוך ה-VM.
NativeDevice	יישום ברירת מחדל של `ITestDevice` מכשירי אנדרואיד שאינם מחסנית מלאה.
NestedRemoteDevice	ייצוג המכשיר הפועל בתוך מכשיר VM מרוחק של Cuttlefish.
RemoteAndroidDevice	יישום של `ITestDevice` עבור מכשיר אנדרואיד מלא המחובר באמצעות adb connect.
RemoteAndroidVirtualDevice	מרחיב את התנהגות `RemoteAndroidDevice` עבור מכשיר אנדרואיד מלא שפועל ב-Google Compute Engine (Gce).
TestDevice	הטמעת `ITestDevice` עבור מכשיר אנדרואיד מלא מחסנית

מספק API אמין וברמה מעט גבוהה יותר ל-ddmlib IDevice .

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

סיכום

כיתות מקוננות
`class`	`ITestDevice.ApexInfo` מחלקת struct פשוטה לאחסון מידע על APEX בודד
`class`	`ITestDevice.MountPointInfo` מחלקת struct פשוטה לאחסון מידע על נקודת הרכבה בודדת

שיטות ציבוריות
`abstract boolean`	`canSwitchToHeadlessSystemUser ()` מחזירה אם מותר לעבור למשתמש SYSTEM ללא ראש.
`abstract boolean`	`checkConnectivity ()` בדוק שלמכשיר יש קישוריות רשת.
`abstract boolean`	`clearErrorDialogs ()` נסה לבטל את כל תיבת הדו-שיח של שגיאה המוצגת כעת בממשק המשתמש של המכשיר.
`abstract void`	`clearLastConnectedWifiNetwork ()` מנקה את רשת ה-WiFi המחוברת האחרונה.
`abstract boolean`	`connectToWifiNetwork ( wifiSsidToPsk)` `connectToWifiNetwork ( wifiSsidToPsk)` מתחבר לרשת wifi.
`abstract boolean`	`connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)` `connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)` מתחבר לרשת wifi.
`abstract boolean`	`connectToWifiNetwork (String wifiSsid, String wifiPsk)` מתחבר לרשת wifi.
`abstract boolean`	`connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)` מתחבר לרשת wifi.
`abstract boolean`	`connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)` גרסה של `connectToWifiNetwork(String, String)` שמתחברת רק אם למכשיר אין כרגע קישוריות רשת.
`abstract boolean`	`connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)` גרסה של `connectToWifiNetwork(String, String)` שמתחברת רק אם למכשיר אין כרגע קישוריות רשת.
`abstract int`	`createUser (String name)` צור משתמש עם שם נתון ודגלי ברירת מחדל 0.
`abstract int`	`createUser (String name, boolean guest, boolean ephemeral)` צור משתמש עם שם נתון והדגלים שסופקו
`abstract int`	`createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)` צור משתמש עם שם נתון והדגלים שסופקו
`abstract int`	`createUserNoThrow (String name)` צור משתמש עם שם נתון ודגלי ברירת מחדל 0.
`abstract void`	`deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)` מסיר את `IDeviceActionReceiver` הרשום.
`abstract void`	`disableKeyguard ()` ניסיונות להשבית את מגן המקשים.
`abstract boolean`	`disableNetworkMonitor ()` משבית את ניטור הרשת במכשיר.
`abstract boolean`	`disconnectFromWifi ()` מתנתק מרשת wifi.
`abstract boolean`	`doesFileExist (String deviceFilePath, int userId)` שיטת עוזר לקבוע אם קיים קובץ במכשיר עבור משתמש נתון.
`abstract File`	`dumpHeap (String process, String devicePath)` נסה לזרוק את הערימה מה-system_server.
`abstract boolean`	`enableNetworkMonitor ()` מאפשר ניטור רשת במכשיר.
`abstract`	`getActiveApexes ()` אחזר את המידע על APEXs שהופעלו במכשיר.
`abstract`	`getAllSettings (String namespace)` החזר צמדי ערכי מפתח של מרחב השמות המבוקש.
`abstract String`	`getAndroidId (int userId)` מצא והחזר את ה-Android-ID המשויך ל-userId, null אם לא נמצא.
`abstract`	`getAndroidIds ()` צור מפה של מזהי אנדרואיד שנמצאו תואמים מזהי משתמש.
`abstract PackageInfo`	`getAppPackageInfo (String packageName)` אחזר מידע על חבילה המותקנת במכשיר.
`abstract`	`getAppPackageInfos ()` אחזר מידע של חבילות המותקנות במכשיר.
`abstract InputStreamSource`	`getBugreport ()` מאחזר דוח באג מהמכשיר.
`abstract InputStreamSource`	`getBugreportz ()` מאחזר דיווח באג מהמכשיר.
`abstract DeviceFoldableState`	`getCurrentFoldableState ()` מחזיר את המצב המתקפל הנוכחי של המכשיר או null אם התרחשו בעיות מסוימות.
`abstract int`	`getCurrentUser ()` החזר את המזהה של המשתמש הנוכחי הפועל.
`abstract`	`getFoldableStates ()` מחזירה את רשימת המצבים הניתנים לקיפול במכשיר.
`abstract`	`getInstalledPackageNames ()` אחזר את שמות חבילות היישומים הקיימים במכשיר.
`abstract String`	`getIpAddress ()` מקבל את כתובת ה-IP של המכשיר.
`abstract KeyguardControllerState`	`getKeyguardState ()` החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך.
`abstract Integer`	`getMainUserId ()` מחזירה את מזהה המשתמש הראשי.
`abstract`	`getMainlineModuleInfo ()` קבל את המידע על המודולים המרכזיים המותקנים במכשיר.
`abstract int`	`getMaxNumberOfRunningUsersSupported ()` קבל את המספר המרבי של משתמשים שפועלים בו זמנית.
`abstract int`	`getMaxNumberOfUsersSupported ()` קבל את המספר המרבי של משתמשים נתמכים.
`abstract TestDeviceOptions`	`getOptions ()` אחזר את אפשרויות הבדיקה של המכשיר.
`abstract Integer`	`getPrimaryUserId ()` מחזירה את מזהה המשתמש הראשי.
`abstract InputStreamSource`	`getScreenshot (String format, boolean rescale)` תופס צילום מסך מהמכשיר.
`abstract InputStreamSource`	`getScreenshot (String format)` תופס צילום מסך מהמכשיר.
`abstract InputStreamSource`	`getScreenshot (long displayId)` תופס צילום מסך מהמכשיר שקיבל מזהה תצוגה.
`abstract InputStreamSource`	`getScreenshot ()` תופס צילום מסך מהמכשיר.
`abstract String`	`getSetting (int userId, String namespace, String key)` החזר את הערך של ההגדרה המבוקשת.
`abstract String`	`getSetting (String namespace, String key)` ראה `getSetting(int, String, String)` ובוצע על משתמש מערכת.
`abstract`	`getUninstallablePackageNames ()` אחזר את שמות חבילות האפליקציות שניתן להסיר.
`abstract int`	`getUserFlags (int userId)` מצא והחזר את הדגלים של משתמש נתון.
`abstract`	`getUserInfos ()` מקבל את מפת useId ל- `UserInfo` במכשיר.
`abstract int`	`getUserSerialNumber (int userId)` החזר את המספר הסידורי המשויך ל-userId אם נמצא, -10000 בכל מקרה אחר.
`abstract boolean`	`hasFeature (String feature)` בדוק אם תכונה זמינה במכשיר.
`abstract String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` התקן חבילת אנדרואיד במכשיר.
`abstract String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקן חבילת אנדרואיד במכשיר.
`abstract String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.
`abstract String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.
`default String`	`installPackages ( packageFiles, boolean reinstall, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, String... extraArgs)` התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (חבילה ראשית וחבילה מפוצלת נוספת).
`default String`	`installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) שיושבים על מכשיר האנדרואיד.
`default String`	`installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)` התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) עבור משתמש נתון.
`default String`	`installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) עבור משתמש נתון.
`default String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)` התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) שיושבים על מכשיר האנדרואיד.
`default String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) שיושבים על מכשיר האנדרואיד.
`abstract boolean`	`isHeadlessSystemUserMode ()` מחזירה אם המכשיר משתמש במצב משתמש מערכת ללא ראש.
`abstract boolean`	`isMainUserPermanentAdmin ()` מחזירה אם המשתמש הראשי הוא מנהל קבוע ולא ניתן למחוק אותו או לשדרג לאחור למצב שאינו מנהל.
`abstract boolean`	`isMultiUserSupported ()` קובע אם ריבוי משתמשים נתמך.
`abstract boolean`	`isPackageInstalled (String packageName, String userId)` שאל את המכשיר עבור שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם הוא מותקן כעת או לא עבור אותו משתמש.
`abstract boolean`	`isPackageInstalled (String packageName)` שאל את המכשיר עבור שם חבילה נתון כדי לבדוק אם הוא מותקן כעת או לא.
`abstract boolean`	`isUserRunning (int userId)` בדוק אם משתמש נתון פועל.
`abstract boolean`	`isUserSecondary (int userId)` החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
`abstract boolean`	`isUserVisible (int userId)` בודק אם המשתמש הנתון גלוי.
`abstract boolean`	`isUserVisibleOnDisplay (int userId, int displayId)` בודק אם המשתמש הנתון גלוי בתצוגה הנתונה.
`abstract boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported ()` מחזירה אם המכשיר מאפשר הפעלת משתמשים גלויים ברקע ב- `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` .
`abstract boolean`	`isVisibleBackgroundUsersSupported ()` מחזירה אם המכשיר מאפשר הפעלת משתמשים גלויים ברקע.
`abstract boolean`	`isWifiEnabled ()` בדוק אם wifi מופעל.
`abstract`	`listDisplayIds ()` אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".
`abstract`	`listDisplayIdsForStartingVisibleBackgroundUsers ()` מקבל את רשימת הצגים שניתן להשתמש בהם כדי `start a user visible in the background` .
`abstract`	`listUsers ()` מקבל את רשימת המשתמשים במכשיר.
`abstract boolean`	`logBugreport (String dataName, ITestLogger listener)` שיטת עוזר לקחת דוח באג ולהתחבר לכתבים.
`default void`	`notifySnapuserd ( SnapuserdWaitPhase waitPhase)` הודע למכשיר להמתין להשלמת snapuserd.
`abstract void`	`registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)` רושם `IDeviceActionReceiver` עבור מכשיר זה.
`abstract boolean`	`removeAdmin (String componentName, int userId)` הסר מנהל מכשיר נתון במשתמש נתון והחזר `true` אם זה מצליח, `false` אחרת.
`abstract void`	`removeOwners ()` הסר את כל בעלי פרופיל המכשירים הקיימים במאמץ הטוב ביותר.
`abstract boolean`	`removeUser (int userId)` הסר משתמש נתון מהמכשיר.
`abstract boolean`	`setDeviceOwner (String componentName, int userId)` הגדר רכיב ניהול מכשיר כבעל מכשיר במשתמש נתון.
`abstract void`	`setSetting (String namespace, String key, String value)` ראה `setSetting(int, String, String, String)` ובוצע על משתמש המערכת.
`abstract void`	`setSetting (int userId, String namespace, String key, String value)` הוסף ערך הגדרה למרחב השמות של משתמש נתון.
`abstract boolean`	`startUser (int userId)` מפעיל משתמש נתון ברקע אם הוא מופסק כעת.
`abstract boolean`	`startUser (int userId, boolean waitFlag)` מפעיל משתמש נתון ברקע אם הוא מופסק כעת.
`abstract boolean`	`startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)` מפעיל משתמש נתון ברקע, גלוי בתצוגה הנתונה (כלומר, מאפשר למשתמש להפעיל פעילויות בתצוגה זו).
`abstract boolean`	`stopUser (int userId)` עוצר משתמש נתון.
`abstract boolean`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` עצור משתמש נתון.
`abstract boolean`	`switchUser (int userId)` עבור ל-userId אחר עם פסק זמן ברירת מחדל.
`abstract boolean`	`switchUser (int userId, long timeout)` עבור ל-userId אחר עם הזמן הקצוב שסופק כתאריך יעד.
`abstract Bugreport`	`takeBugreport ()` קח דוח באג ומחזיר אותו בתוך אובייקט `Bugreport` כדי לטפל בו.
`abstract String`	`uninstallPackage (String packageName)` הסר התקנה של חבילת אנדרואיד מהמכשיר.
`abstract String`	`uninstallPackageForUser (String packageName, int userId)` הסר התקנה של חבילת אנדרואיד מהמכשיר עבור משתמש נתון.
`default void`	`waitForSnapuserd ( SnapuserdWaitPhase currentPhase)` אם צפוי, המתן עד להשלמת snapuserd.

שיטות ציבוריות

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

מחזירה אם מותר לעבור למשתמש SYSTEM ללא ראש.

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

לבדוק קישוריות

public abstract boolean checkConnectivity ()

בדוק שלמכשיר יש קישוריות רשת.

החזרות
`boolean`	`true` אם למכשיר יש חיבור רשת עובד, `false` יתר על המידה.

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

החזרות
`boolean`	`true` אם לא היו תיבות דו-שיח או אם תיבות דו-שיח נוקו בהצלחה. `false` אחרת.

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

מתחבר לרשת wifi.

מפעיל wifi וחוסם עד ליצירת חיבור מוצלח עם אחת מרשתות ה- wifi המפורטות במפת wifiSsidToPsk. לאחר יצירת חיבור, המופע ינסה לשחזר את החיבור לאחר כל אתחול מחדש עד שייקרא ITestDevice#disconnectFromWifi() או ITestDevice#clearLastConnectedWifiNetwork() .

פרמטרים
`wifiSsidToPsk`	: מפה של wifi SSIDs לסיסמאות.

החזרות
`boolean`	`true` אם מחובר לרשת wifi בהצלחה. `false` אחרת

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

מתחבר לרשת wifi.

פרמטרים
`wifiSsidToPsk`	: מפה של wifi SSIDs לסיסמאות.
`scanSsid`	`boolean` : האם לסרוק SSIDs מוסתרים עבור רשת זו.

החזרות
`boolean`	`true` אם מחובר לרשת wifi בהצלחה. `false` אחרת

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

מתחבר לרשת wifi.

מפעיל wifi וחוסם עד לחיבור מוצלח לרשת wifi שצוינה. לאחר יצירת חיבור, המופע ינסה לשחזר את החיבור לאחר כל אתחול מחדש עד שייקרא ITestDevice#disconnectFromWifi() או ITestDevice#clearLastConnectedWifiNetwork() .

פרמטרים
`wifiSsid`	`String` : ה-ssid של wifi שאליו יש להתחבר
`wifiPsk`	`String` : ביטוי סיסמה PSK או null אם לא מוצפן

החזרות
`boolean`	`true` אם מחובר לרשת wifi בהצלחה. `false` אחרת

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

מתחבר לרשת wifi.

פרמטרים
`wifiSsid`	`String` : ה-ssid של wifi שאליו יש להתחבר
`wifiPsk`	`String` : ביטוי סיסמה PSK או null אם לא מוצפן
`scanSsid`	`boolean` : האם לסרוק SSID מוסתר עבור רשת זו.

החזרות
`boolean`	`true` אם מחובר לרשת wifi בהצלחה. `false` אחרת

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

גרסה של connectToWifiNetwork(String, String) שמתחברת רק אם למכשיר אין כרגע קישוריות רשת.

פרמטרים
`scanSsid`	`boolean` : האם לסרוק SSID מוסתר עבור רשת זו

החזרות
`boolean`	`true` אם מחובר לרשת wifi בהצלחה. `false` אחרת

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

גרסה של connectToWifiNetwork(String, String) שמתחברת רק אם למכשיר אין כרגע קישוריות רשת.

החזרות
`boolean`	`true` אם מחובר לרשת wifi בהצלחה. `false` אחרת

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

צור משתמש

public abstract int createUser (String name)

צור משתמש עם שם נתון ודגלי ברירת מחדל 0.

פרמטרים
`name`	`String` : של המשתמש ליצור במכשיר

החזרות
`int`	המספר השלם עבור מזהה המשתמש שנוצר

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

צור משתמש

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

צור משתמש עם שם נתון והדגלים שסופקו

פרמטרים
`name`	`String` : של המשתמש ליצור במכשיר
`guest`	`boolean` : אפשר את דגל המשתמש --guest במהלך היצירה
`ephemeral`	`boolean` : אפשר את דגל המשתמש - ארעית במהלך היצירה

החזרות
`int`	מזהה המשתמש שנוצר

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

צור משתמש

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

צור משתמש עם שם נתון והדגלים שסופקו

פרמטרים
`name`	`String` : של המשתמש ליצור במכשיר
`guest`	`boolean` : אפשר את דגל המשתמש --guest במהלך היצירה
`ephemeral`	`boolean` : אפשר את דגל המשתמש - ארעית במהלך היצירה
`forTesting`	`boolean` : אפשר את דגל הבדיקה --לבדיקה במהלך היצירה

החזרות
`int`	מזהה המשתמש שנוצר

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

createUserNoThrow

public abstract int createUserNoThrow (String name)

צור משתמש עם שם נתון ודגלי ברירת מחדל 0.

פרמטרים
`name`	`String` : של המשתמש ליצור במכשיר

החזרות
`int`	המספר השלם עבור מזהה המשתמש שנוצר או -1 עבור שגיאה.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

מסיר את IDeviceActionReceiver הרשום.

פרמטרים
`deviceActionReceiver`	`IDeviceActionReceiver` : `IDeviceActionReceiver` שיוסר.

disableKeyguard

public abstract void disableKeyguard ()

ניסיונות להשבית את מגן המקשים.

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

זורק
`DeviceNotAvailableException`

השבת את NetworkMonitor

public abstract boolean disableNetworkMonitor ()

משבית את ניטור הרשת במכשיר.

החזרות
`boolean`	`true` אם הניטור מושבת בהצלחה. `false` אם זה נכשל.

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

מתנתק מרשת wifi.

מסיר את כל הרשתות מרשימת הרשתות המוכרות ומשבית את ה-wifi.

החזרות
`boolean`	`true` אם התנתק מרשת wifi בהצלחה. `false` אם הניתוק נכשל.

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

שיטת עוזר לקבוע אם קיים קובץ במכשיר עבור משתמש נתון.

פרמטרים
`deviceFilePath`	`String` : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק
`userId`	`int` : מזהה המשתמש שכנגדו יש לבדוק את קיום הקובץ

החזרות
`boolean`	`true` אם הקובץ קיים, `false` אחרת.

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

נסה לזרוק את הערימה מה-system_server. באחריות המתקשר לנקות את הקובץ שנזרק.

פרמטרים
`process`	`String` : שם תהליך ההתקן שעליו dumpheap.
`devicePath`	`String` : הנתיב במכשיר שבו לשים את המזבלה. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת.

החזרות
`File`	ה- `ERROR(/File)` המכילה את הדוח. ריק אם משהו נכשל.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

אפשר NetworkMonitor

public abstract boolean enableNetworkMonitor ()

מאפשר ניטור רשת במכשיר.

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

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

getActiveApexes

public abstract  getActiveApexes ()

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

החזרות
	`ERROR(/Set)` של `ApexInfo` המופעל כעת במכשיר

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAllSettings

public abstract  getAllSettings (String namespace)

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

פרמטרים
`namespace`	`String` : חייבת להיות אחת מ-{"system", "secure", "global"}

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

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAndroidId

public abstract String getAndroidId (int userId)

מצא והחזר את ה-Android-ID המשויך ל-userId, null אם לא נמצא.

פרמטרים
`userId`	`int`

החזרות
`String`

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAndroidIds

public abstract  getAndroidIds ()

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

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

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

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

החזרות
`PackageInfo`	את `PackageInfo` או `null` אם לא ניתן היה לאחזר מידע

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

החזרות
	`ERROR(/List)` של `PackageInfo` המותקנים במכשיר.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBugreport

public abstract InputStreamSource getBugreport ()

מאחזר דוח באג מהמכשיר.

היישום של זה מובטח להמשיך לעבוד על מכשיר ללא sdcard (או היכן שה-sdcard עדיין לא מותקן).

החזרות
`InputStreamSource`	`InputStreamSource` אשר יפיק את תוכן דוח הבאגים לפי דרישה. במקרה של כשל, `InputStreamSource` יפיק `ERROR(/InputStream)` .

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

נתמך רק עבור 'גרסת adb' > 1.0.36

החזרות
`InputStreamSource`	a `InputStreamSource` של קובץ ה-zip המכיל את bugreportz, החזר null במקרה של כשל.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getCurrentUser

public abstract int getCurrentUser ()

החזר את המזהה של המשתמש הנוכחי הפועל. במקרה של שגיאה, החזר -10000.

החזרות
`int`

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public abstract  getFoldableStates ()

מחזירה את רשימת המצבים הניתנים לקיפול במכשיר. ניתן להשיג עם "cmd device_state print-states".

החזרות

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

החזרות
	`ERROR(/Set)` של שמות חבילות `String` המותקנות כעת במכשיר.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIpAddress

public abstract String getIpAddress ()

מקבל את כתובת ה-IP של המכשיר.

החזרות
`String`	כתובת ה-IP של המכשיר, או `null` אם למכשיר אין כתובת IP

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך.

החזרות
`KeyguardControllerState`	`KeyguardControllerState` המכיל תמונת מצב של המקלדת ומחזירה Null אם שאילתת Keyguard אינה נתמכת.

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

getMainUserId

public abstract Integer getMainUserId ()

מחזירה את מזהה המשתמש הראשי.

החזרות
`Integer`	userId של המשתמש הראשי אם קיים אחד, ו-null אם אין משתמש ראשי.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	אם הפלט מהמכשיר אינו כצפוי.
`DeviceNotAvailableException`

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

החזרות
	`ERROR(/Set)` של מודולי `String` mainline המותקנים כעת במכשיר.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

קבל את המספר המרבי של משתמשים שפועלים בו זמנית. ברירת המחדל היא 0.

החזרות
`int`	מספר שלם המציין את מספר המשתמשים הפועלים בו זמנית

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

קבל את המספר המרבי של משתמשים נתמכים. ברירת המחדל היא 0.

החזרות
`int`	מספר שלם המציין את מספר המשתמשים הנתמכים

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getOptions

public abstract TestDeviceOptions getOptions ()

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

החזרות
`TestDeviceOptions`	`TestDeviceOptions` הקשורים למכשיר הנבדק.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

מחזירה את מזהה המשתמש הראשי.

החזרות
`Integer`	userId של המשתמש הראשי אם קיים אחד, ו-null אם אין משתמש ראשי.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	אם הפלט מהמכשיר אינו כצפוי.
`DeviceNotAvailableException`

get Screenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

תופס צילום מסך מהמכשיר. מומלץ להשתמש getScreenshot(String) במקום עם קידוד JPEG לגודל קטן יותר.

פרמטרים
`format`	`String` : נתמך PNG, JPEG
`rescale`	`boolean` : אם יש לשנות את קנה המידה של צילום המסך כדי להקטין את גודל התמונה המתקבלת

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט, או `null` אם צילום המסך לא הצליח.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

get Screenshot

public abstract InputStreamSource getScreenshot (String format)

תופס צילום מסך מהמכשיר. מומלץ להשתמש ב-getScreenshot(פורמט) במקום עם קידוד JPEG לגודל קטן יותר

פרמטרים
`format`	`String` : נתמך PNG, JPEG

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט, או `null` אם צילום המסך לא הצליח.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

get Screenshot

public abstract InputStreamSource getScreenshot (long displayId)

תופס צילום מסך מהמכשיר שקיבל מזהה תצוגה. הפורמט הוא PNG.

TODO: הרחב את ההטמעות לעיל כדי לתמוך ב'פורמט' ו'שינוי קנה מידה'

פרמטרים
`displayId`	`long` : מזהה התצוגה של המסך שממנו ניתן לקבל צילום מסך.

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט, או `null` אם צילום המסך לא הצליח.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

get Screenshot

public abstract InputStreamSource getScreenshot ()

תופס צילום מסך מהמכשיר.

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט png, או `null` אם צילום המסך לא הצליח.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getSetting

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

החזר את הערך של ההגדרה המבוקשת. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}

פרמטרים
`userId`	`int`
`namespace`	`String`
`key`	`String`

החזרות
`String`	הערך המשויך ל-namespace:key של משתמש. ריק אם לא נמצא.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getSetting

public abstract String getSetting (String namespace, 
                String key)

ראה getSetting(int, String, String) ובוצע על משתמש מערכת.

פרמטרים
`namespace`	`String`
`key`	`String`

החזרות
`String`

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

החזרות
	`ERROR(/Set)` של שמות חבילות `String` שלא ניתנות להתקנה המותקנות כעת במכשיר.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getUserFlags

public abstract int getUserFlags (int userId)

מצא והחזר את הדגלים של משתמש נתון. דגלים מוגדרים בכיתה "android.content.pm.UserInfo" ב-Android Open Source Project.

פרמטרים
`userId`	`int`

החזרות
`int`	הדגלים המשויכים ל-userId שסופק אם נמצאו, -10000 בכל מקרה אחר.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getUserInfos

public abstract  getUserInfos ()

מקבל את מפת useId ל- UserInfo במכשיר. יזרוק DeviceRuntimeException אם הפלט מהמכשיר אינו כצפוי.

החזרות
	רשימת אובייקטי UserInfo.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

החזר את המספר הסידורי המשויך ל-userId אם נמצא, -10000 בכל מקרה אחר.

פרמטרים
`userId`	`int`

החזרות
`int`

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

יש תכונה

public abstract boolean hasFeature (String feature)

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

פרמטרים
`feature`	`String` : איזה פורמט צריך להיות "תכונה: "או" " באופן ישיר.

החזרות
`boolean`	נכון אם תכונה נמצאה, false אחרת.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

חבילת התקנה

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

חבילת התקנה

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`userId`	`int` : מזהה המשתמש השלם שיש להתקין עבורו.
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`userId`	`int` : מזהה המשתמש השלם שיש להתקין עבורו.
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

התקנת חבילות

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (חבילה ראשית וחבילה מפוצלת נוספת). ראה "https://developer.android.com/studio/build/configure-apk-splits" כיצד לפצל את ה-APK למספר קבצים.

פרמטרים
`packageFiles`	: קבצי ה-apk המקומיים
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

התקנת חבילות

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) שיושבים על מכשיר האנדרואיד. ראה "https://developer.android.com/studio/build/configure-apk-splits" כיצד לפצל apk למספר קבצים.

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

פרמטרים
`packageFiles`	: נתיבי קובץ ה-apk המרוחקים להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

התקן אפליקציית אנדרואיד המורכבת ממספר קבצי APK (אחת חבילה ראשית וחבילה מפוצלת נוספת) עבור משתמש נתון. ראה "https://developer.android.com/studio/build/configure-apk-splits" כיצד לפצל apk למספר קבצים.

פרמטרים
`packageFiles`	: קבצי ה-apk המקומיים
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`userId`	`int` : מזהה המשתמש השלם שיש להתקין עבורו.
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

פרמטרים
`packageFiles`	: קבצי ה-apk המקומיים
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`userId`	`int` : מזהה המשתמש השלם שיש להתקין עבורו.
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

התקן RemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

פרמטרים
`remoteApkPaths`	: נתיבי קובץ ה-apk המרוחקים
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

התקן RemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

פרמטרים
`remoteApkPaths`	: נתיבי קובץ ה-apk המרוחקים
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

קובע אם ריבוי משתמשים נתמך.

החזרות
`boolean`	true אם ריבוי משתמשים נתמך, false אחרת

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

פרמטרים
`packageName`	`String` : החבילה שאנו בודקים אם היא מותקנת.
`userId`	`String` : מזהה המשתמש שאנו בודקים עבורו מותקן החבילה. אם null, המשתמש הראשי אפס ישמש.

החזרות
`boolean`	נכון אם החבילה מדווחת כמותקנת. שקר אחרת.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

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

החזרות
`boolean`	נכון אם החבילה מדווחת כמותקנת. שקר אחרת.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isUserRunning

public abstract boolean isUserRunning (int userId)

בדוק אם משתמש נתון פועל.

פרמטרים
`userId`	`int`

החזרות
`boolean`	נכון אם המשתמש פועל, שקר בכל מקרים אחרים.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isUserSecondary

public abstract boolean isUserSecondary (int userId)

החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.

פרמטרים
`userId`	`int`

החזרות
`boolean`	נכון אם המשתמש הוא משני, false אחרת.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isUserVisible

public abstract boolean isUserVisible (int userId)

בודק אם המשתמש הנתון גלוי.

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

פרמטרים
`userId`	`int`

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

בודק אם המשתמש הנתון גלוי בתצוגה הנתונה.

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

פרמטרים
`userId`	`int`
`displayId`	`int`

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplay נתמך

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

מחזירה אם המכשיר מאפשר הפעלת משתמשים גלויים ברקע ב- ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

אם כן, תוכל לקרוא ל- startVisibleBackgroundUser(int, int, boolean) , ולהעביר תצוגה המוחזרת על ידי listDisplayIdsForStartingVisibleBackgroundUsers() (שאמורה לכלול ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

אם כן, תוכל לקרוא startVisibleBackgroundUser(int, int, boolean) , ולהעביר תצוגה המוחזרת על ידי listDisplayIdsForStartingVisibleBackgroundUsers() .

החזרות
`boolean`

זורק
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

בדוק אם wifi מופעל.

בודק אם wifi מופעל במכשיר. שימושי לקביעת סטטוס wifi לפני בדיקות שלא אמורות לפעול עם wifi, למשל בדיקות נתונים לנייד.

החזרות
`boolean`	`true` אם wifi מופעל. `false` אם מושבת

זורק
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

listDisplayIds

public abstract  listDisplayIds ()

אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".

החזרות
	רשימת התצוגות. ברירת המחדל תמיד מחזירה את תצוגת ברירת המחדל 0.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

מקבל את רשימת הצגים שניתן להשתמש בהם כדי start a user visible in the background .

החזרות

זורק
`DeviceNotAvailableException`

רשימת משתמשים

public abstract  listUsers ()

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

החזרות
	רשימת מזהי המשתמשים.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

שיטת עוזר לקחת דוח באג ולהתחבר לכתבים.

פרמטרים
`dataName`	`String` : שם תחתיו ידווח דיווח הבאג.
`listener`	`ITestLogger` : `ITestLogger` לרישום של דוח הבאג.

החזרות
`boolean`	נכון אם הרישום הצליח, לא נכון אחרת.

הודע לSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

הודע למכשיר להמתין להשלמת snapuserd.

פרמטרים
`waitPhase`	`SnapuserdWaitPhase`

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

רושם IDeviceActionReceiver עבור מכשיר זה.

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

פרמטרים
`deviceActionReceiver`	`IDeviceActionReceiver` : `IDeviceActionReceiver` שיירשם.

הסר אדמין

public abstract boolean removeAdmin (String componentName, 
                int userId)

הסר מנהל מכשיר נתון במשתמש נתון והחזר true אם זה מצליח, false אחרת.

פרמטרים
`componentName`	`String` : של מנהל המכשיר להסרה.
`userId`	`int` : של המשתמש שמנהל המכשיר גר בו.

החזרות
`boolean`	נכון אם זה מצליח, לא נכון אחרת.

זורק
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

בעלי הסר

public abstract void removeOwners ()

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

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

הסר

public abstract boolean removeUser (int userId)

הסר משתמש נתון מהמכשיר.

פרמטרים
`userId`	`int` : של המשתמש להסיר

החזרות
`boolean`	נכון אם היינו מצליחים להסיר את המשתמש, שקרית אחרת.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

SetDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

הגדר רכיב מנהל התקן כבעל מכשיר במשתמש נתון.

פרמטרים
`componentName`	`String` : של מנהל התקנים להיות בעל המכשיר.
`userId`	`int` : של המשתמש שבעל המכשיר חי בו.

החזרות
`boolean`	נכון אם זה מצליח, לא נכון אחרת.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

הגדרה

public abstract void setSetting (String namespace, 
                String key, 
                String value)

ראה setSetting(int, String, String, String) ובוצע על ידי משתמש המערכת.

פרמטרים
`namespace`	`String`
`key`	`String`
`value`	`String`

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

הגדרה

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

הוסף ערך הגדרה למרחב השמות של משתמש נתון. הגדרות מסוימות יהיו זמינות רק לאחר אתחול מחדש. מרחב השמות חייב להיות אחד מ: {"מערכת", "מאובטח", "גלובלי"}

פרמטרים
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

STARTUSER

public abstract boolean startUser (int userId)

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

פרמטרים
`userId`	`int` : של המשתמש להתחיל ברקע

החזרות
`boolean`	נכון אם המשתמש התחיל בהצלחה ברקע.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

STARTUSER

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

פרמטרים
`userId`	`int` : של המשתמש להתחיל ברקע
`waitFlag`	`boolean` : יגרום לפקודה להמתין עד שהמשתמש יתחיל ולא נעול.

החזרות
`boolean`	נכון אם המשתמש התחיל בהצלחה ברקע.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

StartVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

מתחיל משתמש נתון ברקע, גלוי בתצוגה הנתונה (כלומר, ומאפשר למשתמש להפעיל פעילויות בתצוגה זו).

הערה: פקודה זו אינה בודקת אם המשתמש קיים, תצוגה זמינה, device supports such feature וכו '.

פרמטרים
`userId`	`int` : של המשתמש להתחיל ברקע
`displayId`	`int` : תצוגה כדי להפעיל את המשתמש גלוי
`waitFlag`	`boolean` : יגרום לפקודה להמתין עד שהמשתמש יתחיל ולא נעול.

החזרות
`boolean`	`true` אם המשתמש התחיל בהצלחה ברקע.

זורק
`DeviceNotAvailableException`

עצר

public abstract boolean stopUser (int userId)

עוצר משתמש נתון. אם המשתמש כבר נעצר, שיטה זו היא NOOP. לא ניתן לעצור את המשתמש הנוכחי והמערכת.

פרמטרים
`userId`	`int` : של המשתמש להפסיק.

החזרות
`boolean`	נכון אם המשתמש הופסק בהצלחה.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

עצר

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

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

פרמטרים
`userId`	`int` : של המשתמש להפסיק.
`waitFlag`	`boolean` : יגרום לפקודה להמתין עד להפסקת המשתמש.
`forceFlag`	`boolean` : יכריח לעצור את המשתמש.

החזרות
`boolean`	נכון אם המשתמש הופסק בהצלחה.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

החלף משתמש

public abstract boolean switchUser (int userId)

עבור למשתמש אחר עם פסק זמן ברירת מחדל. switchUser(int, long) .

פרמטרים
`userId`	`int`

החזרות
`boolean`	נכון אם המשתמש החדש תואם את ספק ה- UserID. לא נכון אחרת.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

החלף משתמש

public abstract boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
`userId`	`int`
`timeout`	`long` : לחכות לפני שהחזר שקר למשתמש המתג נכשל.

החזרות
`boolean`	נכון אם המשתמש החדש תואם את ספק ה- UserID. לא נכון אחרת.

זורק
	com.android.tradefed.device.devicenotavailableException
`DeviceNotAvailableException`

TakeBugReport

public abstract Bugreport takeBugreport ()

קח דו"ח BugrePort ומחזיר אותו בתוך אובייקט Bugreport כדי לטפל בו. להחזיר NULL במקרה של הנושא. יש לנקות את הקובץ המוזכר באובייקט BugrePort באמצעות Bugreport.close() .

החזרות
`Bugreport`

הסר את ההתקלה

public abstract String uninstallPackage (String packageName)

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

פרמטרים
`packageName`	`String` : חבילת אנדרואיד להסרת ההתקנה

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

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

הסר את ההתקפה

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

פרמטרים
`packageName`	`String` : חבילת אנדרואיד להסרת ההתקנה
`userId`	`int` : מזהה המשתמש שלם שלם להסרת ההתקנה.

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

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

waitforsnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

אם צפוי, המתן לסיום Snapuserd.

פרמטרים
`currentPhase`	`SnapuserdWaitPhase`

זורק
`DeviceNotAvailableException`