INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Memberikan API level yang andal dan sedikit lebih tinggi ke IDevice ddmlib.

Mencoba kembali 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 saat API Level tidak dapat dideteksi

Metode publik

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Periksa apakah fitur saat ini didukung atau tidak dengan tingkat dukungan minimum.

abstract void clearLogcat()

Menghapus data logcat yang terkumpul.

abstract void deleteFile(String deviceFilePath)

Metode helper untuk menghapus file atau direktori di perangkat.

abstract void deleteFile(String deviceFilePath, int userId)

Metode helper untuk menghapus file atau direktori di perangkat.

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Metode bantuan untuk memeriksa apakah perangkat dimulai ulang secara soft dengan membandingkan system_server saat ini dengan ProcessInfo system_server sebelumnya.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Metode bantuan untuk memeriksa apakah perangkat dimulai ulang secara soft sejak waktu UTC sejak epoch dari perangkat dan ERROR(/TimeUnit)-nya.

abstract boolean disableAdbRoot()

Menonaktifkan root adb.

abstract boolean doesFileExist(String deviceFilePath)

Metode helper untuk menentukan apakah file di perangkat ada.

abstract boolean enableAdbRoot()

Mengaktifkan root adb.

abstract String executeAdbCommand(long timeout, String... commandArgs)

Metode helper yang mengeksekusi perintah adb sebagai perintah sistem dengan waktu tunggu yang ditentukan.

abstract String executeAdbCommand(String... commandArgs)

Metode helper yang menjalankan perintah adb sebagai perintah sistem.

abstract String executeAdbCommand(long timeout, envMap, String... commandArgs)

Metode helper yang mengeksekusi perintah adb sebagai perintah sistem dengan waktu tunggu yang ditentukan.

abstract CommandResult executeFastbootCommand(long timeout, String... commandArgs)

Metode helper yang menjalankan perintah fastboot sebagai perintah sistem.

abstract CommandResult executeFastbootCommand(String... commandArgs)

Metode helper yang menjalankan perintah fastboot sebagai perintah sistem dengan waktu tunggu default 2 menit.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

Metode helper yang menjalankan perintah fastboot yang berjalan lama sebagai perintah sistem.

abstract CommandResult executeLongFastbootCommand( envVarMap, String... commandArgs)

Metode bantuan yang menjalankan perintah fastboot yang berjalan lama sebagai perintah sistem dengan variabel lingkungan sistem.

abstract String executeShellCommand(String command)

Metode bantuan yang menjalankan perintah shell adb dan menampilkan output sebagai String.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Menjalankan perintah shell adb, 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 shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Menjalankan perintah shell adb yang diberikan, mencoba kembali beberapa kali jika perintah gagal.

abstract CommandResult executeShellV2Command(String command)

Metode helper yang menjalankan perintah shell adb dan menampilkan hasilnya sebagai CommandResult yang diisi dengan benar dengan output status perintah, stdout, dan stderr.

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

Metode helper yang menjalankan perintah shell adb dan menampilkan hasilnya sebagai CommandResult yang diisi dengan benar dengan output status perintah dan stderr.

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

Metode helper yang menjalankan perintah shell adb dan menampilkan hasilnya sebagai CommandResult yang diisi dengan benar dengan output status perintah, stdout, dan stderr.

abstract CommandResult executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

abstract CommandResult executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)

Menjalankan perintah shell adb, 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 shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

abstract CommandResult executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

abstract CommandResult fastbootWipePartition(String partition)

Metode bantuan yang menghapus partisi untuk perangkat.

abstract int getApiLevel()

Mendapatkan API Level perangkat.

abstract String getBasebandVersion()

Metode praktis untuk mendapatkan versi baseband (radio) perangkat ini.

abstract Integer getBattery()

Menampilkan level baterai perangkat saat ini atau Null jika level baterai tidak tersedia.

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Menampilkan nilai boolean dari properti yang diberikan.

abstract getBootHistory()

Metode helper mengumpulkan peta histori booting dengan waktu booting dan alasan booting.

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Metode helper mengumpulkan peta histori booting dengan waktu booting dan alasan booting sejak waktu yang ditentukan sejak epoch dari perangkat dan satuan waktu yang ditentukan.

abstract String getBootloaderVersion()

Metode praktis untuk mendapatkan versi bootloader perangkat ini.

abstract String getBuildAlias()

Mengambil alias build yang saat ini dijalankan perangkat.

abstract String getBuildFlavor()

Mengambil ragam build untuk perangkat.

abstract String getBuildId()

Mengambil build yang sedang dijalankan perangkat.

abstract String getBuildSigningKeys()

Menampilkan jenis kunci yang digunakan untuk menandatangani image perangkat

Biasanya perangkat Android dapat ditandatangani dengan kunci pengujian (seperti di AOSP) atau kunci rilis (dikontrol oleh setiap produsen perangkat)

abstract DeviceDescriptor getCachedDeviceDescriptor()

Menampilkan DeviceDescriptor yang di-cache jika perangkat dialokasikan, jika tidak, akan menampilkan DeviceDescriptor saat ini.

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Menampilkan DeviceDescriptor yang di-cache jika perangkat dialokasikan, jika tidak, akan menampilkan DeviceDescriptor saat ini.

abstract String[] getChildren(String deviceFilePath)

Alternatif untuk menggunakan IFileEntry yang terkadang tidak akan berfungsi karena izin.

abstract AbstractConnection getConnection()

Menampilkan koneksi yang terkait dengan perangkat.

abstract String getDeviceClass()

Mendapatkan class perangkat.

abstract long getDeviceDate()

Menampilkan tanggal perangkat dalam milidetik sejak epoch.

abstract DeviceDescriptor getDeviceDescriptor()

Menampilkan DeviceDescriptor dari informasi perangkat untuk mendapatkan info tentangnya tanpa meneruskan objek perangkat yang sebenarnya.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Menampilkan DeviceDescriptor dari informasi perangkat untuk mendapatkan info tentangnya tanpa meneruskan objek perangkat yang sebenarnya.

abstract TestDeviceState getDeviceState()

Mendapatkan status perangkat.

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

Mendapatkan aliran data stdout dan stderr emulator

abstract long getExternalStoreFreeSpace()

Metode bantuan untuk menentukan jumlah ruang kosong di penyimpanan eksternal perangkat.

abstract String getFastbootProductType()

Metode praktis untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot.

abstract String getFastbootProductVariant()

Metode praktis untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot.

abstract String getFastbootSerialNumber()

Menampilkan nomor seri mode fastboot.

abstract String getFastbootVariable(String variableName)

Ambil nilai variabel fastboot yang diberikan dari perangkat.

abstract IFileEntry getFileEntry(String path)

Mengambil referensi ke file jarak jauh di perangkat.

abstract IDevice getIDevice()

Menampilkan referensi ke IDevice ddmlib terkait.

abstract long getIntProperty(String name, long defaultValue)

Menampilkan nilai bilangan bulat dari properti yang diberikan dari perangkat.

abstract long getLastExpectedRebootTimeMillis()

Menampilkan waktu terakhir Tradefed API memicu mulai ulang dalam milidetik sejak EPOCH seperti yang ditampilkan oleh System.currentTimeMillis().

abstract int getLaunchApiLevel()

Dapatkan API Level yang pertama kali diluncurkan perangkat.

abstract InputStreamSource getLogcat()

Mengambil aliran snapshot data logcat.

abstract InputStreamSource getLogcat(int maxBytes)

Mengambil aliran snapshot dari maxBytes data logcat terakhir yang diambil.

abstract InputStreamSource getLogcatDump()

Mendapatkan dump logcat saat ini untuk perangkat.

abstract InputStreamSource getLogcatSince(long date)

Mengambil aliran snapshot data logcat yang diambil mulai tanggal yang diberikan.

abstract String getMountPoint(String mountName)

Menampilkan titik pemasangan.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Menampilkan MountPointInfo yang sesuai dengan jalur titik pemasangan yang ditentukan, atau null jika jalur tersebut tidak memiliki apa pun yang dipasang atau tidak muncul di /proc/mounts sebagai titik pemasangan.

abstract getMountPointInfo()

Menampilkan versi informasi yang diuraikan di /proc/mounts pada perangkat

abstract long getPartitionFreeSpace(String partition)

Metode bantuan untuk menentukan jumlah ruang kosong di partisi perangkat.

abstract ProcessInfo getProcessByName(String processName)

Metode helper menjalankan perintah "pidof" dan "stat" serta menampilkan objek ProcessInfo dengan PID dan waktu mulai proses dari proses yang diberikan.

abstract String getProcessPid(String process)

Menampilkan pid layanan atau null jika terjadi error.

abstract String getProductType()

Metode praktis untuk mendapatkan jenis produk perangkat ini.

abstract String getProductVariant()

Metode praktis 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 praktis untuk mendapatkan nomor seri perangkat ini.

abstract getTombstones()

Mengambil dan menampilkan daftar tombstone dari perangkat.

abstract long getTotalMemory()

Menampilkan total ukuran memori fisik dalam byte atau -1 jika terjadi error internal

default String getTrackingSerial()

Untuk tujuan pengelolaan perangkat, dapatkan serial yang digunakan untuk melacak perangkat.

abstract boolean getUseFastbootErase()

Mendapatkan apakah akan menggunakan penghapusan fastboot atau format fastboot untuk menghapus total partisi di perangkat.

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

Memeriksa apakah platform di perangkat mendukung enumerasi aplikasi

abstract boolean isBypassLowTargetSdkBlockSupported()

Memeriksa apakah platform di perangkat mendukung pengabaian pemblokiran sdk target rendah pada penginstalan aplikasi

abstract boolean isDebugfsMounted()

Periksa apakah debugfs terpasang.

abstract boolean isDeviceEncrypted()

Menampilkan apakah perangkat dienkripsi.

abstract boolean isDirectory(String deviceFilePath)

Menampilkan True jika jalur di perangkat adalah direktori, salah jika tidak.

abstract boolean isEncryptionSupported()

Menampilkan apakah enkripsi didukung di perangkat.

abstract boolean isExecutable(String fullPath)

Menampilkan True (Benar) jika jalur file di perangkat adalah file yang dapat dieksekusi, salah jika tidak.

abstract boolean isHeadless()

Menampilkan true jika perangkat headless (tanpa layar), false jika sebaliknya.

abstract boolean isRuntimePermissionSupported()

Memeriksa apakah platform di perangkat mendukung pemberian izin runtime

abstract boolean isStateBootloaderOrFastbootd()

Menampilkan true jika perangkat berada di TestDeviceState.FASTBOOT atau TestDeviceState.FASTBOOTD.

abstract boolean logAnrs(ITestLogger logger)

Mengumpulkan dan mencatat ANR dari perangkat.

abstract void logOnDevice(String tag, Log.LogLevel level, String format, Object... args)

Catat pesan di logcat perangkat.

abstract void mountDebugfs()

Pasang debugfs.

abstract void nonBlockingReboot()

Mengeluarkan perintah untuk memulai ulang perangkat dan ditampilkan saat perintah selesai dan saat perangkat tidak lagi terlihat oleh adb.

abstract void postBootSetup()

Lakukan petunjuk untuk mengonfigurasi perangkat untuk pengujian setelah setiap booting.

default void postInvocationTearDown()

Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan postInvocationTearDown(Throwable).

abstract void postInvocationTearDown(Throwable invocationException)

Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan selesai.

default void preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)

Langkah tambahan untuk penyiapan khusus perangkat yang diperlukan yang akan dijalankan di perangkat sebelum alur pemanggilan.

abstract boolean pullDir(String deviceFilePath, File localDir)

Menarik konten direktori secara berulang dari perangkat.

abstract boolean pullDir(String deviceFilePath, File localDir, int userId)

Menarik konten direktori secara berulang dari perangkat.

abstract File pullFile(String remoteFilePath, int userId)

Mengambil file dari perangkat, menyimpannya di ERROR(/File) sementara lokal, dan menampilkan File tersebut.

abstract File pullFile(String remoteFilePath)

Mengambil file dari perangkat, menyimpannya di ERROR(/File) sementara lokal, dan menampilkan File tersebut.

abstract boolean pullFile(String remoteFilePath, File localFile)

Mengambil file dari perangkat.

abstract boolean pullFile(String remoteFilePath, File localFile, int userId)

Mengambil file dari perangkat.

abstract String pullFileContents(String remoteFilePath)

Mengambil file dari perangkat, dan menampilkan kontennya.

abstract File pullFileFromExternal(String remoteFilePath)

Metode praktis untuk mengambil file dari penyimpanan eksternal perangkat, menyimpannya di ERROR(/File) sementara lokal, dan menampilkan referensi ke File tersebut.

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

Kirim konten direktori secara berulang ke perangkat.

abstract boolean pushDir(File localDir, String deviceFilePath, excludedDirectories)

Mendorong konten direktori secara rekursif ke perangkat sekaligus mengecualikan beberapa direktori yang difilter.

abstract boolean pushDir(File localDir, String deviceFilePath)

Kirim konten direktori secara berulang ke perangkat.

abstract boolean pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

Varian pushFile(File, String) yang secara opsional dapat mempertimbangkan untuk mengevaluasi kebutuhan bagi penyedia konten.

abstract boolean pushFile(File localFile, String deviceFilePath)

Mengirim file ke perangkat.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Mengirim file ke perangkat.

abstract boolean pushString(String contents, String deviceFilePath)

Mengirim file yang dibuat dari string ke perangkat

abstract void reboot()

Memulai ulang perangkat ke mode adb.

abstract void reboot(String reason)

Me-reboot perangkat ke mode adb dengan reason yang diberikan untuk dipertahankan saat reboot.

abstract void rebootIntoBootloader()

Me-reboot perangkat ke mode bootloader.

abstract void rebootIntoFastbootd()

Me-reboot perangkat ke mode fastbootd.

abstract void rebootIntoRecovery()

Memulai ulang perangkat ke mode pemulihan adb.

abstract void rebootIntoSideload(boolean autoReboot)

Me-reboot perangkat ke mode sideload adb (perhatikan bahwa ini adalah mode khusus dalam pemulihan)

Memblokir hingga perangkat memasuki mode sideload

abstract void rebootIntoSideload()

Me-reboot perangkat ke mode sideload adb (perhatikan bahwa ini adalah mode khusus dalam pemulihan)

Memblokir hingga perangkat memasuki mode sideload

abstract void rebootUntilOnline()

Alternatif untuk reboot() yang hanya memblokir hingga perangkat online, yaitu terlihat oleh adb.

abstract void rebootUntilOnline(String reason)

Alternatif untuk reboot() yang hanya memblokir hingga perangkat online, yaitu terlihat oleh adb.

abstract void rebootUserspace()

Hanya memulai ulang bagian ruang pengguna perangkat.

abstract void rebootUserspaceUntilOnline()

Alternatif untuk rebootUserspace() ()} yang hanya memblokir hingga perangkat online, yaitu terlihat oleh adb.

abstract void remountSystemReadOnly()

Membuat partisi sistem di perangkat menjadi hanya baca.

abstract void remountSystemWritable()

Buat partisi sistem di perangkat agar dapat ditulis.

abstract void remountVendorReadOnly()

Membuat partisi vendor di perangkat menjadi hanya baca.

abstract void remountVendorWritable()

Buat partisi vendor di perangkat agar dapat ditulis.

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

Metode praktis 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)

Menjalankan uji instrumentasi, dan menyediakan pemulihan perangkat.

abstract boolean 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)), tetapi menjalankan pengujian untuk pengguna tertentu.

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

Sama seperti ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), tetapi menjalankan pengujian untuk pengguna tertentu.

abstract void setDate(Date date)

Menetapkan tanggal di perangkat

Catatan: setelan tanggal di perangkat memerlukan root

abstract void setOptions(TestDeviceOptions options)

Menetapkan TestDeviceOptions untuk perangkat

abstract boolean setProperty(String propKey, String propValue)

Menetapkan nilai properti yang diberikan di perangkat.

abstract void setRecovery(IDeviceRecovery recovery)

Tetapkan IDeviceRecovery yang akan digunakan untuk perangkat ini.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

Tetapkan mode pemulihan saat ini yang akan digunakan untuk perangkat.

abstract void setTrackingSerial(String trackingSerial)

Untuk tujuan pengelolaan perangkat, lacak serial yang kita gunakan untuk mereferensikan perangkat.

abstract void setUseFastbootErase(boolean useFastbootErase)

Tetapkan apakah akan menggunakan fastboot erase atau fastboot format untuk menghapus total partisi di perangkat.

abstract void startLogcat()

Mulai merekam output logcat dari perangkat di latar belakang.

abstract boolean startTradeInModeTesting(int timeoutMs)

Aktifkan mode tukar tambah pengujian.

abstract void stopEmulatorOutput()

Tutup dan hapus output emulator.

abstract void stopLogcat()

Berhenti merekam output logcat dari perangkat, dan hapus data logcat yang saat ini disimpan.

abstract void stopTradeInModeTesting()

Menghentikan pengujian mode trade-in.

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)

Menyinkronkan konten direktori file lokal secara bertahap ke perangkat.

abstract boolean unlockDevice()

Membuka kunci perangkat jika perangkat dalam status terenkripsi.

abstract void unmountDebugfs()

Lepaskan debugfs.

abstract boolean waitForBootComplete(long timeOut)

Memblokir hingga tanda selesai booting perangkat ditetapkan.

abstract boolean waitForDeviceAvailable()

Menunggu perangkat menjadi responsif dan tersedia untuk pengujian.

abstract boolean waitForDeviceAvailable(long waitTime)

Menunggu perangkat menjadi responsif dan tersedia untuk pengujian.

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Menunggu perangkat menjadi responsif dan tersedia tanpa mempertimbangkan jalur pemulihan.

abstract void waitForDeviceBootloader()

Memblokir hingga perangkat terlihat melalui fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

Memblokir agar perangkat berada dalam status 'adb recovery' (perhatikan bahwa ini berbeda dengan IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Memblokir agar perangkat berada dalam status 'adb sideload'

abstract boolean waitForDeviceNotAvailable(long waitTime)

Memblokir agar perangkat tidak tersedia, yaitu tidak ada di 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 responsif terhadap perintah shell adb dasar.

Konstanta

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Nilai default saat API Level tidak dapat dideteksi

Nilai Konstanta: -1 (0xffffffff)

Metode publik

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Periksa apakah fitur saat ini didukung atau tidak dengan tingkat dukungan minimum. Metode ini memperhitungkan fitur yang belum dirilis, sebelum level API dinaikkan.

Parameter
strictMinLevel int: Tingkat minimum ketat yang mendukung fitur.
Hasil
boolean Benar jika level didukung. Salah jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Menghapus data logcat yang terkumpul.

Hal ini berguna jika Anda ingin memastikan ITestDevice.getLogcat() hanya menampilkan data log yang dihasilkan setelah titik tertentu (seperti setelah mem-flash build perangkat baru, dll.).

deleteFile

public abstract void deleteFile (String deviceFilePath)

Metode helper untuk menghapus file atau direktori di perangkat.

Parameter
deviceFilePath String: Jalur absolut file di perangkat.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

Metode helper untuk menghapus file atau direktori di perangkat.

Parameter
deviceFilePath String: Jalur absolut file di perangkat.
userId int: ID pengguna yang akan dihapus
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metode bantuan untuk memeriksa apakah perangkat dimulai ulang secara soft dengan membandingkan system_server saat ini dengan ProcessInfo system_server sebelumnya. Gunakan getProcessByName(String) untuk mendapatkan ProcessInfo.

Parameter
prevSystemServerProcess ProcessInfo: proses system_server sebelumnya ProcessInfo.
Hasil
boolean true jika perangkat dimulai ulang secara soft
Menampilkan
RuntimeException jika perangkat memiliki alasan booting yang tidak normal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metode bantuan untuk memeriksa apakah perangkat dimulai ulang secara soft sejak waktu UTC sejak epoch dari perangkat dan ERROR(/TimeUnit)-nya. Soft-Restart mengacu pada system_server yang dimulai ulang di luar mulai ulang paksa perangkat (misalnya: mulai ulang yang diminta). utcEpochTime perangkat saat ini dalam Millidetik dapat diperoleh dengan metode getDeviceDate().

Parameter
utcEpochTime long: waktu perangkat dalam detik sejak epoch.
timeUnit TimeUnit: unit waktu TimeUnit untuk utcEpochTime yang diberikan.
Hasil
boolean true jika perangkat dimulai ulang secara soft
Menampilkan
RuntimeException jika perangkat memiliki alasan booting yang tidak normal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Menonaktifkan root adb.

Menonaktifkan root adb dapat menyebabkan perangkat terputus dari adb. Metode ini akan memblokir hingga perangkat tersedia.

Hasil
boolean true jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Metode helper untuk menentukan apakah file di perangkat ada.

Parameter
deviceFilePath String: jalur absolut file di perangkat yang akan diperiksa
Hasil
boolean true jika file ada, false jika tidak.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Mengaktifkan root adb. Jika setelan "enable-root" adalah "false", akan mencatat pesan ke dalam log dan ditampilkan tanpa mengaktifkan root.

Mengaktifkan adb root dapat menyebabkan perangkat terputus dari adb. Metode ini akan memblokir hingga perangkat tersedia.

Hasil
boolean true jika berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

Metode helper yang mengeksekusi perintah adb sebagai perintah sistem dengan waktu tunggu yang ditentukan.

executeShellCommand(String) harus digunakan jika memungkinkan, karena metode tersebut memberikan performa dan deteksi kegagalan yang lebih baik.

Parameter
timeout long: waktu dalam milidetik sebelum perangkat dianggap tidak responsif, 0L untuk tidak ada waktu tunggu
commandArgs String: perintah dan argumen adb yang akan dijalankan
Hasil
String stdout dari perintah. null jika perintah gagal dieksekusi.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

Metode helper yang menjalankan perintah adb sebagai perintah sistem.

executeShellCommand(String) harus digunakan jika memungkinkan, karena metode tersebut memberikan performa dan deteksi kegagalan yang lebih baik.

Parameter
commandArgs String: perintah dan argumen adb yang akan dijalankan
Hasil
String stdout dari perintah. null jika perintah gagal dieksekusi.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

Metode helper yang mengeksekusi perintah adb sebagai perintah sistem dengan waktu tunggu yang ditentukan.

executeShellCommand(String) harus digunakan jika memungkinkan, karena metode tersebut memberikan performa dan deteksi kegagalan yang lebih baik.

Parameter
timeout long: waktu dalam milidetik sebelum perangkat dianggap tidak responsif, 0L untuk tidak ada waktu tunggu
envMap : lingkungan yang akan ditetapkan untuk perintah
commandArgs String: perintah dan argumen adb yang akan dijalankan
Hasil
String stdout dari perintah. null jika perintah gagal dieksekusi.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

Metode helper yang menjalankan perintah fastboot sebagai perintah sistem.

Diharapkan akan digunakan saat perangkat sudah dalam mode fastboot.

Parameter
timeout long: waktu dalam milidetik sebelum masa berlaku perintah berakhir
commandArgs String: perintah dan argumen fastboot yang akan dijalankan
Hasil
CommandResult CommandResult yang berisi output perintah
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Metode helper yang menjalankan perintah fastboot sebagai perintah sistem dengan waktu tunggu default 2 menit.

Diharapkan akan digunakan saat perangkat sudah dalam mode fastboot.

Parameter
commandArgs String: perintah dan argumen fastboot yang akan dijalankan
Hasil
CommandResult CommandResult yang berisi output perintah
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Metode helper yang menjalankan perintah fastboot yang berjalan lama sebagai perintah sistem.

Identik dengan executeFastbootCommand(String), kecuali menggunakan waktu tunggu yang lebih lama.

Parameter
commandArgs String: perintah dan argumen fastboot yang akan dijalankan
Hasil
CommandResult CommandResult yang berisi output perintah
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

Metode bantuan yang menjalankan perintah fastboot yang berjalan lama sebagai perintah sistem dengan variabel lingkungan sistem.

Identik dengan executeFastbootCommand(String), kecuali menggunakan waktu tunggu yang lebih lama.

Parameter
envVarMap : variabel lingkungan sistem yang digunakan perintah fastboot
commandArgs String: perintah dan argumen fastboot yang akan dijalankan
Hasil
CommandResult CommandResult yang berisi output perintah
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellCommand

public abstract String executeShellCommand (String command)

Metode bantuan yang menjalankan perintah shell adb dan menampilkan output sebagai String.

Parameter
command String: perintah shell adb yang akan dijalankan
Hasil
String output shell
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

Parameter
command String: perintah shell adb yang akan dijalankan
receiver IShellOutputReceiver: IShellOutputReceiver untuk mengarahkan output shell.
maxTimeToOutputShellResponse long: jumlah waktu maksimum selama perintah diizinkan untuk tidak menghasilkan 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 berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

Parameter
command String: perintah shell adb yang akan dijalankan
receiver IShellOutputReceiver: IShellOutputReceiver untuk mengarahkan output shell.
maxTimeoutForCommand long: waktu tunggu maksimum untuk menyelesaikan perintah; satuan seperti yang ditentukan dalam timeUnit
maxTimeToOutputShellResponse long: jumlah waktu maksimum selama perintah 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 berhasil.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Menjalankan perintah shell adb yang diberikan, mencoba kembali beberapa kali jika perintah gagal.

Bentuk executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) yang lebih sederhana dengan nilai default.

Parameter
command String: perintah shell adb yang akan dijalankan
receiver IShellOutputReceiver: IShellOutputReceiver untuk mengarahkan output shell.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Metode helper yang menjalankan perintah shell adb dan menampilkan hasilnya sebagai CommandResult yang diisi dengan benar dengan output status perintah, stdout, dan stderr.

Parameter
command String: Perintah yang harus dijalankan.
Hasil
CommandResult Hasilnya dalam CommandResult.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Metode bantuan yang menjalankan perintah shell adb dan menampilkan hasilnya sebagai CommandResult yang diisi dengan benar dengan output status perintah dan stderr. stdout diarahkan ke aliran yang ditentukan.

Parameter
command String: Perintah yang harus dijalankan.
pipeToOutput OutputStream: ERROR(/OutputStream) tempat output std akan dialihkan, atau null.
Hasil
CommandResult Hasilnya dalam CommandResult.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Metode helper yang menjalankan perintah shell adb dan menampilkan hasilnya sebagai CommandResult yang diisi dengan benar dengan output status perintah, stdout, dan stderr.

Parameter
command String: Perintah yang harus dijalankan.
pipeAsInput File: ERROR(/File) yang akan disalurkan sebagai input ke perintah, atau null.
Hasil
CommandResult Hasilnya dalam CommandResult.
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

Parameter
command String: perintah shell adb yang akan dijalankan
maxTimeoutForCommand long: waktu tunggu maksimum untuk menyelesaikan perintah; satuan 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 berhasil.
Hasil
CommandResult

Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

Parameter
command String: perintah shell adb yang akan dijalankan
maxTimeoutForCommand long: waktu tunggu maksimum untuk menyelesaikan perintah; satuan seperti yang ditentukan dalam timeUnit
timeUnit TimeUnit: unit untuk maxTimeToOutputShellResponse
Hasil
CommandResult

Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

Parameter
command String: perintah shell adb yang akan dijalankan
pipeAsInput File: ERROR(/File) yang akan disalurkan sebagai input ke perintah, atau null.
pipeToOutput OutputStream: ERROR(/OutputStream) tempat output std akan dialihkan, atau null.
maxTimeoutForCommand long: waktu tunggu maksimum untuk menyelesaikan perintah; satuan 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 berhasil.
Hasil
CommandResult

Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Menjalankan perintah shell adb, dengan lebih banyak parameter untuk mengontrol perilaku perintah.

Parameter
command String: perintah shell adb yang akan dijalankan
pipeAsInput File: ERROR(/File) yang akan disalurkan sebagai input ke perintah, atau null.
pipeToOutput OutputStream: ERROR(/OutputStream) tempat output std akan dialihkan, atau null.
pipeToError OutputStream: ERROR(/OutputStream) tempat error std akan dialihkan, atau null.
maxTimeoutForCommand long: waktu tunggu maksimum untuk menyelesaikan perintah; satuan 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 berhasil.
Hasil
CommandResult

Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metode bantuan yang menghapus partisi untuk perangkat.

Jika getUseFastbootErase() adalah true, penghapusan fastboot akan digunakan untuk menghapus partisi. Perangkat kemudian harus membuat sistem file saat perangkat di-booting lagi. Jika tidak, format fastboot akan digunakan yang akan membuat sistem file baru di perangkat.

Diharapkan akan digunakan saat perangkat sudah dalam mode fastboot.

Parameter
partition String: partisi yang akan dihapus
Hasil
CommandResult CommandResult yang berisi output perintah
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getApiLevel

public abstract int getApiLevel ()

Mendapatkan API Level perangkat. Default-nya adalah UNKNOWN_API_LEVEL.

Hasil
int bilangan bulat yang menunjukkan API Level perangkat
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Metode praktis untuk mendapatkan versi baseband (radio) perangkat ini. Mendapatkan versi radio bersifat khusus per perangkat, sehingga mungkin tidak menampilkan informasi yang benar untuk semua perangkat. Metode ini mengandalkan properti gsm.version.baseband untuk menampilkan informasi versi yang benar. Hal ini tidak akurat untuk beberapa perangkat CDMA dan versi yang ditampilkan di sini mungkin tidak cocok dengan versi yang dilaporkan dari fastboot dan mungkin tidak menampilkan versi untuk radio CDMA. TL;DR metode ini hanya melaporkan versi yang akurat jika properti gsm.version.baseband sama dengan versi yang ditampilkan oleh fastboot getvar version-baseband.

Hasil
String versi baseband String atau null jika tidak dapat ditentukan (perangkat tidak memiliki radio atau string versi tidak dapat dibaca)
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getBattery

public abstract Integer getBattery ()

Menampilkan level baterai perangkat saat ini atau Null jika level baterai tidak tersedia.

Hasil
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Menampilkan nilai boolean dari properti yang diberikan.

Parameter
name String: nama properti
defaultValue boolean: nilai default yang akan ditampilkan jika properti kosong atau tidak ada.
Hasil
boolean true jika properti memiliki nilai "1", "y", "yes", "on", atau "true", false jika properti memiliki nilai "0", "n", "no", "off", "false", atau defaultValue jika tidak.
Menampilkan
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

Metode helper mengumpulkan peta histori booting dengan waktu booting dan alasan booting.

Hasil
Peta waktu booting (waktu UTC dalam detik sejak Epoch) dan alasan booting
Menampilkan
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Metode helper mengumpulkan peta histori booting dengan waktu booting dan alasan booting sejak waktu yang ditentukan sejak epoch dari perangkat dan satuan waktu yang ditentukan. utcEpochTime perangkat saat ini dalam Milidetik dapat diperoleh dengan metode getDeviceDate().

Parameter
utcEpochTime long: waktu perangkat sejak Epoch.
timeUnit TimeUnit: unit waktu TimeUnit.
Hasil
Peta waktu booting (waktu UTC dalam detik sejak Epoch) dan alasan booting
Menampilkan
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Metode praktis untuk mendapatkan versi bootloader perangkat ini.

Akan mencoba mengambil versi bootloader dari status perangkat saat ini. (yaitu jika perangkat dalam mode fastboot, perangkat akan mencoba mengambil versi dari fastboot)

Hasil
String versi bootloader String atau null jika tidak dapat ditemukan
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getBuildAlias

public abstract String getBuildAlias ()

Mengambil alias build yang saat ini dijalankan perangkat.

Alias build biasanya merupakan string yang lebih mudah dibaca daripada ID build (biasanya berupa angka untuk build Nexus). Misalnya, rilis Android 4.2 final memiliki alias build JDQ39, dan ID build 573038

Hasil
String alias build atau kembali ke ID build jika tidak dapat diambil
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Mengambil ragam build untuk perangkat.

Hasil
String ragam build atau null jika tidak dapat diambil
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Mengambil build yang sedang dijalankan perangkat.

Hasil
String ID build atau IBuildInfo.UNKNOWN_BUILD_ID jika tidak dapat diambil
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

Menampilkan jenis kunci yang digunakan untuk menandatangani image perangkat

Biasanya perangkat Android dapat ditandatangani dengan kunci pengujian (seperti di AOSP) atau kunci rilis (dikontrol oleh setiap produsen perangkat)

Hasil
String Kunci penandatanganan jika ditemukan, null jika tidak.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Menampilkan DeviceDescriptor yang di-cache jika perangkat dialokasikan, jika tidak, akan menampilkan DeviceDescriptor saat ini.

Hasil
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Menampilkan DeviceDescriptor yang di-cache jika perangkat dialokasikan, jika tidak, akan menampilkan DeviceDescriptor saat ini.

Parameter
shortDescriptor boolean: Apakah akan membatasi deskripsi ke info minimum saja atau tidak
Hasil
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

Alternatif untuk menggunakan IFileEntry yang terkadang tidak akan berfungsi karena izin.

Parameter
deviceFilePath String: adalah jalur di perangkat tempat penelusuran dilakukan
Hasil
String[] Array string yang berisi semua file dalam jalur di perangkat.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Menampilkan koneksi yang terkait dengan perangkat.

Hasil
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Mendapatkan class perangkat.

Hasil
String class perangkat String.

getDeviceDate

public abstract long getDeviceDate ()

Menampilkan tanggal perangkat dalam milidetik sejak epoch.

Hasil
long tanggal perangkat dalam format epoch.
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Menampilkan DeviceDescriptor dari informasi perangkat untuk mendapatkan info tentangnya tanpa meneruskan objek perangkat yang sebenarnya.

Hasil
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Menampilkan DeviceDescriptor dari informasi perangkat untuk mendapatkan info tentangnya tanpa meneruskan objek perangkat yang sebenarnya.

Parameter
shortDescriptor boolean: Apakah akan membatasi deskripsi ke info minimum saja atau tidak
Hasil
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Mendapatkan status perangkat.

Hasil
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper untuk mendapatkan perbedaan waktu antara perangkat dan ERROR(/Date) tertentu. Gunakan waktu Epoch secara internal.

Parameter
date Date

Hasil
long perbedaan dalam milidetik
Menampilkan
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Mendapatkan aliran data stdout dan stderr emulator

Hasil
InputStreamSource output emulator

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Metode bantuan untuk menentukan jumlah ruang kosong di penyimpanan eksternal perangkat.

Hasil
long jumlah ruang kosong dalam KB
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getFastbootProductType

public abstract String getFastbootProductType ()

Metode praktis untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot.

Metode ini hanya boleh digunakan jika perangkat harus dalam fastboot. Varian ini sedikit lebih aman daripada metode getProductType() umum dalam hal ini, karena ITestDevice akan mengetahui cara memulihkan perangkat ke fastboot jika perangkat dalam status yang salah atau tidak responsif.

Hasil
String nama jenis produk String atau null jika tidak dapat ditentukan
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Metode praktis untuk mendapatkan jenis produk perangkat ini saat dalam mode fastboot.

Metode ini hanya boleh digunakan jika perangkat harus dalam fastboot. Varian ini sedikit lebih aman daripada metode getProductType() umum dalam hal ini, karena ITestDevice akan mengetahui cara memulihkan perangkat ke fastboot jika perangkat dalam status yang salah atau tidak responsif.

Hasil
String nama jenis produk String atau null jika tidak dapat ditentukan
Menampilkan
DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Menampilkan nomor seri mode fastboot.

Hasil
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Ambil nilai variabel fastboot yang diberikan dari perangkat.

Parameter
variableName String: nama variabel
Hasil
String nilai properti atau null jika tidak ada
Menampilkan
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Mengambil referensi ke file jarak jauh di perangkat.

Parameter
path String: jalur file yang akan diambil. Dapat berupa jalur absolut atau jalur yang relatif terhadap '/'. (yaitu sintaksis "/system" dan "system" didukung)
Hasil
IFileEntry IFileEntry atau null jika file di path tertentu tidak dapat ditemukan
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Menampilkan referensi ke IDevice ddmlib terkait.

IDevice baru dapat dialokasikan oleh DDMS setiap kali perangkat terputus dan terhubung kembali dari adb. Dengan demikian, pemanggil tidak boleh menyimpan referensi ke IDevice, karena referensi tersebut mungkin menjadi tidak berlaku.

Hasil
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Menampilkan nilai bilangan bulat dari properti yang diberikan dari perangkat.

Parameter
name String: nama properti
defaultValue long: nilai default yang akan ditampilkan jika properti kosong atau tidak ada.
Hasil
long nilai properti atau defaultValue jika properti kosong, tidak ada, atau tidak memiliki nilai bilangan bulat.
Menampilkan
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Menampilkan waktu terakhir Tradefed API memicu mulai ulang dalam milidetik sejak EPOCH seperti yang ditampilkan oleh System.currentTimeMillis().

Hasil
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Dapatkan API Level yang pertama kali diluncurkan perangkat. Default-nya adalah UNKNOWN_API_LEVEL.

Hasil
int bilangan bulat yang menunjukkan API Level perangkat yang pertama kali diluncurkan
Menampilkan
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Mengambil aliran snapshot data logcat.

Berfungsi dalam dua mode:

  • Jika logcat saat ini sedang diambil di latar belakang, akan menampilkan hingga TestDeviceOptions.getMaxLogcatDataSize() byte konten saat ini dari pengambilan logcat latar belakang
  • Jika tidak, akan menampilkan dump statis data logcat jika perangkat saat ini merespons

    Hasil
    InputStreamSource

    • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Mengambil aliran snapshot dari maxBytes data logcat terakhir yang diambil.

    Berguna untuk kasus saat Anda ingin mengambil snapshot data logcat yang sering diambil tanpa menimbulkan penalti ruang disk yang berpotensi besar untuk mendapatkan seluruh snapshot getLogcat().

    Parameter
    maxBytes int: jumlah maksimum data yang akan ditampilkan. Harus berupa jumlah yang dapat muat dengan nyaman di memori
    Hasil
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Mendapatkan dump logcat saat ini untuk perangkat. Tidak seperti getLogcat(), metode ini akan selalu menampilkan dump statis logcat.

    Memiliki kelemahan bahwa tidak ada yang akan ditampilkan jika perangkat tidak dapat dijangkau.

    Hasil
    InputStreamSource InputStreamSource data logcat. Streaming kosong akan ditampilkan jika gagal mengambil data logcat.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Mengambil aliran snapshot data logcat yang diambil mulai tanggal yang diberikan. Waktu di perangkat harus menggunakan getDeviceDate().

    Parameter
    date long: dalam milidetik sejak format epoch kapan harus memulai snapshot hingga saat ini. (dapat diperoleh menggunakan 'date +%s')
    Hasil
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Menampilkan titik pemasangan.

    Membuat 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
    Hasil
    String titik pemasangan atau null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Menampilkan MountPointInfo yang sesuai dengan jalur titik pemasangan yang ditentukan, atau null jika jalur tersebut tidak memiliki apa pun yang dipasang atau tidak muncul di /proc/mounts sebagai titik pemasangan.

    Parameter
    mountpoint String

    Hasil
    ITestDevice.MountPointInfo ERROR(/List) dari MountPointInfo yang berisi informasi di "/proc/mounts"
    Menampilkan
    DeviceNotAvailableException

    Lihat juga:

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Menampilkan versi informasi yang diuraikan di /proc/mounts pada perangkat

    Hasil
    ERROR(/List) dari MountPointInfo yang berisi informasi di "/proc/mounts"
    Menampilkan
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Metode bantuan untuk menentukan jumlah ruang kosong di partisi perangkat.

    Parameter
    partition String

    Hasil
    long jumlah ruang kosong dalam KB
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Metode helper menjalankan perintah "pidof" dan "stat" serta menampilkan objek ProcessInfo dengan PID dan waktu mulai proses dari proses yang diberikan.

    Parameter
    processName String: String nama proses.
    Hasil
    ProcessInfo ProcessInfo dari processName tertentu
    Menampilkan
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Menampilkan pid layanan atau null jika terjadi error.

    Parameter
    process String: String nama proses.
    Hasil
    String

    Menampilkan
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Metode praktis untuk mendapatkan jenis produk perangkat ini.

    Metode ini akan berfungsi jika perangkat dalam mode adb atau fastboot.

    Hasil
    String nama jenis produk String. Tidak akan null
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat hilang dan tidak dapat dipulihkan, atau jika jenis produk tidak dapat ditentukan

    getProductVariant

    public abstract String getProductVariant ()

    Metode praktis untuk mendapatkan varian produk perangkat ini.

    Metode ini akan berfungsi jika perangkat dalam mode adb atau fastboot.

    Hasil
    String nama varian produk String atau null jika tidak dapat ditentukan
    Menampilkan
    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
    Hasil
    String nilai properti atau null jika tidak ada
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Dapatkan mode pemulihan saat ini yang digunakan untuk perangkat.

    Hasil
    ITestDevice.RecoveryMode mode pemulihan saat ini yang digunakan untuk perangkat.

    getSerialNumber

    public abstract String getSerialNumber ()

    Metode praktis untuk mendapatkan nomor seri perangkat ini.

    Hasil
    String nomor seri String

    getTombstones

    public abstract  getTombstones ()

    Mengambil dan menampilkan daftar tombstone dari perangkat. Memerlukan root.

    adalah upaya terbaik sehingga jika satu tombstone gagal diambil karena alasan apa pun, tombstone tersebut akan hilang dari daftar. Hanya DeviceNotAvailableException yang akan menghentikan metode lebih awal.

    Hasil
    Daftar file tombstone, kosong jika tidak ada tombstone.
    Menampilkan
    DeviceNotAvailableException

    Lihat juga:

    getTotalMemory

    public abstract long getTotalMemory ()

    Menampilkan total ukuran memori fisik dalam byte atau -1 jika terjadi error internal

    Hasil
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Untuk tujuan pengelolaan perangkat, dapatkan serial yang digunakan untuk melacak perangkat.

    Hasil
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Mendapatkan apakah akan menggunakan penghapusan fastboot atau format fastboot untuk menghapus total partisi di perangkat.

    Hasil
    boolean true jika penghapusan fastboot akan digunakan atau false jika format fastboot akan digunakan.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Hasil
    boolean true jika perangkat saat ini memiliki root adb, false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Hasil
    boolean true jika perangkat terhubung ke adb-over-tcp, false jika tidak.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Memeriksa apakah platform di perangkat mendukung enumerasi aplikasi

    Hasil
    boolean Benar jika enumerasi aplikasi didukung, salah jika tidak
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Memeriksa apakah platform di perangkat mendukung pengabaian pemblokiran sdk target rendah pada penginstalan aplikasi

    Hasil
    boolean Benar jika blok sdk target rendah yang dilewati didukung, salah jika tidak
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Periksa apakah debugfs terpasang.

    Hasil
    boolean true jika debugfs dipasang
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Menampilkan apakah perangkat dienkripsi.

    Hasil
    boolean true jika perangkat dienkripsi.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Menampilkan True jika jalur di perangkat adalah direktori, salah jika tidak.

    Parameter
    deviceFilePath String

    Hasil
    boolean

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Menampilkan apakah enkripsi didukung di perangkat.

    Hasil
    boolean true jika perangkat mendukung enkripsi.
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Menampilkan True (Benar) jika jalur file di perangkat adalah file yang dapat dieksekusi, salah jika tidak.

    Parameter
    fullPath String

    Hasil
    boolean

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Menampilkan true jika perangkat headless (tanpa layar), false jika sebaliknya.

    Hasil
    boolean

    Menampilkan
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Memeriksa apakah platform di perangkat mendukung pemberian izin runtime

    Hasil
    boolean Benar jika izin runtime didukung, salah jika tidak.
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Menampilkan true jika perangkat berada di TestDeviceState.FASTBOOT atau TestDeviceState.FASTBOOTD.

    Hasil
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Mengumpulkan dan mencatat ANR dari perangkat.

    Parameter
    logger ITestLogger: ITestLogger untuk mencatat ANR.
    Hasil
    boolean Benar jika logging berhasil, salah jika tidak.
    Menampilkan
    DeviceNotAvailableException

    logOnDevice

    public abstract void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

    Catat pesan di logcat perangkat. Ini adalah panggilan aman yang tidak akan ditampilkan meskipun logging gagal.

    Parameter
    tag String: Tag tempat kita mencatat pesan di logcat.
    level Log.LogLevel: Tingkat debug pesan di logcat.
    format String: Format pesan.
    args Object: argumen yang akan diganti melalui String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Pasang debugfs.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Mengeluarkan perintah untuk memulai ulang perangkat dan ditampilkan saat perintah selesai dan saat perangkat tidak lagi terlihat oleh adb.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Lakukan petunjuk untuk mengonfigurasi perangkat untuk pengujian setelah setiap booting.

    Harus dipanggil setelah perangkat di-booting/tersedia sepenuhnya

    Dalam keadaan normal, metode ini tidak perlu dipanggil secara eksplisit, karena implementasi harus melakukan langkah-langkah ini secara otomatis saat melakukan mulai ulang.

    Tempat yang mungkin perlu dipanggil adalah saat perangkat dimulai ulang karena peristiwa lain (misalnya saat perintah update fastboot selesai)

    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    postInvocationTearDown

    public void postInvocationTearDown ()

    Metode ini tidak digunakan lagi.
    Sebagai gantinya, gunakan postInvocationTearDown(Throwable).

    Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan selesai.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Langkah tambahan untuk pembersihan khusus perangkat yang diperlukan yang akan dijalankan setelah pemanggilan selesai.

    Parameter
    invocationException Throwable: jika ada, pengecualian akhir yang ditampilkan oleh kegagalan pemanggilan.

    preInvocationSetup

    public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

    Langkah tambahan untuk penyiapan khusus perangkat yang diperlukan yang akan dijalankan di perangkat sebelum alur pemanggilan.

    Parameter
    info IBuildInfo: IBuildInfo perangkat.
    attributes MultiMap: Atribut yang disimpan dalam konteks pemanggilan
    Menampilkan
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

    Menarik konten direktori secara berulang dari perangkat.

    Parameter
    deviceFilePath String: jalur file absolut dari sumber jarak jauh
    localDir File: direktori lokal untuk menarik file
    Hasil
    boolean true jika file berhasil diambil. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

    Menarik konten direktori secara berulang dari perangkat.

    Parameter
    deviceFilePath String: jalur file absolut dari sumber jarak jauh
    localDir File: direktori lokal untuk menarik file
    userId int: ID pengguna yang akan diambil
    Hasil
    boolean true jika file berhasil diambil. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                int userId)

    Mengambil file dari perangkat, menyimpannya di ERROR(/File) sementara lokal, dan menampilkan File tersebut.

    Parameter
    remoteFilePath String: jalur absolut ke file di perangkat.
    userId int: ID pengguna yang akan diambil
    Hasil
    File ERROR(/File) yang berisi konten file perangkat, atau null jika penyalinan gagal karena alasan apa pun (termasuk masalah pada sistem file host)
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pullFile

    public abstract File pullFile (String remoteFilePath)

    Mengambil file dari perangkat, menyimpannya di ERROR(/File) sementara lokal, dan menampilkan File tersebut.

    Parameter
    remoteFilePath String: jalur absolut ke file di perangkat.
    Hasil
    File ERROR(/File) yang berisi konten file perangkat, atau null jika penyalinan gagal karena alasan apa pun (termasuk masalah pada sistem file host)
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

    Mengambil file dari perangkat.

    Parameter
    remoteFilePath String: jalur absolut ke file di perangkat.
    localFile File: file lokal untuk menyimpan konten. Jika tidak kosong, konten akan diganti.
    Hasil
    boolean true jika file berhasil diambil. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

    Mengambil file dari perangkat.

    Parameter
    remoteFilePath String: jalur absolut ke file di perangkat.
    localFile File: file lokal untuk menyimpan konten. Jika tidak kosong, konten akan diganti.
    userId int: ID pengguna yang akan diambil
    Hasil
    boolean true jika file berhasil diambil. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Mengambil file dari perangkat, dan menampilkan kontennya.

    Parameter
    remoteFilePath String: jalur absolut ke file di perangkat.
    Hasil
    String String yang berisi konten file perangkat, atau null jika penyalinan gagal karena alasan apa pun (termasuk masalah pada sistem file host)
    Menampilkan
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Metode praktis untuk mengambil file dari penyimpanan eksternal perangkat, menyimpannya di ERROR(/File) sementara lokal, dan menampilkan referensi ke File tersebut.

    Parameter
    remoteFilePath String: jalur ke file di perangkat, relatif terhadap titik pemasangan penyimpanan eksternal perangkat
    Hasil
    File ERROR(/File) yang berisi konten file perangkat, atau null jika penyalinan gagal karena alasan apa pun (termasuk masalah pada sistem file host)
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushDir

    public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

    Kirim konten direktori secara berulang ke perangkat.

    Parameter
    localDir File: direktori lokal yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    userId int: ID pengguna yang akan di-push
    Hasil
    boolean true jika file berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushDir

    public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

    Mendorong konten direktori secara rekursif ke perangkat sekaligus mengecualikan beberapa direktori yang difilter.

    Parameter
    localDir File: direktori lokal yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    excludedDirectories : Kumpulan nama direktori yang dikecualikan yang tidak boleh didorong.
    Hasil
    boolean true jika file berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushDir

    public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

    Kirim konten direktori secara berulang ke perangkat.

    Parameter
    localDir File: direktori lokal yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    Hasil
    boolean true jika file berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushFile

    public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

    Varian pushFile(File, String) yang secara opsional dapat mempertimbangkan untuk mengevaluasi kebutuhan bagi penyedia konten.

    Parameter
    localFile File: file lokal yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    evaluateContentProviderNeeded boolean: apakah akan memeriksa apakah kita memerlukan penyedia konten
    Hasil
    boolean true jika file berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushFile

    public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

    Mengirim file ke perangkat. Secara default menggunakan penyedia konten.

    Parameter
    localFile File: file lokal yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    Hasil
    boolean true jika file berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushFile

    public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

    Mengirim file ke perangkat. Secara default menggunakan penyedia konten.

    Parameter
    localFile File: file lokal yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    userId int: userId yang akan dikirim ke
    Hasil
    boolean true jika file berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    pushString

    public abstract boolean pushString (String contents, 
                String deviceFilePath)

    Mengirim file yang dibuat dari string ke perangkat

    Parameter
    contents String: konten file yang akan di-push
    deviceFilePath String: jalur file absolut tujuan jarak jauh
    Hasil
    boolean true jika string berhasil dikirim. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    mulai ulang

    public abstract void reboot ()

    Memulai ulang perangkat ke mode adb.

    Memblokir hingga perangkat tersedia.

    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    mulai ulang

    public abstract void reboot (String reason)

    Me-reboot perangkat ke mode adb dengan reason yang diberikan untuk dipertahankan saat reboot.

    Memblokir hingga perangkat tersedia.

    Alasan mulai ulang terakhir dapat diperoleh dengan membuat kueri properti sys.boot.reason.

    Parameter
    reason String: alasan untuk memulai ulang ini, atau null jika tidak ada alasan yang ditentukan.
    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Me-reboot perangkat ke mode bootloader.

    Memblokir hingga perangkat berada dalam mode bootloader.

    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Me-reboot perangkat ke mode fastbootd.

    Memblokir hingga perangkat dalam mode fastbootd.

    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Memulai ulang perangkat ke mode pemulihan adb.

    Memblokir hingga perangkat memasuki pemulihan

    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Me-reboot perangkat ke mode sideload adb (perhatikan bahwa ini adalah mode khusus dalam pemulihan)

    Memblokir hingga perangkat memasuki mode sideload

    Parameter
    autoReboot boolean: apakah akan memulai ulang perangkat secara otomatis setelah sideload
    Menampilkan
    DeviceNotAvailableException jika perangkat tidak dalam sideload setelah dimulai ulang

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Me-reboot perangkat ke mode sideload adb (perhatikan bahwa ini adalah mode khusus dalam pemulihan)

    Memblokir hingga perangkat memasuki mode sideload

    Menampilkan
    DeviceNotAvailableException jika perangkat tidak dalam sideload setelah dimulai ulang

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    Alternatif untuk reboot() yang hanya memblokir hingga perangkat online, yaitu terlihat oleh adb.

    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    Alternatif untuk reboot() yang hanya memblokir hingga perangkat online, yaitu terlihat oleh adb.

    Parameter
    reason String: alasan untuk memulai ulang ini, atau null jika tidak ada alasan yang ditentukan.
    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    Lihat juga:

    rebootUserspace

    public abstract void rebootUserspace ()

    Hanya memulai ulang bagian ruang pengguna perangkat.

    Memblokir hingga perangkat tersedia.

    PERINGATAN. Mulai ulang ruang pengguna saat ini sedang dalam pengembangan aktif, gunakan dengan menanggung sendiri risikonya.

    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    Alternatif untuk rebootUserspace() ()} yang hanya memblokir hingga perangkat online, yaitu terlihat oleh adb.

    Menampilkan
    DeviceNotAvailableException jika perangkat tidak tersedia setelah dimulai ulang

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Membuat partisi sistem di perangkat menjadi hanya baca. Dapat memulai ulang perangkat.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Buat partisi sistem di perangkat agar dapat ditulis. Dapat memulai ulang perangkat.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Membuat partisi vendor di perangkat menjadi hanya baca. Dapat memulai ulang perangkat.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Buat partisi vendor di perangkat agar dapat ditulis. Dapat memulai ulang perangkat.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

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

    Parameter
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner yang menjalankan pengujian
    listeners ITestLifeCycleReceiver: pemroses hasil pengujian
    Hasil
    boolean true jika perintah pengujian selesai. false jika gagal diselesaikan, tetapi pemulihan berhasil
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat hilang dan tidak dapat dipulihkan. Misalnya, perintah pengujian gagal diselesaikan dan pemulihan gagal.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

    Menjalankan uji instrumentasi, dan menyediakan pemulihan perangkat.

    Jika koneksi dengan perangkat hilang sebelum pengujian selesai, dan pemulihan berhasil, semua pemroses akan diberi tahu tentang testRunFailed dan "false" akan ditampilkan. Perintah pengujian tidak akan dijalankan kembali. Pemanggil dapat mencoba lagi jika perlu.

    Jika koneksi dengan perangkat hilang sebelum pengujian selesai, dan pemulihan gagal, semua pemroses akan diberi tahu tentang testRunFailed dan DeviceNotAvailableException akan ditampilkan.

    Parameter
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner yang menjalankan pengujian
    listeners : pemroses hasil pengujian
    Hasil
    boolean true jika perintah pengujian selesai. false jika gagal diselesaikan karena pengecualian komunikasi perangkat, tetapi pemulihan berhasil
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat hilang dan tidak dapat dipulihkan. Misalnya, perintah pengujian gagal diselesaikan dan pemulihan gagal.

    runInstrumentationTestsAsUser

    public abstract boolean 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)), tetapi menjalankan pengujian untuk pengguna tertentu.

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Hasil
    boolean

    Menampilkan
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

    Sama seperti ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), tetapi menjalankan pengujian untuk pengguna tertentu.

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Hasil
    boolean

    Menampilkan
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Menetapkan tanggal di perangkat

    Catatan: setelan tanggal di perangkat memerlukan root

    Parameter
    date Date: menentukan tanggal tertentu; akan menggunakan tanggal host jika null
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Menetapkan TestDeviceOptions untuk perangkat

    Parameter
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                String propValue)

    Menetapkan nilai properti yang diberikan di perangkat. Memerlukan root adb yang benar.

    Parameter
    propKey String: Kunci yang ditargetkan untuk ditetapkan.
    propValue String: Nilai properti yang akan ditetapkan.
    Hasil
    boolean menampilkan True jika perintah setprop berhasil, False jika tidak.
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Tetapkan IDeviceRecovery yang akan digunakan untuk perangkat ini. Harus ditetapkan saat perangkat pertama kali dialokasikan.

    Parameter
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Tetapkan mode pemulihan saat ini yang akan digunakan untuk perangkat.

    Digunakan untuk mengontrol metode pemulihan yang akan digunakan saat terjadi masalah komunikasi perangkat. Sebaiknya hanya gunakan metode ini seperlunya jika diperlukan (misalnya, saat framework tidak berfungsi, dll.

    Parameter
    mode ITestDevice.RecoveryMode: apakah mode 'pemulihan hingga hanya online' harus diaktifkan atau tidak.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Untuk tujuan pengelolaan perangkat, lacak serial yang kita gunakan untuk mereferensikan perangkat.

    Parameter
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Tetapkan apakah akan menggunakan fastboot erase atau fastboot format untuk menghapus total partisi di perangkat.

    Parameter
    useFastbootErase boolean: true jika penghapusan fastboot harus digunakan atau false jika format fastboot harus digunakan.

    startLogcat

    public abstract void startLogcat ()

    Mulai merekam output logcat dari perangkat di latar belakang.

    Tidak akan berpengaruh jika output logcat sudah diambil. Data dapat diambil nanti melalui getLogcat.

    Saat perangkat tidak lagi digunakan, stopLogcat() harus dipanggil.

    startLogcat() dan stopLogcat() biasanya tidak perlu dipanggil saat berada dalam konteks pemanggilan TF, karena framework TF akan memulai dan menghentikan logcat.

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

    Aktifkan mode tukar tambah pengujian. Perangkat akan dihapus total dan akan dimulai ulang.

    Parameter
    timeoutMs int

    Hasil
    boolean Benar jika kita berhasil, salah jika tidak
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Tutup dan hapus output emulator.

    stopLogcat

    public abstract void stopLogcat ()

    Berhenti merekam output logcat dari perangkat, dan hapus data logcat yang saat ini disimpan.

    Tidak akan berpengaruh jika output logcat tidak diambil.

    stopTradeInModeTesting

    public abstract void stopTradeInModeTesting ()

    Menghentikan pengujian mode trade-in. Perangkat akan dimulai ulang.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Alihkan perangkat ke mode adb-over-tcp.

    Hasil
    String nomor seri tcp atau null jika perangkat tidak dapat dialihkan
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Alihkan perangkat ke mode adb melalui usb.

    Hasil
    boolean true jika tombol berhasil, false jika tidak.
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

    Menyinkronkan konten direktori file lokal secara bertahap ke perangkat.

    Menentukan file yang akan di-push dengan membandingkan stempel waktu file lokal dengan file jarak jauh yang setara. Hanya file 'yang lebih baru' atau yang tidak ada yang akan dikirim ke perangkat. Dengan demikian, overhead harus relatif kecil jika file yang ditetapkan di perangkat sudah yang terbaru.

    File tersembunyi (dengan nama yang diawali dengan ".") akan diabaikan.

    Contoh penggunaan: syncFiles("/tmp/files", "/sdcard") akan membuat direktori /sdcard/files jika belum ada, dan secara rekursif mendorong konten /tmp/files ke /sdcard/files.

    Parameter
    localFileDir File: direktori file lokal yang berisi file untuk didorong secara rekursif.
    deviceFilePath String: root jalur file absolut tujuan jarak jauh. Semua direktori di jalur file ini harus dapat dibaca. Misalnya, mengirim ke /data/local/tmp saat adb bukan root akan gagal
    Hasil
    boolean true jika file berhasil disinkronkan. false jika tidak.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    unlockDevice

    public abstract boolean unlockDevice ()

    Membuka kunci perangkat jika perangkat dalam status terenkripsi.

    Metode ini dapat memulai ulang framework, tetapi tidak akan memanggil postBootSetup(). Oleh karena itu, perangkat mungkin belum sepenuhnya siap untuk diuji saat metode ini ditampilkan.

    Hasil
    boolean true jika berhasil atau jika perangkat tidak dienkripsi.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.
    UnsupportedOperationException jika enkripsi tidak didukung di perangkat.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Lepaskan debugfs.

    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Memblokir hingga tanda selesai booting perangkat ditetapkan.

    Parameter
    timeOut long: waktu dalam milidetik untuk menunggu flag ditetapkan
    Hasil
    boolean benar jika flag selesai booting perangkat ditetapkan dalam waktu tunggu
    Menampilkan
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Menunggu perangkat menjadi responsif dan tersedia untuk pengujian. Menggunakan waktu tunggu default.

    Hasil
    boolean Benar jika perangkat tersedia, Salah jika pemulihan dinonaktifkan dan tidak tersedia.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Menunggu perangkat menjadi responsif dan tersedia untuk pengujian.

    Parameter
    waitTime long: waktu dalam md untuk menunggu
    Hasil
    boolean Benar jika perangkat tersedia, Salah jika pemulihan dinonaktifkan dan tidak tersedia.
    Menampilkan
    DeviceNotAvailableException jika perangkat masih tidak responsif setelah masa berlaku waitTime berakhir.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Menunggu perangkat menjadi responsif dan tersedia tanpa mempertimbangkan jalur pemulihan.

    Parameter
    waitTime long

    Hasil
    boolean Benar jika perangkat tersedia, Salah jika tidak tersedia.
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Memblokir hingga perangkat terlihat melalui fastboot. Gunakan waktu tunggu default.

    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Memblokir agar perangkat berada dalam status 'adb recovery' (perhatikan bahwa ini berbeda dengan IDeviceRecovery).

    Parameter
    waitTime long: waktu dalam md untuk menunggu
    Hasil
    boolean true jika perangkat melakukan booting ke mode pemulihan sebelum waktu habis. false jika tidak

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Memblokir agar perangkat berada dalam status 'adb sideload'

    Parameter
    waitTime long: waktu dalam md untuk menunggu
    Hasil
    boolean true jika perangkat melakukan booting ke sideload sebelum waktu habis. false jika tidak

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Memblokir agar perangkat tidak tersedia, yaitu tidak ada di adb

    Parameter
    waitTime long: waktu dalam md untuk menunggu
    Hasil
    boolean true jika perangkat tidak tersedia sebelum waktu habis. false jika tidak

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Memblokir hingga perangkat terlihat melalui adb. Menggunakan waktu tunggu default

    Perhatikan bahwa perangkat mungkin tidak selalu responsif terhadap perintah setelah selesai. Sebagai gantinya, gunakan waitForDeviceAvailable().

    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Memblokir hingga perangkat terlihat melalui adb.

    Perhatikan bahwa perangkat mungkin tidak selalu responsif terhadap perintah setelah selesai. Sebagai gantinya, gunakan waitForDeviceAvailable().

    Parameter
    waitTime long: waktu dalam md untuk menunggu
    Menampilkan
    DeviceNotAvailableException jika koneksi dengan perangkat terputus dan tidak dapat dipulihkan.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

    Menunggu perangkat responsif terhadap perintah shell adb dasar.

    Parameter
    waitTime long: waktu dalam md untuk menunggu
    Hasil
    boolean true jika perangkat menjadi responsif sebelum waitTime berlalu.