PerangkatPengujian

public class TestDevice
extends NativeDevice

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

Implementasi ITestDevice untuk perangkat Android stack lengkap

Ringkasan

Class bertingkat

class TestDevice.MicrodroidBuilder

Builder yang digunakan untuk membuat Microdroid TestDevice. 

Kolom

public static final String DISMISS_KEYGUARD_CMD

Perintah yang dapat digunakan untuk menutup keyguard.

Konstruktor publik

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

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)

Metode yang dilindungi

AaptParser createParser(File appFile)
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

Lakukan mulai ulang adb.

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

Metode Bantuan Internal untuk mendapatkan file zip bugreportz sebagai ERROR(/File).

long getCheckNewUserSleep()

Terekspos untuk pengujian.

long getHostCurrentTime()

Terekspos untuk pengujian

void prePostBootSetup()

Mengizinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) untuk mengganti metode ini untuk pengaturan pasca-{i>booting<i} yang spesifik.

Kolom

TUTUP_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Perintah yang dapat digunakan untuk menutup keyguard.

Konstruktor publik

PerangkatPengujian

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

Metode publik

dapatSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Menampilkan apakah diizinkan untuk beralih ke pengguna SYSTEM headless.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

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

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
Menampilkan
DeviceNotAvailableException

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
Menampilkan
DeviceNotAvailableException

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
Menampilkan
DeviceNotAvailableException

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

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)

Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

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

getActiveApexe

public  getActiveApexes ()

Ambil informasi tentang APEX yang diaktifkan di perangkat.

Hasil
ERROR(/Set) dari ApexInfo saat ini diaktifkan di perangkat
Menampilkan
DeviceNotAvailableException

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

getAndroidId

public String getAndroidId (int userId)

Menemukan dan menampilkan ID Android yang terkait dengan userId, null jika tidak ditemukan.

Parameter
userId int

Hasil
String

Menampilkan
DeviceNotAvailableException

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

getAppPackageInfo

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

getAppPackageInfos

public  getAppPackageInfos ()

Mengambil informasi paket yang diinstal pada perangkat.

Hasil
ERROR(/List) dari PackageInfo diinstal di perangkat.
Menampilkan
DeviceNotAvailableException

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

Hasil
InputStreamSource InputStreamSource yang akan menghasilkan konten laporan bug sesuai permintaan. Di beberapa jika terjadi kegagalan, InputStreamSource akan menghasilkan ERROR(/InputStream) kosong.

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' &gt; 1.0.36

Hasil
InputStreamSource InputStreamSource dari file zip yang berisi bugreportz, tampilkan null di jika terjadi kegagalan.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Hasil
DeviceFoldableState

Menampilkan
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Hasil
int

Menampilkan
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Menampilkan daftar status perangkat foldable di perangkat. Dapat diperoleh dengan "cmd device_state status cetak".

Hasil
Menampilkan
DeviceNotAvailableException

getInstallPackageNames

public  getInstalledPackageNames ()

Ambil nama paket aplikasi yang ada di perangkat.

Hasil
ERROR(/Set) dari String nama paket saat ini terinstal di perangkat.
Menampilkan
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

Hasil
KeyguardControllerState KeyguardControllerState yang berisi snapshot status keyguard dan mengembalikan Null jika kueri Keyguard tidak didukung.
Menampilkan
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Menampilkan ID pengguna utama.

Hasil
Integer userId pengguna utama jika ada, dan null jika tidak ada pengguna utama.
Menampilkan
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Dapatkan informasi tentang modul mainline yang diinstal di perangkat.

Hasil
ERROR(/Set) dari String modul mainline saat ini terinstal di perangkat.
Menampilkan
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

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
Menampilkan
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

Hasil
int bilangan bulat yang menunjukkan jumlah pengguna yang didukung
Menampilkan
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Menampilkan ID pengguna utama.

Hasil
Integer userId pengguna utama jika ada, dan null jika tidak ada pengguna utama.
Menampilkan
DeviceNotAvailableException

dapatkanScreenshot

public InputStreamSource getScreenshot ()

Mengambil screenshot dari perangkat.

Hasil
InputStreamSource InputStreamSource dari screenshot dalam format png, atau null jika screenshot tidak berhasil.
Menampilkan
DeviceNotAvailableException

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
Hasil
InputStreamSource InputStreamSource dari screenshot dalam format, atau null jika screenshot tidak berhasil.
Menampilkan
DeviceNotAvailableException

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
Hasil
InputStreamSource InputStreamSource dari screenshot dalam format, atau null jika screenshot tidak berhasil.
Menampilkan
DeviceNotAvailableException

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.
Hasil
InputStreamSource InputStreamSource dari screenshot dalam format, atau null jika screenshot tidak berhasil.
Menampilkan
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Parameter
namespace String

key String

Hasil
String

Menampilkan
DeviceNotAvailableException

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

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

getUserFlags

public int getUserFlags (int userId)

Temukan dan tampilkan tanda pengguna tertentu. Tanda ditentukan di "android.content.pm.UserInfo" di Project Open Source Android.

Parameter
userId int

Hasil
int flag yang terkait dengan userId yang disediakan jika ditemukan, -10000 dalam kasus lainnya.
Menampilkan
DeviceNotAvailableException

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

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Parameter
userId int

Hasil
int

Menampilkan
DeviceNotAvailableException

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

{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.
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

installPackages

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

Parameter
packageFiles

reinstall boolean

extraArgs String

Hasil
String

Menampilkan
DeviceNotAvailableException

installPackages

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

Parameter
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Hasil
String

Menampilkan
DeviceNotAvailableException

installPackagesForUser

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

Parameter
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Hasil
String

Menampilkan
DeviceNotAvailableException

installPackagesForUser

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

Parameter
packageFiles

reinstall boolean

userId int

extraArgs String

Hasil
String

Menampilkan
DeviceNotAvailableException

{i>installRemotePackages<i}

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

Parameter
remoteApkPaths

reinstall boolean

extraArgs String

Hasil
String

Menampilkan
DeviceNotAvailableException

{i>installRemotePackages<i}

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

Parameter
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Hasil
String

Menampilkan
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Periksa apakah platform di perangkat mendukung enumerasi aplikasi

Hasil
boolean True jika enumerasi aplikasi didukung, salah jika tidak
Menampilkan
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Menampilkan apakah perangkat menggunakan mode pengguna sistem headless.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

IsMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isMultiUserDidukung

public boolean isMultiUserSupported ()

Menentukan apakah multi-pengguna didukung.

Hasil
boolean true jika multi-pengguna didukung, false jika tidak
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

{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.
Menampilkan
DeviceNotAvailableException

{i>isUserRunning<i}

public boolean isUserRunning (int userId)

Periksa apakah pengguna tertentu sedang berjalan.

Parameter
userId int

Hasil
boolean True jika pengguna berjalan, false dalam setiap kasus lainnya.
Menampilkan
DeviceNotAvailableException

IsUserSecondary

public boolean isUserSecondary (int userId)

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

Parameter
userId int

Hasil
boolean benar (true) jika pengguna bersifat sekunder, salah (false) jika tidak.
Menampilkan
DeviceNotAvailableException

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

Parameter
userId int

Hasil
boolean

Menampilkan
DeviceNotAvailableException

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

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplayDidukung

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Menampilkan apakah perangkat mengizinkan pengguna untuk memulai dengan terlihat di latar belakang dalam 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 boolean isVisibleBackgroundUsersSupported ()

Menampilkan apakah perangkat mengizinkan pengguna untuk memulai dengan terlihat di latar belakang.

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

Hasil
boolean

Menampilkan
DeviceNotAvailableException

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

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Hasil
Menampilkan
DeviceNotAvailableException

daftarPengguna

public  listUsers ()

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

Hasil
daftar ID pengguna.
Menampilkan
DeviceNotAvailableException

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

removeOwners

public void removeOwners ()

Hapus semua pemilik profil perangkat yang ada dengan upaya terbaik.

Menampilkan
DeviceNotAvailableException

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

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

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

Menampilkan
DeviceNotAvailableException

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

Menampilkan
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Mematikan perangkat mikrodroid, jika ada.

Parameter
microdroidDevice ITestDevice

Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

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

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

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

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

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

Parameter
userId int

Hasil
boolean True jika userId baru cocok dengan penyedia userId. Salah jika sebaliknya.
Menampilkan
DeviceNotAvailableException

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

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

Hasil
Bugreport

{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.
Menampilkan
DeviceNotAvailableException

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

tungguForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Parameter
currentPhase SnapuserdWaitPhase

Menampilkan
DeviceNotAvailableException

Metode yang dilindungi

createParser

protected AaptParser createParser (File appFile)

Parameter
appFile File

Hasil
AaptParser

{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.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Hasil
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Metode Bantuan Internal untuk mendapatkan file zip bugreportz sebagai ERROR(/File).

Hasil
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Terekspos untuk pengujian.

Hasil
long

getHostCurrentTime

protected long getHostCurrentTime ()

Terekspos untuk pengujian

Hasil
long

prePostBootSetup

protected void prePostBootSetup ()

Mengizinkan setiap jenis perangkat (AndroidNativeDevice, TestDevice) untuk mengganti metode ini untuk pengaturan pasca-{i>booting<i} yang spesifik.

Menampilkan
DeviceNotAvailableException