INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Menyediakan API tingkat yang andal dan sedikit lebih tinggi ke ddmlib IDevice
.
Ringkasan
Konstanta | |
---|---|
int | UNKNOWN_API_LEVEL Nilai default ketika API Level tidak dapat dideteksi |
Metode publik | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Periksa apakah suatu fitur saat ini didukung dengan tingkat dukungan minimal. |
abstract void | clearLogcat () Menghapus semua data logcat yang terkumpul. |
abstract void | deleteFile (String deviceFilePath) Metode pembantu untuk menghapus file atau direktori pada perangkat. |
abstract boolean | disableAdbRoot () Mematikan adb root. |
abstract boolean | doesFileExist (String deviceFilePath) Metode pembantu untuk menentukan apakah file di perangkat ada. |
abstract boolean | enableAdbRoot () Mengaktifkan adb root. |
abstract boolean | encryptDevice (boolean inplace) Mengenkripsi perangkat. |
abstract String | executeAdbCommand (String... commandArgs) Metode helper yang menjalankan perintah adb sebagai perintah sistem. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) Metode helper yang menjalankan perintah fastboot sebagai perintah sistem dengan batas waktu default 2 menit. |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) Metode pembantu yang menjalankan perintah fastboot sebagai perintah sistem. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) Metode pembantu yang menjalankan perintah fastboot yang sudah lama berjalan sebagai perintah sistem. |
abstract String | executeShellCommand (String command) Metode pembantu yang menjalankan perintah shell adb dan mengembalikan keluaran sebagai |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) Menjalankan perintah adb shell yang diberikan, mencoba lagi beberapa kali jika perintah gagal. |
abstract CommandResult | executeShellV2Command (String command) Metode pembantu yang menjalankan perintah shell adb dan mengembalikan hasil sebagai |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) Metode pembantu yang menjalankan perintah shell adb dan mengembalikan hasil sebagai |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) Metode pembantu yang menjalankan perintah shell adb dan mengembalikan hasil sebagai |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah. |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah. |
abstract CommandResult | fastbootWipePartition (String partition) Metode pembantu yang menghapus partisi untuk perangkat. |
abstract int | getApiLevel () Dapatkan API Level perangkat. |
abstract String | getBasebandVersion () Metode kemudahan untuk mendapatkan versi baseband (radio) dari perangkat ini. |
abstract Integer | getBattery () Mengembalikan level baterai perangkat saat ini atau Null jika level baterai tidak tersedia. |
abstract String | getBootloaderVersion () Metode kemudahan untuk mendapatkan versi bootloader dari perangkat ini. |
abstract InputStreamSource | getBugreport () Mengambil laporan bug dari perangkat. |
abstract InputStreamSource | getBugreportz () Mengambil bugreportz dari perangkat. |
abstract String | getBuildAlias () Ambil alias dari build yang saat ini dijalankan oleh perangkat. |
abstract String | getBuildFlavor () Ambil ragam build untuk perangkat. |
abstract String | getBuildId () Ambil build yang sedang dijalankan perangkat. |
abstract String | getBuildSigningKeys () Mengembalikan jenis kunci yang digunakan untuk menandatangani gambar perangkat Biasanya perangkat Android dapat ditandatangani dengan kunci uji (seperti di AOSP) atau kunci rilis (dikontrol oleh produsen perangkat individu) |
abstract String[] | getChildren (String deviceFilePath) Alternatif untuk menggunakan |
abstract String | getDeviceClass () Dapatkan kelas perangkat. |
abstract long | getDeviceDate () Kembalikan tanggal perangkat dalam milidetik sejak periode. |
abstract DeviceDescriptor | getDeviceDescriptor () Kembalikan |
abstract TestDeviceState | getDeviceState () Dapatkan status perangkat. |
abstract long | getDeviceTimeOffset (Date date) Pembantu untuk mendapatkan perbedaan waktu antara perangkat dan |
abstract InputStreamSource | getEmulatorOutput () Dapatkan aliran emulator stdout dan stderr |
abstract long | getExternalStoreFreeSpace () Metode pembantu untuk menentukan jumlah ruang kosong pada penyimpanan eksternal perangkat. |
abstract String | getFastbootProductType () Metode kemudahan untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot. |
abstract String | getFastbootProductVariant () Metode kemudahan untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot. |
abstract IFileEntry | getFileEntry (String path) Ambil referensi ke file jarak jauh di perangkat. |
abstract IDevice | getIDevice () Mengembalikan referensi ke ddmlib |
abstract long | getLastExpectedRebootTimeMillis () Mengembalikan terakhir kali Tradefed API memicu boot ulang dalam milidetik sejak EPOCH seperti yang dikembalikan oleh |
abstract InputStreamSource | getLogcat () Mendapatkan aliran snapshot dari data logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) |
abstract InputStreamSource | getLogcatDump () Dapatkan dump logcat saat ini untuk perangkat. |
abstract InputStreamSource | getLogcatSince (long date) Mendapatkan aliran snapshot dari data logcat yang diambil mulai tanggal yang disediakan. |
abstract String | getMountPoint (String mountName) Mengembalikan titik pemasangan. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Mengembalikan |
abstract | getMountPointInfo () Mengembalikan versi informasi yang sudah diurai di / proc / mounts di perangkat |
abstract long | getPartitionFreeSpace (String partition) Metode pembantu untuk menentukan jumlah ruang kosong pada partisi perangkat. |
abstract ProcessInfo | getProcessByName (String processName) Metode helper menjalankan perintah "ps" dan mengembalikan USER, PID dan NAMA dari nama proses yang diberikan. |
abstract String | getProcessPid (String process) Mengembalikan pid dari layanan atau null jika terjadi kesalahan. |
abstract | getProcesses () Metode helper menjalankan perintah "ps" dan mengembalikan daftar PENGGUNA, PID dan NAMA dari semua proses. |
abstract String | getProductType () Metode kemudahan untuk mendapatkan jenis produk perangkat ini. |
abstract String | getProductVariant () Metode kemudahan untuk mendapatkan varian produk perangkat ini. |
abstract String | getProperty (String name) Ambil nilai properti yang diberikan dari perangkat. |
abstract ITestDevice.RecoveryMode | getRecoveryMode () Dapatkan mode pemulihan saat ini yang digunakan untuk perangkat. |
abstract String | getSerialNumber () Metode kemudahan untuk mendapatkan nomor seri perangkat ini. |
abstract | getTombstones () Ambil dan kembalikan daftar batu nisan dari perangkat. |
abstract long | getTotalMemory () Mengembalikan ukuran memori fisik total dalam byte atau -1 jika terjadi kesalahan internal |
abstract boolean | getUseFastbootErase () Dapatkan apakah akan menggunakan fastboot erase atau fastboot format untuk menghapus partisi pada perangkat. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isDeviceEncrypted () Kembali jika perangkat dienkripsi. |
abstract boolean | isDirectory (String deviceFilePath) Kembalikan True jika jalur pada perangkat adalah direktori, salah jika sebaliknya. |
abstract boolean | isEncryptionSupported () Kembali jika enkripsi didukung pada perangkat. |
abstract boolean | isExecutable (String fullPath) Mengembalikan True jika jalur file pada perangkat adalah file yang dapat dieksekusi, salah jika sebaliknya. |
abstract boolean | isHeadless () Kembalikan nilai benar jika perangkat tanpa kepala (tanpa layar), salah jika sebaliknya. |
abstract boolean | isRuntimePermissionSupported () Periksa apakah platform pada perangkat mendukung pemberian izin waktu proses |
abstract boolean | logBugreport (String dataName, ITestLogger listener) Metode pembantu untuk mengambil laporan bug dan mencatatnya ke reporter. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Catat pesan di logcat perangkat. |
abstract void | nonBlockingReboot () Mengeluarkan perintah untuk mem-boot ulang perangkat dan kembali saat perintah selesai dan saat perangkat tidak lagi terlihat oleh adb. |
abstract void | postBootSetup () Lakukan instruksi untuk mengkonfigurasi perangkat untuk mengujinya setelah setiap boot. |
abstract void | postInvocationTearDown () Langkah-langkah ekstra untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan selesai. |
abstract void | preInvocationSetup ( IBuildInfo info) Langkah-langkah tambahan untuk penyiapan khusus perangkat yang diperlukan yang akan dijalankan di perangkat sebelum aliran pemanggilan. |
default void | preInvocationSetup ( IBuildInfo info, testResourceBuildInfos) preInvocationSetup ( IBuildInfo info, testResourceBuildInfos) Langkah-langkah tambahan untuk penyiapan khusus perangkat yang diperlukan yang akan dijalankan di perangkat sebelum aliran pemanggilan. |
abstract boolean | pullDir (String deviceFilePath, File localDir) Menarik konten direktori secara rekursif dari perangkat. |
abstract File | pullFile (String remoteFilePath) Mengambil file dari perangkat, menyimpannya di |
abstract boolean | pullFile (String remoteFilePath, File localFile) Mengambil file dari perangkat. |
abstract String | pullFileContents (String remoteFilePath) Mengambil file dari perangkat, dan mengembalikan isinya. |
abstract File | pullFileFromExternal (String remoteFilePath) Metode praktis untuk mengambil file dari penyimpanan eksternal perangkat, menyimpannya di |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) Mendorong konten direktori ke perangkat secara rekursif sambil mengecualikan beberapa direktori yang difilter. |
abstract boolean | pushDir (File localDir, String deviceFilePath) Mendorong konten direktori ke perangkat secara rekursif. |
abstract boolean | pushFile (File localFile, String deviceFilePath) Dorong file ke perangkat |
abstract boolean | pushString (String contents, String deviceFilePath) File push dibuat dari string ke perangkat |
abstract void | reboot () Reboot perangkat ke mode adb. |
abstract void | rebootIntoBootloader () Reboot perangkat ke mode bootloader. |
abstract void | rebootIntoRecovery () Reboot perangkat ke mode pemulihan adb. |
abstract void | rebootUntilOnline () Alternatif untuk |
abstract void | remountSystemWritable () Buat partisi sistem di perangkat dapat ditulis. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Metode kemudahan untuk menjalankan |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Menjalankan uji instrumentasi, dan menyediakan pemulihan perangkat. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Sama seperti |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Sama seperti |
abstract void | setDate (Date date) Set tanggal di perangkat Catatan: mengatur tanggal pada perangkat membutuhkan root |
abstract void | setOptions ( TestDeviceOptions options) Setel |
abstract boolean | setProperty (String propKey, String propValue) Menetapkan nilai properti yang diberikan di perangkat. |
abstract void | setRecovery ( IDeviceRecovery recovery) Setel |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Atur mode pemulihan saat ini yang akan digunakan untuk perangkat. |
abstract void | setUseFastbootErase (boolean useFastbootErase) Setel apakah akan menggunakan fastboot erase atau fastboot format untuk menghapus partisi pada perangkat. |
abstract void | startLogcat () Mulai ambil keluaran logcat dari perangkat di latar belakang. |
abstract void | stopEmulatorOutput () Tutup dan hapus keluaran emulator. |
abstract void | stopLogcat () Berhenti menangkap keluaran logcat dari perangkat, dan buang data logcat yang saat ini disimpan. |
abstract String | switchToAdbTcp () Alihkan perangkat ke mode adb-over-tcp. |
abstract boolean | switchToAdbUsb () Alihkan perangkat ke mode adb melalui usb. |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) Secara bertahap menyinkronkan konten direktori file lokal ke perangkat. |
abstract Bugreport | takeBugreport () Ambil laporan bug dan kembalikan ke dalam objek |
abstract boolean | unencryptDevice () Batalkan enkripsi perangkat. |
abstract boolean | unlockDevice () Membuka kunci perangkat jika perangkat dalam keadaan terenkripsi. |
abstract boolean | waitForBootComplete (long timeOut) Memblokir hingga flag selesai boot perangkat disetel. |
abstract void | waitForDeviceAvailable () Menunggu perangkat menjadi responsif dan tersedia untuk pengujian. |
abstract void | waitForDeviceAvailable (long waitTime) Menunggu perangkat menjadi responsif dan tersedia untuk pengujian. |
abstract boolean | waitForDeviceInRecovery (long waitTime) Blok untuk perangkat agar berada dalam status 'pemulihan adb' (perhatikan ini berbeda dari |
abstract boolean | waitForDeviceNotAvailable (long waitTime) Blok untuk perangkat tidak tersedia yaitu hilang dari adb |
abstract void | waitForDeviceOnline () Memblokir hingga perangkat terlihat melalui adb. |
abstract void | waitForDeviceOnline (long waitTime) Memblokir hingga perangkat terlihat melalui adb. |
abstract boolean | waitForDeviceShell (long waitTime) Menunggu perangkat merespons perintah shell adb dasar. |
Konstanta
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Nilai default ketika API Level tidak dapat dideteksi
Nilai Konstanta: -1 (0xffffffff)
Metode publik
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel).dll
Periksa apakah suatu fitur saat ini didukung dengan tingkat dukungan minimal. Metode ini memperhitungkan fitur yang belum dirilis, sebelum level API dinaikkan.
Parameter | |
---|---|
strictMinLevel | int : Tingkat min yang ketat yang mendukung fitur tersebut. |
Kembali | |
---|---|
boolean | Benar jika levelnya didukung. Salah sebaliknya. |
Melempar | |
---|---|
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
Menghapus semua data logcat yang terkumpul.
Ini berguna untuk kasus ketika Anda ingin memastikanITestDevice#getLogcat()
hanya mengembalikan data log yang dihasilkan setelah titik tertentu (seperti setelah ITestDevice#getLogcat()
build perangkat baru, dll).menghapus berkas
public abstract void deleteFile (String deviceFilePath)
Metode pembantu untuk menghapus file atau direktori pada perangkat.
Parameter | |
---|---|
deviceFilePath | String : Jalur absolut file di perangkat. |
Melempar | |
---|---|
DeviceNotAvailableException |
disableAdbRoot
public abstract boolean disableAdbRoot ()
Mematikan adb root.
Menonaktifkan adb root dapat menyebabkan perangkat terputus dari adb. Metode ini akan memblokir hingga perangkat tersedia.Kembali | |
---|---|
boolean | true jika berhasil. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Metode pembantu untuk menentukan apakah file di perangkat ada.
Parameter | |
---|---|
deviceFilePath | String : jalur absolut file di perangkat untuk diperiksa |
Kembali | |
---|---|
boolean | true jika file ada, false jika tidak. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
Mengaktifkan adb root. Jika pengaturan "enable-root" adalah "false", akan mencatat pesan dan kembali tanpa mengaktifkan root.
Mengaktifkan adb root dapat menyebabkan perangkat terputus dari adb. Metode ini akan memblokir hingga perangkat tersedia.Kembali | |
---|---|
boolean | true jika berhasil. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
encryptDevice
public abstract boolean encryptDevice (boolean inplace)
Mengenkripsi perangkat.
Mengenkripsi perangkat dapat dilakukan di tempat atau dengan penghapusan. Enkripsi di tempat tidak akan menghapus data apa pun di perangkat tetapi biasanya membutuhkan beberapa kali lipat lebih lama daripada penghapusan. Metode ini akan me-reboot perangkat jika belum dienkripsi dan akan memblokir hingga perangkat online. Juga, itu tidak akan mendekripsi perangkat setelah reboot. Oleh karena itu, perangkat mungkin tidak sepenuhnya di-boot dan / atau siap untuk diuji ketika metode ini kembali.Parameter | |
---|---|
inplace | boolean : jika proses enkripsi harus dilakukan dan perangkat tidak boleh dihapus. |
Kembali | |
---|---|
boolean | true jika berhasil. |
Melempar | |
---|---|
DeviceNotAvailableException | jika perangkat tidak tersedia setelah reboot. |
UnsupportedOperationException | jika enkripsi tidak didukung pada perangkat. |
eksekusiAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Metode helper yang menjalankan perintah adb sebagai perintah sistem.
executeShellCommand(String)
sebaiknya digunakan jika memungkinkan, karena metode tersebut memberikan performa dan deteksi kegagalan yang lebih baik.Parameter | |
---|---|
commandArgs | String : perintah adb dan argumen yang akan dijalankan |
Kembali | |
---|---|
String | stdout dari perintah. null jika perintah gagal dijalankan. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiFastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Metode helper yang menjalankan perintah fastboot sebagai perintah sistem dengan batas waktu default 2 menit.
Diharapkan dapat digunakan saat perangkat sudah dalam mode fastboot.Parameter | |
---|---|
commandArgs | String : perintah fastboot dan argumen untuk dijalankan |
Kembali | |
---|---|
CommandResult | CommandResult yang berisi keluaran dari perintah |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiFastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Metode pembantu yang menjalankan perintah fastboot sebagai perintah sistem.
Diharapkan dapat digunakan saat perangkat sudah dalam mode fastboot.Parameter | |
---|---|
timeout | long : waktu dalam milidetik sebelum perintah berakhir |
commandArgs | String : perintah fastboot dan argumen untuk dijalankan |
Kembali | |
---|---|
CommandResult | CommandResult yang berisi keluaran dari perintah |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Metode pembantu yang menjalankan perintah fastboot yang sudah lama berjalan sebagai perintah sistem.
Identik untukexecuteFastbootCommand(String)
kecuali menggunakan waktu tunggu yang lebih lama.Parameter | |
---|---|
commandArgs | String : perintah fastboot dan argumen untuk dijalankan |
Kembali | |
---|---|
CommandResult | CommandResult yang berisi keluaran dari perintah |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellCommand
public abstract String executeShellCommand (String command)
Metode helper yang menjalankan perintah adb shell dan mengembalikan keluaran sebagaiString
.
Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
Kembali | |
---|---|
String | keluaran shell |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah.
Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
receiver | IShellOutputReceiver : IShellOutputReceiver untuk mengarahkan keluaran shell. |
maxTimeToOutputShellResponse | long : jumlah waktu maksimum selama perintah yang diizinkan untuk tidak menampilkan respons apa pun; unit seperti yang ditentukan dalam timeUnit |
timeUnit | TimeUnit : unit untuk maxTimeToOutputShellResponse |
retryAttempts | int : jumlah maksimum percobaan ulang perintah jika gagal karena pengecualian. DeviceNotResponsiveException akan ditampilkan jika retryAttempts dilakukan tanpa hasil. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah.
Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
receiver | IShellOutputReceiver : IShellOutputReceiver untuk mengarahkan keluaran shell. |
maxTimeoutForCommand | long : batas waktu maksimum untuk menyelesaikan perintah; unit seperti yang ditentukan dalam timeUnit |
maxTimeToOutputShellResponse | long : jumlah waktu maksimum selama perintah yang diizinkan untuk tidak menampilkan respons apa pun; unit seperti yang ditentukan dalam timeUnit |
timeUnit | TimeUnit : unit untuk maxTimeToOutputShellResponse |
retryAttempts | int : jumlah maksimum percobaan ulang perintah jika gagal karena pengecualian. DeviceNotResponsiveException akan ditampilkan jika retryAttempts dilakukan tanpa hasil. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
Menjalankan perintah adb shell yang diberikan, mencoba lagi beberapa kali jika perintah gagal.
Bentuk yang lebih sederhana dariexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
dengan nilai default.Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
receiver | IShellOutputReceiver : IShellOutputReceiver untuk mengarahkan keluaran shell. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellV2Command
public abstract CommandResult executeShellV2Command (String command)
Metode pembantu yang menjalankan perintah shell adb dan mengembalikan hasil sebagai CommandResult
diisi dengan benar dengan keluaran status perintah, stdout dan stderr.
Parameter | |
---|---|
command | String : Perintah yang harus dijalankan. |
Kembali | |
---|---|
CommandResult | Hasilnya di CommandResult . |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Metode pembantu yang menjalankan perintah shell adb dan mengembalikan hasil sebagai CommandResult
diisi dengan benar dengan keluaran status perintah, stdout dan stderr.
Parameter | |
---|---|
command | String : Perintah yang harus dijalankan. |
pipeToOutput | OutputStream : ERROR(/OutputStream) mana output std akan dialihkan. |
Kembali | |
---|---|
CommandResult | Hasilnya di CommandResult . |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Metode pembantu yang menjalankan perintah shell adb dan mengembalikan hasil sebagai CommandResult
diisi dengan benar dengan keluaran status perintah, stdout dan stderr.
Parameter | |
---|---|
command | String : Perintah yang harus dijalankan. |
pipeAsInput | File : ERROR(/File) yang akan disalurkan sebagai input ke perintah. |
Kembali | |
---|---|
CommandResult | Hasilnya di CommandResult . |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
eksekusiShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah.
Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
maxTimeoutForCommand | long : batas waktu maksimum untuk menyelesaikan perintah; unit seperti yang ditentukan dalam timeUnit |
timeUnit | TimeUnit : unit untuk maxTimeToOutputShellResponse |
retryAttempts | int : jumlah maksimum percobaan ulang perintah jika gagal karena pengecualian. DeviceNotResponsiveException akan ditampilkan jika retryAttempts dilakukan tanpa hasil. |
Kembali | |
---|---|
CommandResult |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
Lihat juga:
eksekusiShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah.
Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
maxTimeoutForCommand | long : batas waktu maksimum untuk menyelesaikan perintah; unit seperti yang ditentukan dalam timeUnit |
timeUnit | TimeUnit : unit untuk maxTimeToOutputShellResponse |
Kembali | |
---|---|
CommandResult |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
Lihat juga:
eksekusiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Menjalankan perintah adb shell, dengan lebih banyak parameter untuk mengontrol perilaku perintah.
Parameter | |
---|---|
command | String : perintah adb shell yang akan dijalankan |
pipeAsInput | File : ERROR(/File) yang akan disalurkan sebagai input ke perintah. |
pipeToOutput | OutputStream : ERROR(/OutputStream) mana output std akan dialihkan. |
maxTimeoutForCommand | long : batas waktu maksimum untuk menyelesaikan perintah; unit seperti yang ditentukan dalam timeUnit |
timeUnit | TimeUnit : unit untuk maxTimeToOutputShellResponse |
retryAttempts | int : jumlah maksimum percobaan ulang perintah jika gagal karena pengecualian. DeviceNotResponsiveException akan ditampilkan jika retryAttempts dilakukan tanpa hasil. |
Kembali | |
---|---|
CommandResult |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
Lihat juga:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Metode pembantu yang menghapus partisi untuk perangkat.
JikagetUseFastbootErase()
true
, maka fastboot erase akan digunakan untuk menghapus partisi. Perangkat kemudian harus membuat sistem file saat perangkat melakukan booting di lain waktu. Jika tidak, format fastboot digunakan yang akan membuat sistem file baru pada perangkat. Diharapkan dapat digunakan saat perangkat sudah dalam mode fastboot.Parameter | |
---|---|
partition | String : partisi yang akan dihapus |
Kembali | |
---|---|
CommandResult | CommandResult yang berisi keluaran dari perintah |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getApiLevel
public abstract int getApiLevel ()
Dapatkan API Level perangkat. Default-nya adalah UNKNOWN_API_LEVEL
.
Kembali | |
---|---|
int | bilangan bulat yang menunjukkan API Level perangkat |
Melempar | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Metode kemudahan untuk mendapatkan versi baseband (radio) dari perangkat ini. Mendapatkan versi radio tergantung pada perangkat, jadi mungkin tidak mengembalikan informasi yang benar untuk semua perangkat. Metode ini bergantung pada propery gsm.version.baseband untuk mengembalikan informasi versi yang benar. Ini tidak akurat untuk beberapa perangkat CDMA dan versi yang dikembalikan di sini mungkin tidak cocok dengan versi yang dilaporkan dari fastboot dan mungkin tidak mengembalikan versi untuk radio CDMA. TL; DR metode ini hanya melaporkan versi akurat jika properti gsm.version.baseband sama dengan versi yang dikembalikan oleh fastboot getvar version-baseband
.
Kembali | |
---|---|
String | versi pita dasarString atau null jika tidak dapat ditentukan (perangkat tidak memiliki radio atau string versi tidak dapat dibaca) |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getBattery
public abstract Integer getBattery ()
Mengembalikan level baterai perangkat saat ini atau Null jika level baterai tidak tersedia.
Kembali | |
---|---|
Integer |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Metode kemudahan untuk mendapatkan versi bootloader dari perangkat ini.
Akan mencoba mengambil versi bootloader dari status perangkat saat ini. (yaitu jika perangkat dalam mode fastboot, itu akan mencoba untuk mengambil versi dari fastboot)Kembali | |
---|---|
String | versiString bootloader atau null jika tidak dapat ditemukan |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getBugreport
public abstract InputStreamSource getBugreport ()
Mengambil laporan bug dari perangkat.
Implementasi ini dijamin akan terus berfungsi di perangkat tanpa kartu sd (atau di mana sdcard belum dipasang).Kembali | |
---|---|
InputStreamSource | InputStreamSource yang akan menghasilkan konten laporan bug sesuai permintaan. Jika terjadi kegagalan, InputStreamSource akan menghasilkan ERROR(/InputStream) kosong. |
getBugreportz
public abstract InputStreamSource getBugreportz ()
Mengambil bugreportz dari perangkat. Laporan bug format zip berisi laporan bug utama dan file log lain yang berguna untuk debugging.
Hanya didukung untuk 'versi adb'> 1.0.36Kembali | |
---|---|
InputStreamSource | a InputStreamSource dari file zip yang berisi bugreportz, mengembalikan null jika terjadi kegagalan. |
getBuildAlias
public abstract String getBuildAlias ()
Ambil alias dari build yang saat ini dijalankan oleh perangkat.
Alias build biasanya berupa string yang lebih mudah dibaca daripada build id (biasanya angka untuk build Nexus). Misalnya, rilis Android 4.2 final memiliki alias build JDQ39, dan build id 573038
Kembali | |
---|---|
String | alias build atau fall back ke build id jika tidak bisa diambil |
Melempar | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Ambil ragam build untuk perangkat.
Kembali | |
---|---|
String | ragam build atau null jika tidak dapat diambil |
Melempar | |
---|---|
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Ambil build yang sedang dijalankan perangkat.
Kembali | |
---|---|
String | id build atau IBuildInfo#UNKNOWN_BUILD_ID jika tidak dapat diambil |
Melempar | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Mengembalikan jenis kunci yang digunakan untuk menandatangani gambar perangkat
Biasanya perangkat Android dapat ditandatangani dengan kunci uji (seperti di AOSP) atau kunci rilis (dikontrol oleh produsen perangkat individu)
Kembali | |
---|---|
String | Kunci penandatanganan jika ditemukan, null jika tidak. |
Melempar | |
---|---|
DeviceNotAvailableException |
getChildren
public abstract String[] getChildren (String deviceFilePath)
Alternatif untuk menggunakan IFileEntry
yang terkadang tidak berfungsi karena izin.
Parameter | |
---|---|
deviceFilePath | String : adalah jalur di perangkat tempat melakukan pencarian |
Kembali | |
---|---|
String[] | Larik string yang berisi semua file di jalur pada perangkat. |
Melempar | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public abstract String getDeviceClass ()
Dapatkan kelas perangkat.
Kembali | |
---|---|
String | kelas perangkatString . |
getDeviceDate
public abstract long getDeviceDate ()
Kembalikan tanggal perangkat dalam milidetik sejak periode.
Kembali | |
---|---|
long | tanggal perangkat dalam format zaman. |
Melempar | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Kembalikan DeviceDescriptor
dari informasi perangkat untuk mendapatkan infonya tanpa meneruskan objek perangkat sebenarnya.
Kembali | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
Dapatkan status perangkat.
Kembali | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Pembantu untuk mendapatkan perbedaan waktu antara perangkat dan ERROR(/Date)
. Gunakan waktu Epoch secara internal.
Parameter | |
---|---|
date | Date |
Kembali | |
---|---|
long | perbedaan dalam milidetik |
Melempar | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Dapatkan aliran emulator stdout dan stderr
Kembali | |
---|---|
InputStreamSource | keluaran emulator |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Metode pembantu untuk menentukan jumlah ruang kosong pada penyimpanan eksternal perangkat.
Kembali | |
---|---|
long | jumlah ruang kosong dalam KB |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getFastbootProductType
public abstract String getFastbootProductType ()
Metode kemudahan untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot.
Metode ini hanya boleh digunakan jika perangkat harus di fastboot. Variannya sedikit lebih aman daripada metodegetProductType()
generik dalam kasus ini, karena ITestDevice akan tahu untuk memulihkan perangkat ke fastboot jika perangkat dalam keadaan salah atau tidak responsif.Kembali | |
---|---|
String | nama tipe produkString atau null jika tidak dapat ditentukan |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Metode kemudahan untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot.
Metode ini hanya boleh digunakan jika perangkat harus di fastboot. Variannya sedikit lebih aman daripada metodegetProductType()
generik dalam kasus ini, karena ITestDevice akan tahu untuk memulihkan perangkat ke fastboot jika perangkat dalam keadaan salah atau tidak responsif.Kembali | |
---|---|
String | nama tipe produkString atau null jika tidak dapat ditentukan |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Ambil referensi ke file jarak jauh di perangkat.
Parameter | |
---|---|
path | String : jalur file yang akan diambil. Bisa berupa jalur absolut atau jalur yang berhubungan dengan '/'. (yaitu, sintaks "/ system" dan "system" didukung) |
Kembali | |
---|---|
IFileEntry | IFileEntry atau null jika file di path tertentu tidak dapat ditemukan |
Melempar | |
---|---|
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Mengembalikan referensi ke ddmlib IDevice
terkait.
IDevice
baru dapat dialokasikan oleh DDMS setiap kali perangkat terputus dan tersambung kembali dari adb. Oleh karena itu, penelepon tidak boleh menyimpan referensi ke IDevice
, karena referensi itu mungkin sudah IDevice
.Kembali | |
---|---|
IDevice | IDevice |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Mengembalikan terakhir kali Tradefed API memicu boot ulang dalam milidetik sejak EPOCH seperti yang dikembalikan oleh System.currentTimeMillis()
.
Kembali | |
---|---|
long |
getLogcat
public abstract InputStreamSource getLogcat ()
Mendapatkan aliran snapshot dari data logcat.
Bekerja dalam dua mode:
TestDeviceOptions#getMaxLogcatDataSize()
byte dari konten saat ini dari tangkapan logcat latar belakangKembali | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
maxBytes
aliran snapshot dari maxBytes
terakhir dari data logcat yang diambil.
Berguna untuk kasus ketika Anda ingin mengambil snapshot data logcat yang diambil secara rutin tanpa menimbulkan penalti ruang disk yang berpotensi besar karena mendapatkan seluruh snapshot getLogcat()
.
Parameter | |
---|---|
maxBytes | int : jumlah data maksimum untuk dikembalikan. Harus menjadi jumlah yang dapat dengan nyaman masuk ke dalam memori |
Kembali | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Dapatkan dump logcat saat ini untuk perangkat. Tidak seperti getLogcat()
, metode ini akan selalu mengembalikan dump statis logcat.
Memiliki kelemahan yaitu tidak ada yang dikembalikan jika perangkat tidak terjangkau.
Kembali | |
---|---|
InputStreamSource | sebuah InputStreamSource dari data logcat. Aliran kosong dikembalikan jika gagal menangkap data logcat. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Mendapatkan aliran snapshot dari data logcat yang diambil mulai tanggal yang disediakan. Waktu di perangkat harus digunakan getDeviceDate()
.
Parameter | |
---|---|
date | long : dalam milidetik sejak format epoch kapan harus memulai snapshot hingga saat ini. (dapat diperoleh menggunakan 'date +% s') |
Kembali | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Mengembalikan titik pemasangan.
Kueri perangkat secara langsung jika info yang di-cache diIDevice
tidak tersedia. TODO: pindahkan perilaku ini ke IDevice#getMountPoint(String)
Parameter | |
---|---|
mountName | String : nama titik pemasangan |
Kembali | |
---|---|
String | mount point atau null |
Lihat juga:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Mengembalikan MountPointInfo
sesuai dengan jalur titik MountPointInfo
yang ditentukan, atau null
jika jalur tersebut tidak memiliki apa pun yang terpasang atau sebaliknya tidak muncul di / proc / mounts sebagai titik pemasangan.
Parameter | |
---|---|
mountpoint | String |
Kembali | |
---|---|
ITestDevice.MountPointInfo | ERROR(/List) MountPointInfo berisi informasi di "/ proc / mounts" |
Melempar | |
---|---|
DeviceNotAvailableException |
Lihat juga:
getMountPointInfo
public abstractgetMountPointInfo ()
Mengembalikan versi informasi yang sudah diurai di / proc / mounts di perangkat
Kembali | |
---|---|
ERROR(/List) MountPointInfo berisi informasi di "/ proc / mounts" |
Melempar | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Metode pembantu untuk menentukan jumlah ruang kosong pada partisi perangkat.
Parameter | |
---|---|
partition | String |
Kembali | |
---|---|
long | jumlah ruang kosong dalam KB |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
Metode helper menjalankan perintah "ps" dan mengembalikan USER, PID dan NAMA dari nama proses yang diberikan.
Parameter | |
---|---|
processName | String |
Kembali | |
---|---|
ProcessInfo | ProcessInfo dari processName yang diberikan |
Melempar | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Mengembalikan pid dari layanan atau null jika terjadi kesalahan.
Parameter | |
---|---|
process | String |
Kembali | |
---|---|
String |
Melempar | |
---|---|
DeviceNotAvailableException |
getProcesses
public abstractgetProcesses ()
Metode helper menjalankan perintah "ps" dan mengembalikan daftar PENGGUNA, PID dan NAMA dari semua proses.
Kembali | |
---|---|
Daftar objek ProcessInfo |
Melempar | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Metode kemudahan untuk mendapatkan jenis produk perangkat ini.
Metode ini akan berfungsi jika perangkat dalam mode adb atau fastboot.Kembali | |
---|---|
String | nama tipe produkString . Tidak akan menjadi nol |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan, atau jika jenis produk tidak dapat ditentukan |
getProductVariant
public abstract String getProductVariant ()
Metode kemudahan untuk mendapatkan varian produk perangkat ini.
Metode ini akan berfungsi jika perangkat dalam mode adb atau fastboot.Kembali | |
---|---|
String | nama varian produkString atau null jika tidak dapat ditentukan |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
getProperty
public abstract String getProperty (String name)
Ambil nilai properti yang diberikan dari perangkat.
Parameter | |
---|---|
name | String : nama properti |
Kembali | |
---|---|
String | nilai properti atau null jika tidak ada |
Melempar | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Dapatkan mode pemulihan saat ini yang digunakan untuk perangkat.
Kembali | |
---|---|
ITestDevice.RecoveryMode | mode pemulihan saat ini yang digunakan untuk perangkat. |
getSerialNumber
public abstract String getSerialNumber ()
Metode kemudahan untuk mendapatkan nomor seri perangkat ini.
Kembali | |
---|---|
String | nomor seriString |
getTombstones
public abstractgetTombstones ()
Ambil dan kembalikan daftar batu nisan dari perangkat. Membutuhkan root.
Metode adalah upaya terbaik sehingga jika salah satu batu nisan gagal ditarik karena alasan apa pun, itu akan hilang dari daftar. Hanya DeviceNotAvailableException
akan menghentikan metode ini lebih awal.
Kembali | |
---|---|
Daftar file batu nisan, kosong jika tidak ada batu nisan. |
Melempar | |
---|---|
DeviceNotAvailableException |
Lihat juga:
getTotalMemory
public abstract long getTotalMemory ()
Mengembalikan ukuran memori fisik total dalam byte atau -1 jika terjadi kesalahan internal
Kembali | |
---|---|
long |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Dapatkan apakah akan menggunakan fastboot erase atau fastboot format untuk menghapus partisi pada perangkat.
Kembali | |
---|---|
boolean | true jika fastboot erase akan digunakan atau false jika format fastboot akan digunakan. |
Lihat juga:
isAdbRoot
public abstract boolean isAdbRoot ()
Kembali | |
---|---|
boolean | true jika perangkat saat ini memiliki root adb, false jika tidak. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
isAdbTcp
public abstract boolean isAdbTcp ()
Kembali | |
---|---|
boolean | true jika perangkat terhubung ke adb-over-tcp, false jika tidak. |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Kembali jika perangkat dienkripsi.
Kembali | |
---|---|
boolean | true jika perangkat dienkripsi. |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan. |
isDirectory
public abstract boolean isDirectory (String deviceFilePath)
Kembalikan True jika jalur pada perangkat adalah direktori, salah jika sebaliknya.
Parameter | |
---|---|
deviceFilePath | String |
Kembali | |
---|---|
boolean |
Melempar | |
---|---|
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Kembali jika enkripsi didukung pada perangkat.
Kembali | |
---|---|
boolean | true jika perangkat mendukung enkripsi. |
Melempar | |
---|---|
DeviceNotAvailableException |
isExecutable
public abstract boolean isExecutable (String fullPath)
Mengembalikan True jika jalur file pada perangkat adalah file yang dapat dieksekusi, salah jika sebaliknya.
Parameter | |
---|---|
fullPath | String |
Kembali | |
---|---|
boolean |
Melempar | |
---|---|
DeviceNotAvailableException |
isHeadless
public abstract boolean isHeadless ()
Kembalikan nilai benar jika perangkat tanpa kepala (tanpa layar), salah jika sebaliknya.
Kembali | |
---|---|
boolean |
Melempar | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Periksa apakah platform pada perangkat mendukung pemberian izin waktu proses
Kembali | |
---|---|
boolean | Benar jika izin waktu proses didukung, salah jika sebaliknya. |
Melempar | |
---|---|
DeviceNotAvailableException |
logBugreport
public abstract boolean logBugreport (String dataName, ITestLogger listener)
Metode pembantu untuk mengambil laporan bug dan mencatatnya ke reporter.
Parameter | |
---|---|
dataName | String : nama tempat laporan bug akan dilaporkan. |
listener | ITestLogger : ITestLogger untuk mencatat laporan bug. |
Kembali | |
---|---|
boolean | Benar jika penebangan berhasil, salah jika tidak. |
logOnDevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Catat pesan di logcat perangkat. This is a safe call that will not throw even if the logging fails.
Parameters | |
---|---|
tag | String : The tag under which we log our message in the logcat. |
level | Log.LogLevel : The debug level of the message in the logcat. |
format | String : The message format. |
args | Object : the args to be replaced via String.format(). |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.
Throws | |
---|---|
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Perform instructions to configure device for testing that after every boot.
Should be called after device is fully booted/available In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot. Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
postInvocationTearDown
public abstract void postInvocationTearDown ()
Extra steps for device specific required clean up that will be executed after the invocation is done.
preInvocationSetup
public abstract void preInvocationSetup (IBuildInfo info)
Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.
Parameters | |
---|---|
info | IBuildInfo |
Throws | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info,testResourceBuildInfos)
Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.
Parameters | |
---|---|
info | IBuildInfo |
testResourceBuildInfos |
Throws | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Recursively pull directory contents from device.
Parameters | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
Returns | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Parameters | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Returns | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Retrieves a file off device.
Parameters | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
Returns | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
Parameters | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Returns | |
---|---|
String | AString containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
Parameters | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Returns | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
Parameters | |
---|---|
localDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Recursively push directory contents to device.
Parameters | |
---|---|
localDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Push a file to device
Parameters | |
---|---|
localFile | File : the local file to push |
deviceFilePath | String : the remote destination absolute file path |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushString
public abstract boolean pushString (String contents, String deviceFilePath)
Push file created from a string to device
Parameters | |
---|---|
contents | String : the contents of the file to push |
deviceFilePath | String : the remote destination absolute file path |
Returns | |
---|---|
boolean | true if string was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
reboot
public abstract void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Throws | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootIntoBootloader
public abstract void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
rebootIntoRecovery
public abstract void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryThrows | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootUntilOnline
public abstract void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Throws | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
remountSystemWritable
public abstract void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
Parameters | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Returns | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
Parameters | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
Returns | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
Parameters | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Returns | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
Parameters | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Returns | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
Parameters | |
---|---|
date | Date : specify a particular date; will use host date if null |
Throws | |
---|---|
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
Parameters | |
---|---|
options | TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
Parameters | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Returns | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
Parameters | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etcParameters | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
Parameters | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
See also:
startLogcat
public abstract void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public abstract void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.switchToAdbTcp
public abstract String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Returns | |
---|---|
String | the tcp serial number or null if device could not be switched |
Throws | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Returns | |
---|---|
boolean | true if switch was successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.Parameters | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Returns | |
---|---|
boolean | true if files were synced successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
takeBugreport
public abstract Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue.
Bugreport#close()
.Returns | |
---|---|
Bugreport |
unencryptDevice
public abstract boolean unencryptDevice ()
Unencrypts the device.
Unencrypting the device may cause device to be wiped and may reboot device. This method will block until device is available and ready for testing. Requires fastboot inorder to wipe the userdata partition.Returns | |
---|---|
boolean | true if successful. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
UnsupportedOperationException | if encryption is not supported on the device. |
unlockDevice
public abstract boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Returns | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
UnsupportedOperationException | if encryption is not supported on the device. |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
Parameters | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Returns | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public abstract void waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceAvailable
public abstract void waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Throws | |
---|---|
DeviceNotAvailableException | if device is still unresponsive after waitTime expires. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Throws | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |