ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.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, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

מתחבר לרשת wifi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

מתחבר לרשת 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, boolean forTesting)

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

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

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

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

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

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

החזר את הערך של ההגדרה המבוקשת.

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, boolean grantPermissions, int userId, String... extraArgs)

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

abstract String installPackageForUser (File packageFile, boolean reinstall, 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, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

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

default String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, 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)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

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)

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

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, boolean waitFlag, boolean forceFlag)

עצור משתמש נתון.

abstract boolean stopUser (int userId)

עוצר משתמש נתון.

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)

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

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

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, 
                boolean scanSsid)

מתחבר לרשת wifi.

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

פרמטרים
wifiSsidToPsk : מפה של Wi-Fi SSIDs לסיסמאות.

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

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

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

מתחבר לרשת wifi.

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

פרמטרים
wifiSsidToPsk : מפה של Wi-Fi 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.

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

פרמטרים
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, 
                boolean forTesting)

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

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

guest boolean : אפשר את דגל המשתמש --guest במהלך היצירה

ephemeral boolean : אפשר את דגל המשתמש - ארעית במהלך היצירה

forTesting boolean : אפשר את דגל הבדיקה --לבדיקה במהלך היצירה

החזרות
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

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

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

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

זורק
com.android.tradefed.device.DeviceNotAvailableException
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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

פרמטרים
namespace String

key String

החזרות
String

זורק
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

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, 
                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 אם הרשאת זמן ריצה אינה נתמכת על ידי הפלטפורמה במכשיר.

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 אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

התקנת חבילות

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, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

פרמטרים
packageFiles : קבצי ה-apk המקומיים

reinstall boolean : true אם יש לבצע התקנה מחדש

grantPermissions boolean : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה

userId int : מזהה המשתמש השלם שיש להתקין עבורו.

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

התקן RemotePackages

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

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

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

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

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

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

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

פרמטרים
packageName String

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

זורק
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

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 נכון אם הרישום הצליח, לא נכון אחרת.

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 נכון אם הצלחנו להסיר את המשתמש, false אחרת.

זורק
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

setSetting

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

setSetting

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

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

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

stopUser

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

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

פרמטרים
userId int : של המשתמש לעצור.

waitFlag boolean : יגרום לפקודה להמתין עד שהמשתמש יופסק.

forceFlag boolean : יאלץ לעצור את המשתמש.

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

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

stopUser

public abstract boolean stopUser (int userId)

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

פרמטרים
userId int : של המשתמש לעצור.

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

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

החלף משתמש

public abstract boolean switchUser (int userId)

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

פרמטרים
userId int

החזרות
boolean True אם ה-userId החדש תואם לספק ה-userId. שקר אחרת.

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

החלף משתמש

public abstract boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
userId int

timeout long : להמתין לפני החזרת false עבור מתג-משתמש נכשלה.

החזרות
boolean True אם ה-userId החדש תואם לספק ה-userId. שקר אחרת.

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

קח דיווח על שגיאות

public abstract Bugreport takeBugreport ()

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

החזרות
Bugreport

הסר את חבילת ההתקנה

public abstract String uninstallPackage (String packageName)

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

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

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

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

הסר את ההתקנה שלPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

userId int : מזהה המשתמש השלם שיש להסיר עבורו.

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

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