ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Memberikan API level yang andal dan sedikit lebih tinggi ke IDevice ddmlib.

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

Ringkasan

Class bertingkat

class ITestDevice.ApexInfo

Class struct sederhana untuk menyimpan informasi tentang satu APEX 

class ITestDevice.MountPointInfo

Class struct sederhana untuk menyimpan informasi tentang satu titik pemasangan 

Metode publik

abstract boolean canSwitchToHeadlessSystemUser()

Menampilkan apakah diizinkan untuk beralih ke pengguna SISTEM headless.

abstract boolean checkConnectivity()

Pastikan perangkat memiliki konektivitas jaringan.

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

Menghapus jaringan Wi-Fi terakhir yang terhubung.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Menghubungkan ke jaringan Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Menghubungkan ke jaringan Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Menghubungkan ke jaringan Wi-Fi.

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

Menghubungkan ke jaringan Wi-Fi.

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 yang diberikan dan flag default 0.

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

Membuat pengguna dengan nama tertentu dan flag yang diberikan

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

Membuat pengguna dengan nama tertentu dan flag yang diberikan

abstract int createUserNoThrow(String name)

Buat pengguna dengan nama yang diberikan dan flag default 0.

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Menghapus IDeviceActionReceiver terdaftar.

abstract void disableKeyguard()

Mencoba menonaktifkan kunci layar.

abstract boolean disableNetworkMonitor()

Menonaktifkan pemantauan jaringan di perangkat.

abstract boolean disconnectFromWifi()

Memutuskan koneksi dari jaringan Wi-Fi.

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

Mencoba membuang heap dari system_server.

abstract boolean enableNetworkMonitor()

Mengaktifkan pemantauan jaringan di perangkat.

abstract getActiveApexes()

Mengambil informasi tentang APEX yang diaktifkan di perangkat.

abstract getAllSettings(String namespace)

Menampilkan pasangan nilai kunci dari namespace yang diminta.

abstract String getAndroidId(int userId)

Menemukan dan menampilkan 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)

Mengambil informasi tentang paket yang diinstal di perangkat.

abstract getAppPackageInfos()

Mengambil informasi paket yang diinstal di perangkat.

abstract InputStreamSource getBugreport()

Mengambil laporan bug dari perangkat.

abstract InputStreamSource getBugreportz()

Mengambil bugreportz dari perangkat.

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

Menampilkan ID pengguna yang sedang berjalan saat ini.

abstract getFoldableStates()

Menampilkan daftar status perangkat foldable.

abstract getInstalledPackageNames()

Mengambil nama paket aplikasi yang ada di perangkat.

abstract String getIpAddress()

Mendapatkan alamat IP perangkat.

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

Menampilkan ID pengguna utama.

abstract getMainlineModuleInfo()

Dapatkan informasi tentang modul utama yang diinstal di perangkat.

abstract int getMaxNumberOfRunningUsersSupported()

Mendapatkan jumlah maksimum pengguna yang didukung yang berjalan secara bersamaan.

abstract int getMaxNumberOfUsersSupported()

Mendapatkan jumlah maksimum pengguna yang didukung.

abstract TestDeviceOptions getOptions()

Mengambil opsi pengujian untuk perangkat.

abstract Integer getPrimaryUserId()

Metode ini tidak digunakan lagi. getPrimaryUser tidak digunakan lagi dari layanan UserManager, gunakan ERROR(/android.os.UserManager#getMainUserId()) untuk mendapatkan pengguna penuh pertama atau 0 untuk sistem. Perhatikan bahwa untuk sistem headless, ini bukan pengguna penuh.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Mengambil screenshot dari perangkat.

abstract InputStreamSource getScreenshot(long displayId)

Mengambil screenshot dari perangkat yang diberi ID tampilan.

abstract InputStreamSource getScreenshot(String format)

Mengambil screenshot dari perangkat.

abstract InputStreamSource getScreenshot()

Mengambil screenshot dari perangkat.

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

Menampilkan nilai setelan yang diminta.

abstract String getSetting(String namespace, String key)

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

abstract getUninstallablePackageNames()

Mengambil nama paket aplikasi yang dapat diuninstal.

abstract int getUserFlags(int userId)

Menemukan dan menampilkan flag pengguna tertentu.

abstract getUserInfos()

Mendapatkan Peta useId ke UserInfo di perangkat.

abstract int getUserSerialNumber(int userId)

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

abstract boolean hasFeature(String feature)

Memeriksa apakah fitur tersedia di perangkat.

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

Menginstal paket Android di perangkat.

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

Menginstal paket Android di perangkat.

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

Menginstal paket Android di perangkat untuk pengguna tertentu.

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

Menginstal paket Android di perangkat untuk pengguna tertentu.

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

Menginstal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan).

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

Instal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) yang berada di perangkat Android.

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

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

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

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

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

Instal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) yang berada di perangkat Android.

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

Instal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) yang berada di perangkat Android.

abstract boolean isHeadlessSystemUserMode()

Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

Menentukan apakah multi-pengguna didukung.

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

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

abstract boolean isUserRunning(int userId)

Periksa apakah pengguna tertentu sedang berjalan.

abstract boolean isUserSecondary(int userId)

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

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()

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

Uji apakah Wi-Fi diaktifkan.

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Mendapatkan daftar layar 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 bantuan untuk mengambil laporan bug dan mencatatnya ke pelapor.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Memberi tahu perangkat untuk menunggu penyelesaian snapuserd.

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 tampilkan true jika berhasil, false jika tidak.

abstract void removeOwners()

Menghapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

abstract boolean removeUser(int userId)

Menghapus pengguna tertentu dari perangkat.

abstract boolean setDeviceOwner(String componentName, int userId)

Menetapkan 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)

Menambahkan nilai setelan ke namespace pengguna tertentu.

abstract boolean startUser(int userId)

Memulai pengguna tertentu di latar belakang jika saat ini dihentikan.

abstract boolean startUser(int userId, boolean waitFlag)

Memulai pengguna tertentu di latar belakang jika saat ini dihentikan.

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

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

abstract boolean stopUser(int userId)

Menghentikan pengguna tertentu.

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

Menghentikan pengguna tertentu.

abstract boolean switchUser(int userId)

Beralih ke userId lain dengan waktu tunggu default.

abstract boolean switchUser(int userId, long timeout)

Beralih ke userId lain dengan waktu tunggu yang diberikan sebagai batas waktu.

abstract Bugreport takeBugreport()

Ambil bugreport dan tampilkan di dalam objek Bugreport untuk menanganinya.

abstract String uninstallPackage(String packageName)

Meng-uninstal paket Android dari perangkat.

abstract String uninstallPackageForUser(String packageName, int userId)

Meng-uninstal paket Android dari perangkat untuk pengguna tertentu.

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Jika diharapkan, tunggu hingga snapuserd selesai.

Metode publik

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Menampilkan apakah diizinkan untuk beralih ke pengguna SISTEM headless.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Pastikan perangkat memiliki konektivitas jaringan.

Hasil
boolean true jika perangkat memiliki koneksi jaringan yang berfungsi, false jika tidak.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Hasil
boolean true jika tidak ada dialog atau dialog berhasil dihapus. false jika tidak.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Menghubungkan ke jaringan Wi-Fi.

Mengaktifkan Wi-Fi dan memblokir hingga koneksi berhasil dibuat dengan salah satu jaringan Wi-Fi yang diberikan di peta wifiSsidToPsk. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap mulai ulang hingga ITestDevice.disconnectFromWifi() atau ITestDevice.clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsidToPsk : Peta SSID Wi-Fi ke sandi.
Hasil
boolean true jika berhasil terhubung ke jaringan Wi-Fi. false jika tidak
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Menghubungkan ke jaringan Wi-Fi.

Mengaktifkan Wi-Fi dan memblokir hingga koneksi berhasil dibuat dengan salah satu jaringan Wi-Fi yang diberikan di peta wifiSsidToPsk. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap mulai ulang hingga ITestDevice.disconnectFromWifi() atau ITestDevice.clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsidToPsk : Peta SSID Wi-Fi ke sandi.
scanSsid boolean: apakah akan memindai SSID tersembunyi untuk jaringan ini.
Hasil
boolean true jika berhasil terhubung ke jaringan Wi-Fi. false jika tidak
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Menghubungkan ke jaringan Wi-Fi.

Mengaktifkan Wi-Fi dan memblokir hingga koneksi berhasil dibuat ke jaringan Wi-Fi yang ditentukan. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap mulai ulang hingga ITestDevice.disconnectFromWifi() atau ITestDevice.clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsid String: ssid wifi yang akan dihubungkan
wifiPsk String: Frasa sandi PSK atau null jika tidak dienkripsi
Hasil
boolean true jika berhasil terhubung ke jaringan Wi-Fi. false jika tidak
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

connectToWifiNetwork

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

Menghubungkan ke jaringan Wi-Fi.

Mengaktifkan Wi-Fi dan memblokir hingga koneksi berhasil dibuat ke jaringan Wi-Fi yang ditentukan. Setelah koneksi dibuat, instance akan mencoba memulihkan koneksi setelah setiap mulai ulang hingga ITestDevice.disconnectFromWifi() atau ITestDevice.clearLastConnectedWifiNetwork() dipanggil.

Parameter
wifiSsid String: ssid wifi yang akan dihubungkan
wifiPsk String: Frasa sandi PSK atau null jika tidak dienkripsi
scanSsid boolean: apakah akan memindai SSID tersembunyi untuk jaringan ini.
Hasil
boolean true jika berhasil terhubung ke jaringan Wi-Fi. false jika tidak
Menampilkan
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
Hasil
boolean true jika berhasil terhubung ke jaringan Wi-Fi. false jika tidak
Menampilkan
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.

Hasil
boolean true jika berhasil terhubung ke jaringan Wi-Fi. false jika tidak
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

Buat pengguna dengan nama yang diberikan dan flag default 0.

Parameter
name String: pengguna yang akan dibuat di perangkat
Hasil
int bilangan bulat untuk ID pengguna yang dibuat
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Membuat pengguna dengan nama tertentu dan flag yang diberikan

Parameter
name String: pengguna yang akan dibuat di perangkat
guest boolean: mengaktifkan flag pengguna --guest selama pembuatan
ephemeral boolean: mengaktifkan flag pengguna --ephemeral selama pembuatan
Hasil
int ID pengguna yang dibuat
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Membuat pengguna dengan nama tertentu dan flag yang diberikan

Parameter
name String: pengguna yang akan dibuat di perangkat
guest boolean: mengaktifkan flag pengguna --guest selama pembuatan
ephemeral boolean: mengaktifkan flag pengguna --ephemeral selama pembuatan
forTesting boolean: mengaktifkan flag pengujian --for-testing selama pembuatan
Hasil
int ID pengguna yang dibuat
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Buat pengguna dengan nama yang diberikan dan flag default 0.

Parameter
name String: pengguna yang akan dibuat di perangkat
Hasil
int bilangan bulat untuk ID pengguna yang dibuat atau -1 untuk error.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Menghapus IDeviceActionReceiver terdaftar.

Parameter
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver yang akan dihapus.

disableKeyguard

public abstract void disableKeyguard ()

Mencoba menonaktifkan kunci layar.

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

Menampilkan
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Menonaktifkan pemantauan jaringan di perangkat.

Hasil
boolean true jika pemantauan berhasil dinonaktifkan. false jika gagal.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Memutuskan koneksi dari jaringan Wi-Fi.

Menghapus semua jaringan dari daftar jaringan yang diketahui dan menonaktifkan Wi-Fi.

Hasil
boolean true jika berhasil terputus dari jaringan Wi-Fi. false jika pemutusan gagal.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parameter
deviceFilePath String: jalur absolut file di perangkat yang akan diperiksa
userId int: ID pengguna yang akan digunakan untuk memeriksa keberadaan file
Hasil
boolean true jika file ada, false jika tidak.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

Parameter
process String: nama proses perangkat untuk dumpheap.
devicePath String: jalur di perangkat tempat dump akan ditempatkan. Lokasi ini harus berupa lokasi tempat izin mengizinkannya.
Hasil
File ERROR(/File) yang berisi laporan. Null jika ada yang gagal.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Mengaktifkan pemantauan jaringan di perangkat.

Hasil
boolean true jika pemantauan berhasil diaktifkan. false jika gagal.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getActiveApexes

public abstract  getActiveApexes ()

Mengambil informasi tentang APEX yang diaktifkan di perangkat.

Hasil
ERROR(/Set) dari ApexInfo saat ini diaktifkan di perangkat
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Menampilkan pasangan nilai kunci dari namespace yang diminta.

Parameter
namespace String: harus salah satu dari {"system", "secure", "global"}
Hasil
peta pasangan nilai kunci. Null jika namespace tidak didukung.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Parameter
userId int

Hasil
String

Menampilkan
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 null.

Hasil
Peta ID Android yang ditemukan cocok dengan ID pengguna.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Mengambil informasi tentang paket yang diinstal di perangkat.

Parameter
packageName String

Hasil
PackageInfo PackageInfo atau null jika informasi tidak dapat diambil
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Mengambil informasi paket yang diinstal di perangkat.

Hasil
ERROR(/List) dari PackageInfo yang diinstal di perangkat.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Mengambil laporan bug dari perangkat.

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Hanya didukung untuk 'adb version' > 1.0.36

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Hasil
DeviceFoldableState

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Hasil
int

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Hasil
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Mengambil nama paket aplikasi yang ada di perangkat.

Hasil
ERROR(/Set) dari String nama paket yang saat ini diinstal di perangkat.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Mendapatkan alamat IP perangkat.

Hasil
String alamat IP perangkat, atau null jika perangkat tidak memiliki alamat IP
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Hasil
KeyguardControllerState KeyguardControllerState yang berisi snapshot status pelindung kunci dan menampilkan Null jika kueri Pelindung Kunci tidak didukung.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getMainUserId

public abstract Integer getMainUserId ()

Menampilkan ID pengguna utama.

Hasil
Integer userId pengguna utama jika ada, dan null jika tidak ada pengguna utama.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jika output dari perangkat tidak seperti yang diharapkan.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Dapatkan informasi tentang modul utama yang diinstal di perangkat.

Hasil
ERROR(/Set) dari String modul utama yang saat ini diinstal di perangkat.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Hasil
int bilangan bulat yang menunjukkan jumlah pengguna yang berjalan secara bersamaan
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

Hasil
int bilangan bulat yang menunjukkan jumlah pengguna yang didukung
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Mengambil opsi pengujian untuk perangkat.

Hasil
TestDeviceOptions TestDeviceOptions terkait dengan perangkat yang sedang diuji.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Metode ini tidak digunakan lagi.
getPrimaryUser tidak digunakan lagi dari layanan UserManager, gunakan ERROR(/android.os.UserManager#getMainUserId()) untuk mendapatkan pengguna penuh pertama atau 0 untuk sistem. Perhatikan bahwa untuk sistem headless, ini bukan pengguna penuh.

Menampilkan ID pengguna utama.

Hasil
Integer userId pengguna utama jika ada, dan null jika tidak ada pengguna utama.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jika output dari perangkat tidak seperti yang diharapkan.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parameter
format String: PNG, JPEG yang didukung
rescale boolean: apakah screenshot harus diskalakan ulang untuk mengurangi ukuran gambar yang dihasilkan
Hasil
InputStreamSource InputStreamSource screenshot dalam format, atau null jika screenshot tidak berhasil.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

Parameter
displayId long: ID tampilan layar untuk mendapatkan screenshot.
Hasil
InputStreamSource InputStreamSource screenshot dalam format, atau null jika screenshot tidak berhasil.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Parameter
format String: PNG, JPEG yang didukung
Hasil
InputStreamSource InputStreamSource screenshot dalam format, atau null jika screenshot tidak berhasil.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Mengambil screenshot dari perangkat.

Hasil
InputStreamSource InputStreamSource screenshot dalam format png, atau null jika screenshot tidak berhasil.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

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

Parameter
userId int

namespace String

key String

Hasil
String nilai yang terkait dengan namespace:key pengguna. Null jika tidak ditemukan.
Menampilkan
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

Hasil
String

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

Hasil
ERROR(/Set) nama paket String yang dapat di-uninstal yang saat ini diinstal di perangkat.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

Parameter
userId int

Hasil
int flag yang terkait dengan userId yang diberikan jika ditemukan, -10000 dalam kasus lain.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

Hasil
daftar objek UserInfo.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parameter
userId int

Hasil
int

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Memeriksa apakah fitur tersedia di perangkat.

Parameter
feature String: format yang harus berupa "feature:" atau "" secara langsung.
Hasil
boolean Benar jika fitur ditemukan, salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

Menginstal paket Android di perangkat.

Parameter
packageFile File: file apk yang akan diinstal
reinstall boolean: true jika penginstalan ulang harus dilakukan
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

installPackage

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

Menginstal paket Android di perangkat.

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

Parameter
packageFile File: file apk yang akan diinstal
reinstall boolean: true jika penginstalan ulang harus dilakukan
grantPermissions boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installPackageForUser

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

Menginstal paket Android di perangkat untuk pengguna tertentu.

Parameter
packageFile File: file apk yang akan diinstal
reinstall boolean: true jika penginstalan ulang harus dilakukan
userId int: ID pengguna bilangan bulat yang akan diinstal.
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

installPackageForUser

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

Menginstal paket Android di perangkat untuk pengguna tertentu.

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

Parameter
packageFile File: file apk yang akan diinstal
reinstall boolean: true jika penginstalan ulang harus dilakukan
grantPermissions boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
userId int: ID pengguna bilangan bulat yang akan diinstal.
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installPackages

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

Menginstal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan). Lihat "https://developer.android.com/studio/build/configure-apk-splits" tentang cara membagi APK menjadi beberapa file.

Parameter
packageFiles : file apk lokal
reinstall boolean: true jika penginstalan ulang harus dilakukan
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installPackages

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

Instal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) yang berada di perangkat Android. Lihat "https://developer.android.com/studio/build/configure-apk-splits" tentang cara membagi APK menjadi 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 yang akan diinstal
reinstall boolean: true jika penginstalan ulang harus dilakukan
grantPermissions boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installPackagesForUser

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

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

Parameter
packageFiles : file apk lokal
reinstall boolean: true jika penginstalan ulang harus dilakukan
userId int: ID pengguna bilangan bulat yang akan diinstal.
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installPackagesForUser

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

Menginstal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) untuk pengguna tertentu. Lihat "https://developer.android.com/studio/build/configure-apk-splits" tentang cara membagi apk menjadi 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 penginstalan ulang harus dilakukan
grantPermissions boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
userId int: ID pengguna bilangan bulat yang akan diinstal.
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installRemotePackages

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

Instal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) yang berada di perangkat Android. Lihat "https://developer.android.com/studio/build/configure-apk-splits" tentang cara membagi APK menjadi beberapa file.

Parameter
remoteApkPaths : jalur file apk jarak jauh
reinstall boolean: true jika penginstalan ulang harus dilakukan
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

installRemotePackages

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

Instal aplikasi Android yang terdiri dari beberapa file APK (satu paket utama dan paket terpisah tambahan) yang berada di perangkat Android. Lihat "https://developer.android.com/studio/build/configure-apk-splits" tentang cara membagi APK menjadi 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 penginstalan ulang harus dilakukan
grantPermissions boolean: apakah semua izin runtime harus diberikan pada waktu penginstalan
extraArgs String: argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi yang tersedia.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
UnsupportedOperationException jika izin runtime tidak didukung oleh platform di perangkat.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Menentukan apakah multi-pengguna didukung.

Hasil
boolean true jika multi-pengguna didukung, false jika tidak
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Parameter
packageName String: paket yang kita periksa apakah sudah diinstal.
userId String: ID pengguna yang paketnya sedang kita periksa. Jika null, pengguna utama nol akan digunakan.
Hasil
boolean Benar jika paket dilaporkan sebagai diinstal. Salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parameter
packageName String

Hasil
boolean Benar jika paket dilaporkan sebagai diinstal. Salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Periksa apakah pengguna tertentu sedang berjalan.

Parameter
userId int

Hasil
boolean Benar jika pengguna sedang berjalan, salah dalam kasus lainnya.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parameter
userId int

Hasil
boolean true jika pengguna adalah sekunder, false jika tidak.
Menampilkan
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" sehingga dapat meluncurkan aktivitas peluncuran (biasanya di tampilan default).

Parameter
userId int

Hasil
boolean

Menampilkan
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" sehingga dapat meluncurkan aktivitas peluncuran di layar tersebut.

Parameter
userId int

displayId int

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Uji apakah Wi-Fi diaktifkan.

Memeriksa apakah Wi-Fi diaktifkan di perangkat. Berguna untuk menyatakan status Wi-Fi sebelum pengujian yang tidak boleh berjalan dengan Wi-Fi, misalnya pengujian data seluler.

Hasil
boolean true jika Wi-Fi diaktifkan. false jika dinonaktifkan
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

listDisplayIds

public abstract  listDisplayIds ()

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

Hasil
Daftar layar. Default selalu menampilkan tampilan default 0.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Hasil
Menampilkan
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

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

Hasil
daftar ID pengguna.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metode bantuan untuk mengambil laporan bug dan mencatatnya ke pelapor.

Parameter
dataName String: nama yang digunakan untuk melaporkan bugreport.
listener ITestLogger: ITestLogger untuk mencatat bugreport ke dalam log.
Hasil
boolean Benar jika logging berhasil, salah jika tidak.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Memberi tahu perangkat untuk menunggu penyelesaian snapuserd.

Parameter
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Mendaftarkan IDeviceActionReceiver untuk perangkat ini.

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

Parameter
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver yang akan didaftarkan.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

Parameter
componentName String: admin perangkat yang akan dihapus.
userId int: pengguna yang menjadi tempat tinggal admin perangkat.
Hasil
boolean Benar jika berhasil, salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Menghapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Menghapus pengguna tertentu dari perangkat.

Parameter
userId int: pengguna yang akan dihapus
Hasil
boolean benar jika kita berhasil menghapus pengguna, salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Menetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.

Parameter
componentName String: admin perangkat menjadi pemilik perangkat.
userId int: pengguna tempat pemilik perangkat tinggal.
Hasil
boolean Benar jika berhasil, salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

Parameter
userId int

namespace String

key String

value String

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

Parameter
userId int: pengguna untuk memulai di latar belakang
Hasil
boolean benar jika pengguna berhasil dimulai di latar belakang.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

Parameter
userId int: pengguna untuk memulai di latar belakang
waitFlag boolean: akan membuat perintah menunggu hingga pengguna dimulai dan dibuka kuncinya.
Hasil
boolean benar jika pengguna berhasil dimulai di latar belakang.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

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

stopUser

public abstract boolean stopUser (int userId)

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

Parameter
userId int: pengguna yang akan dihentikan.
Hasil
boolean benar jika pengguna berhasil dihentikan.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

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

Parameter
userId int: pengguna yang akan dihentikan.
waitFlag boolean: akan membuat perintah menunggu hingga pengguna dihentikan.
forceFlag boolean: akan memaksa pengguna berhenti.
Hasil
boolean benar jika pengguna berhasil dihentikan.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Parameter
userId int

Hasil
boolean Benar jika userId baru cocok dengan penyedia userId. Salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Parameter
userId int

timeout long: untuk menunggu sebelum menampilkan salah karena gagal beralih pengguna.
Hasil
boolean Benar jika userId baru cocok dengan penyedia userId. Salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

Hasil
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Meng-uninstal paket Android dari perangkat.

Parameter
packageName String: paket Android yang akan di-uninstal
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Meng-uninstal paket Android dari perangkat untuk pengguna tertentu.

Parameter
packageName String: paket Android yang akan di-uninstal
userId int: ID pengguna bilangan bulat yang akan di-uninstal.
Hasil
String String dengan kode error, atau null jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Jika diharapkan, tunggu hingga snapuserd selesai.

Parameter
currentPhase SnapuserdWaitPhase

Menampilkan
DeviceNotAvailableException