PerangkatPengujian
public
class
TestDevice
extends NativeDevice
Subclass langsung yang dikenal
ManagedRemoteDevice |
Perangkat yang berjalan di dalam mesin virtual yang kita kelola dari jarak jauh melalui instance Tradefed di dalamnya
VM.
|
NestedRemoteDevice |
Representasi perangkat yang berjalan di dalam VM Cuttlefish jarak jauh.
|
PerangkatAndroidRemote |
Implementasi ITestDevice untuk perangkat Android stack lengkap yang terhubung melalui
adb Connect.
|
|
Subclass tidak langsung yang umum
|
Implementasi ITestDevice
untuk perangkat Android stack lengkap
Ringkasan
Kolom |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Perintah yang dapat digunakan untuk menutup keyguard.
|
Metode publik |
boolean
|
canSwitchToHeadlessSystemUser()
Menampilkan apakah diizinkan untuk beralih ke pengguna SYSTEM headless.
|
boolean
|
clearErrorDialogs()
Mencoba menutup dialog error yang saat ini ditampilkan di UI perangkat.
|
int
|
createUser(String name)
Buat pengguna dengan nama tertentu dan tanda default 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Membuat pengguna dengan nama tertentu dan tanda yang disediakan
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Membuat pengguna dengan nama tertentu dan tanda yang disediakan
|
int
|
createUserNoThrow(String name)
Buat pengguna dengan nama tertentu dan tanda default 0.
|
void
|
disableKeyguard()
Berupaya menonaktifkan pengaman.
|
boolean
|
doesFileExist(String deviceFilePath)
Metode bantuan untuk menentukan apakah file pada 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)
Upaya untuk membuang heap dari system_server.
|
|
getActiveApexes()
Ambil informasi tentang APEX yang diaktifkan di perangkat.
|
|
getAllSettings(String namespace)
Menampilkan pasangan nilai kunci namespace yang diminta.
|
String
|
getAndroidId(int userId)
Menemukan dan menampilkan ID Android yang terkait dengan userId, null jika tidak ditemukan.
|
|
getAndroidIds()
Buat Peta ID Android yang cocok dengan ID pengguna.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Mengambil informasi tentang paket yang diinstal di perangkat.
|
|
getAppPackageInfos()
Mengambil informasi paket yang diinstal pada perangkat.
|
InputStreamSource
|
getBugreport()
Mengambil laporan bug dari perangkat.
|
InputStreamSource
|
getBugreportz()
Mengambil laporan bug dari perangkat.
|
DeviceFoldableState
|
getCurrentFoldableState()
Menampilkan status perangkat foldable saat ini atau null jika terjadi beberapa masalah.
|
int
|
getCurrentUser()
Tampilkan ID pengguna yang sedang berjalan saat ini.
|
|
getFoldableStates()
Menampilkan daftar status perangkat foldable di perangkat.
|
|
getInstalledPackageNames()
Ambil nama paket aplikasi yang ada di perangkat.
|
KeyguardControllerState
|
getKeyguardState()
Menampilkan objek untuk mendapatkan status keyguard saat ini atau null jika tidak didukung.
|
Integer
|
getMainUserId()
Menampilkan ID pengguna utama.
|
|
getMainlineModuleInfo()
Dapatkan informasi tentang modul mainline 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(String format)
Mengambil screenshot dari perangkat.
|
InputStreamSource
|
getScreenshot(long displayId)
Mengambil screenshot dari ID tampilan yang ditentukan 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()
Ambil nama paket aplikasi yang dapat di-uninstal.
|
int
|
getUserFlags(int userId)
Temukan dan tampilkan tanda 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 lainnya.
|
boolean
|
hasFeature(String feature)
Memeriksa apakah suatu fitur tersedia di perangkat.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Instal paket Android di perangkat.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instal paket Android di perangkat.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
Instal 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()
Periksa 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 didowngrade menjadi
status non-admin.
|
boolean
|
isMultiUserSupported()
Menentukan apakah multi-pengguna didukung.
|
boolean
|
isPackageInstalled(String packageName)
Buat kueri perangkat untuk nama paket tertentu guna memeriksa apakah perangkat tersebut saat ini terinstal atau tidak.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Mengkueri perangkat untuk nama paket tertentu dan ID pengguna yang diberikan untuk memeriksa apakah saat ini
diinstal atau tidak untuk pengguna tersebut.
|
boolean
|
isUserRunning(int userId)
Periksa apakah pengguna tertentu sedang berjalan.
|
boolean
|
isUserSecondary(int userId)
Menampilkan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan tandanya.
|
boolean
|
isUserVisible(int userId)
Memeriksa apakah pengguna tertentu terlihat.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Menampilkan apakah perangkat mengizinkan pengguna untuk memulai dengan terlihat di latar belakang dalam ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .
|
boolean
|
isVisibleBackgroundUsersSupported()
Menampilkan apakah perangkat mengizinkan pengguna untuk memulai dengan terlihat di latar belakang.
|
|
listDisplayIds()
Kumpulkan daftar ID tampilan 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 reporter.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Langkah tambahan untuk perangkat khusus memerlukan pembersihan yang akan dijalankan setelah panggilan
selesai.
|
boolean
|
removeAdmin(String componentName, int userId)
Menghapus admin perangkat tertentu pada pengguna tertentu dan menampilkan true jika berhasil, false jika tidak.
|
void
|
removeOwners()
Hapus 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 pada pengguna tertentu.
|
void
|
setSetting(String namespace, String key, String value)
Lihat setSetting(int, String, String, String) dan dilakukan pada pengguna sistem.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Menambahkan nilai setelan ke namespace pengguna tertentu.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Mematikan perangkat mikrodroid, 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, terlihat di tampilan tertentu (yaitu, memungkinkan pengguna
untuk 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 mikrodroid.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Memeriksa prasyarat untuk menjalankan mikrodroid.
|
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 laporan bug dan tampilkan di dalam objek Bugreport untuk menanganinya.
|
String
|
uninstallPackage(String packageName)
Uninstal paket Android dari perangkat.
|
String
|
uninstallPackageForUser(String packageName, int userId)
Uninstal paket Android dari perangkat untuk pengguna tertentu.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Kolom
TUTUP_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Perintah yang dapat digunakan untuk menutup keyguard.
Konstruktor publik
Metode publik
dapatSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Menampilkan apakah diizinkan untuk beralih ke pengguna SYSTEM 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 sebaliknya. |
buatPengguna
public int createUser (String name)
Buat pengguna dengan nama tertentu dan tanda default 0.
Parameter |
name |
String : dari pengguna yang akan dibuat di perangkat |
Hasil |
int |
bilangan bulat untuk id pengguna yang dibuat |
buatPengguna
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Membuat pengguna dengan nama tertentu dan tanda yang disediakan
Parameter |
name |
String : dari pengguna yang akan dibuat di perangkat |
guest |
boolean : mengaktifkan tanda pengguna --guest selama pembuatan |
ephemeral |
boolean : mengaktifkan flag pengguna --ephemeral selama pembuatan |
forTesting |
boolean : mengaktifkan tanda pengujian --for-testing selama pembuatan |
Hasil |
int |
id pengguna yang dibuat |
buatPengguna
public int createUser (String name,
boolean guest,
boolean ephemeral)
Membuat pengguna dengan nama tertentu dan tanda yang disediakan
Parameter |
name |
String : dari pengguna yang akan dibuat di perangkat |
guest |
boolean : mengaktifkan tanda 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 tertentu dan tanda default 0.
Parameter |
name |
String : dari pengguna yang akan dibuat di perangkat |
Hasil |
int |
bilangan bulat untuk ID pengguna yang dibuat atau -1 untuk kesalahan. |
nonaktifkanKeyguard
public void disableKeyguard ()
Berupaya menonaktifkan pengaman.
Pertama, tunggu hingga pengiriman input siap, hal ini terjadi pada waktu yang sama
laporan perangkat BOOT_SELESAI, tampaknya secara asinkron, karena kerangka kerja saat ini
implementasinya terkadang memiliki kondisi race. Kemudian perintah dikirim untuk
menutup keyguard (berfungsi
hanya pada jaringan yang tidak aman)
{i>DoFileExist<i}
public boolean doesFileExist (String deviceFilePath)
Metode bantuan untuk menentukan apakah file pada perangkat ada.
Parameter |
deviceFilePath |
String : jalur absolut file di perangkat yang akan diperiksa |
Hasil |
boolean |
true jika file ada, false jika tidak. |
{i>DoFileExist<i}
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 digunakan untuk memeriksa keberadaan file |
Hasil |
boolean |
true jika file ada, false jika tidak. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Upaya untuk membuang heap dari system_server. Pemanggil bertanggung jawab untuk membersihkan
file {i>dump<i}.
Parameter |
process |
String : nama proses perangkat yang akan digunakan untuk membuang dumpheap. |
devicePath |
String : jalur di perangkat tempat membuang dump. Ini harus berupa
lokasi tempat
izin akses yang memungkinkannya. |
Hasil |
File |
ERROR(/File) yang berisi laporan. Null jika terjadi kegagalan. |
getActiveApexe
public getActiveApexes ()
Ambil informasi tentang APEX yang diaktifkan di perangkat.
getAllSettings
public getAllSettings (String namespace)
Menampilkan pasangan nilai kunci 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 ID Android yang terkait dengan userId, null jika tidak ditemukan.
getAndroidIds
public getAndroidIds ()
Buat Peta ID Android yang cocok dengan ID pengguna. Tidak ada asuransi untuk setiap pengguna
akan menemukan ID Android yang terkait dalam fungsi ini sehingga beberapa ID pengguna mungkin cocok dengan null.
Hasil |
|
Peta ID Android yang 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 pada perangkat.
getBugreport
public InputStreamSource getBugreport ()
Mengambil laporan bug dari perangkat.
Implementasinya dijamin akan terus berfungsi pada perangkat tanpa sdcard
(atau di mana {i>sdcard<i} belum dipasang).
getBugreportz
public InputStreamSource getBugreportz ()
Mengambil laporan bug dari perangkat. Laporan {i>bug<i} format {i>zip<i} berisi
laporan {i>bug<i} utama dan
file log lainnya yang
berguna untuk {i>debugging<i}.
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 ()
Tampilkan ID pengguna yang sedang berjalan saat ini. Jika terjadi error, tampilkan -10000.
getFoldableStates
public getFoldableStates ()
Menampilkan daftar status perangkat foldable di perangkat. Dapat diperoleh dengan "cmd device_state
status cetak".
getInstallPackageNames
public getInstalledPackageNames ()
Ambil nama paket aplikasi yang ada di perangkat.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Menampilkan objek untuk mendapatkan status keyguard 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 mainline 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. |
dapatkanScreenshot
public InputStreamSource getScreenshot ()
Mengambil screenshot dari perangkat.
dapatkanScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Mengambil screenshot dari perangkat. Sebaiknya gunakan getScreenshot(String)
saja
dengan encoding JPEG untuk
ukuran yang lebih kecil.
Parameter |
format |
String : PNG, JPEG yang didukung |
rescale |
boolean : jika screenshot harus diskalakan ulang untuk mengurangi ukuran gambar yang dihasilkan |
dapatkanScreenshot
public InputStreamSource getScreenshot (String format)
Mengambil screenshot dari perangkat.
Direkomendasikan untuk menggunakan getScreenshot(format) dengan encoding JPEG untuk ukuran yang lebih kecil
Parameter |
format |
String : PNG, JPEG yang didukung |
dapatkanScreenshot
public InputStreamSource getScreenshot (long displayId)
Mengambil screenshot dari ID tampilan yang ditentukan perangkat. Formatnya adalah PNG.
TODO: perluas implementasi di atas untuk mendukung 'format' dan 'mengubah skala'
Parameter |
displayId |
long : ID tampilan layar untuk mengambil screenshot. |
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:kunci pengguna. Null jika tidak ditemukan. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Ambil nama paket aplikasi yang dapat di-uninstal. Saat ini, fungsi tersebut didefinisikan sebagai
paket non-sistem, dan
paket sistem yang diperbarui.
Hasil |
|
ERROR(/Set) dari nama paket String yang dapat di-uninstal, yang saat ini terinstal di
perangkat seluler. |
getUserFlags
public int getUserFlags (int userId)
Temukan dan tampilkan tanda pengguna tertentu.
Tanda ditentukan di "android.content.pm.UserInfo" di Project Open Source Android.
Hasil |
int |
flag yang terkait dengan userId yang disediakan jika ditemukan, -10000 dalam kasus lainnya. |
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 lainnya.
hasFeature
public boolean hasFeature (String feature)
Memeriksa apakah suatu fitur tersedia di perangkat.
Parameter |
feature |
String : format mana yang harus "feature:" atau "" secara langsung. |
Hasil |
boolean |
True jika fitur ditemukan, false jika tidak. |
{i>installPackage<i}
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Instal paket Android di perangkat.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk tersedia
lainnya. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
{i>installPackage<i}
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Instal paket Android di perangkat.
Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime
akan memanggil fungsi ini.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
grantPermissions |
boolean : jika semua izin runtime harus diberikan pada waktu penginstalan |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk tersedia
lainnya. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
{i>installPackage<i}
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Instal paket Android di perangkat.
Catatan: Hanya kasus penggunaan yang memerlukan kontrol eksplisit untuk memberikan izin runtime
akan memanggil fungsi ini.
Parameter |
packageFile |
File : file apk yang akan diinstal |
certFile |
File : true jika penginstalan ulang harus dilakukan |
reinstall |
boolean : jika semua izin runtime harus diberikan pada waktu penginstalan |
extraArgs |
String : argumen tambahan opsional yang akan diteruskan. Lihat 'adb shell pm -h' untuk tersedia
lainnya. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
{i>installPackageForUser<i}
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
akan memanggil fungsi ini.
Parameter |
packageFile |
File : file apk yang akan diinstal |
reinstall |
boolean : true jika penginstalan ulang harus dilakukan |
grantPermissions |
boolean : jika 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 tersedia
lainnya. |
Hasil |
String |
String dengan kode error, atau null jika berhasil. |
{i>installPackageForUser<i}
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 tersedia
lainnya. |
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 |
{i>installRemotePackages<i}
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parameter |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
{i>installRemotePackages<i}
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parameter |
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Periksa apakah platform di perangkat mendukung enumerasi aplikasi
Hasil |
boolean |
True 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 didowngrade menjadi
status non-admin.
isMultiUserDidukung
public boolean isMultiUserSupported ()
Menentukan apakah multi-pengguna didukung.
Hasil |
boolean |
true jika multi-pengguna didukung, false jika tidak |
{i>isPackagePackage<i}
public boolean isPackageInstalled (String packageName)
Buat kueri perangkat untuk nama paket tertentu guna memeriksa apakah perangkat tersebut saat ini terinstal atau tidak.
Parameter |
packageName |
String |
Hasil |
boolean |
True jika paket dilaporkan sebagai diinstal. Salah jika sebaliknya. |
{i>isPackagePackage<i}
public boolean isPackageInstalled (String packageName,
String userId)
Mengkueri perangkat untuk nama paket tertentu dan ID pengguna yang diberikan untuk memeriksa apakah saat ini
diinstal atau tidak untuk pengguna tersebut.
Parameter |
packageName |
String : paket yang kita periksa apakah sudah diinstal. |
userId |
String : ID pengguna yang kita periksa untuk menginstal paket. Jika null, pengguna utama
nol akan digunakan. |
Hasil |
boolean |
True jika paket dilaporkan sebagai diinstal. Salah jika sebaliknya. |
{i>isUserRunning<i}
public boolean isUserRunning (int userId)
Periksa apakah pengguna tertentu sedang berjalan.
Hasil |
boolean |
True jika pengguna berjalan, false dalam setiap kasus lainnya. |
IsUserSecondary
public boolean isUserSecondary (int userId)
Menampilkan apakah pengguna yang ditentukan adalah pengguna sekunder sesuai dengan tandanya.
Hasil |
boolean |
benar (true) jika pengguna bersifat sekunder, salah (false) jika tidak. |
IsUserVisible
public boolean isUserVisible (int userId)
Memeriksa apakah pengguna tertentu terlihat.
"terlihat" pengguna adalah pengguna yang berinteraksi dengan "manusia" pengguna dan karenanya dapat
meluncurkan aktivitas peluncuran (biasanya di tampilan default).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Memeriksa apakah pengguna tertentu terlihat di tampilan tertentu.
"terlihat" pengguna adalah pengguna yang berinteraksi dengan "manusia" pengguna dan karenanya dapat
meluncurkan aktivitas peluncuran di tampilan tersebut.
Parameter |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Kumpulkan daftar ID tampilan yang tersedia di perangkat seperti yang dilaporkan oleh "dumpsys
SurfaceFlinger".
Hasil |
|
Daftar tampilan. Default selalu mengembalikan tampilan default 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Mendapatkan daftar layar yang dapat digunakan untuk start a user visible in the background
.
daftarPengguna
public listUsers ()
Mendapatkan daftar pengguna di perangkat. Akan menampilkan DeviceRuntimeException
jika output
dari perangkat tidak seperti yang diharapkan.
Hasil |
|
daftar ID pengguna. |
laporanBuglog
public boolean logBugreport (String dataName,
ITestLogger listener)
Metode bantuan untuk mengambil laporan bug dan mencatatnya ke reporter.
Parameter |
dataName |
String : nama yang digunakan untuk melaporkan laporan bug. |
listener |
ITestLogger : ITestLogger untuk mencatat laporan bug. |
Hasil |
boolean |
True jika logging berhasil, false jika tidak. |
beri tahuSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parameter |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Langkah tambahan untuk perangkat khusus memerlukan pembersihan yang akan dijalankan setelah panggilan
selesai.
Parameter |
exception |
Throwable : jika ada, pengecualian terakhir yang dimunculkan oleh kegagalan pemanggilan. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Menghapus admin perangkat tertentu pada pengguna tertentu dan menampilkan true
jika berhasil, false
jika tidak.
Parameter |
componentName |
String : dari admin perangkat akan dihapus. |
userId |
int : pengguna tempat admin perangkat berada. |
Hasil |
boolean |
True jika berhasil, false jika tidak. |
removeOwners
public void removeOwners ()
Hapus semua pemilik profil perangkat yang ada dengan upaya terbaik.
hapusPengguna
public boolean removeUser (int userId)
Menghapus pengguna tertentu dari perangkat.
Parameter |
userId |
int : pengguna yang akan dihapus |
Hasil |
boolean |
true jika kami berhasil menghapus pengguna, false jika tidak. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Menetapkan komponen admin perangkat sebagai pemilik perangkat pada pengguna tertentu.
Parameter |
componentName |
String : admin perangkat menjadi pemilik perangkat. |
userId |
int : pengguna yang ditempati pemilik perangkat. |
Hasil |
boolean |
True jika berhasil, false jika tidak. |
setelSetelan
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 |
setelSetelan
public void setSetting (int userId,
String namespace,
String key,
String value)
Menambahkan nilai setelan ke namespace pengguna tertentu. Beberapa setelan hanya akan tersedia
setelah {i>reboot<i}.
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 mikrodroid, jika ada.
Parameter |
microdroidDevice |
ITestDevice |
penggunamulai
public boolean startUser (int userId)
Memulai pengguna tertentu di latar belakang jika saat ini dihentikan. Jika pengguna sudah
yang berjalan di latar belakang, metode ini adalah NOOP.
Parameter |
userId |
int : pengguna yang memulai di latar belakang |
Hasil |
boolean |
benar (true) jika pengguna berhasil
memulai di latar belakang. |
penggunamulai
public boolean startUser (int userId,
boolean waitFlag)
Memulai pengguna tertentu di latar belakang jika saat ini dihentikan. Jika pengguna sudah
yang berjalan di latar belakang, metode ini adalah NOOP. Kemungkinan menyediakan tanda tambahan untuk menunggu
agar operasi diterapkan.
Parameter |
userId |
int : pengguna yang memulai di latar belakang |
waitFlag |
boolean : akan membuat perintah menunggu hingga pengguna dimulai dan dibuka kuncinya. |
Hasil |
boolean |
benar (true) jika pengguna berhasil
memulai di latar belakang. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Memulai pengguna tertentu di latar belakang, terlihat di tampilan tertentu (yaitu, memungkinkan pengguna
untuk meluncurkan aktivitas di tampilan tersebut).
CATATAN: perintah ini tidak memeriksa apakah pengguna ada, tampilan tersedia, device supports such feature
, dll.
Parameter |
userId |
int : pengguna yang memulai di latar belakang |
displayId |
int : menampilkan ke pengguna awal yang terlihat di |
waitFlag |
boolean : akan membuat perintah menunggu hingga pengguna dimulai dan dibuka kuncinya. |
Hasil |
boolean |
true jika pengguna berhasil mulai terlihat di latar belakang. |
pengguna
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Menghentikan pengguna tertentu. Mungkin menyediakan penanda tambahan
untuk menunggu operasi berjalan,
dan memaksa pengguna
berhenti. Tidak dapat menghentikan pengguna saat ini dan sistem.
Parameter |
userId |
int : pengguna yang akan berhenti. |
waitFlag |
boolean : akan membuat perintah menunggu hingga pengguna dihentikan. |
forceFlag |
boolean : akan memaksa pengguna berhenti. |
Hasil |
boolean |
benar (true) jika pengguna berhasil dihentikan. |
pengguna
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 berhenti. |
Hasil |
boolean |
benar (true) jika pengguna berhasil dihentikan. |
mendukungMicrodroid
public boolean supportsMicrodroid ()
Memeriksa prasyarat untuk menjalankan mikrodroid.
Hasil |
boolean |
menampilkan true (benar) jika prasyarat terpenuhi, salah (false) jika tidak. |
mendukungMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Memeriksa prasyarat untuk menjalankan mikrodroid.
Parameter |
protectedVm |
boolean : benar jika mikrodroid ditujukan untuk dijalankan di VM yang dilindungi. |
Hasil |
boolean |
menampilkan true (benar) jika prasyarat terpenuhi, salah (false) jika tidak. |
penggunapengguna
public boolean switchUser (int userId)
Beralih ke userId lain dengan waktu tunggu default. switchUser(int, long)
.
Hasil |
boolean |
True jika userId baru cocok dengan penyedia userId. Salah jika sebaliknya. |
penggunapengguna
public boolean switchUser (int userId,
long timeout)
Beralih ke userId lain dengan waktu tunggu yang diberikan sebagai batas waktu.
Upaya menonaktifkan pengaman tombol setelah pergantian pengguna berhasil.
Parameter |
userId |
int |
timeout |
long : menunggu sebelum menampilkan nilai salah untuk pengguna tombol akses yang gagal. |
Hasil |
boolean |
True jika userId baru cocok dengan penyedia userId. Salah jika sebaliknya. |
laporantakeBug
public Bugreport takeBugreport ()
Ambil laporan bug dan tampilkan di dalam objek Bugreport
untuk menanganinya. Menampilkan null
jika terjadi masalah. File yang dirujuk dalam objek Bugreport perlu dibersihkan melalui Bugreport.close()
.
{i>uninstallPackage<i}
public String uninstallPackage (String packageName)
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)
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. |
tungguForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parameter |
currentPhase |
SnapuserdWaitPhase |
Metode yang dilindungi
createParser
protected AaptParser createParser (File appFile)
{i>DoAdbReboot<i}
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 Bantuan Internal untuk mendapatkan file zip bugreportz sebagai ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Terekspos untuk pengujian.
getHostCurrentTime
protected long getHostCurrentTime ()
Terekspos untuk pengujian
prePostBootSetup
protected void prePostBootSetup ()
Mengizinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) untuk mengganti metode ini untuk
pengaturan pasca-{i>booting<i} yang spesifik.