דף זה תורגם על ידי Cloud Translation API.

TestDevice

public class TestDevice
extends NativeDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

תת מחלקות ישירות ידועות

ManagedRemoteDevice , NestedRemoteDevice , RemoteAndroidDevice

ManagedRemoteDevice	מכשיר הפועל בתוך מכונה וירטואלית שאנו מנהלים מרחוק באמצעות מופע Tradefed בתוך ה-VM.
NestedRemoteDevice	ייצוג המכשיר הפועל בתוך מכשיר VM מרוחק של Cuttlefish.
RemoteAndroidDevice	יישום של `ITestDevice` עבור מכשיר אנדרואיד מלא המחובר באמצעות adb connect.

תת-מחלקות עקיפות ידועות

LocalAndroidVirtualDevice , RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	המחלקה למכשירים וירטואליים מקומיים הפועלים על מארח TradeFed.
RemoteAndroidVirtualDevice	מרחיב את התנהגות `RemoteAndroidDevice` עבור מכשיר אנדרואיד מלא שפועל ב-Google Compute Engine (Gce).

הטמעת ITestDevice עבור מכשיר אנדרואיד מלא מחסנית

סיכום

כיתות מקוננות
`class`	`TestDevice.MicrodroidBuilder` בונה המשמש ליצירת Microdroid TestDevice.

שדות
`public static final String`	`DISMISS_KEYGUARD_CMD` פקודות שניתן להשתמש בהן כדי לבטל את מגן המקשים.

בנאים ציבוריים
`TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

שיטות ציבוריות
`boolean`	`clearErrorDialogs ()` נסה לבטל את כל תיבת הדו-שיח של שגיאה המוצגת כעת בממשק המשתמש של המכשיר.
`int`	`createUser (String name)` צור משתמש עם שם נתון ודגלי ברירת מחדל 0.
`int`	`createUser (String name, boolean guest, boolean ephemeral)` צור משתמש עם שם נתון והדגלים שסופקו
`int`	`createUserNoThrow (String name)` צור משתמש עם שם נתון ודגלי ברירת מחדל 0.
`void`	`disableKeyguard ()` ניסיונות להשבית את מגן המקשים.
`boolean`	`doesFileExist (String deviceFilePath)` שיטת עוזר כדי לקבוע אם קיים קובץ במכשיר.
`boolean`	`doesFileExist (String deviceFilePath, int userId)` שיטת עוזר לקבוע אם קיים קובץ במכשיר עבור משתמש נתון.
`File`	`dumpHeap (String process, String devicePath)` נסה לזרוק את הערימה מה-system_server.
	`getActiveApexes ()` אחזר את המידע על APEXs שהופעלו במכשיר.
	`getAllSettings (String namespace)` החזר צמדי ערכי מפתח של מרחב השמות המבוקש.
`String`	`getAndroidId (int userId)` מצא והחזר את ה-Android-ID המשויך ל-userId, null אם לא נמצא.
	`getAndroidIds ()` צור מפה של מזהי אנדרואיד שנמצאו מזהי משתמש תואמים.
`PackageInfo`	`getAppPackageInfo (String packageName)` אחזר מידע על חבילה המותקנת במכשיר.
	`getAppPackageInfos ()` אחזר מידע של חבילות המותקנות במכשיר.
`DeviceFoldableState`	`getCurrentFoldableState ()` מחזיר את המצב המתקפל הנוכחי של המכשיר או null אם התרחשו בעיות מסוימות.
`int`	`getCurrentUser ()` החזר את המזהה של המשתמש הנוכחי הפועל.
	`getFoldableStates ()` מחזירה את רשימת המצבים הניתנים לקיפול במכשיר.
	`getInstalledPackageNames ()` אחזר את שמות חבילות היישומים הקיימים במכשיר.
`KeyguardControllerState`	`getKeyguardState ()` החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך.
	`getMainlineModuleInfo ()` קבל את המידע על המודולים המרכזיים המותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported ()` קבל את המספר המרבי של משתמשים שפועלים בו זמנית.
`int`	`getMaxNumberOfUsersSupported ()` קבל את המספר המרבי של משתמשים נתמכים.
`String`	`getMicrodroidCID ()`
`Integer`	`getPrimaryUserId ()` מחזירה את מזהה המשתמש הראשי.
`InputStreamSource`	`getScreenshot ()` תופס צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot (String format, boolean rescale)` תופס צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot (String format)` תופס צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot (long displayId)` תופס צילום מסך מהמכשיר שקיבל מזהה תצוגה.
`String`	`getSetting (String namespace, String key)` ראה `getSetting(int, String, String)` ובוצע על משתמש המערכת.
`String`	`getSetting (int userId, String namespace, String key)` החזר את הערך של ההגדרה המבוקשת.
	`getUninstallablePackageNames ()` אחזר את שמות חבילות האפליקציות שניתן להסיר.
`int`	`getUserFlags (int userId)` מצא והחזר את הדגלים של משתמש נתון.
	`getUserInfos ()` מקבל את מפת useId ל- `UserInfo` במכשיר.
`int`	`getUserSerialNumber (int userId)` החזר את המספר הסידורי המשויך ל-userId אם נמצא, -10000 בכל מקרה אחר.
`boolean`	`hasFeature (String feature)` בדוק אם תכונה זמינה במכשיר.
`String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` התקן חבילת אנדרואיד במכשיר.
`String`	`installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs)` התקן חבילת אנדרואיד במכשיר.
`String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקן חבילת אנדרואיד במכשיר.
`String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.
`String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.
`String`	`installPackages ( packageFiles, boolean reinstall, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)`
`boolean`	`isAppEnumerationSupported ()` בדוק אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
`boolean`	`isMultiUserSupported ()` קובע אם ריבוי משתמשים נתמך.
`boolean`	`isPackageInstalled (String packageName)` שאל את המכשיר עבור שם חבילה נתון כדי לבדוק אם הוא מותקן כעת או לא.
`boolean`	`isPackageInstalled (String packageName, String userId)` שאל את המכשיר עבור שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם הוא מותקן כעת או לא עבור אותו משתמש.
`boolean`	`isUserRunning (int userId)` בדוק אם משתמש נתון פועל.
`boolean`	`isUserSecondary (int userId)` החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
	`listDisplayIds ()` אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".
	`listUsers ()` מקבל את רשימת המשתמשים במכשיר.
`void`	`postInvocationTearDown (Throwable exception)` שלבים נוספים עבור ניקוי נדרש ספציפי למכשיר שיבוצעו לאחר ביצוע ההזמנה.
`boolean`	`removeAdmin (String componentName, int userId)` הסר מנהל מכשיר נתון במשתמש נתון והחזר `true` אם זה מצליח, `false` אחרת.
`void`	`removeOwners ()` הסר את כל בעלי פרופיל המכשירים הקיימים במאמץ הטוב ביותר.
`boolean`	`removeUser (int userId)` הסר משתמש נתון מהמכשיר.
`boolean`	`setDeviceOwner (String componentName, int userId)` הגדר רכיב ניהול מכשיר כבעל מכשיר במשתמש נתון.
`void`	`setSetting (String namespace, String key, String value)` ראה `setSetting(int, String, String, String)` ובוצע על משתמש המערכת.
`void`	`setSetting (int userId, String namespace, String key, String value)` הוסף ערך הגדרה למרחב השמות של משתמש נתון.
`void`	`shutdownMicrodroid ( ITestDevice microdroidDevice)` מכבה את מכשיר ה-microdroid, אם קיים.
`boolean`	`startUser (int userId)` מפעיל משתמש נתון ברקע אם הוא נעצר כעת.
`boolean`	`startUser (int userId, boolean waitFlag)` מפעיל משתמש נתון ברקע אם הוא נעצר כעת.
`boolean`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` עצור משתמש נתון.
`boolean`	`stopUser (int userId)` עוצר משתמש נתון.
`boolean`	`supportsMicrodroid ()` בודק את התנאים המוקדמים להפעלת microdroid.
`boolean`	`supportsMicrodroid (boolean protectedVm)` בודק את התנאים המוקדמים להפעלת microdroid.
`boolean`	`switchUser (int userId)` עבור ל-userId אחר עם פסק זמן ברירת מחדל.
`boolean`	`switchUser (int userId, long timeout)` עבור ל-userId אחר עם הזמן הקצוב שסופק כתאריך יעד.
`String`	`uninstallPackage (String packageName)` הסר התקנה של חבילת אנדרואיד מהמכשיר.
`String`	`uninstallPackageForUser (String packageName, int userId)` הסר התקנה של חבילת אנדרואיד מהמכשיר עבור משתמש נתון.

שיטות מוגנות
`AaptParser`	`createParser (File appFile)`
`void`	`doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)` בצע אתחול של adb.
`long`	`getCheckNewUserSleep ()` נחשף לבדיקה.
`long`	`getHostCurrentTime ()` נחשף לבדיקה
`void`	`prePostBootSetup ()` מאפשר לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לעקוף שיטה זו עבור הגדרה ספציפית לאחר האתחול.

שדות

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

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

בנאים ציבוריים

TestDevice

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

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

clearErrorDialogs

public boolean clearErrorDialogs ()

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

החזרות
`boolean`	`true` אם לא היו תיבות דו-שיח או אם תיבות דו-שיח נוקו בהצלחה. `false` אחרת.

זורק
`DeviceNotAvailableException`

צור משתמש

public int createUser (String name)

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

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

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

זורק
`DeviceNotAvailableException`

צור משתמש

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

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

פרמטרים
`name`	`String` : של המשתמש ליצור במכשיר
`guest`	`boolean` : אפשר את דגל המשתמש --guest במהלך היצירה
`ephemeral`	`boolean` : אפשר את דגל המשתמש - ארעית במהלך היצירה

החזרות
`int`	מזהה המשתמש שנוצר

זורק
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

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

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

החזרות
`int`	המספר השלם עבור מזהה המשתמש שנוצר או -1 עבור שגיאה.

זורק
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

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

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

זורק
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

פרמטרים
`deviceFilePath`	`String` : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק

החזרות
`boolean`	`true` אם הקובץ קיים, `false` אחרת.

זורק
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

פרמטרים
`deviceFilePath`	`String` : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק
`userId`	`int` : מזהה המשתמש שכנגדו יש לבדוק את קיום הקובץ

החזרות
`boolean`	`true` אם הקובץ קיים, `false` אחרת.

זורק
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

פרמטרים
`process`	`String` : שם תהליך ההתקן שעליו dumpheap.
`devicePath`	`String` : הנתיב במכשיר שבו לשים את המזבלה. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת.

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

זורק
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

החזרות
	`ERROR(/Set)` של `ApexInfo` מופעל כעת במכשיר

זורק
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

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

פרמטרים
`namespace`	`String` : חייבת להיות אחת מ-{"system", "secure", "global"}

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

זורק
`DeviceNotAvailableException`

getAndroidId

public String getAndroidId (int userId)

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

פרמטרים
`userId`	`int`

החזרות
`String`

זורק
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

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

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

זורק
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

פרמטרים
`packageName`	`String`

החזרות
`PackageInfo`	`PackageInfo` או `null` אם לא ניתן היה לאחזר מידע

זורק
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

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

החזרות
	`ERROR(/List)` של `PackageInfo` המותקנים במכשיר.

זורק
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

זורק
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

החזרות
`int`

זורק
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

מחזירה את רשימת המצבים הניתנים לקיפול במכשיר. ניתן להשיג עם "cmd device_state print-states".

החזרות

זורק
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

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

החזרות
	`ERROR(/Set)` של שמות חבילות `String` המותקנות כעת במכשיר.

זורק
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

החזרות
`KeyguardControllerState`	`KeyguardControllerState` המכיל תמונת מצב של המקלדת ומחזירה Null אם שאילתת Keyguard אינה נתמכת.

זורק
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

זורק
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

החזרות
`int`	מספר שלם המציין את מספר המשתמשים הפועלים בו זמנית

זורק
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

החזרות
`int`	מספר שלם המציין את מספר המשתמשים הנתמכים

זורק
`DeviceNotAvailableException`

getMicrodroidCID

public String getMicrodroidCID ()

החזרות
`String`	מחזיר את ה-CID של ה-microdroid vm. אם TestDevice אינו microdroid, החזר null.

getPrimaryUserId

public Integer getPrimaryUserId ()

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

החזרות
`Integer`	userId של המשתמש הראשי אם קיים אחד, ו-null אם אין משתמש ראשי.

זורק
`DeviceNotAvailableException`

get Screenshot

public InputStreamSource getScreenshot ()

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

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט png, או `null` אם צילום המסך לא הצליח.

זורק
`DeviceNotAvailableException`

get Screenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

פרמטרים
`format`	`String` : נתמך PNG, JPEG
`rescale`	`boolean` : אם יש לשנות את קנה המידה של צילום המסך כדי להקטין את גודל התמונה המתקבלת

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט, או `null` אם צילום המסך לא הצליח.

זורק
`DeviceNotAvailableException`

get Screenshot

public InputStreamSource getScreenshot (String format)

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

פרמטרים
`format`	`String` : נתמך PNG, JPEG

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט, או `null` אם צילום המסך לא הצליח.

זורק
`DeviceNotAvailableException`

get Screenshot

public InputStreamSource getScreenshot (long displayId)

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

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

פרמטרים
`displayId`	`long` : מזהה התצוגה של המסך שממנו ניתן לקבל צילום מסך.

החזרות
`InputStreamSource`	a `InputStreamSource` של צילום המסך בפורמט, או `null` אם צילום המסך לא הצליח.

זורק
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

פרמטרים
`namespace`	`String`
`key`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

החזר את הערך של ההגדרה המבוקשת. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}

פרמטרים
`userId`	`int`
`namespace`	`String`
`key`	`String`

החזרות
`String`	הערך המשויך ל-namespace:key של משתמש. ריק אם לא נמצא.

זורק
`DeviceNotAvailableException`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

זורק
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

מצא והחזר את הדגלים של משתמש נתון. דגלים מוגדרים בכיתה "android.content.pm.UserInfo" ב-Android Open Source Project.

פרמטרים
`userId`	`int`

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

זורק
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

החזרות
	רשימת אובייקטי UserInfo.

זורק
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

פרמטרים
`userId`	`int`

החזרות
`int`

זורק
`DeviceNotAvailableException`

יש תכונה

public boolean hasFeature (String feature)

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

פרמטרים
`feature`	`String` : איזה פורמט צריך להיות "תכונה: "או" " בצורה ישירה.

החזרות
`boolean`	נכון אם תכונה נמצאה, false אחרת.

זורק
`DeviceNotAvailableException`

חבילת התקנה

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעביר. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`

חבילת התקנה

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

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`certFile`	`File` : `true` אם יש לבצע התקנה מחדש
`reinstall`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`

חבילת התקנה

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

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעביר. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`

installPackageForUser

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

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`grantPermissions`	`boolean` : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה
`userId`	`int` : מזהה המשתמש השלם שיש להתקין עבורו.
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`

installPackageForUser

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

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

פרמטרים
`packageFile`	`File` : קובץ ה-apk להתקנה
`reinstall`	`boolean` : `true` אם יש לבצע התקנה מחדש
`userId`	`int` : מזהה המשתמש השלם שיש להתקין עבורו.
`extraArgs`	`String` : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

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

זורק
`DeviceNotAvailableException`

התקנת חבילות

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

פרמטרים
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

התקנת חבילות

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

פרמטרים
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

installPackagesForUser

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

פרמטרים
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

installPackagesForUser

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

פרמטרים
`packageFiles`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

התקן RemotePackages

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

פרמטרים
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

התקן RemotePackages

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

פרמטרים
`remoteApkPaths`
`reinstall`	`boolean`
`extraArgs`	`String`

החזרות
`String`

זורק
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

בדוק אם הפלטפורמה במכשיר תומכת בספירת אפליקציות

החזרות
`boolean`	נכון אם ספירת האפליקציה נתמכת, לא נכון אחרת

זורק
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

קובע אם ריבוי משתמשים נתמך.

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

זורק
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

פרמטרים
`packageName`	`String`

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

זורק
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

זורק
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

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

פרמטרים
`userId`	`int`

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

זורק
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

פרמטרים
`userId`	`int`

החזרות
`boolean`	נכון אם המשתמש הוא משני, false אחרת.

זורק
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".

החזרות
	רשימת התצוגות. ברירת המחדל תמיד מחזירה את תצוגת ברירת המחדל 0.

זורק
`DeviceNotAvailableException`

רשימת משתמשים

public  listUsers ()

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

החזרות
	רשימת מזהי המשתמשים.

זורק
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

פרמטרים
`exception`	`Throwable` : אם קיים, החריג האחרון שהועלה עקב כישלון הפנייה.

הסר אדמין

public boolean removeAdmin (String componentName, 
                int userId)

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

פרמטרים
`componentName`	`String` : של מנהל המכשיר להסרה.
`userId`	`int` : של המשתמש שמנהל המכשיר גר בו.

החזרות
`boolean`	נכון אם זה מצליח, לא נכון אחרת.

זורק
`DeviceNotAvailableException`

להסיר בעלים

public void removeOwners ()

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

זורק
`DeviceNotAvailableException`

הסר משתמש

public boolean removeUser (int userId)

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

פרמטרים
`userId`	`int` : של המשתמש להסרה

החזרות
`boolean`	נכון אם הצלחנו להסיר את המשתמש, false אחרת.

זורק
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

פרמטרים
`componentName`	`String` : של מנהל המכשיר להיות הבעלים של המכשיר.
`userId`	`int` : של המשתמש שבו מתגורר בעל המכשיר.

החזרות
`boolean`	נכון אם זה מצליח, לא נכון אחרת.

זורק
`DeviceNotAvailableException`

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

ראה setSetting(int, String, String, String) ובוצע על משתמש המערכת.

פרמטרים
`namespace`	`String`
`key`	`String`
`value`	`String`

זורק
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

הוסף ערך הגדרה למרחב השמות של משתמש נתון. חלק מההגדרות יהיו זמינות רק לאחר אתחול מחדש. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}

פרמטרים
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

זורק
`DeviceNotAvailableException`

כיבוי מיקרודרואיד

public void shutdownMicrodroid (ITestDevice microdroidDevice)

מכבה את מכשיר ה-microdroid, אם קיים.

פרמטרים
`microdroidDevice`	`ITestDevice`

זורק
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

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

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

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

זורק
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

פרמטרים
`userId`	`int` : של המשתמש להתחיל ברקע
`waitFlag`	`boolean` : יגרום לפקודה להמתין עד שהמשתמש יופעל וייפתח.

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

זורק
`DeviceNotAvailableException`

stopUser

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

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

פרמטרים
`userId`	`int` : של המשתמש לעצור.
`waitFlag`	`boolean` : יגרום לפקודה לחכות עד שהמשתמש יופסק.
`forceFlag`	`boolean` : יאלץ לעצור את המשתמש.

החזרות
`boolean`	נכון אם המשתמש הופסק בהצלחה.

זורק
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

פרמטרים
`userId`	`int` : של המשתמש לעצור.

החזרות
`boolean`	נכון אם המשתמש הופסק בהצלחה.

זורק
`DeviceNotAvailableException`

תומך ב-Microdroid

public boolean supportsMicrodroid ()

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

החזרות
`boolean`	מחזירה true אם מתקיימים התנאים המוקדמים, אחרת שקר.

תומך ב-Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

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

פרמטרים
`protectedVm`	`boolean` : נכון אם microdroid מיועד לפעול ב-VM מוגן.

החזרות
`boolean`	מחזירה true אם מתקיימים התנאים המוקדמים, אחרת שקר.

החלף משתמש

public boolean switchUser (int userId)

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

פרמטרים
`userId`	`int`

החזרות
`boolean`	נכון אם ה-userId החדש תואם לספק ה-userId. שקר אחרת.

זורק
`DeviceNotAvailableException`

החלף משתמש

public boolean switchUser (int userId, 
                long timeout)

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

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

החזרות
`boolean`	נכון אם ה-userId החדש תואם לספק ה-userId. שקר אחרת.

זורק
`DeviceNotAvailableException`

הסר את חבילת ההתקנה

public String uninstallPackage (String packageName)

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

פרמטרים
`packageName`	`String` : חבילת אנדרואיד להסרת ההתקנה

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

זורק
`DeviceNotAvailableException`

הסר את ההתקנה שלPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

זורק
`DeviceNotAvailableException`

שיטות מוגנות

createParser

protected AaptParser createParser (File appFile)

פרמטרים
`appFile`	`File`

החזרות
`AaptParser`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

בצע אתחול של adb.

פרמטרים
`rebootMode`	`NativeDevice.RebootMode` : מצב של אתחול מחדש זה.
`reason`	`String` : לאתחול מחדש זה.

זורק
`DeviceNotAvailableException`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

נחשף לבדיקה.

החזרות
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

נחשף לבדיקה

החזרות
`long`

prePostBootSetup

protected void prePostBootSetup ()

מאפשר לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לעקוף שיטה זו עבור הגדרה ספציפית לאחר האתחול.

זורק
`DeviceNotAvailableException`

TestDevice

סיכום

כיתות מקוננות

שדות

בנאים ציבוריים

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

שיטות מוגנות

שדות

DISMISS_KEYGUARD_CMD

בנאים ציבוריים

TestDevice

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

clearErrorDialogs

צור משתמש

צור משתמש

createUserNoThrow

disableKeyguard

doesFileExist

doesFileExist

dumpHeap

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getMicrodroidCID

getPrimaryUserId

get Screenshot

get Screenshot

get Screenshot

get Screenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

יש תכונה

חבילת התקנה

חבילת התקנה

חבילת התקנה

installPackageForUser

installPackageForUser

התקנת חבילות

התקנת חבילות

installPackagesForUser

installPackagesForUser

התקן RemotePackages

התקן RemotePackages

isAppEnumerationSupported

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

listDisplayIds

רשימת משתמשים

postInvocationTearDown

הסר אדמין

להסיר בעלים

הסר משתמש

setDeviceOwner

setSetting

setSetting

כיבוי מיקרודרואיד

startUser

startUser

stopUser

stopUser

תומך ב-Microdroid

תומך ב-Microdroid