Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

TestDevice

public class TestDevice
extends NativeDevice

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

Subclass langsung yang dikenal

ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice

ManagedRemoteDevice	Perangkat yang berjalan di dalam virtual machine yang kita kelola dari jarak jauh melalui instance Tradefed di dalam VM.
NestedRemoteDevice	Representasi perangkat yang berjalan di dalam VM Cuttlefish jarak jauh.
RemoteAndroidDevice	Implementasi `ITestDevice` untuk perangkat Android stack penuh yang terhubung melalui adb connect.

Subclass tidak langsung yang umum

LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	Class untuk perangkat virtual lokal yang berjalan di host TradeFed.
RemoteAndroidVirtualDevice	Memperluas perilaku `RemoteAndroidDevice` untuk perangkat Android stack lengkap yang berjalan di Google Compute Engine (Gce).

Implementasi ITestDevice untuk perangkat Android stack penuh

Ringkasan

Kolom
`public static final String`	`DISMISS_KEYGUARD_CMD` Perintah yang dapat digunakan untuk menutup pelindung kunci.

Konstruktor publik
`TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

Metode publik
`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)`

Metode yang dilindungi
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Lakukan mulai ulang adb.
`long`	`getCheckNewUserSleep()` Ditampilkan untuk pengujian.
`long`	`getHostCurrentTime()` Diekspos untuk pengujian
`void`	`prePostBootSetup()` Memungkinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) mengganti metode ini untuk penyiapan pasca-booting tertentu.

Kolom

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Perintah yang dapat digunakan untuk menutup pelindung kunci.

Konstruktor publik

TestDevice

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

Metode publik

clearErrorDialogs

public boolean clearErrorDialogs ()

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Parameter
`name`	`String`

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

createUser

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

Parameter
`name`	`String`
`guest`	`boolean`
`ephemeral`	`boolean`

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Parameter
`name`	`String`

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Menampilkan
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Parameter
`deviceFilePath`	`String`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Parameter
`process`	`String`
`devicePath`	`String`

Hasil
`File`

Menampilkan
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Parameter
`namespace`	`String`

Hasil

Menampilkan
`DeviceNotAvailableException`

getAndroidId

public String getAndroidId (int userId)

Parameter
`userId`	`int`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Parameter
`packageName`	`String`

Hasil
`PackageInfo`

Menampilkan
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Hasil
`DeviceFoldableState`

Menampilkan
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Hasil
`KeyguardControllerState`

Menampilkan
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

Hasil
`Integer`

Menampilkan
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Hasil
`InputStreamSource`

Menampilkan
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Parameter
`format`	`String`
`rescale`	`boolean`

Hasil
`InputStreamSource`

Menampilkan
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Parameter
`format`	`String`

Hasil
`InputStreamSource`

Menampilkan
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Parameter
`displayId`	`long`

Hasil
`InputStreamSource`

Menampilkan
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Parameter
`namespace`	`String`
`key`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

getSetting

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

Parameter
`userId`	`int`
`namespace`	`String`
`key`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

Parameter
`userId`	`int`

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Hasil

Menampilkan
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Parameter
`userId`	`int`

Hasil
`int`

Menampilkan
`DeviceNotAvailableException`

hasFeature

public boolean hasFeature (String feature)

Parameter
`feature`	`String`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

installPackage

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

Parameter
`packageFile`	`File`
`reinstall`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackage

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

Parameter
`packageFile`	`File`
`certFile`	`File`
`reinstall`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackage

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

Parameter
`packageFile`	`File`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackageForUser

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

Parameter
`packageFile`	`File`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackageForUser

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

Parameter
`packageFile`	`File`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackages

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

Parameter
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackages

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

Parameter
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackagesForUser

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

Parameter
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installPackagesForUser

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

Parameter
`packageFiles`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installRemotePackages

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

Parameter
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

installRemotePackages

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

Parameter
`remoteApkPaths`
`reinstall`	`boolean`
`extraArgs`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Parameter
`packageName`	`String`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Parameter
`packageName`	`String`
`userId`	`String`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

Parameter
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Parameter
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Hasil

Menampilkan
`DeviceNotAvailableException`

listUsers

public  listUsers ()

Hasil

Menampilkan
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Parameter
`exception`	`Throwable`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Parameter
`componentName`	`String`
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Menampilkan
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Parameter
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Parameter
`componentName`	`String`
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

setSetting

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

Parameter
`namespace`	`String`
`key`	`String`
`value`	`String`

Menampilkan
`DeviceNotAvailableException`

setSetting

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

Parameter
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Menampilkan
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

Parameter
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Parameter
`userId`	`int`
`waitFlag`	`boolean`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

stopUser

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

Parameter
`userId`	`int`
`waitFlag`	`boolean`
`forceFlag`	`boolean`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

Parameter
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Parameter
`userId`	`int`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Parameter
`userId`	`int`
`timeout`	`long`

Hasil
`boolean`

Menampilkan
`DeviceNotAvailableException`

uninstallPackage

public String uninstallPackage (String packageName)

Parameter
`packageName`	`String`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Parameter
`packageName`	`String`
`userId`	`int`

Hasil
`String`

Menampilkan
`DeviceNotAvailableException`

Metode yang dilindungi

doAdbReboot

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

Lakukan mulai ulang adb.

Parameter
`rebootMode`	`NativeDevice.RebootMode`: mode mulai ulang ini.
`reason`	`String`: untuk mulai ulang ini.

Menampilkan
`DeviceNotAvailableException`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Ditampilkan untuk pengujian.

Hasil
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

Diekspos untuk pengujian

Hasil
`long`

prePostBootSetup

protected void prePostBootSetup ()

Memungkinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) mengganti metode ini untuk penyiapan pasca-booting tertentu.

Menampilkan
`DeviceNotAvailableException`