INativeDevice

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Nilai default ketika API Level tidak dapat dideteksi

Nilai Konstanta: -1 (0xffffffff)

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

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.