ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

סיכום

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

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

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

abstract boolean canSwitchToHeadlessSystemUser()

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

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)

נסה למחוק את הערימה מה-system_server.

abstract boolean enableNetworkMonitor()

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

abstract getActiveApexes()

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

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

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

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

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

abstract InputStreamSource getBugreport()

אחזור דוח על באג מהמכשיר.

abstract InputStreamSource getBugreportz()

אחזור דוח על באג מהמכשיר.

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

החזרת המזהה של המשתמש הפעיל הנוכחי.

abstract getFoldableStates()

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

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

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

abstract KeyguardControllerState getKeyguardState()

החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-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(String format)

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

abstract InputStreamSource getScreenshot(long displayId)

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

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

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

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)

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

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

בדיקת קישוריות

public abstract boolean checkConnectivity ()

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

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

cleanErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

cleanLastConnectedWi-FiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

ConnectToWi-FiNetwork

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: מזהה ה-Wi-Fi שאליו צריך להתחבר
wifiPsk String: ביטוי סיסמה של PSK או ערך null אם לא מוצפן
החזרות
boolean true אם הוא מחובר לרשת Wi-Fi בהצלחה. false אחרת
קליעות
DeviceNotAvailableException אם החיבור למכשיר אבד ולא ניתן שוחזר.

ConnectToWi-FiNetwork

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

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

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

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

ConnectToWi-FiNetworkIf Needed

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

ConnectToWi-FiNetworkIf Needed

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: הפעלת סימון המשתמש – אורח במהלך היצירה
ephemeral boolean: הפעלת סימון המשתמש באופן זמני במהלך היצירה
החזרות
int המזהה של המשתמש שנוצר
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

CreateUser

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

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

פרמטרים
name String: של המשתמש שצריך ליצור במכשיר
guest boolean: הפעלת סימון המשתמש – אורח במהלך היצירה
ephemeral boolean: הפעלת סימון המשתמש באופן זמני במהלך היצירה
forTesting boolean: הפעלת סימון הבדיקה –לבדיקה במהלך היצירה
החזרות
int המזהה של המשתמש שנוצר
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

פרמטרים
name String: של המשתמש שצריך ליצור במכשיר
החזרות
int המספר השלם של מזהה המשתמש שנוצר, או 1- לשגיאה.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ביטול הרישוםDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

הסרה של IDeviceActionReceiver הרשום.

פרמטרים
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver שיוסר.

השבתה של KeyGuard

public abstract void disableKeyguard ()

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

קודם כל צריך להמתין עד ששליחה הקלט תהיה מוכנה, זה מתרחש בערך באותו זמן כאשר המכשיר מדווח על BOOT_COMPLETE, באופן אסינכרוני, כי המסגרת הנוכחית יש מרוץ תהליכים מדי פעם. לאחר מכן נשלחת פקודה לסגירת מקש KeyGuard (פועל בתנועה לא מאובטחת בלבד)

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

DoFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

עריסות

public abstract File dumpHeap (String process, 
                String devicePath)

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

פרמטרים
process String: שם התהליך במכשיר שאליו רוצים לבצע את ה-Dumpheap.
devicePath String: הנתיב במכשיר שבו צריך למקם את קובץ ה-Dump. המיקום הזה חייב להיות מיקום שבו ההרשאות מאפשרות זאת.
החזרות
File ERROR(/File) שמכיל את הדוח. המערכת תציג ערך של null אם משהו נכשל.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

הפעלת NetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

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

getActiveApexes

public abstract  getActiveApexes ()

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

החזרות
ERROR(/Set) מתוך ApexInfo מופעלים כרגע במכשיר
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

פרמטרים
namespace String: חייב להיות אחד מהערכים {"system", "secure", "global"}
החזרות
המפה של צמדי המפתח. המערכת תציג ערך של null אם אין תמיכה במרחב השמות.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

פרמטרים
userId int

החזרות
String

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

מזהי getAndroidId

public abstract  getAndroidIds ()

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

החזרות
מפה של מזהי Android שנמצאו במזהי משתמשים תואמים.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

פרמטרים
packageName String

החזרות
PackageInfo PackageInfo או null אם לא ניתן לאחזר את המידע
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

החזרות
הותקנו ERROR(/List) מתוך PackageInfo במכשיר.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

דוח getBugreport

public abstract InputStreamSource getBugreport ()

אחזור דוח על באג מהמכשיר.

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

נתמך רק עבור 'גרסת adb' > 1.0.36

החזרות
InputStreamSource InputStreamSource של קובץ ה-ZIP שמכיל את דוח הבאג, החזרת הערך null ב- במקרה של כשל.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

החזרות
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

החזרות
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

החזרות
ERROR(/Set) מתוך String שמות של חבילות המותקנים כרגע במכשיר.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

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

החזרות
String כתובת ה-IP של המכשיר, או null אם למכשיר אין כתובת IP
קליעות
DeviceNotAvailableException אם החיבור למכשיר אבד ולא ניתן שוחזר.

getKeyGuardState

public abstract KeyguardControllerState getKeyguardState ()

החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-null אם אין תמיכה בו.

החזרות
KeyguardControllerState KeyguardControllerState שמכיל תמונת מצב של מצב מגן המפתח ומחזירה את הערך Null אם שאילתת KeyGuard לא נתמכת.
קליעות
DeviceNotAvailableException אם החיבור למכשיר אבד ולא ניתן שוחזר.

getMainUserId

public abstract Integer getMainUserId ()

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

החזרות
ERROR(/Set) מתוך String מודולים של השורה הראשית שמותקנים כרגע במכשיר.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getMaxNumberOf runningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

החזרות
int מספר שלם שמציין את מספר המשתמשים הפעילים בו-זמנית
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

החזרות
int מספר שלם שמציין את מספר המשתמשים הנתמכים
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

getצילום מסך

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

getצילום מסך

public abstract InputStreamSource getScreenshot (String format)

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

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

getצילום מסך

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: הרחבת ההטמעות שלמעלה כדי לתמוך ב-'format' ו'קנה מידה'

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

getצילום מסך

public abstract InputStreamSource getScreenshot ()

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

החזרות
InputStreamSource InputStreamSource של צילום המסך בפורמט png, או null אם צילום המסך נכשל.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

הגדרה

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

הגדרה

public abstract String getSetting (String namespace, 
                String key)

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

פרמטרים
namespace String

key String

החזרות
String

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

getUserSeriesNumber 

public abstract int getUserSerialNumber (int userId)

אם נמצא, יש להחזיר את המספר הסידורי שמשויך למזהה המשתמש, -10000 במקרים אחרים.

פרמטרים
userId int

החזרות
int

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

hasFeature

public abstract boolean hasFeature (String feature)

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

פרמטרים
feature String: איזה פורמט צריך להיות "feature:" או "" ישירות.
החזרות
boolean True אם התכונה נמצאת, אחרת False.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
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 אם ההרשאה בתחילת ההפעלה לא נתמכת בפלטפורמה במכשיר.

התקנהPackageForUser

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

התקנהPackageForUser

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

חבילות התקנה

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

התקנה RemotePackages

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

התקנה RemotePackages

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

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

החזרות
boolean

קליעות
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

החזרות
boolean true אם יש תמיכה בריבוי משתמשים, FALSE אם יש תמיכה בריבוי משתמשים, אחרת
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isPackageInstalled (בהתקנה)

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

פרמטרים
packageName String: החבילה שאנחנו בודקים אם היא מותקנת.
userId String: מזהה המשתמש שאנחנו בודקים שהחבילה מותקנת עבורו. אם הערך הוא null, המשתמש הראשי המערכת תשתמש באפס.
החזרות
boolean הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isPackageInstalled (בהתקנה)

public abstract boolean isPackageInstalled (String packageName)

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

פרמטרים
packageName String

החזרות
boolean הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isUser running

public abstract boolean isUserRunning (int userId)

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

פרמטרים
userId int

החזרות
boolean הערך הוא True אם המשתמש פועל, בכל מקרה אחר הערך False.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isUsersecondary

public abstract boolean isUserSecondary (int userId)

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

פרמטרים
userId int

החזרות
boolean true אם המשתמש הוא משני, אחרת false.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isUserצג

public abstract boolean isUserVisible (int userId)

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

A "גלוי" הוא משתמש שמקיים אינטראקציה עם ולכן הוא יכול להפעיל פעילויות הפעלה (בדרך כלל בתצוגת ברירת המחדל).

פרמטרים
userId int

החזרות
boolean

קליעות
DeviceNotAvailableException

isUserVisibilityOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

פרמטרים
userId int

displayId int

החזרות
boolean

קליעות
DeviceNotAvailableException

isdisplayBackgroundUsersOnDefaultDisplaySupported

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

isViewBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
boolean

קליעות
DeviceNotAvailableException

תואם ל-Wi-Fi

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

listDisplayIdsForSTART visibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

קבלת רשימת המסכים שבהם אפשר להשתמש כדי start a user visible in the background.

החזרות
קליעות
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

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

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

דוח LogBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

פרמטרים
dataName String: השם שתחתיו ידווח הדוח על הבאג.
listener ITestLogger: ITestLogger לרישום הדוח על הבאג.
החזרות
boolean הערך הוא True אם הרישום ביומן בוצע בהצלחה, אחרת False.

התרת Snapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

יש להודיע למכשיר להמתין להשלמת Snapuserd.

פרמטרים
waitPhase SnapuserdWaitPhase

רישוםDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

רישום IDeviceActionReceiver למכשיר הזה.

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

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

הסרת אדמין

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

הסרת בעלים

public abstract void removeOwners ()

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

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

removeUser

public abstract boolean removeUser (int userId)

להסיר משתמש נתון מהמכשיר.

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

setDeviceOwner (הבעלים של המכשיר)

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

הגדרה

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

start visibilityBackgroundUser

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

stopUser

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

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

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

מתג משתמש

public abstract boolean switchUser (int userId)

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

פרמטרים
userId int

החזרות
boolean הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

מתג משתמש

public abstract boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
userId int

timeout long: להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה.
החזרות
boolean הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

החזרות
Bugreport

הסרת החבילה

public abstract String uninstallPackage (String packageName)

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

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

removePackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

להמתין ל-Snapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

פרמטרים
currentPhase SnapuserdWaitPhase

קליעות
DeviceNotAvailableException