ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

סיכום

מחלקות מקוננות

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

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

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

abstract boolean canSwitchToHeadlessSystemUser()

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

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)

ניסיון לדמפ את האוסף (heap) מ-system_server.

abstract boolean enableNetworkMonitor()

הפעלת ניטור רשת במכשיר.

abstract getActiveApexes()

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

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

חיפוש והחזרת הערך של android-id שמשויך למשתמש, ערך 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()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

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

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)

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

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

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

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

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

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

abstract boolean isUserRunning(int userId)

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

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

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

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

בודקים אם ה-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)

צריך לעבור ל-User-ID אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.

abstract boolean switchUser(int userId, long timeout)

עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד.

abstract Bugreport takeBugreport()

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

abstract String uninstallPackage(String packageName)

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

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

אם צפוי, צריך להמתין עד ש-Snapuserd יושלם.

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

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

ConnectToWi-FiNetwork

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

ConnectToWi-FiNetwork

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.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

החזרות
boolean true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false אחרת

זריקות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

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

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

זריקות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
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.DeviceNotAvailableExt [המכשיר לא זמין]
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

השבתת NetworkMonitor

public abstract boolean disableNetworkMonitor ()

השבתת מעקב הרשת במכשיר.

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

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

התנתקות מ-Wi-Fi

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 אם הקובץ קיים, false אחרת.

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

ניסיון לדמפ את האוסף (heap) מ-system_server. זהו באחריות מבצע הקריאה לנקות את הקובץ שהועתק.

פרמטרים
process String: השם של תהליך המכשיר שבו רוצים ליצור dumpheap.

devicePath String: הנתיב במכשיר שבו רוצים להציב את האימג'. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת.

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

זריקות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

הפעלת NetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

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

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

getActiveApexes

public abstract  getActiveApexes ()

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

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

יצירת מפה של מזהי 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 ()

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

נתמכת רק ב-'adb version' > 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.DeviceNotAvailableExt [המכשיר לא זמין]
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 שמכיל קובץ snapshot של מצב מסך הנעילה, ומחזיר Null אם השאילתה של מסך הנעילה לא נתמכת.

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

getMainUserId

public abstract Integer getMainUserId ()

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

החזרות
Integer מזהה המשתמש של המשתמש הראשי, אם יש כזה, ו-null אם אין משתמש ראשי.

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

זריקות
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 מזהה המשתמש של המשתמש הראשי, אם יש כזה, ו-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: להרחיב את ההטמעות שלמעלה כך שתהיה תמיכה ב-'format' וב-'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 הערך שמשויך למפתח namespace:של משתמש. הערך 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.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

חיפוש הדגלים של משתמש נתון והחזרתם. הדגלים מוגדרים בכיתה android.content.pm.UserInfo בפרויקט הקוד הפתוח של Android.

פרמטרים
userId int

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

זריקות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

החזרות
את הרשימה של UserInfo.

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

getUserSerialNumber

public abstract int getUserSerialNumber (int 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

חבילת התקנה

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

חבילת התקנה

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

חבילות התקנה

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 (חבילת ראשית אחת וחבילות מפוצלות נוספות) למשתמש נתון. במאמר https://developer.android.com/studio/build/configure-apk-splits מוסבר איך לפצל קובץ APK למספר קבצים.

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

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

userId int: מספר המשתמש השלם שרוצים להתקין.

extraArgs String: ארגומנטים נוספים אופציונליים להעברה. אפשרויות זמינות מפורטות ב-'adb shell pm -h'.

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

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

InstallPackagesForUser

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

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

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

פרמטרים
packageName String

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

זריקות
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 ()

הפונקציה מחזירה את הערך 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 ()

בודקים אם ה-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.DeviceRuntimeError
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

רישוםDeviceActionReceiver

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

הגדרה

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.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

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

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

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

waitFlag boolean: הפקודה תמתין עד שהמשתמש יופעל ויינעל.

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

קליעות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startמוצגBackgroundUser

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)

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

פרמטרים
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 אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, שקרית.

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
userId int

timeout long: להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה.

החזרות
boolean הערך True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, שקרית.

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