Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


Menyediakan API tingkat yang andal dan sedikit lebih tinggi ke ddmlib IDevice .

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

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

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 CommandResult diisi dengan benar dengan keluaran status perintah, stdout dan stderr.

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.

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.

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 IFileEntry yang terkadang tidak berfungsi karena izin.

abstract String getDeviceClass ()

Dapatkan kelas perangkat.

abstract long getDeviceDate ()

Kembalikan tanggal perangkat dalam milidetik sejak periode.

abstract DeviceDescriptor getDeviceDescriptor ()

Kembalikan DeviceDescriptor dari informasi perangkat untuk mendapatkan infonya tanpa meneruskan objek perangkat sebenarnya.

abstract TestDeviceState getDeviceState ()

Dapatkan status perangkat.

abstract long getDeviceTimeOffset (Date date)

Pembantu untuk mendapatkan perbedaan waktu antara perangkat dan ERROR(/Date) .

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 IDevice terkait.

abstract long getLastExpectedRebootTimeMillis ()

Mengembalikan terakhir kali Tradefed API memicu boot ulang dalam milidetik sejak EPOCH seperti yang dikembalikan oleh System.currentTimeMillis() .

abstract InputStreamSource getLogcat ()

Mendapatkan aliran snapshot dari data logcat.

abstract InputStreamSource getLogcat (int maxBytes)

maxBytes aliran snapshot dari maxBytes terakhir dari data logcat yang diambil.

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

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 ERROR(/File) sementara lokal ERROR(/File) , dan mengembalikan File .

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 ERROR(/File) sementara lokal ERROR(/File) , dan mengembalikan referensi ke File .

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 reboot() yang hanya memblokir hingga perangkat online yaitu terlihat oleh adb.

abstract void remountSystemWritable ()

Buat partisi sistem di perangkat dapat ditulis.

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

Metode kemudahan untuk menjalankan ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) dengan satu atau beberapa pemroses yang diteruskan sebagai parameter.

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 ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) tetapi menjalankan pengujian untuk pengguna tertentu.

abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)

Sama seperti ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) untuk pengguna tertentu.

abstract void setDate (Date date)

Set tanggal di perangkat

Catatan: mengatur tanggal pada perangkat membutuhkan root

abstract void setOptions ( TestDeviceOptions options)

Setel TestDeviceOptions untuk perangkat

abstract boolean setProperty (String propKey, String propValue)

Menetapkan nilai properti yang diberikan di perangkat.

abstract void setRecovery ( IDeviceRecovery recovery)

Setel IDeviceRecovery akan digunakan untuk perangkat ini.

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 Bugreport untuk menanganinya.

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

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 memastikan ITestDevice#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 untuk executeFastbootCommand(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 dari executeShellCommand(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.

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.

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.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metode pembantu yang menghapus partisi untuk perangkat.

Jika getUseFastbootErase() 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.36

Kembali
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 metode getProductType() 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 metode getProductType() 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.

Perangkat 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:

  • Jika logcat saat ini ditangkap di latar belakang, akan mengembalikan hingga TestDeviceOptions#getMaxLogcatDataSize() byte dari konten saat ini dari tangkapan logcat latar belakang
  • Jika tidak, akan mengembalikan dump statis data logcat jika perangkat saat ini merespons

    Kembali
    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 di IDevice tidak tersedia.

    TODO: pindahkan perilaku ini ke IDevice#getMountPoint(String)

    Parameter
    mountName String : nama titik pemasangan

    Kembali
    String mount point atau null

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

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

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

    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

    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.

    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 : Set of excluded directories names that shouldn't be pushed.

    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 recovery

    Throws
    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 : the test result 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, etc

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

    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.

    File referenced in the Bugreport object need to be cleaned via 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 call postBootSetup() . 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. Use waitForDeviceAvailable() 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. Use waitForDeviceAvailable() 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.