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

Class bertingkat
class	TestDevice.MicrodroidBuilder Builder yang digunakan untuk membuat TestDevice Microdroid.

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	canSwitchToHeadlessSystemUser() Menampilkan apakah diizinkan untuk beralih ke pengguna SISTEM headless.
boolean	clearErrorDialogs() Mencoba menutup dialog error yang saat ini ditampilkan di UI perangkat.
int	createUser(String name) Buat pengguna dengan nama yang diberikan dan flag default 0.
int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Membuat pengguna dengan nama tertentu dan flag yang diberikan
int	createUser(String name, boolean guest, boolean ephemeral) Membuat pengguna dengan nama tertentu dan flag yang diberikan
int	createUserNoThrow(String name) Buat pengguna dengan nama yang diberikan dan flag default 0.
void	disableKeyguard() Mencoba menonaktifkan kunci layar.
boolean	doesFileExist(String deviceFilePath) Metode helper untuk menentukan apakah file di perangkat ada.
boolean	doesFileExist(String deviceFilePath, int userId) Metode bantuan untuk menentukan apakah file di perangkat ada untuk pengguna tertentu.
File	dumpHeap(String process, String devicePath) Mencoba membuang heap dari system_server.
	getActiveApexes() Mengambil informasi tentang APEX yang diaktifkan di perangkat.
	getAllSettings(String namespace) Menampilkan pasangan nilai kunci dari namespace yang diminta.
String	getAndroidId(int userId) Menemukan dan menampilkan android-id yang terkait dengan userId, null jika tidak ditemukan.
	getAndroidIds() Buat Peta ID Android yang ditemukan cocok dengan ID pengguna.
PackageInfo	getAppPackageInfo(String packageName) Mengambil informasi tentang paket yang diinstal di perangkat.
	getAppPackageInfos() Mengambil informasi paket yang diinstal di perangkat.
InputStreamSource	getBugreport() Mengambil laporan bug dari perangkat.
InputStreamSource	getBugreportz() Mengambil bugreportz dari perangkat.
DeviceFoldableState	getCurrentFoldableState() Menampilkan status perangkat foldable saat ini atau null jika terjadi beberapa masalah.
int	getCurrentUser() Menampilkan ID pengguna yang sedang berjalan saat ini.
	getFoldableStates() Menampilkan daftar status perangkat foldable.
	getInstalledPackageNames() Mengambil nama paket aplikasi yang ada di perangkat.
KeyguardControllerState	getKeyguardState() Menampilkan objek untuk mendapatkan status kunci layar saat ini atau null jika tidak didukung.
Integer	getMainUserId() Menampilkan ID pengguna utama.
	getMainlineModuleInfo() Dapatkan informasi tentang modul utama yang diinstal di perangkat.
int	getMaxNumberOfRunningUsersSupported() Mendapatkan jumlah maksimum pengguna yang didukung yang berjalan secara bersamaan.
int	getMaxNumberOfUsersSupported() Mendapatkan jumlah maksimum pengguna yang didukung.
Integer	getPrimaryUserId() Menampilkan ID pengguna utama.
InputStreamSource	getScreenshot() Mengambil screenshot dari perangkat.
InputStreamSource	getScreenshot(String format, boolean rescale) Mengambil screenshot dari perangkat.
InputStreamSource	getScreenshot(long displayId) Mengambil screenshot dari perangkat yang diberi ID tampilan.
InputStreamSource	getScreenshot(String format) Mengambil screenshot dari perangkat.
String	getSetting(String namespace, String key) Lihat getSetting(int, String, String) dan dilakukan pada pengguna sistem.
String	getSetting(int userId, String namespace, String key) Menampilkan nilai setelan yang diminta.
	getUninstallablePackageNames() Mengambil nama paket aplikasi yang dapat diuninstal.
int	getUserFlags(int userId) Menemukan dan menampilkan flag pengguna tertentu.
	getUserInfos() Mendapatkan Peta useId ke UserInfo di perangkat.
int	getUserSerialNumber(int userId) Menampilkan nomor seri yang terkait dengan userId jika ditemukan, -10000 dalam kasus lain.
boolean	hasFeature(String feature) Memeriksa apakah fitur tersedia di perangkat.
String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Menginstal paket Android di perangkat.
String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Menginstal paket Android di perangkat.
String	installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs) Menginstal paket Android di perangkat.
String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Menginstal paket Android di perangkat untuk pengguna tertentu.
String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Menginstal paket Android di perangkat untuk pengguna tertentu.
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, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
boolean	isAppEnumerationSupported() Memeriksa apakah platform di perangkat mendukung enumerasi aplikasi
boolean	isHeadlessSystemUserMode() Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.
boolean	isMainUserPermanentAdmin() Menampilkan apakah pengguna utama adalah admin permanen dan tidak dapat dihapus atau diturunkan statusnya menjadi non-admin.
boolean	isMultiUserSupported() Menentukan apakah multi-pengguna didukung.
boolean	isPackageInstalled(String packageName) Buat kueri perangkat untuk nama paket tertentu guna memeriksa apakah paket tersebut saat ini diinstal atau tidak.
boolean	isPackageInstalled(String packageName, String userId) Buat kueri perangkat untuk nama paket tertentu dan ID pengguna tertentu untuk memeriksa apakah saat ini diinstal atau tidak untuk pengguna tersebut.
boolean	isUserRunning(int userId) Periksa apakah pengguna tertentu sedang berjalan.
boolean	isUserSecondary(int userId) Menampilkan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan tandanya.
boolean	isUserVisible(int userId) Memeriksa apakah pengguna tertentu terlihat.
boolean	isUserVisibleOnDisplay(int userId, int displayId) Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.
boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Menampilkan apakah perangkat mengizinkan pengguna dimulai dan terlihat di latar belakang di ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
boolean	isVisibleBackgroundUsersSupported() Menampilkan apakah perangkat mengizinkan pengguna dimulai dan terlihat di latar belakang.
	listDisplayIds() Kumpulkan daftar ID layar yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys SurfaceFlinger".
	listDisplayIdsForStartingVisibleBackgroundUsers() Mendapatkan daftar layar yang dapat digunakan untuk start a user visible in the background.
	listUsers() Mendapatkan daftar pengguna di perangkat.
boolean	logBugreport(String dataName, ITestLogger listener) Metode bantuan untuk mengambil laporan bug dan mencatatnya ke pelapor.
void	notifySnapuserd(SnapuserdWaitPhase waitPhase)
void	postInvocationTearDown(Throwable exception) Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan selesai.
boolean	removeAdmin(String componentName, int userId) Hapus admin perangkat tertentu di pengguna tertentu dan tampilkan true jika berhasil, false jika tidak.
void	removeOwners() Menghapus semua pemilik profil perangkat yang ada dengan upaya terbaik.
boolean	removeUser(int userId) Menghapus pengguna tertentu dari perangkat.
boolean	setDeviceOwner(String componentName, int userId) Menetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.
void	setFirstBootloaderReboot()
void	setSetting(String namespace, String key, String value) Lihat setSetting(int, String, String, String) dan dilakukan pada pengguna sistem.
void	setSetting(int userId, String namespace, String key, String value) Menambahkan nilai setelan ke namespace pengguna tertentu.
void	shutdownMicrodroid(ITestDevice microdroidDevice) Mematikan perangkat microdroid, jika ada.
boolean	startUser(int userId) Memulai pengguna tertentu di latar belakang jika saat ini dihentikan.
boolean	startUser(int userId, boolean waitFlag) Memulai pengguna tertentu di latar belakang jika saat ini dihentikan.
boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Memulai pengguna tertentu di latar belakang, yang terlihat di tampilan tertentu (yaitu, memungkinkan pengguna meluncurkan aktivitas di tampilan tersebut).
boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Menghentikan pengguna tertentu.
boolean	stopUser(int userId) Menghentikan pengguna tertentu.
boolean	supportsMicrodroid() Memeriksa prasyarat untuk menjalankan microdroid.
boolean	supportsMicrodroid(boolean protectedVm) Memeriksa prasyarat untuk menjalankan microdroid.
boolean	switchUser(int userId) Beralih ke userId lain dengan waktu tunggu default.
boolean	switchUser(int userId, long timeout) Beralih ke userId lain dengan waktu tunggu yang diberikan sebagai batas waktu.
Bugreport	takeBugreport() Ambil bugreport dan tampilkan di dalam objek Bugreport untuk menanganinya.
String	uninstallPackage(String packageName) Meng-uninstal paket Android dari perangkat.
String	uninstallPackageForUser(String packageName, int userId) Meng-uninstal paket Android dari perangkat untuk pengguna tertentu.
void	waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Metode yang dilindungi
AaptParser	createParser(File appFile)
void	doAdbReboot(NativeDevice.RebootMode rebootMode, String reason) Lakukan mulai ulang adb.
InputStreamSource	getBugreportInternal()
File	getBugreportzInternal() Metode Helper internal untuk mendapatkan file zip bugreportz sebagai ERROR(/File).
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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Menampilkan apakah diizinkan untuk beralih ke pengguna SISTEM headless.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

Mencoba menutup dialog error yang saat ini ditampilkan di UI perangkat.

Hasil
boolean	true jika tidak ada dialog atau dialog berhasil dihapus. false jika tidak.

Menampilkan
DeviceNotAvailableException

createUser

public int createUser (String name)

Buat pengguna dengan nama yang diberikan dan flag default 0.

Parameter
name	String: pengguna yang akan dibuat di perangkat

Hasil
int	bilangan bulat untuk ID pengguna yang dibuat

Menampilkan
DeviceNotAvailableException

createUser

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

Membuat pengguna dengan nama tertentu dan flag yang diberikan

Parameter
name	String: pengguna yang akan dibuat di perangkat
guest	boolean: mengaktifkan flag pengguna --guest selama pembuatan
ephemeral	boolean: mengaktifkan flag pengguna --ephemeral selama pembuatan
forTesting	boolean: mengaktifkan flag pengujian --for-testing selama pembuatan

Hasil
int	ID pengguna yang dibuat

Menampilkan
DeviceNotAvailableException

createUser

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

Membuat pengguna dengan nama tertentu dan flag yang diberikan

Parameter
name	String: pengguna yang akan dibuat di perangkat
guest	boolean: mengaktifkan flag pengguna --guest selama pembuatan
ephemeral	boolean: mengaktifkan flag pengguna --ephemeral selama pembuatan

Hasil
int	ID pengguna yang dibuat

Menampilkan
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Buat pengguna dengan nama yang diberikan dan flag default 0.

Parameter
name	String: pengguna yang akan dibuat di perangkat

Hasil
int	bilangan bulat untuk ID pengguna yang dibuat atau -1 untuk error.

Menampilkan
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Mencoba menonaktifkan kunci layar.

Pertama, tunggu pengiriman input hingga siap, hal ini terjadi pada waktu yang sama saat perangkat melaporkan BOOT_COMPLETE, tampaknya secara asinkron, karena implementasi framework saat ini memiliki kondisi perlombaan sesekali. Kemudian, perintah dikirim untuk menutup kunci layar (hanya berfungsi pada kunci layar yang tidak aman)

Menampilkan
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Metode helper untuk menentukan apakah file di perangkat ada.

Parameter
deviceFilePath	String: jalur absolut file di perangkat yang akan diperiksa

Hasil
boolean	true jika file ada, false jika tidak.

Menampilkan
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metode bantuan untuk menentukan apakah file di perangkat ada untuk pengguna tertentu.

Parameter
deviceFilePath	String: jalur absolut file di perangkat yang akan diperiksa
userId	int: ID pengguna yang akan digunakan untuk memeriksa keberadaan file

Hasil
boolean	true jika file ada, false jika tidak.

Menampilkan
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Mencoba membuang heap dari system_server. Pemanggil bertanggung jawab untuk membersihkan file yang di-dump.

Parameter
process	String: nama proses perangkat untuk dumpheap.
devicePath	String: jalur di perangkat tempat dump akan ditempatkan. Lokasi ini harus berupa lokasi tempat izin mengizinkannya.

Hasil
File	ERROR(/File) yang berisi laporan. Null jika ada yang gagal.

Menampilkan
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Mengambil informasi tentang APEX yang diaktifkan di perangkat.

Hasil
	ERROR(/Set) dari ApexInfo saat ini diaktifkan di perangkat

Menampilkan
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Menampilkan pasangan nilai kunci dari namespace yang diminta.

Parameter
namespace	String: harus salah satu dari {"system", "secure", "global"}

Hasil
	peta pasangan nilai kunci. Null jika namespace tidak didukung.

Menampilkan
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Menemukan dan menampilkan android-id yang terkait dengan userId, null jika tidak ditemukan.

Parameter
userId	int

Hasil
String

Menampilkan
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Buat Peta ID Android yang ditemukan cocok dengan ID pengguna. Tidak ada jaminan bahwa setiap ID pengguna akan menemukan ID Android yang terkait dalam fungsi ini sehingga beberapa ID pengguna mungkin cocok dengan null.

Hasil
	Peta ID Android yang ditemukan cocok dengan ID pengguna.

Menampilkan
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Mengambil informasi tentang paket yang diinstal di perangkat.

Parameter
packageName	String

Hasil
PackageInfo	PackageInfo atau null jika informasi tidak dapat diambil

Menampilkan
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Mengambil informasi paket yang diinstal di perangkat.

Hasil
	ERROR(/List) dari PackageInfo yang diinstal di perangkat.

Menampilkan
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Mengambil laporan bug dari perangkat.

Penerapan ini dijamin akan terus berfungsi di perangkat tanpa sdcard (atau jika sdcard belum dipasang).

Hasil
InputStreamSource	InputStreamSource yang akan menghasilkan konten bugreport sesuai permintaan. Jika terjadi kegagalan, InputStreamSource akan menghasilkan ERROR(/InputStream) kosong.

getBugreportz

public InputStreamSource getBugreportz ()

Mengambil bugreportz dari perangkat. Bugreport format ZIP berisi bugreport utama dan file log lainnya yang berguna untuk proses debug.

Hanya didukung untuk 'adb version' > 1.0.36

Hasil
InputStreamSource	InputStreamSource dari file zip yang berisi bugreportz, menampilkan null jika gagal.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Menampilkan status perangkat foldable saat ini atau null jika terjadi beberapa masalah.

Hasil
DeviceFoldableState

Menampilkan
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Menampilkan ID pengguna yang sedang berjalan saat ini. Jika terjadi error, tampilkan -10000.

Hasil
int

Menampilkan
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Menampilkan daftar status perangkat foldable. Dapat diperoleh dengan "cmd device_state print-states".

Hasil

Menampilkan
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Mengambil nama paket aplikasi yang ada di perangkat.

Hasil
	ERROR(/Set) dari String nama paket yang saat ini diinstal di perangkat.

Menampilkan
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Menampilkan objek untuk mendapatkan status kunci layar saat ini atau null jika tidak didukung.

Hasil
KeyguardControllerState	KeyguardControllerState yang berisi snapshot status pelindung kunci dan menampilkan Null jika kueri Pelindung Kunci tidak didukung.

Menampilkan
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Menampilkan ID pengguna utama.

Hasil
Integer	userId pengguna utama jika ada, dan null jika tidak ada pengguna utama.

Menampilkan
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Dapatkan informasi tentang modul utama yang diinstal di perangkat.

Hasil
	ERROR(/Set) dari String modul utama yang saat ini diinstal di perangkat.

Menampilkan
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Mendapatkan jumlah maksimum pengguna yang didukung yang berjalan secara bersamaan. Default-nya adalah 0.

Hasil
int	bilangan bulat yang menunjukkan jumlah pengguna yang berjalan secara bersamaan

Menampilkan
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Mendapatkan jumlah maksimum pengguna yang didukung. Default-nya adalah 0.

Hasil
int	bilangan bulat yang menunjukkan jumlah pengguna yang didukung

Menampilkan
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Menampilkan ID pengguna utama.

Hasil
Integer	userId pengguna utama jika ada, dan null jika tidak ada pengguna utama.

Menampilkan
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

Mengambil screenshot dari perangkat.

Hasil
InputStreamSource	InputStreamSource screenshot dalam format png, atau null jika screenshot tidak berhasil.

Menampilkan
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Mengambil screenshot dari perangkat. Sebaiknya gunakan getScreenshot(String) dengan encoding JPEG untuk ukuran yang lebih kecil.

Parameter
format	String: PNG, JPEG yang didukung
rescale	boolean: apakah screenshot harus diskalakan ulang untuk mengurangi ukuran gambar yang dihasilkan

Hasil
InputStreamSource	InputStreamSource screenshot dalam format, atau null jika screenshot tidak berhasil.

Menampilkan
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Mengambil screenshot dari perangkat yang diberi ID tampilan. Formatnya adalah PNG.

TODO: memperluas implementasi di atas untuk mendukung 'format' dan 'rescale'

Parameter
displayId	long: ID tampilan layar untuk mendapatkan screenshot.

Hasil
InputStreamSource	InputStreamSource screenshot dalam format, atau null jika screenshot tidak berhasil.

Menampilkan
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

Mengambil screenshot dari perangkat. Sebaiknya gunakan getScreenshot(format) dengan encoding JPEG untuk ukuran yang lebih kecil

Parameter
format	String: PNG, JPEG yang didukung

Hasil
InputStreamSource	InputStreamSource screenshot dalam format, atau null jika screenshot tidak berhasil.

Menampilkan
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

Lihat getSetting(int, String, String) dan dilakukan pada pengguna sistem.

Parameter
namespace	String
key	String

Hasil
String

Menampilkan
DeviceNotAvailableException

getSetting

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

Menampilkan nilai setelan yang diminta. namespace harus salah satu dari: {"system", "secure", "global"}

Parameter
userId	int
namespace	String
key	String

Hasil
String	nilai yang terkait dengan namespace:key pengguna. Null jika tidak ditemukan.

Menampilkan
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Mengambil nama paket aplikasi yang dapat diuninstal. Hal ini saat ini ditentukan sebagai paket non-sistem, dan paket sistem yang diupdate.

Hasil
	ERROR(/Set) nama paket String yang dapat di-uninstal yang saat ini diinstal di perangkat.

Menampilkan
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Menemukan dan menampilkan flag pengguna tertentu. Flag ditentukan di class "android.content.pm.UserInfo" di Project Open Source Android.

Parameter
userId	int

Hasil
int	flag yang terkait dengan userId yang diberikan jika ditemukan, -10000 dalam kasus lain.

Menampilkan
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

Mendapatkan Peta useId ke UserInfo di perangkat. Akan menampilkan DeviceRuntimeException jika output dari perangkat tidak seperti yang diharapkan.

Hasil
	daftar objek UserInfo.

Menampilkan
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Menampilkan nomor seri yang terkait dengan userId jika ditemukan, -10000 dalam kasus lain.

Parameter
userId	int

Hasil
int

Menampilkan
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

Memeriksa apakah fitur tersedia di perangkat.

Parameter
feature	String: format yang harus berupa "feature:" atau "" secara langsung.

Hasil
boolean	Benar jika fitur ditemukan, salah jika tidak.

Menampilkan
DeviceNotAvailableException

installPackage

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

Menginstal paket Android di perangkat.

Parameter
packageFile	File: file apk yang akan diinstal
reinstall	boolean: true jika penginstalan ulang harus dilakukan
extraArgs	String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.

Hasil
String	String dengan kode error, atau null jika berhasil.

Menampilkan
DeviceNotAvailableException

installPackage

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

Menginstal paket Android di perangkat.

Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime pada waktu penginstalan yang harus memanggil fungsi ini.

Parameter
packageFile	File: file apk yang akan diinstal
reinstall	boolean: true jika penginstalan ulang harus dilakukan
grantPermissions	boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
extraArgs	String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.

Hasil
String	String dengan kode error, atau null jika berhasil.

Menampilkan
DeviceNotAvailableException

installPackage

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

Menginstal paket Android di perangkat.

Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime pada waktu penginstalan yang harus memanggil fungsi ini.

Parameter
packageFile	File: file apk yang akan diinstal
certFile	File: true jika penginstalan ulang harus dilakukan
reinstall	boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
extraArgs	String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.

Hasil
String	String dengan kode error, atau null jika berhasil.

Menampilkan
DeviceNotAvailableException

installPackageForUser

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

Menginstal paket Android di perangkat untuk pengguna tertentu.

Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime pada waktu penginstalan yang harus memanggil fungsi ini.

Parameter
packageFile	File: file apk yang akan diinstal
reinstall	boolean: true jika penginstalan ulang harus dilakukan
grantPermissions	boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
userId	int: ID pengguna bilangan bulat yang akan diinstal.
extraArgs	String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.

Hasil
String	String dengan kode error, atau null jika berhasil.

Menampilkan
DeviceNotAvailableException

installPackageForUser

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

Menginstal paket Android di perangkat untuk pengguna tertentu.

Parameter
packageFile	File: file apk yang akan diinstal
reinstall	boolean: true jika penginstalan ulang harus dilakukan
userId	int: ID pengguna bilangan bulat yang akan diinstal.
extraArgs	String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.

Hasil
String	String dengan kode error, atau null jika berhasil.

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, 
                String... extraArgs)

Parameter
remoteApkPaths
reinstall	boolean
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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Memeriksa apakah platform di perangkat mendukung enumerasi aplikasi

Hasil
boolean	Benar jika enumerasi aplikasi didukung, salah jika tidak

Menampilkan
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Menampilkan apakah pengguna utama adalah admin permanen dan tidak dapat dihapus atau diturunkan statusnya menjadi non-admin.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

Menentukan apakah multi-pengguna didukung.

Hasil
boolean	true jika multi-pengguna didukung, false jika tidak

Menampilkan
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Buat kueri perangkat untuk nama paket tertentu guna memeriksa apakah paket tersebut saat ini diinstal atau tidak.

Parameter
packageName	String

Hasil
boolean	Benar jika paket dilaporkan sebagai diinstal. Salah jika tidak.

Menampilkan
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Buat kueri perangkat untuk nama paket tertentu dan ID pengguna tertentu untuk memeriksa apakah saat ini diinstal atau tidak untuk pengguna tersebut.

Parameter
packageName	String: paket yang kita periksa apakah sudah diinstal.
userId	String: ID pengguna yang paketnya sedang kita periksa. Jika null, pengguna utama nol akan digunakan.

Hasil
boolean	Benar jika paket dilaporkan sebagai diinstal. Salah jika tidak.

Menampilkan
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Periksa apakah pengguna tertentu sedang berjalan.

Parameter
userId	int

Hasil
boolean	Benar jika pengguna sedang berjalan, salah dalam kasus lainnya.

Menampilkan
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

Menampilkan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan tandanya.

Parameter
userId	int

Hasil
boolean	true jika pengguna adalah sekunder, false jika tidak.

Menampilkan
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

Memeriksa apakah pengguna tertentu terlihat.

Pengguna "terlihat" adalah pengguna yang berinteraksi dengan pengguna "manusia" sehingga dapat meluncurkan aktivitas peluncuran (biasanya di tampilan default).

Parameter
userId	int

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.

Pengguna "terlihat" adalah pengguna yang berinteraksi dengan pengguna "manusia" sehingga dapat meluncurkan aktivitas peluncuran di layar tersebut.

Parameter
userId	int
displayId	int

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Menampilkan apakah perangkat mengizinkan pengguna dimulai dan terlihat di latar belakang di ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Jika ya, Anda dapat memanggil startVisibleBackgroundUser(int, int, boolean), yang meneruskan tampilan yang ditampilkan oleh listDisplayIdsForStartingVisibleBackgroundUsers() (yang harus menyertakan ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Menampilkan apakah perangkat mengizinkan pengguna dimulai dan terlihat di latar belakang.

Jika ya, Anda dapat memanggil startVisibleBackgroundUser(int, int, boolean), yang meneruskan tampilan yang ditampilkan oleh listDisplayIdsForStartingVisibleBackgroundUsers().

Hasil
boolean

Menampilkan
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

Kumpulkan daftar ID layar yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys SurfaceFlinger".

Hasil
	Daftar layar. Default selalu menampilkan tampilan default 0.

Menampilkan
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Mendapatkan daftar layar yang dapat digunakan untuk start a user visible in the background.

Hasil

Menampilkan
DeviceNotAvailableException

listUsers

public  listUsers ()

Mendapatkan daftar pengguna di perangkat. Akan menampilkan DeviceRuntimeException jika output dari perangkat tidak seperti yang diharapkan.

Hasil
	daftar ID pengguna.

Menampilkan
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Metode bantuan untuk mengambil laporan bug dan mencatatnya ke pelapor.

Parameter
dataName	String: nama yang digunakan untuk melaporkan bugreport.
listener	ITestLogger: ITestLogger untuk mencatat bugreport ke dalam log.

Hasil
boolean	Benar jika logging berhasil, salah jika tidak.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Parameter
waitPhase	SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan selesai.

Parameter
exception	Throwable: jika ada, pengecualian akhir yang ditampilkan oleh kegagalan pemanggilan.

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Hapus admin perangkat tertentu di pengguna tertentu dan tampilkan true jika berhasil, false jika tidak.

Parameter
componentName	String: admin perangkat yang akan dihapus.
userId	int: pengguna yang menjadi tempat tinggal admin perangkat.

Hasil
boolean	Benar jika berhasil, salah jika tidak.

Menampilkan
DeviceNotAvailableException

removeOwners

public void removeOwners ()

Menghapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

Menampilkan
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Menghapus pengguna tertentu dari perangkat.

Parameter
userId	int: pengguna yang akan dihapus

Hasil
boolean	benar jika kita berhasil menghapus pengguna, salah jika tidak.

Menampilkan
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Menetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.

Parameter
componentName	String: admin perangkat menjadi pemilik perangkat.
userId	int: pengguna tempat pemilik perangkat tinggal.

Hasil
boolean	Benar jika berhasil, salah jika tidak.

Menampilkan
DeviceNotAvailableException

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

Lihat setSetting(int, String, String, String) dan dilakukan pada pengguna sistem.

Parameter
namespace	String
key	String
value	String

Menampilkan
DeviceNotAvailableException

setSetting

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

Menambahkan nilai setelan ke namespace pengguna tertentu. Beberapa setelan hanya akan tersedia setelah mulai ulang. namespace harus salah satu dari: {"system", "secure", "global"}

Parameter
userId	int
namespace	String
key	String
value	String

Menampilkan
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Mematikan perangkat microdroid, jika ada.

Parameter
microdroidDevice	ITestDevice

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

Memulai pengguna tertentu di latar belakang jika saat ini dihentikan. Jika pengguna sudah berjalan di latar belakang, metode ini adalah NOOP.

Parameter
userId	int: pengguna untuk memulai di latar belakang

Hasil
boolean	benar jika pengguna berhasil dimulai di latar belakang.

Menampilkan
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Memulai pengguna tertentu di latar belakang jika saat ini dihentikan. Jika pengguna sudah berjalan di latar belakang, metode ini adalah NOOP. Dapat memberikan flag tambahan untuk menunggu operasi diterapkan.

Parameter
userId	int: pengguna untuk memulai di latar belakang
waitFlag	boolean: akan membuat perintah menunggu hingga pengguna dimulai dan dibuka kuncinya.

Hasil
boolean	benar jika pengguna berhasil dimulai di latar belakang.

Menampilkan
DeviceNotAvailableException

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Memulai pengguna tertentu di latar belakang, yang terlihat di tampilan tertentu (yaitu, memungkinkan pengguna meluncurkan aktivitas di tampilan tersebut).

CATATAN: perintah ini tidak memeriksa apakah pengguna ada, tampilan tersedia, device supports such feature, dll.

Parameter
userId	int: pengguna untuk memulai di latar belakang
displayId	int: tampilan untuk memulai pengguna yang terlihat di
waitFlag	boolean: akan membuat perintah menunggu hingga pengguna dimulai dan dibuka kuncinya.

Hasil
boolean	true jika pengguna berhasil dimulai dan terlihat di latar belakang.

Menampilkan
DeviceNotAvailableException

stopUser

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

Menghentikan pengguna tertentu. Dapat memberikan flag tambahan untuk menunggu operasi diterapkan, dan memaksa pengguna untuk berhenti. Tidak dapat menghentikan pengguna saat ini dan sistem.

Parameter
userId	int: pengguna yang akan dihentikan.
waitFlag	boolean: akan membuat perintah menunggu hingga pengguna dihentikan.
forceFlag	boolean: akan memaksa pengguna berhenti.

Hasil
boolean	benar jika pengguna berhasil dihentikan.

Menampilkan
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

Menghentikan pengguna tertentu. Jika pengguna sudah dihentikan, metode ini adalah NOOP. Tidak dapat menghentikan pengguna saat ini dan sistem.

Parameter
userId	int: pengguna yang akan dihentikan.

Hasil
boolean	benar jika pengguna berhasil dihentikan.

Menampilkan
DeviceNotAvailableException

supportsMicrodroid

public boolean supportsMicrodroid ()

Memeriksa prasyarat untuk menjalankan microdroid.

Hasil
boolean	menampilkan nilai benar jika prasyarat terpenuhi, salah jika tidak.

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Memeriksa prasyarat untuk menjalankan microdroid.

Parameter
protectedVm	boolean: benar jika microdroid dimaksudkan untuk berjalan di VM yang dilindungi.

Hasil
boolean	menampilkan nilai benar jika prasyarat terpenuhi, salah jika tidak.

switchUser

public boolean switchUser (int userId)

Beralih ke userId lain dengan waktu tunggu default. switchUser(int, long).

Parameter
userId	int

Hasil
boolean	Benar jika userId baru cocok dengan penyedia userId. Salah jika tidak.

Menampilkan
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

Beralih ke userId lain dengan waktu tunggu yang diberikan sebagai batas waktu. Mencoba menonaktifkan kunci layar setelah perubahan pengguna berhasil.

Parameter
userId	int
timeout	long: untuk menunggu sebelum menampilkan salah karena gagal beralih pengguna.

Hasil
boolean	Benar jika userId baru cocok dengan penyedia userId. Salah jika tidak.

Menampilkan
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

Ambil bugreport dan tampilkan di dalam objek Bugreport untuk menanganinya. Menampilkan null jika terjadi masalah. File yang dirujuk dalam objek Bugreport perlu dihapus melalui Bugreport.close().

Hasil
Bugreport

uninstallPackage

public String uninstallPackage (String packageName)

Meng-uninstal paket Android dari perangkat.

Parameter
packageName	String: paket Android yang akan di-uninstal

Hasil
String	String dengan kode error, atau null jika berhasil.

Menampilkan
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Meng-uninstal paket Android dari perangkat untuk pengguna tertentu.

Parameter
packageName	String: paket Android yang akan di-uninstal
userId	int: ID pengguna bilangan bulat yang akan di-uninstal.

Hasil
String	String dengan kode error, atau null jika berhasil.

Menampilkan
DeviceNotAvailableException

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Parameter
currentPhase	SnapuserdWaitPhase

Menampilkan
DeviceNotAvailableException

Metode yang dilindungi

createParser

protected AaptParser createParser (File appFile)

Parameter
appFile	File

Hasil
AaptParser

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
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Hasil
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Metode Helper internal untuk mendapatkan file zip bugreportz sebagai ERROR(/File).

Hasil
File

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