ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

---

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

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

סיכום

כיתות בתצוגת עץ
class	ITestDevice.ApexInfo סוג פשוט של מבנה (struct) לאחסון מידע על 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() הפונקציה מחזירה את הערך '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() הפונקציה מחזירה את הערך ERROR(/java.android.view.Display#DEFAULT_DISPLAY) שמציין אם המכשיר מאפשר למשתמשים להופיע ברקע כשהם מופעלים.
abstract boolean	isVisibleBackgroundUsersSupported() הפונקציה מחזירה את הערך 'true' אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע.
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.

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

החזרות
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: האם לסרוק אחר SSIDs מוסתרים של הרשת הזו.

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

enableNetworkMonitor

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

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

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 (חבילת ראשית אחת וחבילות מפוצלות נוספות) למשתמש נתון. במאמר 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 ()

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

החזרות
boolean

זריקות
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

החזרות
boolean

זריקות
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

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

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

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
userId	int
timeout	long: כדי להמתין לפני החזרת הערך false במקרה של כשל במעבר משתמש.

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