ITestDevice
public
interface
ITestDevice
implements
INativeDevice
com.android.tradefed.device.ITestDevice
|
ממשק API מהימן ברמה מעט גבוהה יותר ל-ddmlib IDevice
.
השירות מנסה שוב לבצע פקודות במכשיר מספר פעמים, בהתאם להגדרה, ומספק ממשק לשחזור המכשיר למכשירים שלא מגיבים.
סיכום
שיטות ציבוריות |
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.
checkConnectivity
public abstract boolean checkConnectivity ()
חשוב לבדוק שלמכשיר יש קישוריות לרשת.
החזרות |
boolean |
true אם למכשיר יש חיבור פעיל לרשת,
false מעליו. |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
מנסים לסגור את כל תיבות הדו-שיח של השגיאות שמוצגות כרגע בממשק המשתמש של המכשיר.
החזרות |
boolean |
true אם לא היו תיבת דו-שיח או שהתיבת דו-שיח נמחקה בהצלחה.
false אחרת. |
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
אחרת |
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
אחרת |
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
אחרת |
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
אחרת |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
וריאנט של connectToWifiNetwork(String, String)
שמתחבר רק אם אין כרגע חיבור לרשת במכשיר.
פרמטרים |
scanSsid |
boolean : האם לסרוק אחר SSID מוסתר של הרשת הזו |
החזרות |
boolean |
true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false
אחרת |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
וריאנט של connectToWifiNetwork(String, String)
שמתחבר רק אם אין כרגע חיבור לרשת במכשיר.
החזרות |
boolean |
true אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. false
אחרת |
createUser
public abstract int createUser (String name)
יצירת משתמש עם שם נתון ודגלים שמוגדרים כברירת מחדל כ-0.
פרמטרים |
name |
String : של המשתמש שייווצר במכשיר |
החזרות |
int |
המספר השלם של מזהה המשתמש שנוצר |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
יצירת משתמש עם שם נתון והדגלים שסופקו
פרמטרים |
name |
String : של המשתמש שצריך ליצור במכשיר |
guest |
boolean : הפעלת הדגל של המשתמש --guest במהלך היצירה |
ephemeral |
boolean : הפעלת הדגל של המשתמש --ephemeral במהלך היצירה |
החזרות |
int |
המזהה של המשתמש שנוצר |
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 |
המזהה של המשתמש שנוצר |
createUserNoThrow
public abstract int createUserNoThrow (String name)
יצירת משתמש עם שם נתון ודגלים שמוגדרים כברירת מחדל כ-0.
פרמטרים |
name |
String : של המשתמש שייווצר במכשיר |
החזרות |
int |
המספר השלם של מזהה המשתמש שנוצר או -1 במקרה של שגיאה. |
disableKeyguard
public abstract void disableKeyguard ()
ניסיונות להשבית את מסך הנעילה.
קודם צריך להמתין עד שהקצאת הקלט תהיה מוכנה. זה קורה בערך באותו זמן שבו המכשיר מדווח על BOOT_COMPLETE, באופן אסינכרוני לכאורה, כי להטמעת המסגרת הנוכחית יש מדי פעם תנאי מרוץ. לאחר מכן נשלחת פקודה לסגירת מסך הנעילה (היא פועלת רק במכשירים לא מאובטחים).
השבתת NetworkMonitor
public abstract boolean disableNetworkMonitor ()
השבתת מעקב הרשת במכשיר.
החזרות |
boolean |
true אם המעקב הושבת בהצלחה. false
אם הוא נכשל. |
התנתקות מ-Wi-Fi
public abstract boolean disconnectFromWifi ()
ניתוק מרשת Wi-Fi.
הפעולה הזו מסירה את כל הרשתות מרשימת הרשתות המוכרות ומשביתה את ה-Wi-Fi.
החזרות |
boolean |
true אם התנתקתם מרשת ה-Wi-Fi. false
אם הניתוק נכשל. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
שיטה מסייעת לקביעת אם קובץ קיים במכשיר של משתמש נתון.
פרמטרים |
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר שרוצים לבדוק |
userId |
int : מזהה המשתמש שבו בודקים את קיומו של הקובץ |
החזרות |
boolean |
true אם הקובץ קיים, false אחרת. |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
ניסיון לדמפ את האוסף (heap) מ-system_server. זהו באחריות מבצע הקריאה לנקות את הקובץ שהועתק.
פרמטרים |
process |
String : השם של תהליך המכשיר שבו רוצים ליצור dumpheap. |
devicePath |
String : הנתיב במכשיר שבו רוצים להציב את האימג'. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת. |
הפעלת NetworkMonitor
public abstract boolean enableNetworkMonitor ()
הפעלת מעקב אחר הרשת במכשיר.
החזרות |
boolean |
true אם המעקב הופעל בהצלחה. false
אם הוא נכשל. |
getActiveApexes
public abstract getActiveApexes ()
אחזור המידע על ה-APEXes שהופעלו במכשיר.
getAllSettings
public abstract getAllSettings (String namespace)
הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
פרמטרים |
namespace |
String : חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"} |
החזרות |
|
המפה של צמדי המפתחות/הערכים. המערכת תציג ערך של null אם אין תמיכה במרחב השמות. |
getAndroidId
public abstract String getAndroidId (int userId)
חיפוש והחזרת android-id המשויך ל-userId, null אם לא נמצא.
getAndroidIds
public abstract getAndroidIds ()
יצירת מפה של מזהי Android שתאמו למזהי משתמשים. אין ערובה שלכל מזהה משתמש יהיה מזהה Android שמשויך לפונקציה הזו, ולכן חלק ממזהי המשתמשים עשויים להתאים ל-null.
החזרות |
|
מפה של מזהי Android שמצאו מזהי משתמשים תואמים. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
אחזור מידע על חבילה שמותקנת במכשיר.
פרמטרים |
packageName |
String |
getAppPackageInfos
public abstract getAppPackageInfos ()
אחזור מידע על חבילות שמותקנות במכשיר.
דוח getBugreport
public abstract InputStreamSource getBugreport ()
אחזור דוח באג מהמכשיר.
מובטח שההטמעה תמשיך לפעול במכשיר ללא כרטיס SD
(או אם כרטיס ה-SD עדיין לא מותקן).
getBugreportz
public abstract InputStreamSource getBugreportz ()
אחזור דוח על באג מהמכשיר. דוח איתור הבאגים בפורמט ZIP מכיל את דוח הבאג הראשי וקובצי יומן נוספים שיכולים להועיל לניפוי באגים.
נתמכת רק ב-'adb version' > 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
הפונקציה מחזירה את המצב הנוכחי של המכשיר כמכשיר מתקפל, או null אם אירעו בעיות.
getCurrentUser
public abstract int getCurrentUser ()
החזרת המזהה של המשתמש הנוכחי שפועל. במקרה של שגיאה, הפונקציה מחזירה את הערך -10000.
getFoldableStates
public abstract getFoldableStates ()
הפונקציה מחזירה את רשימת המצבים המתקפלים במכשיר. אפשר לקבל אותן באמצעות הפונקציה 'cmd device_state Print-states'.
getInstalledPackageNames
public abstract getInstalledPackageNames ()
אחזור שמות החבילות של האפליקציות שנמצאות במכשיר.
getIpAddress
public abstract String getIpAddress ()
אחזור כתובת ה-IP של המכשיר.
החזרות |
String |
כתובת ה-IP של המכשיר, או null אם למכשיר אין כתובת IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
הפונקציה מחזירה אובייקט כדי לקבל את המצב הנוכחי של מסך הנעילה, או ערך null אם הוא לא נתמך.
getMainUserId
public abstract Integer getMainUserId ()
הפונקציה מחזירה את מזהה המשתמש הראשי.
החזרות |
Integer |
מזהה המשתמש של המשתמש הראשי, אם יש כזה, ו-null אם אין משתמש ראשי. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
הצגת המידע על המודולים הראשיים שמותקנים במכשיר.
public abstract int getMaxNumberOfRunningUsersSupported ()
קבלת המספר המקסימלי של משתמשים פעילים נתמכים בו-זמנית. ערך ברירת המחדל הוא 0.
החזרות |
int |
מספר שלם שמציין את מספר המשתמשים שפועלים בו-זמנית |
public abstract int getMaxNumberOfUsersSupported ()
לקבל את מספר המשתמשים המרבי שנתמך. ברירת המחדל היא 0.
החזרות |
int |
מספר שלם שמציין את מספר המשתמשים הנתמכים |
getOptions
public abstract TestDeviceOptions getOptions ()
אחזור של אפשרויות הבדיקה למכשיר.
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
מחזירה את מזהה המשתמש הראשי.
החזרות |
Integer |
מזהה המשתמש של המשתמש הראשי, אם יש כזה, ו-null אם אין משתמש ראשי. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
צילום מסך מהמכשיר. מומלץ להשתמש ב-getScreenshot(String)
במקום זאת עם קידוד JPEG לגודל קטן יותר.
פרמטרים |
format |
String : קובץ PNG נתמך, JPEG |
rescale |
boolean : אם צריך לשנות את הגודל של צילום המסך כדי לצמצם את גודל התמונה שנוצרת |
getScreenshot
public abstract InputStreamSource getScreenshot (long displayId)
צילום מסך מהמכשיר לפי מזהה התצוגה. הפורמט הוא PNG.
TODO: להרחיב את ההטמעות שלמעלה כך שתהיה תמיכה ב-'format' וב-'rescale'
פרמטרים |
displayId |
long : מזהה התצוגה של המסך שממנו רוצים לקבל צילום מסך. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format)
מצלם צילום מסך מהמכשיר.
מומלץ להשתמש במקום זאת ב-getScreenshot(format) עם קידוד JPEG לגודל קטן יותר
פרמטרים |
format |
String : פורמטים נתמכים: PNG, JPEG |
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
החזרת הערך של ההגדרה המבוקשת.
מרחב השמות חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
פרמטרים |
userId |
int |
namespace |
String |
key |
String |
החזרות |
String |
הערך שמשויך למפתח namespace:של משתמש. הערך Null אם לא נמצא. |
getSetting
public abstract String getSetting (String namespace,
String key)
ראו getSetting(int, String, String)
והפעולה מתבצעת על משתמש המערכת.
פרמטרים |
namespace |
String |
key |
String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
אחזור שמות חבילות האפליקציות שאפשר להסיר. החבילה הזו מוגדרת כרגע כחבילות שאינן של המערכת, וחבילות מערכת מעודכנות.
getUserFlags
public abstract int getUserFlags (int userId)
חיפוש הדגלים של משתמש נתון והחזרתם.
הדגלים מוגדרים בכיתה android.content.pm.UserInfo בפרויקט הקוד הפתוח של Android.
החזרות |
int |
הדגלים המשויכים למזהה המשתמש שצוין, אם הוא נמצא, או -10000 בכל מקרה אחר. |
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 בכל מקרה אחר.
hasFeature
public abstract boolean hasFeature (String feature)
איך בודקים אם תכונה מסוימת זמינה במכשיר.
פרמטרים |
feature |
String : הפורמט צריך להיות 'feature:' או '' ישירות. |
החזרות |
boolean |
True אם התכונה נמצאת, אחרת False. |
חבילת התקנה
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 אם הפעולה הושלמה. |
חבילת התקנה
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 אם הפעולה הושלמה. |
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.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
הפונקציה מחזירה את הערך 'true' אם המשתמש הראשי הוא אדמין קבוע, ולא ניתן למחוק אותו או לשדרג לאחור את הסטטוס שלו לסטטוס 'לא אדמין'.
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
קובע אם יש תמיכה בכמה משתמשים.
החזרות |
boolean |
true אם יש תמיכה בכמה משתמשים, false אחרת |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
שולחים שאילתה למכשיר לגבי שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם החבילה מותקנת כרגע אצל המשתמש הזה.
פרמטרים |
packageName |
String : החבילה שאנחנו בודקים אם היא מותקנת. |
userId |
String : מזהה המשתמש שאנחנו בודקים שהחבילה מותקנת עבורו. אם הערך הוא null, המערכת תשתמש
באפס. |
החזרות |
boolean |
הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
שולחים שאילתה למכשיר לגבי שם חבילה נתון כדי לבדוק אם היא מותקנת כרגע או לא.
פרמטרים |
packageName |
String |
החזרות |
boolean |
הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית. |
isUserRunning
public abstract boolean isUserRunning (int userId)
בודקים אם משתמש מסוים פועל.
החזרות |
boolean |
הערך הוא True אם המשתמש פועל, בכל מקרה אחר הערך False. |
isUsersecondary
public abstract boolean isUserSecondary (int userId)
מחזירה אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
החזרות |
boolean |
true אם המשתמש משני, false אחרת. |
isUserVisible
public abstract boolean isUserVisible (int userId)
בדיקה אם המשתמש הנתון גלוי.
משתמש 'גלוי' הוא משתמש שמקיים אינטראקציה עם המשתמש 'האנושי', ולכן הוא יכול להפעיל פעילויות השקה (בדרך כלל בתצוגת ברירת המחדל).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
בדיקה אם המשתמש הנתון גלוי במסך הנתון.
משתמש 'גלוי' הוא משתמש שמקיים אינטראקציה עם המשתמש 'האנושי', ולכן יכול להפעיל פעילויות השקה במסך הזה.
פרמטרים |
userId |
int |
displayId |
int |
isWifiEnabled
public abstract boolean isWifiEnabled ()
בודקים אם ה-Wi-Fi מופעל.
בדיקה אם ה-Wi-Fi מופעל במכשיר. המדיניות הזו שימושית לקביעת סטטוס רשת ה-Wi-Fi לפני בדיקות
שלא אמורות לפעול עם Wi-Fi, למשל בדיקות של חבילת גלישה.
החזרות |
boolean |
true אם ה-Wi-Fi מופעל. false אם האפשרות מושבתת |
listDisplayIds
public abstract listDisplayIds ()
אוספים את רשימת מזהי המסכים הזמינים במכשיר, כפי שמדווח על ידי "dumpsys
SurfaceFlinger".
החזרות |
|
רשימת המסכים. ברירת המחדל תמיד מחזירה את תצוגת ברירת המחדל 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
הפונקציה מקבלת את רשימת המסכים שאפשר להשתמש בהם כדי start a user visible in the background
.
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 |
removeAdmin
public abstract boolean removeAdmin (String componentName,
int userId)
הסרת האדמין של המכשיר במשתמש הנתון והחזרת הערך true
אם הפעולה בוצעה בהצלחה, או false
אחרת.
פרמטרים |
componentName |
String : של מנהל המכשיר שרוצים להסיר. |
userId |
int : של המשתמש שבו נמצא האדמין של המכשיר. |
החזרות |
boolean |
True אם הפעולה בוצעה בהצלחה, ו-False אחרת. |
removeOwners
public abstract void removeOwners ()
אתם יכולים להסיר את כל בעלי הפרופילים הקיימים של המכשיר בלי להתאמץ.
removeUser
public abstract boolean removeUser (int userId)
הסרת משתמש נתון מהמכשיר.
פרמטרים |
userId |
int : מהמשתמש שרוצים להסיר |
החזרות |
boolean |
true אם הצלחנו להסיר את המשתמש, ו-false אחרת. |
setDeviceOwner (הבעלים של המכשיר)
public abstract boolean setDeviceOwner (String componentName,
int userId)
הגדרת רכיב של אדמין מכשיר כבעלים של מכשיר אצל משתמש נתון.
פרמטרים |
componentName |
String : של אדמין המכשיר להיות הבעלים של המכשיר. |
userId |
int : של המשתמש שבו מתגורר הבעלים של המכשיר. |
החזרות |
boolean |
True אם הפעולה בוצעה בהצלחה, ו-False אחרת. |
הגדרה
public abstract void setSetting (String namespace,
String key,
String value)
ראו setSetting(int, String, String, String)
והפעולה מתבצעת על משתמש המערכת.
פרמטרים |
namespace |
String |
key |
String |
value |
String |
setSetting
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
הוספת ערך הגדרה למרחב השמות של משתמש נתון. חלק מההגדרות יהיו זמינות רק אחרי הפעלה מחדש.
מרחב השמות חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
פרמטרים |
userId |
int |
namespace |
String |
key |
String |
value |
String |
startUser
public abstract boolean startUser (int userId)
הפעלה של משתמש נתון ברקע, אם הוא מושהה כרגע. אם המשתמש כבר פועל ברקע, השיטה הזו היא NOOP.
פרמטרים |
userId |
int : של המשתמש להפעלה ברקע |
החזרות |
boolean |
true אם המשתמש הופעל בהצלחה ברקע. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
הפעלה של משתמש נתון ברקע, אם הוא מושהה כרגע. אם המשתמש כבר פועל ברקע, השיטה הזו היא NOOP. אפשר להוסיף סימון נוסף כדי להמתין
עד שהפעולה תיכנס לתוקף.
פרמטרים |
userId |
int : של המשתמש להפעלה ברקע |
waitFlag |
boolean : הפקודה תמתין עד שהמשתמש יופעל ויינעל. |
החזרות |
boolean |
true אם המשתמש הופעל בהצלחה ברקע. |
startמוצגBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
מפעיל משתמש מסוים ברקע, גלוי במסך הנתון (כלומר, מאפשר למשתמש להפעיל פעילויות במסך הזה).
הערה: הפקודה הזו לא בודקת אם המשתמש קיים, אם המסך זמין, device supports such feature
וכו'.
פרמטרים |
userId |
int : של המשתמש להפעלה ברקע |
displayId |
int : הצגה למשתמש שמתחילה להיות גלויה |
waitFlag |
boolean : יגרום לפקודה להמתין עד שהמשתמש יתחיל לפעול ויבטל את הנעילה שלו. |
החזרות |
boolean |
true אם המשתמש הופעל ברקע. |
stopUser
public abstract boolean stopUser (int userId)
עוצר משתמש נתון. אם המשתמש כבר עצר, השיטה הזו היא NOOP.
אי אפשר לעצור את המשתמש הנוכחי ואת המשתמש המערכתי.
פרמטרים |
userId |
int : של המשתמש שרוצים לעצור. |
החזרות |
boolean |
true אם המשתמש הופסק בהצלחה. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
להפסיק משתמש נתון. אפשר לספק דגלים נוספים כדי להמתין עד שהפעולה תשפיע, ולהכריח את סיום החשבון של המשתמש. אי אפשר לעצור את המשתמש הנוכחי ואת המשתמש המערכתי.
פרמטרים |
userId |
int : של המשתמש כדי להפסיק. |
waitFlag |
boolean : הפקודה תמתין עד שהמשתמש יופסק. |
forceFlag |
boolean : תגרום להפסקה יזומה של המשתמש. |
החזרות |
boolean |
true אם המשתמש הופסק בהצלחה. |
switchUser
public abstract boolean switchUser (int userId)
מעבר למשתמש אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל. switchUser(int, long)
.
החזרות |
boolean |
הערך True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, שקרית. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
עוברים למשתמש אחר עם זמן הקצאת הזמן שצוין כמועד אחרון.
מנסים להשבית את מגן המסך אחרי ששינוי המשתמש הושלם.
פרמטרים |
userId |
int |
timeout |
long : להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה. |
החזרות |
boolean |
הערך True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, שקרית. |
takeBugreport
public abstract Bugreport takeBugreport ()
הפונקציה מקבלת דוח באג ומחזירה אותו בתוך אובייקט Bugreport
לטיפול. במקרה של בעיה, הפונקציה מחזירה ערך null. צריך לנקות את הקובץ שמוזכר באובייקט Bugreport באמצעות Bugreport.close()
.
uninstallPackage
public abstract String uninstallPackage (String packageName)
הסרת חבילת Android מהמכשיר.
פרמטרים |
packageName |
String : חבילת Android להסרה |
החזרות |
String |
String עם קוד שגיאה, או null אם הפעולה הושלמה. |
uninstallPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
הסרת התקנה של חבילת Android מהמכשיר של משתמש נתון.
פרמטרים |
packageName |
String : חבילת Android שיש להסיר |
userId |
int : מזהה המשתמש המלא להסרת ההתקנה. |
החזרות |
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
אם התוצאה צפויה, ממתינים להשלמת snapuserd.
פרמטרים |
currentPhase |
SnapuserdWaitPhase |