Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Menyediakan API tingkat yang andal dan sedikit lebih tinggi ke ddmlib IDevice .

Mencoba kembali perintah perangkat untuk jumlah yang dapat dikonfigurasi, dan menyediakan antarmuka pemulihan perangkat untuk perangkat yang tidak responsif.

Ringkasan

Kelas bersarang

class ITestDevice.ApexInfo

Kelas struct sederhana untuk menyimpan informasi tentang satu APEX

class ITestDevice.MountPointInfo

Kelas struct sederhana untuk menyimpan informasi tentang satu mountpoint

Metode publik

abstract boolean canSwitchToHeadlessSystemUser ()

Mengembalikan apakah diizinkan untuk beralih ke pengguna SISTEM tanpa kepala.

abstract boolean checkConnectivity ()

Periksa apakah perangkat memiliki konektivitas jaringan.

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

Menghapus jaringan wifi yang terakhir terhubung.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Menghubungkan ke jaringan wifi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Menghubungkan ke jaringan wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Menghubungkan ke jaringan wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Menghubungkan ke jaringan wifi.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

Varian connectToWifiNetwork(String, String) yang hanya terhubung jika perangkat saat ini tidak memiliki konektivitas jaringan.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Varian connectToWifiNetwork(String, String) yang hanya terhubung jika perangkat saat ini tidak memiliki konektivitas jaringan.

abstract int createUser (String name)

Buat pengguna dengan nama tertentu dan flag default 0.

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

Buat pengguna dengan nama tertentu dan bendera yang disediakan

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

Buat pengguna dengan nama tertentu dan bendera yang disediakan

abstract int createUserNoThrow (String name)

Buat pengguna dengan nama tertentu dan flag default 0.

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Menghapus IDeviceActionReceiver yang terdaftar.

abstract void disableKeyguard ()

Upaya untuk menonaktifkan pengaman tombol.

abstract boolean disableNetworkMonitor ()

Menonaktifkan pemantauan jaringan pada perangkat.

abstract boolean disconnectFromWifi ()

Terputus dari jaringan wifi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

Mencoba untuk membuang heap dari system_server.

abstract boolean enableNetworkMonitor ()

Mengaktifkan pemantauan jaringan pada perangkat.

abstract getActiveApexes ()

Ambil informasi tentang APEX yang diaktifkan di perangkat.

abstract getAllSettings (String namespace)

Mengembalikan pasangan nilai kunci dari namespace yang diminta.

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

Buat Peta id android yang ditemukan cocok dengan id pengguna.

abstract PackageInfo getAppPackageInfo (String packageName)

Ambil informasi tentang paket yang diinstal pada perangkat.

abstract getAppPackageInfos ()

Ambil informasi paket yang diinstal pada perangkat.

abstract InputStreamSource getBugreport ()

Mengambil laporan bug dari perangkat.

abstract InputStreamSource getBugreportz ()

Mengambil laporan bug dari perangkat.

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

Kembalikan id dari pengguna yang sedang berjalan.

abstract getFoldableStates ()

Mengembalikan daftar status foldable pada perangkat.

abstract getInstalledPackageNames ()

Ambil nama paket aplikasi yang ada di perangkat.

abstract String getIpAddress ()

Mendapatkan alamat IP perangkat.

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

Mengembalikan id pengguna utama.

abstract getMainlineModuleInfo ()

Dapatkan informasi tentang modul jalur utama yang terpasang di perangkat.

abstract int getMaxNumberOfRunningUsersSupported ()

Dapatkan jumlah maksimum pengguna yang didukung secara bersamaan.

abstract int getMaxNumberOfUsersSupported ()

Dapatkan jumlah maksimum pengguna yang didukung.

abstract TestDeviceOptions getOptions ()

Ambil opsi pengujian untuk perangkat.

abstract Integer getPrimaryUserId ()

Mengembalikan id pengguna utama.

abstract InputStreamSource getScreenshot ()

Mengambil tangkapan layar dari perangkat.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Mengambil tangkapan layar dari perangkat.

abstract InputStreamSource getScreenshot (String format)

Mengambil tangkapan layar dari perangkat.

abstract InputStreamSource getScreenshot (long displayId)

Mengambil tangkapan layar dari perangkat yang diberi id tampilan.

abstract String getSetting (String namespace, String key)

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

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

Mengembalikan nilai setelan yang diminta.

abstract getUninstallablePackageNames ()

Ambil nama paket aplikasi yang dapat dihapus instalasinya.

abstract int getUserFlags (int userId)

Temukan dan kembalikan flag dari pengguna tertentu.

abstract getUserInfos ()

Mendapatkan Peta useId ke UserInfo di perangkat.

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

Periksa apakah fitur tersedia di perangkat.

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

Instal paket Android di perangkat.

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

Instal paket Android di perangkat.

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

Instal paket Android di perangkat untuk pengguna tertentu.

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

Instal paket Android di perangkat untuk pengguna tertentu.

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan tambahan).

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra) yang ada di perangkat android.

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket terpisah utama dan tambahan) untuk pengguna tertentu.

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket terpisah utama dan tambahan) untuk pengguna tertentu.

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra) yang ada di perangkat android.

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra) yang ada di perangkat android.

abstract boolean isHeadlessSystemUserMode ()

Mengembalikan apakah perangkat menggunakan mode pengguna sistem tanpa kepala.

abstract boolean isMainUserPermanentAdmin ()

Mengembalikan apakah pengguna utama adalah admin permanen dan tidak dapat dihapus atau diturunkan ke status non-admin.

abstract boolean isMultiUserSupported ()

Menentukan apakah multi-pengguna didukung.

abstract boolean isPackageInstalled (String packageName)

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

abstract 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.

abstract boolean isUserRunning (int userId)

Periksa apakah pengguna tertentu sedang berjalan.

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

Memeriksa apakah pengguna tertentu terlihat.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Mengembalikan apakah perangkat mengizinkan pengguna untuk mulai terlihat di latar belakang di ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

abstract boolean isVisibleBackgroundUsersSupported ()

Mengembalikan apakah perangkat mengizinkan pengguna untuk mulai terlihat di latar belakang.

abstract boolean isWifiEnabled ()

Uji apakah wifi diaktifkan.

abstract listDisplayIds ()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract listUsers ()

Mendapatkan daftar pengguna di perangkat.

abstract boolean logBugreport (String dataName, ITestLogger listener)

Metode pembantu untuk mengambil laporan bug dan mencatatnya ke reporter.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Mendaftarkan IDeviceActionReceiver untuk perangkat ini.

abstract boolean removeAdmin (String componentName, int userId)

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

abstract void removeOwners ()

Hapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

abstract boolean removeUser (int userId)

Hapus pengguna tertentu dari perangkat.

abstract boolean setDeviceOwner (String componentName, int userId)

Tetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.

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

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

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

Tambahkan nilai pengaturan ke ruang nama pengguna tertentu.

abstract boolean startUser (int userId)

Memulai pengguna tertentu di latar belakang jika sedang dihentikan.

abstract boolean startUser (int userId, boolean waitFlag)

Memulai pengguna tertentu di latar belakang jika sedang dihentikan.

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

Memulai pengguna tertentu di latar belakang, terlihat di tampilan tertentu (yaitu, mengizinkan pengguna meluncurkan aktivitas di tampilan itu).

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

Hentikan pengguna tertentu.

abstract boolean stopUser (int userId)

Menghentikan pengguna tertentu.

abstract boolean switchUser (int userId)

Beralih ke userId lain dengan batas waktu default.

abstract boolean switchUser (int userId, long timeout)

Beralih ke userId lain dengan batas waktu yang disediakan sebagai tenggat waktu.

abstract Bugreport takeBugreport ()

Ambil laporan bug dan kembalikan ke dalam objek Bugreport untuk menanganinya.

abstract String uninstallPackage (String packageName)

Copot pemasangan paket Android dari perangkat.

abstract String uninstallPackageForUser (String packageName, int userId)

Copot pemasangan paket Android dari perangkat untuk pengguna tertentu.

Metode publik

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Mengembalikan apakah diizinkan untuk beralih ke pengguna SISTEM tanpa kepala.

Pengembalian
boolean

Melempar
DeviceNotAvailableException

periksa Konektivitas

public abstract boolean checkConnectivity ()

Periksa apakah perangkat memiliki konektivitas jaringan.

Pengembalian
boolean true jika perangkat memiliki koneksi jaringan yang berfungsi, false juga.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

clearErrorDialogs

public abstract 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 jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Menghapus jaringan wifi yang terakhir terhubung. Ini harus dipanggil saat memulai pemanggilan baru untuk menghindari koneksi ke jaringan wifi yang digunakan dalam pengujian sebelumnya setelah perangkat dinyalakan ulang.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Menghubungkan ke jaringan wifi.

Nyalakan wifi dan blokir hingga koneksi berhasil dibuat dengan salah satu jaringan wifi yang diberikan di peta wifiSsidToPsk. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap reboot hingga ITestDevice#disconnectFromWifi() atau ITestDevice#clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsidToPsk : Peta SSID wifi ke kata sandi.

scanSsid boolean : apakah akan memindai SSID tersembunyi untuk jaringan ini.

Pengembalian
boolean true jika terhubung ke jaringan wifi berhasil. false sebaliknya

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Menghubungkan ke jaringan wifi.

Nyalakan wifi dan blokir hingga koneksi berhasil dibuat dengan salah satu jaringan wifi yang diberikan di peta wifiSsidToPsk. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap reboot hingga ITestDevice#disconnectFromWifi() atau ITestDevice#clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsidToPsk : Peta SSID wifi ke kata sandi.

Pengembalian
boolean true jika terhubung ke jaringan wifi berhasil. false sebaliknya

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Menghubungkan ke jaringan wifi.

Nyalakan wifi dan blokir hingga koneksi berhasil dibuat ke jaringan wifi yang ditentukan. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap reboot hingga ITestDevice#disconnectFromWifi() atau ITestDevice#clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsid String : wifi ssid untuk terhubung

wifiPsk String : frasa sandi PSK atau null jika tidak terenkripsi

Pengembalian
boolean true jika terhubung ke jaringan wifi berhasil. false sebaliknya

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Menghubungkan ke jaringan wifi.

Nyalakan wifi dan blokir hingga koneksi berhasil dibuat ke jaringan wifi yang ditentukan. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap reboot hingga ITestDevice#disconnectFromWifi() atau ITestDevice#clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsid String : wifi ssid untuk terhubung

wifiPsk String : frasa sandi PSK atau null jika tidak terenkripsi

scanSsid boolean : apakah akan memindai SSID tersembunyi untuk jaringan ini.

Pengembalian
boolean true jika terhubung ke jaringan wifi berhasil. false sebaliknya

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Varian connectToWifiNetwork(String, String) yang hanya terhubung jika perangkat saat ini tidak memiliki konektivitas jaringan.

Parameter
scanSsid boolean : apakah akan memindai SSID tersembunyi untuk jaringan ini

Pengembalian
boolean true jika terhubung ke jaringan wifi berhasil. false sebaliknya

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Varian connectToWifiNetwork(String, String) yang hanya terhubung jika perangkat saat ini tidak memiliki konektivitas jaringan.

Pengembalian
boolean true jika terhubung ke jaringan wifi berhasil. false sebaliknya

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

buat pengguna

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

buat pengguna

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

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

forTesting boolean : mengaktifkan test flag --for-testing selama pembuatan

Pengembalian
int id pengguna yang dibuat

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

buat pengguna

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

createUserNoThrow

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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Menghapus IDeviceActionReceiver yang terdaftar.

Parameter
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver yang akan dihapus.

menonaktifkanKeyguard

public abstract 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

menonaktifkanNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Menonaktifkan pemantauan jaringan pada perangkat.

Pengembalian
boolean true jika pemantauan berhasil dinonaktifkan. false jika gagal.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Terputus dari jaringan wifi.

Menghapus semua jaringan dari daftar jaringan yang dikenal dan menonaktifkan wifi.

Pengembalian
boolean true jika terputus dari jaringan wifi berhasil. false jika pemutusan gagal.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

doesFileExist

public abstract 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 jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

dumpHeap

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

aktifkanNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Mengaktifkan pemantauan jaringan pada perangkat.

Pengembalian
boolean true jika pemantauan berhasil diaktifkan. false jika gagal.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getActiveApexes

public abstract  getActiveApexes ()

Ambil informasi tentang APEX yang diaktifkan di perangkat.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

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

getAndroidId

public abstract String getAndroidId (int userId)

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

Parameter
userId int

Pengembalian
String

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

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

getAppPackageInfo

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

Ambil informasi paket yang diinstal pada perangkat.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBureport

public abstract InputStreamSource getBugreport ()

Mengambil laporan bug dari perangkat.

Implementasi ini dijamin untuk terus bekerja pada perangkat tanpa sdcard (atau di mana sdcard belum terpasang).

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

Mengambil laporan bug dari perangkat. Laporan bug format zip berisi laporan bug utama dan file log lain yang berguna untuk debugging.

Hanya didukung untuk 'versi adb' > 1.0.36

Pengembalian
InputStreamSource InputStreamSource dari file zip yang berisi bugreportz, kembalikan null jika terjadi kegagalan.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Pengembalian
DeviceFoldableState

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Pengembalian
int

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Pengembalian

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Ambil nama paket aplikasi yang ada di perangkat.

Pengembalian
ERROR(/Set) dari nama paket ERROR(/String) yang saat ini terinstal di perangkat.

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Mendapatkan alamat IP perangkat.

Pengembalian
String alamat IP perangkat, atau null jika perangkat tidak memiliki alamat IP

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getKeyguardState

public abstract 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 jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getMainUserId

public abstract Integer getMainUserId ()

Mengembalikan id pengguna utama.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jika output dari perangkat tidak seperti yang diharapkan.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Dapatkan informasi tentang modul jalur utama yang terpasang di perangkat.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Dapatkan jumlah maksimum pengguna yang didukung. Default ke 0.

Pengembalian
int bilangan bulat yang menunjukkan jumlah pengguna yang didukung

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Ambil opsi pengujian untuk perangkat.

Pengembalian
TestDeviceOptions TestDeviceOptions terkait dengan perangkat yang diuji.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Mengembalikan id pengguna utama.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jika output dari perangkat tidak seperti yang diharapkan.
DeviceNotAvailableException

dapatkanScreenshot

public abstract InputStreamSource getScreenshot ()

Mengambil tangkapan layar dari perangkat.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

dapatkanScreenshot

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

dapatkanScreenshot

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

dapatkanScreenshot

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parameter
namespace String

key String

Pengembalian
String

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

getUninstallablePackageNames

public abstract  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) dari nama paket ERROR(/String) yang dapat dihapus saat ini diinstal pada perangkat.

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

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

getUserInfos

public abstract  getUserInfos ()

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

Pengembalian
daftar objek UserInfo.

Melempar
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parameter
userId int

Pengembalian
int

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

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

installPackage

public abstract 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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

installPackage

public abstract 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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

instalPackageForUser

public abstract 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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

instalPackageForUser

public abstract 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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

installPackages

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra). Lihat "https://developer.android.com/studio/build/configure-apk-splits" untuk cara membagi apk ke beberapa file.

Parameter
packageFiles : file apk lokal

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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

installPackages

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra) yang ada di perangkat android. Lihat "https://developer.android.com/studio/build/configure-apk-splits" untuk cara membagi apk ke beberapa file.

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

Parameter
packageFiles : jalur file apk jarak jauh untuk 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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

installPackagesForUser

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket terpisah utama dan tambahan) untuk pengguna tertentu. Lihat "https://developer.android.com/studio/build/configure-apk-splits" untuk cara membagi apk ke beberapa file.

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

Parameter
packageFiles : file apk lokal

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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

installPackagesForUser

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket terpisah utama dan tambahan) untuk pengguna tertentu. Lihat "https://developer.android.com/studio/build/configure-apk-splits" untuk cara membagi apk ke beberapa file.

Parameter
packageFiles : file apk lokal

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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

instalRemotePackages

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra) yang ada di perangkat android. Lihat "https://developer.android.com/studio/build/configure-apk-splits" untuk cara membagi apk ke beberapa file.

Parameter
remoteApkPaths : jalur file apk jarak jauh

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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

instalRemotePackages

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

Instal aplikasi Android yang terbuat dari beberapa file APK (satu paket split utama dan ekstra) yang ada di perangkat android. Lihat "https://developer.android.com/studio/build/configure-apk-splits" untuk cara membagi apk ke beberapa file.

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

Parameter
remoteApkPaths : jalur file apk jarak jauh

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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
jika izin runtime tidak didukung oleh platform di perangkat.

adalah HeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Mengembalikan apakah perangkat menggunakan mode pengguna sistem tanpa kepala.

Pengembalian
boolean

Melempar
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Mengembalikan apakah pengguna utama adalah admin permanen dan tidak dapat dihapus atau diturunkan ke status non-admin.

Pengembalian
boolean

Melempar
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Menentukan apakah multi-pengguna didukung.

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

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

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

isPackageInstalled

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

isUserRunning

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

isUserSecondary

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

isUserVisible

public abstract boolean isUserVisible (int userId)

Memeriksa apakah pengguna tertentu terlihat.

Pengguna "terlihat" adalah pengguna yang berinteraksi dengan pengguna "manusia" dan karenanya dapat meluncurkan aktivitas peluncuran (biasanya dalam tampilan default).

Parameter
userId int

Pengembalian
boolean

Melempar
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.

Pengguna "terlihat" adalah pengguna yang berinteraksi dengan pengguna "manusia" dan karenanya dapat meluncurkan aktivitas peluncuran di tampilan tersebut.

Parameter
userId int

displayId int

Pengembalian
boolean

Melempar
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Mengembalikan apakah perangkat mengizinkan pengguna untuk mulai terlihat di latar belakang di ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

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

Pengembalian
boolean

Melempar
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Mengembalikan apakah perangkat mengizinkan pengguna untuk mulai terlihat di latar belakang.

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

Pengembalian
boolean

Melempar
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Uji apakah wifi diaktifkan.

Memeriksa apakah wifi diaktifkan di perangkat. Berguna untuk menyatakan status wifi sebelum pengujian yang seharusnya tidak dijalankan dengan wifi, misalnya pengujian data seluler.

Pengembalian
boolean true jika wifi diaktifkan. false jika dinonaktifkan

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

listDisplayIds

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Pengembalian

Melempar
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

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

Pengembalian
daftar id pengguna.

Melempar
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBureport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metode pembantu untuk mengambil laporan bug dan mencatatnya ke reporter.

Parameter
dataName String : nama di mana laporan bug akan dilaporkan.

listener ITestLogger : ITestLogger untuk mencatat laporan bug.

Pengembalian
boolean Benar jika pencatatan berhasil, salah jika sebaliknya.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Mendaftarkan IDeviceActionReceiver untuk perangkat ini.

Semua IDeviceActionReceiver yang terdaftar akan diberi tahu sebelum tindakan perangkat dimulai dan setelah tindakan perangkat berakhir.

Parameter
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver yang akan didaftarkan.

hapusAdmin

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

hapus Pemilik

public abstract void removeOwners ()

Hapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

Melempar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hapusPengguna

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

setDeviceOwner

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

pengaturanPengaturan

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

pengaturanPengaturan

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

startUser

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

startUser

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

startVisibleBackgroundUser

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

Memulai pengguna tertentu di latar belakang, terlihat di tampilan tertentu (yaitu, mengizinkan pengguna meluncurkan aktivitas di tampilan itu).

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 terlihat

waitFlag boolean : akan membuat perintah menunggu sampai pengguna dimulai dan dibuka kuncinya.

Pengembalian
boolean true jika pengguna berhasil mulai terlihat di latar belakang.

Melempar
DeviceNotAvailableException

stopUser

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

stopUser

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

switchUser

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

switchUser

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

takeBureport

public abstract Bugreport takeBugreport ()

Ambil laporan bug dan kembalikan ke dalam objek Bugreport untuk menanganinya. Kembalikan null jika ada masalah. File yang direferensikan dalam objek Bugreport perlu dibersihkan melalui Bugreport.close() .

Pengembalian
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Copot pemasangan paket Android dari perangkat.

Parameter
packageName String : paket Android yang akan di-uninstall

Pengembalian
String sebuah ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

uninstallPackageForUser

public abstract 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 ERROR(/String) dengan kode kesalahan, atau null jika berhasil.

Melempar
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.