Setiap perangkat virtual yang berjalan menyediakan konsol yang memungkinkan Anda untuk meminta dan mengontrol lingkungan perangkat yang diemulasikan. Misalnya, Anda dapat menggunakan konsol untuk mengelola pengalihan port, karakteristik jaringan, dan peristiwa telepon saat aplikasi Anda berjalan di emulator.
Perintah berikut ini mewajibkan Anda sudah menjalankan emulator. Untuk mengetahui informasi selengkapnya tentang menjalankan emulator, lihat Menjalankan Aplikasi di Android Emulator dan Memulai Emulator dari Command Line.
Memulai dan menghentikan sesi konsol
Untuk mengakses konsol dan memasukkan perintah, dari jendela terminal, gunakan telnet agar
terhubung ke
port konsol dan berikan token autentikasi Anda. Setiap kali konsol menampilkan
OK, artinya konsol siap menerima perintah. Konsol tidak memiliki perintah yang khas.
Agar terhubung ke konsol perangkat virtual yang berjalan:
- Buka jendela terminal dan masukkan perintah berikut:
- Setelah konsol menampilkan
OK, masukkan perintahauth auth_token. - Setelah Anda terhubung ke konsol, masukkan perintah konsol.
- Untuk keluar dari sesi konsol, masukkan
quitatauexit.
telnet localhost console-port
Judul jendela emulator mencantumkan nomor port konsol. Misalnya,
judul jendela untuk emulator yang menggunakan port konsol 5554 bisa menjadi Nexus_5X_API_23:5554.
Selain itu, perintah adb devices mencetak daftar
perangkat virtual yang berjalan beserta nomor port konsolnya. Untuk mengetahui informasi selengkapnya, baca
Permintaan untuk Instance Perangkat/Emulator.
Catatan: Emulator akan memproses koneksi pada port 5554 hingga 5585 dan menerima koneksi dari localhost saja.
Sebelum Anda dapat memasukkan perintah konsol, konsol emulator
memerlukan autentikasi. auth_token harus
cocok dengan isi file .emulator_console_auth_token di direktori beranda Anda.
Jika file tersebut tidak ada, perintah
telnet localhost console-port akan membuat file yang berisi token autentikasi yang dibuat secara acak. Untuk menonaktifkan
autentikasi, hapus token dari file
.emulator_console_auth_token atau buat file kosong jika tidak ada.
Masukkan help, help command, atau help-verbose
untuk melihat daftar perintah konsol dan mempelajari perintah
khusus.
Berikut ini adalah contoh sesi:
$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
help|h|? print a list of commands
help-verbose print a list of commands with descriptions
ping check if the emulator is alive
automation manage emulator automation
event simulate hardware events
geo Geo-location commands
gsm GSM related commands
cdma CDMA related commands
crash crash the emulator instance
crash-on-exit simulate crash on exit for the emulator instance
kill kill the emulator instance
restart restart the emulator instance
network manage network settings
power power related commands
quit|exit quit control session
redir manage port redirections
sms SMS related commands
avd control virtual device execution
qemu QEMU-specific commands
sensor manage emulator sensors
physics manage physical model
finger manage emulator finger print
debug control the emulator debug output tags
rotate rotate the screen clockwise by 90 degrees
screenrecord Records the emulator's display
fold fold the device
unfold unfold the device
multidisplay configure the multi-display
try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.
Referensi perintah emulator
Tabel berikut mendeskripsikan perintah konsol emulator beserta parameter dan nilainya.
Tabel 1. Perintah konsol emulator
| Perintah Umum | Deskripsi |
|---|---|
avd {stop|start|status|name}
|
Meminta, mengontrol, dan mengelola perangkat virtual, sebagai berikut:
|
avd snapshot {list|save name|load name|delete
name}
|
Menyimpan dan memulihkan status perangkat dalam snapshot, sebagai berikut:
Contoh berikut menyimpan snapshot dengan nama
avd snapshot save firstactivitysnapshot |
fold
|
Melipat perangkat untuk menampilkan konfigurasi dengan layar lebih kecil (jika perangkat dapat dilipat dan saat ini sedang terbuka). |
unfold
|
Membuka lipatan perangkat untuk menampilkan konfigurasi dengan layar yang lebih besar (jika perangkat dapat dilipat dan saat ini sedang terlipat). |
kill
|
Menghentikan perangkat virtual. |
ping
|
Memeriksa apakah perangkat virtual sedang berjalan. |
rotate
|
Memutar AVD berlawanan arah jarum jam dengan inkremen 45 derajat. |
| Menghentikan emulator | Deskripsi |
crash
|
Menghentikan emulator selama menjalankan aplikasi. |
crash-on-exit |
Menghentikan emulator saat aplikasi ditutup. |
| Tag debug | Deskripsi |
debug tags ...
|
Mengaktifkan atau menonaktifkan pesan debug dari bagian emulator tertentu.
Parameter tags harus berupa nilai dari daftar tag debug yang muncul saat
Anda menjalankan
Contoh berikut ini mengaktifkan tag debug radio |
| Pengalihan port | Deskripsi |
redir list
|
Mencantumkan daftar pengalihan port saat ini. |
redir add protocol:host-port:guest-port
|
Menambahkan pengalihan port baru, sebagai berikut:
|
redir del protocol:host-port
|
Menghapus pengalihan port.
|
| Lokasi geografis | Deskripsi |
|
Setel lokasi geografis yang dilaporkan ke aplikasi yang berjalan dalam emulator
dengan mengirimkan perbaikan GPS ke emulator.
Anda dapat memberikan perintah |
|
geo fix longitude latitude satellites [altitude]
|
Mengirim perbaikan GPS sederhana ke emulator.
Tentukan longitude dan latitude
dalam derajat desimal. Gunakan angka dari 1 sampai 12 untuk menentukan jumlah
satellites yang akan digunakan untuk menentukan posisi, dan tentukan,
dan tentukan altitude dalam meter.
|
geo nmea sentence
|
Mengirim kalimat NMEA 0183 ke perangkat yang diemulasikan, seolah dikirim dari
modem GPS yang ditiru. Mulai sentence dengan '$GP'.
Hanya kalimat '$GPGGA' dan '$GPRCM' yang saat ini didukung. Contoh berikut
adalah kalimat GPGGA (Global Fixing System Fix Data) yang mendapatkan
waktu, posisi, dan memperbaiki data untuk penerima GPS:
geo nmea $GPGGA ,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx |
| Peristiwa hardware palsu | Deskripsi |
event types
|
Mencantumkan semua jenis peristiwa palsu. Untuk peristiwa yang memiliki kode, jumlah kode tercantum dalam tanda kurung
di sebelah kanan.
event types
event <type> can be an integer or one of the following aliases:
EV_SYN
EV_KEY (405 code aliases)
EV_REL (2 code aliases)
EV_ABS (27 code aliases)
EV_MSC
EV_SW (4 code aliases)
EV_LED
EV_SND
EV_REP
EV_FF
EV_PWR
EV_FF_STATUS
EV_MAX
OK
|
event send types [types ...]
|
Mengirim satu atau beberapa jenis peristiwa palsu. |
event codes type
|
Mencantumkan kode acara untuk jenis peristiwa palsu yang ditentukan. |
event send type[:code]:[value] [...]
|
Mengirim satu atau beberapa peristiwa palsu dengan kode opsional dan nilai kode.
Untuk menemukan peristiwa yang akan dikirim, Anda dapat menggunakan perintah Berikut adalah peristiwa yang dihasilkan saat Anda menekan tombol daya:
adb shell getevent -lt
/dev/input/event12: EV_KEY KEY_POWER DOWN
/dev/input/event12: EV_SYN SYN_REPORT 00000000
/dev/input/event12: EV_KEY KEY_POWER UP
/dev/input/event12: EV_SYN SYN_REPORT 00000000
Dalam kasus ini, kami hanya perlu mengirim dua peristiwa EV_KEY, peristiwa keydown, dan keyup
untuk menyimulasikan penekanan lama tombol daya:
event send EV_KEY:KEY_POWER:0
OK
event send EV_KEY:KEY_POWER:1
OK
|
event text message
|
Mengirim string karakter yang melakukan simulasi saat tombol ditekan. Pesan harus berupa string UTF-8. Postingan Unicode dipetakan terbalik sesuai dengan keyboard perangkat saat ini, dan karakter yang tidak didukung akan dibuang tanpa pemberitahuan. |
| Kontrol status daya yang dilaporkan emulator ke aplikasi | Deskripsi |
power display
|
Menampilkan status baterai dan pengisi daya. |
power ac {on|off}
|
Menyetel status pengisian daya AC menjadi on atau off.
|
power status {unknown|charging|discharging|not-charging|full}
|
Mengubah status baterai seperti yang ditentukan. |
power present {true|false}
|
Menyetel status keberadaan baterai. |
power health {unknown|good|overheat|dead|overvoltage|failure}
|
Menyetel status kesehatan baterai. |
power capacity percent
|
Menyetel status kapasitas baterai yang tersisa dalam persen dari 0 hingga 100. |
| Status koneksi jaringan | Deskripsi |
network status
|
Memeriksa status jaringan serta karakteristik kecepatan dan waktu tunda saat ini. |
network delay latency
|
Mengubah latensi jaringan yang diemulasikan.
Emulator memungkinkan Anda melakukan simulasi berbagai tingkat latensi jaringan, sehingga Anda dapat menguji aplikasi di lingkungan yang lebih khas dari kondisi aktual yang akan dijalankannya. Anda dapat menyetel tingkat atau rentang latensi saat memulai emulator, atau menggunakan konsol untuk mengubah latensi saat aplikasi berjalan di emulator. Untuk menyetel latensi saat memulai emulator, gunakan emulator -netdelay gprs emulator -netdelay 40,100 Untuk mengubah penundaan jaringan saat emulator sedang berjalan, sambungkan ke konsol dan gunakan
perintah network delay gprs network delay 40 100 Format latensi jaringan: Format latency jaringan adalah salah satu dari berikut ini (jumlahnya tertera dalam milidetik):
|
network speed speed |
Emulator memungkinkan Anda melakukan simulasi berbagai laju transfer jaringan.
Anda dapat menyetel laju atau rentang transfer pada saat memulai emulator, atau menggunakan konsol untuk mengubah laju, saat aplikasi berjalan di emulator.
Untuk menyetel kecepatan jaringan pada saat memulai emulator, gunakan emulator -netspeed gsm @Pixel_API_26 emulator -netspeed 14.4,80 @Pixel_API_26 Untuk mengubah kecepatan jaringan saat emulator sedang berjalan, sambungkan ke konsol
dan gunakan perintah network speed 14.4 80 Format kecepatan jaringan: Format
|
network capture {start|stop} file |
Mengirim paket ke file. Daftar berikut mendeskripsikan parameter dan
nilai parameter:
|
| Emulasi telepon | Deskripsi |
| Emulator Android menyertakan modem emulasi GSM dan CDMA sendiri yang memungkinkan Anda melakukan simulasi fungsi telepon di emulator. Misalnya, dengan GSM Anda dapat melakukan simulasi panggilan telepon masuk serta membuat dan mengakhiri koneksi data. Dengan CDMA Anda dapat menyediakan sumber langganan dan daftar roaming yang disukai. Sistem Android akan menangani panggilan simulasi persis seperti panggilan sebenarnya. Emulator tidak mendukung audio panggilan. | |
gsm {call|accept|cancel|busy} phonenumber
|
Parameter gsm adalah sebagai berikut:
|
gsm {data|voice} state
|
Perintah data state mengubah status koneksi data GPRS,
dan data voice state mengubah status koneksi suara GPRS,
sebagai berikut:
|
gsm hold
|
Mengubah status panggilan menjadi hold. Anda dapat mengubah
status panggilan menjadi hold hanya jika status saat ini adalah active atau
waiting.
|
gsm list
|
Mencantumkan semua panggilan masuk dan keluar beserta statusnya. |
gsm status
|
Melaporkan status suara/data GSM saat ini. Nilai adalah
yang dijelaskan untuk perintah voice dan data.
|
gsm signal {rssi|ber}
|
Mengubah kekuatan sinyal yang dilaporkan (rssi) dan bit error rate (ber) pada 15
detik update berikutnya. Daftar berikut ini menjelaskan parameter dan nilainya:
|
gsm signal-profile num
|
Menyetel profil kekuatan sinyal. Masukkan angka dari 0 hingga 4. |
cdma ssource source
|
source: Menyetel sumber langganan CDMA saat ini, dengan
source adalah daftar berbasis jaringan yang diizinkan dan berisi
pelanggan operator CDMA beserta nilainya, sebagai berikut:
|
cdma prl_version version
|
Membuang versi preferred roaming list (PRL) saat ini. Nomor versi adalah untuk database PRL yang berisi informasi yang digunakan selama proses pemilihan dan akuisisi sistem. |
| Kelola Sensor pada emulator | Deskripsi |
Perintah ini berhubungan dengan
sensor yang tersedia di AVD. Selain menggunakan perintah sensor, Anda
dapat melihat dan menyesuaikan setelan di emulator pada layar Virtual sensors di
tab Akselerometer dan Sensor tambahan. Untuk mengetahui informasi selengkapnya, baca
Bekerja dengan kontrol, setelan,
dan bantuan yang diperluas.
|
|
sensor status |
Mencantumkan semua sensor dan statusnya. Berikut adalah contoh output untuk
perintah sensor status:
|
sensor get sensor-name
|
Mendapatkan setelan untuk sensor-name. Contoh berikut adalah
nilai untuk sensor akselerasi:
sensor get acceleration acceleration = 2.23517e-07:9.77631:0.812348
Nilai |
sensor set sensor-name value-x:value-y:value-z
|
Menetapkan nilai untuk sensor-name. Contoh berikut menetapkan
sensor akselerasi ke nilai x, y, dan z berikut
yang dipisahkan oleh titik dua. Untuk mengetahui informasi selengkapnya, baca
Bekerja dengan kontrol, setelan,
dan bantuan yang diperluas.
sensor set acceleration 2.23517e-07:9.77631:0.812348 |
| Emulasi SMS | Deskripsi |
sms send sender-phone-number textmessage
|
Membuat emulasi SMS masuk. Daftar berikut menjelaskan parameter dan
nilainya:
Berikut adalah contoh pengiriman pesan "hi there" ke nomor telepon 4085555555. sms send 4085555555 hi there Konsol akan meneruskan pesan SMS ke framework Android, yang akan diteruskan ke aplikasi pada emulator yang menangani SMS, seperti aplikasi Pesan. Jika Anda memasukkan 10 nomor, aplikasi akan memformatnya sebagai nomor telepon. String numerik yang lebih panjang atau lebih pendek akan menampilkan cara Anda mengirimnya.
|
| Simulasi sidik jari | Deskripsi |
finger touch fingerprint-id
|
Menyimulasikan jari yang menyentuh sensor. |
finger remove
|
Menyimulasikan pelepasan jari dari sensor.
Untuk mengetahui petunjuk tentang penggunaan perintah ini, baca Simulasi dan validasi sidik jari. |
Simulasi dan validasi sidik jari
Gambar 1. Layar autentikasi sidik jari.
Gunakan perintah finger untuk menyimulasikan dan memvalidasi autentikasi sidik jari untuk aplikasi
Anda. Anda memerlukan SDK Tools 24.3 atau yang lebih tinggi, dan Android 6.0 (API level 23) atau yang lebih tinggi.
Untuk menyimulasikan dan memvalidasi autentikasi sidik jari, ikuti langkah-langkah ini:
- Jika Anda belum memiliki ID sidik jari, daftarkan sidik jari baru di emulator dengan memilih Setelan > Keamanan > Sidik jari dan ikuti petunjuk pendaftaran.
- Siapkan aplikasi Anda untuk menerima autentikasi sidik jari. Setelah melakukan penyiapan ini, perangkat Anda akan menampilkan layar autentikasi sidik jari.
- Saat aplikasi menampilkan layar autentikasi sidik jari, buka konsol dan
masukkan perintah
finger touchserta ID sidik jari yang Anda buat. Aplikasi akan melakukan simulasi sentuhan jari. - Kemudian, masukkan perintah
finger removeuntuk melakukan simulasi pelepasan jari dari sensor.Aplikasi Anda akan merespons seolah-olah pengguna menyentuh lalu melepaskan jarinya dari sensor sidik jari.