TestDevice

public class TestDevice
extends NativeDevice

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

Subkelas langsung yang dikenal ManagedRemoteDevice , NestedRemoteDevice , RemoteAndroidDevice ManagedRemoteDevice Perangkat yang berjalan di dalam mesin virtual yang kami kelola dari jarak jauh melalui instance Tradefed di dalam VM. NestedRemoteDevice Representasi perangkat yang berjalan di dalam VM Cuttlefish jarak jauh. Perangkat Android Jarak Jauh Implementasi ITestDevice untuk perangkat android full stack yang terhubung melalui adb connect.

Subclass tidak langsung yang dikenal LocalAndroidVirtualDevice , RemoteAndroidVirtualDevice PerangkatVirtualAndroidLokal Kelas untuk perangkat virtual lokal yang berjalan di host TradeFed. Perangkat Virtual Android Jarak Jauh Memperluas perilaku RemoteAndroidDevice untuk perangkat android full stack yang berjalan di Google Compute Engine (Gce).

---

Implementasi ITestDevice untuk perangkat android full stack

Ringkasan

Kelas bersarang
class	TestDevice.MicrodroidBuilder Builder yang digunakan untuk membuat Microdroid TestDevice.

Bidang
public static final String	DISMISS_KEYGUARD_CMD Perintah yang dapat digunakan untuk mengabaikan keyguard.

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

Metode publik
boolean	clearErrorDialogs () Coba abaikan semua dialog kesalahan yang saat ini ditampilkan di UI perangkat.
int	createUser (String name) Buat pengguna dengan nama tertentu dan flag default 0.
int	createUser (String name, boolean guest, boolean ephemeral) Buat pengguna dengan nama tertentu dan bendera yang disediakan
int	createUserNoThrow (String name) Buat pengguna dengan nama tertentu dan flag default 0.
void	disableKeyguard () Upaya untuk menonaktifkan pengaman tombol.
boolean	doesFileExist (String deviceFilePath) Metode pembantu untuk menentukan apakah ada file di perangkat.
boolean	doesFileExist (String deviceFilePath, int userId) Metode pembantu untuk menentukan apakah file di perangkat ada untuk pengguna tertentu.
File	dumpHeap (String process, String devicePath) Mencoba untuk membuang heap dari system_server.
	getActiveApexes () Ambil informasi tentang APEX yang diaktifkan di perangkat.
	getAllSettings (String namespace) Mengembalikan pasangan nilai kunci dari namespace yang diminta.
String	getAndroidId (int userId) Temukan dan kembalikan 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) Ambil informasi tentang paket yang diinstal pada perangkat.
	getAppPackageInfos () Ambil informasi paket yang diinstal pada perangkat.
DeviceFoldableState	getCurrentFoldableState () Mengembalikan status perangkat yang dapat dilipat saat ini atau null jika terjadi beberapa masalah.
int	getCurrentUser () Kembalikan id dari pengguna yang sedang berjalan.
	getFoldableStates () Mengembalikan daftar status foldable pada perangkat.
	getInstalledPackageNames () Ambil nama paket aplikasi yang ada di perangkat.
KeyguardControllerState	getKeyguardState () Kembalikan objek untuk mendapatkan status keyguard saat ini atau null jika tidak didukung.
	getMainlineModuleInfo () Dapatkan informasi tentang modul jalur utama yang terpasang di perangkat.
int	getMaxNumberOfRunningUsersSupported () Dapatkan jumlah maksimum pengguna yang didukung secara bersamaan.
int	getMaxNumberOfUsersSupported () Dapatkan jumlah maksimum pengguna yang didukung.
Process	getMicrodroidProcess ()
Integer	getPrimaryUserId () Mengembalikan id pengguna utama.
InputStreamSource	getScreenshot () Mengambil tangkapan layar dari perangkat.
InputStreamSource	getScreenshot (String format, boolean rescale) Mengambil tangkapan layar dari perangkat.
InputStreamSource	getScreenshot (String format) Mengambil tangkapan layar dari perangkat.
InputStreamSource	getScreenshot (long displayId) Mengambil tangkapan layar dari perangkat yang diberi id tampilan.
String	getSetting (String namespace, String key) Lihat getSetting(int, String, String) dan dilakukan pada pengguna sistem.
String	getSetting (int userId, String namespace, String key) Mengembalikan nilai setelan yang diminta.
	getUninstallablePackageNames () Ambil nama paket aplikasi yang dapat dihapus instalasinya.
int	getUserFlags (int userId) Temukan dan kembalikan flag dari pengguna tertentu.
	getUserInfos () Mendapatkan Peta useId ke UserInfo di perangkat.
int	getUserSerialNumber (int userId) Kembalikan nomor seri yang terkait dengan userId jika ditemukan, -10000 dalam kasus lainnya.
boolean	hasFeature (String feature) Periksa apakah fitur tersedia di perangkat.
String	installPackage (File packageFile, boolean reinstall, String... extraArgs) Instal paket Android di perangkat.
String	installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) Instal paket Android di perangkat.
String	installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instal paket Android di perangkat.
String	installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instal paket Android di perangkat untuk pengguna tertentu.
String	installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Instal paket Android di perangkat untuk pengguna tertentu.
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 () Periksa apakah platform pada perangkat mendukung pencacahan aplikasi
boolean	isMultiUserSupported () Menentukan apakah multi-pengguna didukung.
boolean	isPackageInstalled (String packageName) Permintaan perangkat untuk nama paket yang diberikan untuk memeriksa apakah saat ini diinstal atau tidak.
boolean	isPackageInstalled (String packageName, String userId) Permintaan perangkat untuk nama paket yang diberikan dan id pengguna yang diberikan 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) Kembalikan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan benderanya.
	listDisplayIds () Kumpulkan daftar id tampilan yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys SurfaceFlinger".
	listUsers () Mendapatkan daftar pengguna di perangkat.
void	postInvocationTearDown (Throwable exception) Langkah ekstra untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan dilakukan.
boolean	removeAdmin (String componentName, int userId) Hapus admin perangkat tertentu di pengguna tertentu dan kembalikan true jika berhasil, false jika sebaliknya.
void	removeOwners () Hapus semua pemilik profil perangkat yang ada dengan upaya terbaik.
boolean	removeUser (int userId) Hapus pengguna tertentu dari perangkat.
boolean	setDeviceOwner (String componentName, int userId) Tetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.
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) Tambahkan nilai pengaturan ke ruang nama pengguna tertentu.
void	shutdownMicrodroid ( ITestDevice microdroidDevice) Mematikan perangkat microdroid, jika ada.
boolean	startUser (int userId) Memulai pengguna tertentu di latar belakang jika sedang dihentikan.
boolean	startUser (int userId, boolean waitFlag) Memulai pengguna tertentu di latar belakang jika sedang dihentikan.
boolean	stopUser (int userId, boolean waitFlag, boolean forceFlag) Hentikan 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 batas waktu default.
boolean	switchUser (int userId, long timeout) Beralih ke userId lain dengan batas waktu yang disediakan sebagai tenggat waktu.
String	uninstallPackage (String packageName) Copot pemasangan paket Android dari perangkat.
String	uninstallPackageForUser (String packageName, int userId) Copot pemasangan paket Android dari perangkat untuk pengguna tertentu.

Metode yang dilindungi
AaptParser	createParser (File appFile)
void	doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) Lakukan reboot adb.
long	getCheckNewUserSleep () Diekspos untuk pengujian.
long	getHostCurrentTime () Diekspos untuk pengujian
void	prePostBootSetup () Mengizinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) mengganti metode ini untuk penyiapan pasca boot tertentu.

Bidang

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Perintah yang dapat digunakan untuk mengabaikan keyguard.

Konstruktor publik

TestDevice

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

Metode publik

clearErrorDialogs

public boolean clearErrorDialogs ()

Coba abaikan semua dialog kesalahan yang saat ini ditampilkan di UI perangkat.

Pengembalian
boolean	true jika tidak ada dialog atau dialog berhasil dihapus. false sebaliknya.

Melempar
DeviceNotAvailableException

buat pengguna

public int createUser (String name)

Buat pengguna dengan nama tertentu dan flag default 0.

Parameter
name	String : pengguna yang akan dibuat di perangkat

Pengembalian
int	bilangan bulat untuk id pengguna yang dibuat

Melempar
DeviceNotAvailableException

buat pengguna

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

Buat pengguna dengan nama tertentu dan bendera yang disediakan

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

Pengembalian
int	id pengguna yang dibuat

Melempar
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Buat pengguna dengan nama tertentu dan flag default 0.

Parameter
name	String : pengguna yang akan dibuat di perangkat

Pengembalian
int	bilangan bulat untuk id pengguna yang dibuat atau -1 untuk kesalahan.

Melempar
DeviceNotAvailableException

menonaktifkanKeyguard

public void disableKeyguard ()

Upaya untuk menonaktifkan pengaman tombol.

Pertama tunggu pengiriman input siap, ini terjadi sekitar waktu yang sama ketika perangkat melaporkan BOOT_COMPLETE, tampaknya tidak sinkron, karena implementasi kerangka kerja saat ini memiliki kondisi balapan sesekali. Kemudian perintah dikirim untuk mengabaikan keyguard (hanya berfungsi pada yang tidak aman)

Melempar
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Metode pembantu untuk menentukan apakah ada file di perangkat.

Parameter
deviceFilePath	String : jalur absolut file pada perangkat untuk diperiksa

Pengembalian
boolean	true jika file ada, false jika tidak.

Melempar
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parameter
deviceFilePath	String : jalur absolut file pada perangkat untuk diperiksa
userId	int : ID pengguna untuk memeriksa keberadaan file

Pengembalian
boolean	true jika file ada, false jika tidak.

Melempar
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Mencoba untuk membuang heap dari system_server. Ini adalah tanggung jawab penelepon untuk membersihkan file yang dibuang.

Parameter
process	String : nama proses perangkat untuk dumpheap.
devicePath	String : jalur pada perangkat tempat membuang sampah. Ini harus menjadi lokasi di mana izin mengizinkannya.

Pengembalian
File	ERROR(/File) yang berisi laporan. Null jika sesuatu gagal.

Melempar
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Ambil informasi tentang APEX yang diaktifkan di perangkat.

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

Melempar
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Mengembalikan pasangan nilai kunci dari namespace yang diminta.

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

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

Melempar
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Temukan dan kembalikan android-id yang terkait dengan userId, null jika tidak ditemukan.

Parameter
userId	int

Pengembalian
String

Melempar
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 nol.

Pengembalian
	Peta id android ditemukan id pengguna yang cocok.

Melempar
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Ambil informasi tentang paket yang diinstal pada perangkat.

Parameter
packageName	String

Pengembalian
PackageInfo	PackageInfo atau null jika informasi tidak dapat diambil

Melempar
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Ambil informasi paket yang diinstal pada perangkat.

Pengembalian
	ERROR(/List) dari PackageInfo s diinstal pada perangkat.

Melempar
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Mengembalikan status perangkat yang dapat dilipat saat ini atau null jika terjadi beberapa masalah.

Pengembalian
DeviceFoldableState

Melempar
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Kembalikan id dari pengguna yang sedang berjalan. Jika terjadi kesalahan, kembalikan -10000.

Pengembalian
int

Melempar
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Pengembalian

Melempar
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Ambil nama paket aplikasi yang ada di perangkat.

Pengembalian
	ERROR(/Set) dari nama paket String yang saat ini diinstal pada perangkat.

Melempar
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Kembalikan objek untuk mendapatkan status keyguard saat ini atau null jika tidak didukung.

Pengembalian
KeyguardControllerState	KeyguardControllerState yang berisi snapshot status keyguard dan mengembalikan Null jika kueri Keyguard tidak didukung.

Melempar
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Dapatkan informasi tentang modul jalur utama yang terpasang di perangkat.

Pengembalian
	ERROR(/Set) dari modul jalur utama String yang saat ini diinstal pada perangkat.

Melempar
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Dapatkan jumlah maksimum pengguna yang didukung secara bersamaan. Default ke 0.

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

Melempar
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Dapatkan jumlah maksimum pengguna yang didukung. Default ke 0.

Pengembalian
int	bilangan bulat yang menunjukkan jumlah pengguna yang didukung

Melempar
DeviceNotAvailableException

getMicrodroidProcess

public Process getMicrodroidProcess ()

Pengembalian
Process	Mengembalikan Proses VM Microdroid. Jika TestDevice bukan Microdroid, kembalikan nol.

getPrimaryUserId

public Integer getPrimaryUserId ()

Mengembalikan id pengguna utama.

Pengembalian
Integer	userId dari pengguna utama jika ada, dan null jika tidak ada pengguna utama.

Melempar
DeviceNotAvailableException

dapatkanScreenshot

public InputStreamSource getScreenshot ()

Mengambil tangkapan layar dari perangkat.

Pengembalian
InputStreamSource	InputStreamSource tangkapan layar dalam format png, atau null jika tangkapan layar tidak berhasil.

Melempar
DeviceNotAvailableException

dapatkanScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Mengambil tangkapan layar dari perangkat. Disarankan untuk menggunakan getScreenshot(String) sebagai gantinya dengan pengkodean JPEG untuk ukuran yang lebih kecil.

Parameter
format	String : PNG, JPEG yang didukung
rescale	boolean : jika tangkapan layar harus diubah skalanya untuk mengurangi ukuran gambar yang dihasilkan

Pengembalian
InputStreamSource	InputStreamSource tangkapan layar dalam format, atau null jika tangkapan layar tidak berhasil.

Melempar
DeviceNotAvailableException

dapatkanScreenshot

public InputStreamSource getScreenshot (String format)

Mengambil tangkapan layar dari perangkat. Disarankan untuk menggunakan getScreenshot(format) sebagai gantinya dengan pengkodean JPEG untuk ukuran yang lebih kecil

Parameter
format	String : PNG, JPEG yang didukung

Pengembalian
InputStreamSource	InputStreamSource tangkapan layar dalam format, atau null jika tangkapan layar tidak berhasil.

Melempar
DeviceNotAvailableException

dapatkanScreenshot

public InputStreamSource getScreenshot (long displayId)

Mengambil tangkapan layar dari perangkat yang diberi id tampilan. Formatnya PNG.

TODO: perluas implementasi di atas untuk mendukung 'format' dan 'skala ulang'

Parameter
displayId	long : id tampilan layar untuk mendapatkan tangkapan layar.

Pengembalian
InputStreamSource	InputStreamSource tangkapan layar dalam format, atau null jika tangkapan layar tidak berhasil.

Melempar
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Parameter
namespace	String
key	String

Pengembalian
String

Melempar
DeviceNotAvailableException

getSetting

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

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

Parameter
userId	int
namespace	String
key	String

Pengembalian
String	nilai yang terkait dengan namespace:key dari pengguna. Batal jika tidak ditemukan.

Melempar
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Ambil nama paket aplikasi yang dapat dihapus instalasinya. Ini saat ini didefinisikan sebagai paket non-sistem, dan paket sistem yang diperbarui.

Pengembalian
	ERROR(/Set) nama paket String yang tidak dapat dihapus saat ini diinstal pada perangkat.

Melempar
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Temukan dan kembalikan flag dari pengguna tertentu. Bendera ditentukan dalam kelas "android.content.pm.UserInfo" di Android Open Source Project.

Parameter
userId	int

Pengembalian
int	bendera yang terkait dengan userId disediakan jika ditemukan, -10000 dalam kasus lainnya.

Melempar
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

Pengembalian
	daftar objek UserInfo.

Melempar
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Kembalikan nomor seri yang terkait dengan userId jika ditemukan, -10000 dalam kasus lainnya.

Parameter
userId	int

Pengembalian
int

Melempar
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

Periksa apakah fitur tersedia di perangkat.

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

Pengembalian
boolean	Benar jika fitur ditemukan, salah jika sebaliknya.

Melempar
DeviceNotAvailableException

installPackage

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

Instal paket Android di perangkat.

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

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

installPackage

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

Instal 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 instal ulang harus dilakukan
reinstall	boolean : jika semua izin runtime harus diberikan pada waktu pemasangan
extraArgs	String : argumen tambahan opsional untuk dilewati. Lihat 'adb shell pm -h' untuk opsi yang tersedia.

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

installPackage

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

Instal 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 instal ulang harus dilakukan
grantPermissions	boolean : jika semua izin runtime harus diberikan pada waktu pemasangan
extraArgs	String : argumen tambahan opsional untuk dilewati. Lihat 'adb shell pm -h' untuk opsi yang tersedia.

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

instalPackageForUser

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

Instal 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 instal ulang harus dilakukan
grantPermissions	boolean : jika semua izin runtime harus diberikan pada waktu pemasangan
userId	int : id pengguna integer untuk menginstal.
extraArgs	String : argumen tambahan opsional untuk dilewati. Lihat 'adb shell pm -h' untuk opsi yang tersedia.

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

instalPackageForUser

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

Instal paket Android di perangkat untuk pengguna tertentu.

Parameter
packageFile	File : file apk yang akan diinstal
reinstall	boolean : true jika instal ulang harus dilakukan
userId	int : id pengguna integer untuk menginstal.
extraArgs	String : argumen tambahan opsional untuk dilewati. Lihat 'adb shell pm -h' untuk opsi yang tersedia.

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

installPackages

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

Parameter
packageFiles
reinstall	boolean
extraArgs	String

Pengembalian
String

Melempar
DeviceNotAvailableException

installPackages

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

Parameter
packageFiles
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Pengembalian
String

Melempar
DeviceNotAvailableException

installPackagesForUser

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

Parameter
packageFiles
reinstall	boolean
grantPermissions	boolean
userId	int
extraArgs	String

Pengembalian
String

Melempar
DeviceNotAvailableException

installPackagesForUser

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

Parameter
packageFiles
reinstall	boolean
userId	int
extraArgs	String

Pengembalian
String

Melempar
DeviceNotAvailableException

instalRemotePackages

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

Parameter
remoteApkPaths
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Pengembalian
String

Melempar
DeviceNotAvailableException

instalRemotePackages

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

Parameter
remoteApkPaths
reinstall	boolean
extraArgs	String

Pengembalian
String

Melempar
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Periksa apakah platform pada perangkat mendukung pencacahan aplikasi

Pengembalian
boolean	Benar jika pencacahan aplikasi didukung, salah jika sebaliknya

Melempar
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

Menentukan apakah multi-pengguna didukung.

Pengembalian
boolean	benar jika multi-pengguna didukung, salah jika tidak

Melempar
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Permintaan perangkat untuk nama paket yang diberikan untuk memeriksa apakah saat ini diinstal atau tidak.

Parameter
packageName	String

Pengembalian
boolean	Benar jika paket dilaporkan telah diinstal. Salah sebaliknya.

Melempar
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Permintaan perangkat untuk nama paket yang diberikan dan id pengguna yang diberikan untuk memeriksa apakah saat ini diinstal atau tidak untuk pengguna tersebut.

Parameter
packageName	String : paket yang kita periksa apakah sudah terpasang.
userId	String : Id pengguna yang kami periksa untuk paket terinstal. Jika nol, nol pengguna utama akan digunakan.

Pengembalian
boolean	Benar jika paket dilaporkan telah diinstal. Salah sebaliknya.

Melempar
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Periksa apakah pengguna tertentu sedang berjalan.

Parameter
userId	int

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

Melempar
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

Kembalikan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan benderanya.

Parameter
userId	int

Pengembalian
boolean	benar jika pengguna sekunder, salah jika sebaliknya.

Melempar
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

Kumpulkan daftar id tampilan yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys SurfaceFlinger".

Pengembalian
	Daftar tampilan. Default selalu mengembalikan tampilan default 0.

Melempar
DeviceNotAvailableException

listUsers

public  listUsers ()

Mendapatkan daftar pengguna di perangkat. Akan membuang DeviceRuntimeException jika keluaran dari perangkat tidak seperti yang diharapkan.

Pengembalian
	daftar id pengguna.

Melempar
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Langkah ekstra untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan dilakukan.

Parameter
exception	Throwable : jika ada, pengecualian terakhir yang diajukan oleh kegagalan pemanggilan.

hapusAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Hapus admin perangkat tertentu di pengguna tertentu dan kembalikan true jika berhasil, false jika sebaliknya.

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

Pengembalian
boolean	Benar jika berhasil, salah jika sebaliknya.

Melempar
DeviceNotAvailableException

hapus Pemilik

public void removeOwners ()

Hapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

Melempar
DeviceNotAvailableException

hapusPengguna

public boolean removeUser (int userId)

Hapus pengguna tertentu dari perangkat.

Parameter
userId	int : pengguna yang akan dihapus

Pengembalian
boolean	benar jika kami berhasil menghapus pengguna, salah jika sebaliknya.

Melempar
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Tetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.

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

Pengembalian
boolean	Benar jika berhasil, salah jika sebaliknya.

Melempar
DeviceNotAvailableException

pengaturanPengaturan

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

Melempar
DeviceNotAvailableException

pengaturanPengaturan

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

Tambahkan nilai pengaturan ke ruang nama pengguna tertentu. Beberapa pengaturan hanya akan tersedia setelah reboot. namespace harus salah satu dari: {"system", "secure", "global"}

Parameter
userId	int
namespace	String
key	String
value	String

Melempar
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Mematikan perangkat microdroid, jika ada.

Parameter
microdroidDevice	ITestDevice

Melempar
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

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

Parameter
userId	int : pengguna untuk memulai di latar belakang

Pengembalian
boolean	benar jika pengguna berhasil memulai di latar belakang.

Melempar
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Memulai pengguna tertentu di latar belakang jika sedang dihentikan. Jika pengguna sudah berjalan di latar belakang, metode ini adalah NOOP. Kemungkinan untuk memberikan bendera tambahan untuk menunggu operasi berlaku.

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

Pengembalian
boolean	benar jika pengguna berhasil memulai di latar belakang.

Melempar
DeviceNotAvailableException

stopUser

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

Hentikan pengguna tertentu. Kemungkinan untuk memberikan tanda tambahan untuk menunggu operasi memiliki efek, dan menghentikan paksa pengguna. Tidak dapat menghentikan pengguna saat ini dan sistem.

Parameter
userId	int : dari pengguna untuk berhenti.
waitFlag	boolean : akan membuat perintah menunggu sampai pengguna dihentikan.
forceFlag	boolean : akan memaksa menghentikan pengguna.

Pengembalian
boolean	benar jika pengguna berhasil dihentikan.

Melempar
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

Parameter
userId	int : dari pengguna untuk berhenti.

Pengembalian
boolean	benar jika pengguna berhasil dihentikan.

Melempar
DeviceNotAvailableException

mendukungMicrodroid

public boolean supportsMicrodroid ()

Memeriksa prasyarat untuk menjalankan microdroid.

Pengembalian
boolean	mengembalikan nilai true jika prasyarat terpenuhi, false jika tidak.

mendukungMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Memeriksa prasyarat untuk menjalankan microdroid.

Parameter
protectedVm	boolean : true jika microdroid dimaksudkan untuk dijalankan pada VM yang dilindungi.

Pengembalian
boolean	mengembalikan nilai true jika prasyarat terpenuhi, false jika tidak.

switchUser

public boolean switchUser (int userId)

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

Parameter
userId	int

Pengembalian
boolean	Benar jika userId baru cocok dengan penyedia userId. Salah sebaliknya.

Melempar
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

Beralih ke userId lain dengan batas waktu yang disediakan sebagai tenggat waktu. Coba nonaktifkan pengaman kunci setelah perubahan pengguna berhasil.

Parameter
userId	int
timeout	long : untuk menunggu sebelum mengembalikan false untuk switch-user gagal.

Pengembalian
boolean	Benar jika userId baru cocok dengan penyedia userId. Salah sebaliknya.

Melempar
DeviceNotAvailableException

uninstallPackage

public String uninstallPackage (String packageName)

Copot pemasangan paket Android dari perangkat.

Parameter
packageName	String : paket Android yang akan di-uninstall

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Copot pemasangan paket Android dari perangkat untuk pengguna tertentu.

Parameter
packageName	String : paket Android yang akan di-uninstall
userId	int : id pengguna bilangan bulat yang akan dihapus instalannya.

Pengembalian
String	sebuah String dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException

Metode yang dilindungi

buatParser

protected AaptParser createParser (File appFile)

Parameter
appFile	File

Pengembalian
AaptParser

doAdbReboot

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

Lakukan reboot adb.

Parameter
rebootMode	NativeDevice.RebootMode : mode reboot ini.
reason	String : untuk reboot ini.

Melempar
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Diekspos untuk pengujian.

Pengembalian
long

getHostCurrentTime

protected long getHostCurrentTime ()

Diekspos untuk pengujian

Pengembalian
long

prePostBootSetup

protected void prePostBootSetup ()

Mengizinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) mengganti metode ini untuk penyiapan pasca boot tertentu.

Melempar
DeviceNotAvailableException