TestDevice
public
class
TestDevice
extends NativeDevice
Subclass langsung yang dikenal
ManagedRemoteDevice |
Perangkat yang berjalan di dalam virtual machine yang kita kelola dari jarak jauh melalui instance Tradefed di dalam VM.
|
NestedRemoteDevice |
Representasi perangkat yang berjalan di dalam VM Cuttlefish jarak jauh.
|
RemoteAndroidDevice |
Implementasi ITestDevice untuk perangkat Android stack penuh yang terhubung melalui
adb connect.
|
|
Subclass tidak langsung yang umum
|
Implementasi ITestDevice
untuk perangkat Android stack penuh
Ringkasan
Kolom |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Perintah yang dapat digunakan untuk menutup pelindung kunci.
|
Metode publik |
boolean
|
canSwitchToHeadlessSystemUser()
Menampilkan apakah diizinkan untuk beralih ke pengguna SISTEM headless.
|
boolean
|
clearErrorDialogs()
Mencoba menutup dialog error yang saat ini ditampilkan di UI perangkat.
|
int
|
createUser(String name)
Buat pengguna dengan nama yang diberikan dan flag default 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Membuat pengguna dengan nama tertentu dan flag yang diberikan
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Membuat pengguna dengan nama tertentu dan flag yang diberikan
|
int
|
createUserNoThrow(String name)
Buat pengguna dengan nama yang diberikan dan flag default 0.
|
void
|
disableKeyguard()
Mencoba menonaktifkan kunci layar.
|
boolean
|
doesFileExist(String deviceFilePath)
Metode bantuan untuk menentukan apakah file di perangkat ada.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metode bantuan untuk menentukan apakah file di perangkat ada untuk pengguna tertentu.
|
File
|
dumpHeap(String process, String devicePath)
Mencoba membuang heap dari system_server.
|
|
getActiveApexes()
Mengambil informasi tentang APEX yang diaktifkan di perangkat.
|
|
getAllSettings(String namespace)
Menampilkan pasangan nilai kunci dari namespace yang diminta.
|
String
|
getAndroidId(int userId)
Menemukan dan menampilkan android-id yang terkait dengan userId, null jika tidak ditemukan.
|
|
getAndroidIds()
Buat Peta ID Android yang ditemukan cocok dengan ID pengguna.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Mengambil informasi tentang paket yang diinstal di perangkat.
|
|
getAppPackageInfos()
Mengambil informasi paket yang diinstal di perangkat.
|
InputStreamSource
|
getBugreport()
Mengambil laporan bug dari perangkat.
|
InputStreamSource
|
getBugreportz()
Mengambil bugreportz dari perangkat.
|
DeviceFoldableState
|
getCurrentFoldableState()
Menampilkan status perangkat foldable saat ini atau null jika terjadi beberapa masalah.
|
int
|
getCurrentUser()
Menampilkan ID pengguna yang sedang berjalan saat ini.
|
|
getFoldableStates()
Menampilkan daftar status perangkat foldable.
|
|
getInstalledPackageNames()
Mengambil nama paket aplikasi yang ada di perangkat.
|
KeyguardControllerState
|
getKeyguardState()
Menampilkan objek untuk mendapatkan status kunci layar saat ini atau null jika tidak didukung.
|
Integer
|
getMainUserId()
Menampilkan ID pengguna utama.
|
|
getMainlineModuleInfo()
Dapatkan informasi tentang modul utama yang diinstal di perangkat.
|
int
|
getMaxNumberOfRunningUsersSupported()
Mendapatkan jumlah maksimum pengguna yang didukung yang berjalan secara bersamaan.
|
int
|
getMaxNumberOfUsersSupported()
Mendapatkan jumlah maksimum pengguna yang didukung.
|
Integer
|
getPrimaryUserId()
Menampilkan ID pengguna utama.
|
InputStreamSource
|
getScreenshot()
Mengambil screenshot dari perangkat.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Mengambil screenshot dari perangkat.
|
InputStreamSource
|
getScreenshot(long displayId)
Mengambil screenshot dari perangkat yang diberi ID tampilan.
|
InputStreamSource
|
getScreenshot(String format)
Mengambil screenshot dari perangkat.
|
String
|
getSetting(String namespace, String key)
Lihat getSetting(int, String, String) dan dilakukan pada pengguna sistem.
|
String
|
getSetting(int userId, String namespace, String key)
Menampilkan nilai setelan yang diminta.
|
|
getUninstallablePackageNames()
Mengambil nama paket aplikasi yang dapat diuninstal.
|
int
|
getUserFlags(int userId)
Menemukan dan menampilkan flag pengguna tertentu.
|
|
getUserInfos()
Mendapatkan Peta useId ke UserInfo di perangkat.
|
int
|
getUserSerialNumber(int userId)
Menampilkan nomor seri yang terkait dengan userId jika ditemukan, -10000 dalam kasus lain.
|
boolean
|
hasFeature(String feature)
Memeriksa apakah fitur tersedia di perangkat.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Menginstal paket Android di perangkat.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Menginstal paket Android di perangkat.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
Menginstal paket Android di perangkat.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Menginstal paket Android di perangkat untuk pengguna tertentu.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Menginstal paket Android di perangkat untuk pengguna tertentu.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
boolean
|
isAppEnumerationSupported()
Memeriksa apakah platform di perangkat mendukung enumerasi aplikasi
|
boolean
|
isHeadlessSystemUserMode()
Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.
|
boolean
|
isMainUserPermanentAdmin()
Menampilkan apakah pengguna utama adalah admin permanen dan tidak dapat dihapus atau diturunkan statusnya menjadi
non-admin.
|
boolean
|
isMultiUserSupported()
Menentukan apakah multi-pengguna didukung.
|
boolean
|
isPackageInstalled(String packageName)
Buat kueri perangkat untuk nama paket tertentu guna memeriksa apakah paket tersebut saat ini diinstal atau tidak.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Buat kueri perangkat untuk nama paket tertentu dan ID pengguna tertentu guna memeriksa apakah saat ini
diinstal atau tidak untuk pengguna tersebut.
|
boolean
|
isUserRunning(int userId)
Periksa apakah pengguna tertentu sedang berjalan.
|
boolean
|
isUserSecondary(int userId)
Menampilkan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan flag-nya.
|
boolean
|
isUserVisible(int userId)
Memeriksa apakah pengguna tertentu terlihat.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Menampilkan apakah perangkat mengizinkan pengguna dimulai dan terlihat di latar belakang di ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .
|
boolean
|
isVisibleBackgroundUsersSupported()
Menampilkan apakah perangkat mengizinkan pengguna dimulai dan terlihat di latar belakang.
|
|
listDisplayIds()
Kumpulkan daftar ID layar yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys
SurfaceFlinger".
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Mendapatkan daftar layar yang dapat digunakan untuk start a user visible in the background .
|
|
listUsers()
Mendapatkan daftar pengguna di perangkat.
|
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metode bantuan untuk mengambil laporan bug dan mencatatnya ke pelapor.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dieksekusi setelah pemanggilan
selesai.
|
boolean
|
removeAdmin(String componentName, int userId)
Hapus admin perangkat tertentu di pengguna tertentu dan tampilkan true jika berhasil, false jika tidak.
|
void
|
removeOwners()
Menghapus semua pemilik profil perangkat yang ada dengan upaya terbaik.
|
boolean
|
removeUser(int userId)
Menghapus pengguna tertentu dari perangkat.
|
boolean
|
setDeviceOwner(String componentName, int userId)
Menetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.
|
void
|
setFirstBootloaderReboot()
|
void
|
setSetting(String namespace, String key, String value)
Lihat setSetting(int, String, String, String) dan dilakukan pada pengguna sistem.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Menambahkan nilai setelan ke namespace pengguna tertentu.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Mematikan perangkat microdroid, jika ada.
|
boolean
|
startUser(int userId)
Memulai pengguna tertentu di latar belakang jika saat ini dihentikan.
|
boolean
|
startUser(int userId, boolean waitFlag)
Memulai pengguna tertentu di latar belakang jika saat ini dihentikan.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Memulai pengguna tertentu di latar belakang, yang terlihat di tampilan tertentu (yaitu, memungkinkan pengguna
meluncurkan aktivitas di tampilan tersebut).
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Menghentikan pengguna tertentu.
|
boolean
|
stopUser(int userId)
Menghentikan pengguna tertentu.
|
boolean
|
supportsMicrodroid()
Memeriksa prasyarat untuk menjalankan microdroid.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Memeriksa prasyarat untuk menjalankan microdroid.
|
boolean
|
switchUser(int userId)
Beralih ke userId lain dengan waktu tunggu default.
|
boolean
|
switchUser(int userId, long timeout)
Beralih ke userId lain dengan waktu tunggu yang diberikan sebagai batas waktu.
|
Bugreport
|
takeBugreport()
Ambil bugreport dan tampilkan di dalam objek Bugreport untuk menanganinya.
|
String
|
uninstallPackage(String packageName)
Meng-uninstal paket Android dari perangkat.
|
String
|
uninstallPackageForUser(String packageName, int userId)
Meng-uninstal paket Android dari perangkat untuk pengguna tertentu.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Kolom
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Perintah yang dapat digunakan untuk menutup kunci layar.
Konstruktor publik
Metode publik
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Menampilkan apakah diizinkan untuk beralih ke pengguna SISTEM headless.
clearErrorDialogs
public boolean clearErrorDialogs ()
Mencoba menutup dialog error yang saat ini ditampilkan di UI perangkat.
Hasil |
boolean |
true jika tidak ada dialog atau dialog berhasil dihapus.
false jika tidak. |
createUser
public int createUser (String name)
Buat pengguna dengan nama yang diberikan dan flag default 0.
Parameter |
name |
String : pengguna yang akan dibuat di perangkat |
Hasil |
int |
bilangan bulat untuk ID pengguna yang dibuat |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Membuat pengguna dengan nama tertentu dan flag yang diberikan
Parameter |
name |
String : pengguna yang akan dibuat di perangkat |
guest |
boolean : mengaktifkan flag pengguna --guest selama pembuatan |
ephemeral |
boolean : mengaktifkan flag pengguna --ephemeral selama pembuatan |
forTesting |
boolean : mengaktifkan flag pengujian --for-testing selama pembuatan |
Hasil |
int |
ID pengguna yang dibuat |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
Membuat pengguna dengan nama tertentu dan flag yang diberikan
Parameter |
name |
String : pengguna yang akan dibuat di perangkat |
guest |
boolean : mengaktifkan flag pengguna --guest selama pembuatan |
ephemeral |
boolean : mengaktifkan flag pengguna --ephemeral selama pembuatan |
Hasil |
int |
ID pengguna yang dibuat |
createUserNoThrow
public int createUserNoThrow (String name)
Buat pengguna dengan nama yang diberikan dan flag default 0.
Parameter |
name |
String : pengguna yang akan dibuat di perangkat |
Hasil |
int |
bilangan bulat untuk ID pengguna yang dibuat atau -1 untuk error. |
disableKeyguard
public void disableKeyguard ()
Mencoba menonaktifkan kunci layar.
Pertama, tunggu pengiriman input hingga siap, hal ini terjadi pada waktu yang sama saat
perangkat melaporkan BOOT_COMPLETE, tampaknya secara asinkron, karena implementasi framework
saat ini memiliki kondisi perlombaan sesekali. Kemudian, perintah dikirim untuk menutup keyguard (hanya berfungsi
pada keyguard yang tidak aman)
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Metode bantuan untuk menentukan apakah file di perangkat ada.
Parameter |
deviceFilePath |
String : jalur absolut file di perangkat yang akan diperiksa |
Hasil |
boolean |
true jika file ada, false jika tidak. |
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Metode bantuan untuk menentukan apakah file di perangkat ada untuk pengguna tertentu.
Parameter |
deviceFilePath |
String : jalur absolut file di perangkat yang akan diperiksa |
userId |
int : ID pengguna yang akan digunakan untuk memeriksa keberadaan file |
Hasil |
boolean |
true jika file ada, false jika tidak. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Mencoba membuang heap dari system_server. Pemanggil bertanggung jawab untuk membersihkan
file yang di-dump.
Parameter |
process |
String : nama proses perangkat untuk dumpheap. |
devicePath |
String : jalur di perangkat tempat dump akan ditempatkan. Lokasi ini harus berupa lokasi yang
mengizinkannya. |
Hasil |
File |
ERROR(/File) yang berisi laporan. Null jika ada yang gagal. |
getActiveApexes
public getActiveApexes ()
Mengambil informasi tentang APEX yang diaktifkan di perangkat.
getAllSettings
public getAllSettings (String namespace)
Menampilkan pasangan nilai kunci dari namespace yang diminta.
Parameter |
namespace |
String : harus salah satu dari {"system", "secure", "global"} |
Hasil |
|
peta pasangan nilai kunci. Null jika namespace tidak didukung. |
getAndroidId
public String getAndroidId (int userId)
Menemukan dan menampilkan android-id yang terkait dengan userId, null jika tidak ditemukan.
getAndroidIds
public getAndroidIds ()
Buat Peta ID Android yang ditemukan cocok dengan ID pengguna. Tidak ada jaminan bahwa setiap ID pengguna
akan menemukan ID Android yang terkait dalam fungsi ini sehingga beberapa ID pengguna mungkin cocok dengan null.
Hasil |
|
Peta ID Android yang ditemukan cocok dengan ID pengguna. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Mengambil informasi tentang paket yang diinstal di perangkat.
Parameter |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Mengambil informasi paket yang diinstal di perangkat.
getBugreport
public InputStreamSource getBugreport ()
Mengambil laporan bug dari perangkat.
Penerapan ini dijamin akan terus berfungsi di perangkat tanpa sdcard
(atau jika sdcard belum dipasang).
getBugreportz
public InputStreamSource getBugreportz ()
Mengambil bugreportz dari perangkat. Bugreport format ZIP berisi bugreport utama dan
file log lainnya yang berguna untuk proses debug.
Hanya didukung untuk 'adb version' > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Menampilkan status perangkat foldable saat ini atau null jika terjadi beberapa masalah.
getCurrentUser
public int getCurrentUser ()
Menampilkan ID pengguna yang sedang berjalan saat ini. Jika terjadi error, tampilkan -10000.
getFoldableStates
public getFoldableStates ()
Menampilkan daftar status perangkat foldable. Dapat diperoleh dengan "cmd device_state
print-states".
getInstalledPackageNames
public getInstalledPackageNames ()
Mengambil nama paket aplikasi yang ada di perangkat.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Menampilkan objek untuk mendapatkan status kunci layar saat ini atau null jika tidak didukung.
getMainUserId
public Integer getMainUserId ()
Menampilkan ID pengguna utama.
Hasil |
Integer |
userId pengguna utama jika ada, dan null jika tidak ada pengguna utama. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Dapatkan informasi tentang modul utama yang diinstal di perangkat.
public int getMaxNumberOfRunningUsersSupported ()
Mendapatkan jumlah maksimum pengguna yang didukung yang berjalan secara bersamaan. Default-nya adalah 0.
Hasil |
int |
bilangan bulat yang menunjukkan jumlah pengguna yang berjalan secara bersamaan |
public int getMaxNumberOfUsersSupported ()
Mendapatkan jumlah maksimum pengguna yang didukung. Default-nya adalah 0.
Hasil |
int |
bilangan bulat yang menunjukkan jumlah pengguna yang didukung |
getPrimaryUserId
public Integer getPrimaryUserId ()
Menampilkan ID pengguna utama.
Hasil |
Integer |
userId pengguna utama jika ada, dan null jika tidak ada pengguna utama. |
getScreenshot
public InputStreamSource getScreenshot ()
Mengambil screenshot dari perangkat.
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Mengambil screenshot dari perangkat. Sebaiknya gunakan getScreenshot(String)
dengan encoding JPEG untuk ukuran yang lebih kecil.
Parameter |
format |
String : PNG, JPEG yang didukung |
rescale |
boolean : apakah screenshot harus diskalakan ulang untuk mengurangi ukuran gambar yang dihasilkan |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Mengambil screenshot dari perangkat yang diberi ID tampilan. Formatnya adalah PNG.
TODO: memperluas implementasi di atas untuk mendukung 'format' dan 'rescale'
Parameter |
displayId |
long : ID tampilan layar untuk mendapatkan screenshot. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Mengambil screenshot dari perangkat.
Sebaiknya gunakan getScreenshot(format) dengan encoding JPEG untuk ukuran yang lebih kecil
Parameter |
format |
String : PNG, JPEG yang didukung |
getSetting
public String getSetting (String namespace,
String key)
Lihat getSetting(int, String, String)
dan dilakukan pada pengguna sistem.
Parameter |
namespace |
String |
key |
String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
Menampilkan nilai setelan yang diminta.
namespace harus salah satu dari: {"system", "secure", "global"}
Parameter |
userId |
int |
namespace |
String |
key |
String |
Hasil |
String |
nilai yang terkait dengan namespace:key pengguna. Null jika tidak ditemukan. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Mengambil nama paket aplikasi yang dapat diuninstal. Hal ini saat ini ditentukan sebagai
paket non-sistem, dan paket sistem yang diupdate.
Hasil |
|
ERROR(/Set) nama paket String yang dapat di-uninstal yang saat ini diinstal di
perangkat. |
getUserFlags
public int getUserFlags (int userId)
Menemukan dan menampilkan flag pengguna tertentu.
Flag ditentukan di class "android.content.pm.UserInfo" di Project Open Source Android.
Hasil |
int |
flag yang terkait dengan userId yang diberikan jika ditemukan, -10000 dalam kasus lain. |
getUserInfos
public getUserInfos ()
Mendapatkan Peta useId ke UserInfo
di perangkat. Akan menampilkan DeviceRuntimeException
jika output dari perangkat tidak seperti yang diharapkan.
Hasil |
|
daftar objek UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Menampilkan nomor seri yang terkait dengan userId jika ditemukan, -10000 dalam kasus lain.
hasFeature
public boolean hasFeature (String feature)
Memeriksa apakah fitur tersedia di perangkat.
Parameter |
feature |
String : format yang harus berupa "feature:" atau "" secara langsung. |
Hasil |
boolean |
Benar jika fitur ditemukan, salah jika tidak. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Menginstal paket Android di perangkat.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi
yang tersedia. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Menginstal paket Android di perangkat.
Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime pada
waktu penginstalan yang harus memanggil fungsi ini.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
grantPermissions |
boolean : apakah semua izin runtime harus diberikan pada waktu penginstalan |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi
yang tersedia. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Menginstal paket Android di perangkat.
Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime pada
waktu penginstalan yang harus memanggil fungsi ini.
Parameter |
packageFile |
File : file apk yang akan diinstal |
certFile |
File : true jika penginstalan ulang harus dilakukan |
reinstall |
boolean : apakah semua izin runtime harus diberikan pada waktu penginstalan |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi
yang tersedia. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Menginstal paket Android di perangkat untuk pengguna tertentu.
Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime pada
waktu penginstalan yang harus memanggil fungsi ini.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
grantPermissions |
boolean : apakah semua izin runtime harus diberikan pada waktu penginstalan |
userId |
int : ID pengguna bilangan bulat yang akan diinstal. |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi
yang tersedia. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Menginstal paket Android di perangkat untuk pengguna tertentu.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
userId |
int : ID pengguna bilangan bulat yang akan diinstal. |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk mengetahui opsi
yang tersedia. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parameter |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parameter |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parameter |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parameter |
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parameter |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parameter |
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Memeriksa apakah platform di perangkat mendukung enumerasi aplikasi
Hasil |
boolean |
Benar jika enumerasi aplikasi didukung, salah jika tidak |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Menampilkan apakah pengguna utama adalah admin permanen dan tidak dapat dihapus atau diturunkan statusnya menjadi
non-admin.
isMultiUserSupported
public boolean isMultiUserSupported ()
Menentukan apakah multi-pengguna didukung.
Hasil |
boolean |
true jika multi-pengguna didukung, false jika tidak |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Buat kueri perangkat untuk nama paket tertentu guna memeriksa apakah paket tersebut saat ini diinstal atau tidak.
Parameter |
packageName |
String |
Hasil |
boolean |
Benar jika paket dilaporkan sebagai diinstal. Salah jika tidak. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Buat kueri perangkat untuk nama paket tertentu dan ID pengguna tertentu guna 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 kita periksa. Jika null, pengguna utama
nol akan digunakan. |
Hasil |
boolean |
Benar jika paket dilaporkan sebagai diinstal. Salah jika tidak. |
isUserRunning
public boolean isUserRunning (int userId)
Periksa apakah pengguna tertentu sedang berjalan.
Hasil |
boolean |
Benar jika pengguna sedang berjalan, salah dalam kasus lainnya. |
isUserSecondary
public boolean isUserSecondary (int userId)
Menampilkan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan flag-nya.
Hasil |
boolean |
true jika pengguna adalah sekunder, false jika tidak. |
isUserVisible
public boolean isUserVisible (int userId)
Memeriksa apakah pengguna tertentu terlihat.
Pengguna "terlihat" adalah pengguna yang berinteraksi dengan pengguna "manusia" sehingga dapat
meluncurkan aktivitas peluncuran (biasanya di tampilan default).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.
Pengguna "terlihat" adalah pengguna yang berinteraksi dengan pengguna "manusia" sehingga dapat
meluncurkan aktivitas peluncuran di layar tersebut.
Parameter |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Kumpulkan daftar ID layar yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys
SurfaceFlinger".
Hasil |
|
Daftar layar. Default selalu menampilkan tampilan default 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Mendapatkan daftar layar yang dapat digunakan untuk start a user visible in the background
.
listUsers
public listUsers ()
Mendapatkan daftar pengguna di perangkat. Akan menampilkan DeviceRuntimeException
jika output
dari perangkat tidak seperti yang diharapkan.
Hasil |
|
daftar ID pengguna. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metode bantuan untuk mengambil laporan bug dan mencatatnya ke pelapor.
Parameter |
dataName |
String : nama yang digunakan untuk melaporkan bugreport. |
listener |
ITestLogger : ITestLogger untuk mencatat bugreport ke dalam log. |
Hasil |
boolean |
Benar jika logging berhasil, salah jika tidak. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parameter |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dieksekusi setelah pemanggilan
selesai.
Parameter |
exception |
Throwable : jika ada, pengecualian akhir yang ditampilkan oleh kegagalan pemanggilan. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Hapus admin perangkat tertentu di pengguna tertentu dan tampilkan true
jika berhasil, false
jika tidak.
Parameter |
componentName |
String : admin perangkat yang akan dihapus. |
userId |
int : pengguna yang menjadi tempat tinggal admin perangkat. |
Hasil |
boolean |
Benar jika berhasil, salah jika tidak. |
removeOwners
public void removeOwners ()
Menghapus semua pemilik profil perangkat yang ada dengan upaya terbaik.
removeUser
public boolean removeUser (int userId)
Menghapus pengguna tertentu dari perangkat.
Parameter |
userId |
int : pengguna yang akan dihapus |
Hasil |
boolean |
benar jika kita berhasil menghapus pengguna, salah jika tidak. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Menetapkan komponen admin perangkat sebagai pemilik perangkat di pengguna tertentu.
Parameter |
componentName |
String : admin perangkat menjadi pemilik perangkat. |
userId |
int : pengguna tempat pemilik perangkat tinggal. |
Hasil |
boolean |
Benar jika berhasil, salah jika tidak. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
setSetting
public void setSetting (String namespace,
String key,
String value)
Lihat setSetting(int, String, String, String)
dan dilakukan pada pengguna sistem.
Parameter |
namespace |
String |
key |
String |
value |
String |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Menambahkan nilai setelan ke namespace pengguna tertentu. Beberapa setelan hanya akan tersedia
setelah memulai ulang.
namespace harus salah satu dari: {"system", "secure", "global"}
Parameter |
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Mematikan perangkat microdroid, jika ada.
Parameter |
microdroidDevice |
ITestDevice |
startUser
public boolean startUser (int userId)
Memulai pengguna tertentu di latar belakang jika saat ini dihentikan. Jika pengguna sudah
berjalan di latar belakang, metode ini adalah NOOP.
Parameter |
userId |
int : pengguna untuk memulai di latar belakang |
Hasil |
boolean |
benar jika pengguna berhasil dimulai di latar belakang. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Memulai pengguna tertentu di latar belakang jika saat ini dihentikan. Jika pengguna sudah
berjalan di latar belakang, metode ini adalah NOOP. Dapat memberikan flag tambahan untuk menunggu
operasi diterapkan.
Parameter |
userId |
int : pengguna untuk memulai di latar belakang |
waitFlag |
boolean : akan membuat perintah menunggu hingga pengguna dimulai dan dibuka kuncinya. |
Hasil |
boolean |
benar jika pengguna berhasil dimulai di latar belakang. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Memulai pengguna tertentu di latar belakang, yang terlihat di tampilan tertentu (yaitu, memungkinkan pengguna
meluncurkan aktivitas di tampilan tersebut).
CATATAN: perintah ini tidak memeriksa apakah pengguna ada, layar 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. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Menghentikan pengguna tertentu. Dapat memberikan flag tambahan untuk menunggu operasi diterapkan,
dan memaksa pengguna untuk berhenti. Tidak dapat menghentikan pengguna saat ini dan sistem.
Parameter |
userId |
int : pengguna yang akan dihentikan. |
waitFlag |
boolean : akan membuat perintah menunggu hingga pengguna dihentikan. |
forceFlag |
boolean : akan memaksa pengguna berhenti. |
Hasil |
boolean |
benar jika pengguna berhasil dihentikan. |
stopUser
public boolean stopUser (int userId)
Menghentikan pengguna tertentu. Jika pengguna sudah dihentikan, metode ini adalah NOOP.
Tidak dapat menghentikan pengguna saat ini dan sistem.
Parameter |
userId |
int : pengguna yang akan dihentikan. |
Hasil |
boolean |
benar jika pengguna berhasil dihentikan. |
supportsMicrodroid
public boolean supportsMicrodroid ()
Memeriksa prasyarat untuk menjalankan microdroid.
Hasil |
boolean |
menampilkan nilai benar jika prasyarat terpenuhi, salah jika tidak. |
supportsMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Memeriksa prasyarat untuk menjalankan microdroid.
Parameter |
protectedVm |
boolean : benar jika microdroid dimaksudkan untuk berjalan di VM yang dilindungi. |
Hasil |
boolean |
menampilkan nilai benar jika prasyarat terpenuhi, salah jika tidak. |
switchUser
public boolean switchUser (int userId)
Beralih ke userId lain dengan waktu tunggu default. switchUser(int, long)
.
Hasil |
boolean |
Benar jika userId baru cocok dengan penyedia userId. Salah jika tidak. |
switchUser
public boolean switchUser (int userId,
long timeout)
Beralih ke userId lain dengan waktu tunggu yang diberikan sebagai batas waktu.
Mencoba menonaktifkan kunci layar setelah perubahan pengguna berhasil.
Parameter |
userId |
int |
timeout |
long : untuk menunggu sebelum menampilkan salah jika switch-user gagal. |
Hasil |
boolean |
Benar jika userId baru cocok dengan penyedia userId. Salah jika tidak. |
takeBugreport
public Bugreport takeBugreport ()
Ambil bugreport dan tampilkan di dalam objek Bugreport
untuk menanganinya. Tampilkan null
jika terjadi masalah. File yang dirujuk dalam objek Bugreport perlu dihapus melalui Bugreport.close()
.
uninstallPackage
public String uninstallPackage (String packageName)
Meng-uninstal paket Android dari perangkat.
Parameter |
packageName |
String : paket Android yang akan di-uninstal |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Meng-uninstal paket Android dari perangkat untuk pengguna tertentu.
Parameter |
packageName |
String : paket Android yang akan di-uninstal |
userId |
int : ID pengguna bilangan bulat yang akan di-uninstal. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parameter |
currentPhase |
SnapuserdWaitPhase |
Metode yang dilindungi
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Lakukan mulai ulang adb.
Parameter |
rebootMode |
NativeDevice.RebootMode : mode mulai ulang ini. |
reason |
String : untuk mulai ulang ini. |
getBugreportzInternal
protected File getBugreportzInternal ()
Metode Helper internal untuk mendapatkan file zip bugreportz sebagai ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Ditampilkan untuk pengujian.
getHostCurrentTime
protected long getHostCurrentTime ()
Diekspos untuk pengujian
prePostBootSetup
protected void prePostBootSetup ()
Memungkinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) mengganti metode ini untuk
penyiapan pasca-boot tertentu.