ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

סיכום

כיתות במבנה היררכי

class ITestDevice.ApexInfo

מחלקה פשוטה של struct לאחסון מידע על APEX יחיד 

class ITestDevice.MountPointInfo

מחלקה פשוטה של struct לאחסון מידע על נקודת טעינה יחידה 

‫methods ציבוריים

abstract boolean canSwitchToHeadlessSystemUser()

הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש המערכת ללא ממשק גרפי, אחרת היא מחזירה את הערך False.

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

מנקה את רשת ה-Wi-Fi האחרונה שהייתה מחוברת.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

מתחבר לרשת Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

מתחבר לרשת Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

מתחבר לרשת Wi-Fi.

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

מתחבר לרשת Wi-Fi.

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

התנתקות מרשת Wi-Fi.

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

לנסות ליצור dump של ה-heap מ-system_server.

abstract boolean enableNetworkMonitor()

הגדרה שמאפשרת מעקב אחרי הרשת במכשיר.

abstract getActiveApexes()

שליפת המידע על חבילות APEX שהופעלו במכשיר.

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

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

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

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

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

מאחזר bugreportz מהמכשיר.

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

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

abstract getFoldableStates()

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

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

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

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

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

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

קבלת המספר המקסימלי של משתמשים שנתמכים בהפעלה בו-זמנית.

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

השיטה הזו הוצאה משימוש. הפונקציה getPrimaryUser הוצאה משימוש בשירות UserManager. צריך להשתמש בפונקציה ERROR(/android.os.UserManager#getMainUserId()) כדי לקבל את המשתמש המלא הראשון או 0 למערכת. הערה: במערכת ללא ראש, המשתמש לא מלא.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot(String format)

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

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)

התקנה של חבילת Android במכשיר.

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

התקנה של חבילת Android במכשיר.

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

התקנה של חבילת Android במכשיר עבור משתמש מסוים.

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

התקנה של חבילת Android במכשיר עבור משתמש מסוים.

abstract boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

התקנת קובצי APK במצב מצטבר.

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

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

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

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות מפוצלות נוספות) שנמצאים במכשיר Android.

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

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

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

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

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

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות) שנמצאים במכשיר Android.

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

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות מפוצלות נוספות) שנמצאים במכשיר Android.

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

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

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

בודקים אם ה-Wi-Fi מופעל.

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)

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

abstract boolean switchUser(int userId, long timeout)

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

abstract Bugreport takeBugreport()

יוצר דוח באגים ומחזיר אותו בתוך אובייקט Bugreport כדי לטפל בו.

abstract String uninstallPackage(String packageName)

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

abstract String uninstallPackageForUser(String packageName, int userId)

הסרת חבילת Android מהמכשיר עבור משתמש מסוים.

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

אם זה צפוי, מחכים עד ש-snapuserd יסיים את הפעולה.

‫methods ציבוריים

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש המערכת ללא ממשק גרפי, אחרת היא מחזירה את הערך False.

החזרות
boolean

זריקות
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

החזרות
boolean ‫true אם למכשיר יש חיבור פעיל לרשת, ‫ false אחרת.
זריקות
DeviceNotAvailableException אם החיבור למכשיר יאבד ולא ניתן יהיה לשחזר אותו.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

החזרות
boolean ‫true אם לא היו תיבות דו-שיח או אם הן נוקו בהצלחה. false אחרת.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

מתחבר לרשת Wi-Fi.

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

פרמטרים
wifiSsidToPsk ‫: מיפוי של מזהי SSID של רשתות Wi-Fi לסיסמאות.
החזרות
boolean ‫true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

מתחבר לרשת Wi-Fi.

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

פרמטרים
wifiSsidToPsk ‫: מיפוי של מזהי SSID של רשתות Wi-Fi לסיסמאות.
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו.
החזרות
boolean ‫true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

מתחבר לרשת Wi-Fi.

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

פרמטרים
wifiSsid ‫String: ה-SSID של ה-Wi-Fi שאליו רוצים להתחבר
wifiPsk ‫String: ביטוי הגישה של PSK או null אם לא מוצפן
החזרות
boolean ‫true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetwork

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

מתחבר לרשת Wi-Fi.

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

פרמטרים
wifiSsid ‫String: ה-SSID של ה-Wi-Fi שאליו רוצים להתחבר
wifiPsk ‫String: ביטוי הגישה של PSK או null אם לא מוצפן
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו.
החזרות
boolean ‫true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetworkIfNeeded

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

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

פרמטרים
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו
החזרות
boolean ‫true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

החזרות
boolean ‫true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

פרמטרים
name ‫String: של המשתמש שרוצים ליצור במכשיר
החזרות
int המספר השלם של מזהה המשתמש שנוצר
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

פרמטרים
name ‫String: של המשתמש שרוצים ליצור במכשיר
guest ‫boolean: הפעלת דגל המשתמש --guest במהלך היצירה
ephemeral ‫boolean: הפעלת דגל המשתמש ‎--ephemeral במהלך היצירה
החזרות
int המזהה של המשתמש שנוצר
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

פרמטרים
name ‫String: של המשתמש שרוצים ליצור במכשיר
guest ‫boolean: הפעלת דגל המשתמש --guest במהלך היצירה
ephemeral ‫boolean: הפעלת דגל המשתמש ‎--ephemeral במהלך היצירה
forTesting ‫boolean: הפעלת דגל הבדיקה ‎--for-testing במהלך היצירה
החזרות
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

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

השבתה של מעקב אחרי הרשת במכשיר.

החזרות
boolean ‫true אם ההשבתה של המעקב הצליחה. false אם היא נכשלה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר יאבד ולא ניתן יהיה לשחזר אותו.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

התנתקות מרשת Wi-Fi.

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

החזרות
boolean ‫true אם ההתנתקות מרשת ה-Wi-Fi הצליחה. false אם הניתוק נכשל.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

פרמטרים
deviceFilePath ‫String: הנתיב המוחלט של הקובץ במכשיר לבדיקה
userId int: מזהה המשתמש שביחס אליו צריך לבדוק אם הקובץ קיים
החזרות
boolean ‫true if file exists, false otherwise.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

פרמטרים
process ‫String: השם של תהליך המכשיר שרוצים להשתמש בו בפקודה dumpheap.
devicePath ‫String: הנתיב במכשיר שבו רוצים לשמור את הנתונים. זה חייב להיות מיקום שההרשאות מאפשרות זאת.
החזרות
File השדה ERROR(/File) שמכיל את הדוח. ‫Null אם משהו נכשל.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

הגדרה שמאפשרת מעקב אחרי הרשת במכשיר.

החזרות
boolean ‫true אם המעקב מופעל בהצלחה. false אם היא נכשלה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר יאבד ולא ניתן יהיה לשחזר אותו.

getActiveApexes

public abstract  getActiveApexes ()

שליפת המידע על חבילות APEX שהופעלו במכשיר.

החזרות
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 שמשויך ל-userId, או null אם לא נמצא מזהה.

פרמטרים
userId int

החזרות
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

החזרות
מפה של מזהי Android שתואמים למזהי משתמשים.
זריקות
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 ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

התמיכה קיימת רק בגרסה של adb שגדולה מ-1.0.36

החזרות
InputStreamSource ‫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 אם שאילתת מסך הנעילה לא נתמכת.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getMainUserId

public abstract Integer getMainUserId ()

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

החזרות
Integer מזהה המשתמש של המשתמש הראשי אם יש כזה, ו-null אם אין משתמש ראשי.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException אם הפלט מהמכשיר לא תואם לציפיות.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

השיטה הזו הוצאה משימוש.
הפונקציה getPrimaryUser הוצאה משימוש בשירות UserManager. צריך להשתמש בפונקציה ERROR(/android.os.UserManager#getMainUserId()) כדי לקבל את המשתמש המלא הראשון או 0 למערכת. שימו לב: במערכת ללא ראש, המשתמש לא מלא.

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

החזרות
Integer מזהה המשתמש של המשתמש הראשי, אם יש כזה, או null אם אין משתמש ראשי.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException אם הפלט מהמכשיר לא תואם לציפיות.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

פרמטרים
format ‫String: PNG, ‏ JPEG נתמכים
rescale ‫boolean: אם צריך לשנות את קנה המידה של צילום המסך כדי להקטין את הגודל של התמונה שמתקבלת
החזרות
InputStreamSource InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך לא הצליח.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

פרמטרים
displayId ‫long: מזהה התצוגה של המסך שממנו רוצים לצלם צילום מסך.
החזרות
InputStreamSource InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך לא הצליח.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

פרמטרים
format ‫String: PNG, ‏ JPEG נתמכים
החזרות
InputStreamSource InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך לא הצליח.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

החזרות
InputStreamSource 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 הערך שמשויך למרחב השמות:מפתח של משתמש. אם לא נמצא, הערך הוא 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

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.

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

hasFeature

public abstract boolean hasFeature (String feature)

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

פרמטרים
feature ‫String: הפורמט צריך להיות feature: או ישירות.
החזרות
boolean הערך True אם התכונה נמצאה, אחרת הערך הוא False.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

התקנה של חבילת Android במכשיר.

פרמטרים
packageFile ‫File: קובץ ה-APK להתקנה
reinstall boolean: true אם צריך לבצע התקנה מחדש
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm -h.
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

installPackage

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

התקנה של חבילת Android במכשיר.

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

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

התקנה של חבילת Android במכשיר עבור משתמש מסוים.

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

התקנה של חבילת Android במכשיר עבור משתמש מסוים.

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

פרמטרים
packageFile ‫File: קובץ ה-APK להתקנה
reinstall boolean: true אם צריך לבצע התקנה מחדש
grantPermissions ‫boolean: אם כל ההרשאות בזמן ריצה צריכות להינתן בזמן ההתקנה
userId ‫int: מזהה המשתמש (מספר שלם) להתקנה.
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm -h.
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
UnsupportedOperationException אם הפלטפורמה לא תומכת בהרשאה בתחילת ההפעלה במכשיר.

installPackageWithIncrementalMode

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

התקנת קובצי APK במצב מצטבר.

פרמטרים
apkFiles ‫File: קובצי ה-APK להתקנה.
extraArgs String

userId String

החזרות
boolean

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

installPackages

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

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

installPackages

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

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות) שנמצאים במכשיר Android. במאמר 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)

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

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

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

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

פרמטרים
packageFiles ‫: קובצי ה-APK המקומיים
reinstall boolean: true אם צריך לבצע התקנה מחדש
grantPermissions ‫boolean: אם כל ההרשאות בזמן ריצה צריכות להינתן בזמן ההתקנה
userId ‫int: מזהה המשתמש (מספר שלם) להתקנה.
extraArgs ‫String: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm -h.
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
UnsupportedOperationException אם הפלטפורמה לא תומכת בהרשאה בתחילת ההפעלה במכשיר.

installRemotePackages

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

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות) שנמצאים במכשיר Android. במאמר 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 אם הפלטפורמה לא תומכת בהרשאה בתחילת ההפעלה במכשיר.

installRemotePackages

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

התקנה של אפליקציית Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות) שנמצאים במכשיר Android. במאמר 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 ()

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

החזרות
boolean

זריקות
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

החזרות
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 הערך הוא True אם החבילה מדווחת כחבילה מותקנת. אחרת, הפלט הוא False.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

פרמטרים
packageName String

החזרות
boolean הערך הוא True אם החבילה מדווחת כחבילה מותקנת. אחרת, הפלט הוא False.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

פרמטרים
userId int

החזרות
boolean הערך הוא True אם המשתמש רץ, ו-False בכל מקרה אחר.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

פרמטרים
userId int

החזרות
boolean הערך הוא true אם המשתמש הוא משני, ו-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

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

החזרות
boolean

זריקות
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
boolean

זריקות
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

בודקים אם ה-Wi-Fi מופעל.

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

החזרות
boolean ‫true אם ה-Wi-Fi מופעל. 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

listUsers

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 ‫True אם הרישום ביומן הצליח, אחרת False.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

פרמטרים
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

פרמטרים
componentName ‫String: של מנהל המכשיר שרוצים להסיר.
userId ‫int: של המשתמש שבו נמצא האדמין של המכשיר.
החזרות
boolean ‫True אם הפעולה הצליחה, אחרת False.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

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

removeUser

public abstract boolean removeUser (int userId)

הסרת משתמש מסוים מהמכשיר.

פרמטרים
userId ‫int: של המשתמש שרוצים להסיר
החזרות
boolean ‫true אם הצלחנו להסיר את המשתמש, אחרת false.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

פרמטרים
componentName ‫String: של אדמין המכשיר להיות הבעלים של המכשיר.
userId ‫int: של המשתמש שבעל המכשיר שייך אליו.
החזרות
boolean ‫True אם הפעולה הצליחה, אחרת False.
זריקות
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 ‫true אם המשתמש הופעל בהצלחה ברקע.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

פרמטרים
userId ‫int: של המשתמש כדי להתחיל ברקע
waitFlag ‫boolean: הפקודה תמתין עד שהמשתמש יופעל ויבטל את הנעילה.
החזרות
boolean ‫true אם המשתמש הופעל בהצלחה ברקע.
זריקות
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: display to start user visible on
waitFlag ‫boolean: הפקודה תמתין עד שהמשתמש יופעל וייפתח.
החזרות
boolean ‫true אם המשתמש התחיל בהצלחה את הצפייה ברקע.
זריקות
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

פרמטרים
userId ‫int: של המשתמש שרוצים לעצור.
החזרות
boolean ‫true אם המשתמש הופסק בהצלחה.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

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

פרמטרים
userId ‫int: של המשתמש שרוצים לעצור.
waitFlag ‫boolean: הפקודה תמתין עד שהמשתמש יופסק.
forceFlag ‫boolean: יגרום לסגירה בכוח של המשתמש.
החזרות
boolean ‫true אם המשתמש הופסק בהצלחה.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

פרמטרים
userId int

החזרות
boolean הערך הוא True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, הפלט הוא False.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
userId int

timeout ‫long: להמתנה לפני החזרת הערך false אם הפעולה switch-user נכשלה.
החזרות
boolean הערך הוא True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, הפלט הוא False.
זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

החזרות
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

פרמטרים
packageName ‫String: חבילת Android להסרה
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

הסרת חבילת Android מהמכשיר עבור משתמש מסוים.

פרמטרים
packageName ‫String: חבילת Android להסרה
userId ‫int: מזהה המשתמש כמספר שלם שרוצים להסיר את ההתקנה שלו.
החזרות
String ‫String עם קוד שגיאה, או null אם הפעולה הצליחה.
זריקות
DeviceNotAvailableException אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

אם זה צפוי, מחכים עד ש-snapuserd יסיים את הפעולה.

פרמטרים
currentPhase SnapuserdWaitPhase

זריקות
DeviceNotAvailableException