اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة 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 داخل الجهاز الافتراضي
NestedRemoteDevice	تمثيل للجهاز الذي يعمل داخل جهاز افتراضي عن بُعد من Cuttlefish
RemoteAndroidDevice	تنفيذ `ITestDevice` لجهاز Android مزوّد بمجموعة كاملة من الأدوات ومتصل عبر adb connect

الفئات الفرعية غير المباشرة المعروفة

LocalAndroidVirtualDevice وRemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	فئة الأجهزة الافتراضية المحلية التي تعمل على مضيف TradeFed
RemoteAndroidVirtualDevice	توسيع نطاق سلوك `RemoteAndroidDevice` لجهاز Android مزوّد بمجموعة كاملة من البرامج والتطبيقات ويعمل على Google Compute Engine (Gce)

تنفيذ ITestDevice لجهاز Android مزوّد بمجموعة كاملة من الأدوات

ملخّص

الحقول
`public static final String`	`DISMISS_KEYGUARD_CMD` الأوامر التي يمكن استخدامها لإغلاق شاشة القفل

وظائف الإنشاء العامة
`TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

الطرق العامة
`boolean`	`clearErrorDialogs()`
`int`	`createUser(String name)`
`int`	`createUser(String name, boolean guest, boolean ephemeral)`
`int`	`createUserNoThrow(String name)`
`void`	`disableKeyguard()`
`boolean`	`doesFileExist(String deviceFilePath)`
`File`	`dumpHeap(String process, String devicePath)`
	`getActiveApexes()`
	`getAllSettings(String namespace)`
`String`	`getAndroidId(int userId)`
	`getAndroidIds()`
`PackageInfo`	`getAppPackageInfo(String packageName)`
	`getAppPackageInfos()`
`DeviceFoldableState`	`getCurrentFoldableState()`
`int`	`getCurrentUser()`
	`getFoldableStates()`
	`getInstalledPackageNames()`
`KeyguardControllerState`	`getKeyguardState()`
	`getMainlineModuleInfo()`
`int`	`getMaxNumberOfRunningUsersSupported()`
`int`	`getMaxNumberOfUsersSupported()`
`Integer`	`getPrimaryUserId()`
`InputStreamSource`	`getScreenshot()`
`InputStreamSource`	`getScreenshot(String format, boolean rescale)`
`InputStreamSource`	`getScreenshot(String format)`
`InputStreamSource`	`getScreenshot(long displayId)`
`String`	`getSetting(String namespace, String key)`
`String`	`getSetting(int userId, String namespace, String key)`
	`getUninstallablePackageNames()`
`int`	`getUserFlags(int userId)`
	`getUserInfos()`
`int`	`getUserSerialNumber(int userId)`
`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)`
`String`	`installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`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()`
	`listUsers()`
`void`	`postInvocationTearDown(Throwable exception)`
`boolean`	`removeAdmin(String componentName, int userId)`
`void`	`removeOwners()`
`boolean`	`removeUser(int userId)`
`boolean`	`setDeviceOwner(String componentName, int userId)`
`void`	`setSetting(String namespace, String key, String value)`
`void`	`setSetting(int userId, String namespace, String key, String value)`
`boolean`	`startUser(int userId)`
`boolean`	`startUser(int userId, boolean waitFlag)`
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)`
`boolean`	`stopUser(int userId)`
`boolean`	`switchUser(int userId)`
`boolean`	`switchUser(int userId, long timeout)`
`String`	`uninstallPackage(String packageName)`
`String`	`uninstallPackageForUser(String packageName, int userId)`

الطرق المحمية
`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`

عمليات الرمي
`DeviceNotAvailableException`

createUser

public int createUser (String name)

المعلمات
`name`	`String`

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

createUser

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

المعلمات
`name`	`String`
`guest`	`boolean`
`ephemeral`	`boolean`

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

المعلمات
`name`	`String`

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

عمليات الرمي
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

المعلمات
`deviceFilePath`	`String`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

المعلمات
`process`	`String`
`devicePath`	`String`

المرتجعات
`File`

عمليات الرمي
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

المعلمات
`namespace`	`String`

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getAndroidId

public String getAndroidId (int userId)

المعلمات
`userId`	`int`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

المعلمات
`packageName`	`String`

المرتجعات
`PackageInfo`

عمليات الرمي
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

المرتجعات
`DeviceFoldableState`

عمليات الرمي
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

المرتجعات
`KeyguardControllerState`

عمليات الرمي
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

المرتجعات
`Integer`

عمليات الرمي
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

المرتجعات
`InputStreamSource`

عمليات الرمي
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

المعلمات
`format`	`String`
`rescale`	`boolean`

المرتجعات
`InputStreamSource`

عمليات الرمي
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

المعلمات
`format`	`String`

المرتجعات
`InputStreamSource`

عمليات الرمي
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

المعلمات
`displayId`	`long`

المرتجعات
`InputStreamSource`

عمليات الرمي
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

المعلمات
`namespace`	`String`
`key`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

getSetting

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

المعلمات
`userId`	`int`
`namespace`	`String`
`key`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

المعلمات
`userId`	`int`

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

المعلمات
`userId`	`int`

المرتجعات
`int`

عمليات الرمي
`DeviceNotAvailableException`

hasFeature

public boolean hasFeature (String feature)

المعلمات
`feature`	`String`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

installPackage

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

المعلمات
`packageFile`	`File`
`reinstall`	`boolean`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installPackage

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

المعلمات
`packageFile`	`File`
`certFile`	`File`
`reinstall`	`boolean`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installPackage

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

المعلمات
`packageFile`	`File`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installPackageForUser

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

المعلمات
`packageFile`	`File`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installPackageForUser

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

المعلمات
`packageFile`	`File`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installPackages

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

المعلمات
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installPackages

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`

installRemotePackages

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

المعلمات
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

installRemotePackages

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`

عمليات الرمي
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

المعلمات
`packageName`	`String`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

المعلمات
`packageName`	`String`
`userId`	`String`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

المعلمات
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

المعلمات
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

listUsers

public  listUsers ()

المرتجعات

عمليات الرمي
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

المعلمات
`exception`	`Throwable`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

المعلمات
`componentName`	`String`
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

عمليات الرمي
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

المعلمات
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`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)

المعلمات
`namespace`	`String`
`key`	`String`
`value`	`String`

عمليات الرمي
`DeviceNotAvailableException`

setSetting

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

المعلمات
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

عمليات الرمي
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

المعلمات
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

المعلمات
`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)

المعلمات
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

المعلمات
`userId`	`int`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

المعلمات
`userId`	`int`
`timeout`	`long`

المرتجعات
`boolean`

عمليات الرمي
`DeviceNotAvailableException`

uninstallPackage

public String uninstallPackage (String packageName)

المعلمات
`packageName`	`String`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

المعلمات
`packageName`	`String`
`userId`	`int`

المرتجعات
`String`

عمليات الرمي
`DeviceNotAvailableException`

الطرق المحمية

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`