Berinteraksi dengan aplikasi Android dengan melakukan gestur dan peristiwa tombol pada elemen UI.
Penggunaan
android input [-h] [--device=PARAM]
Opsi
--device=PARAM- Nomor seri perangkat atau ID emulator (seperti yang dilaporkan oleh 'adb devices').-h,--help- Menampilkan pesan bantuan untuk perintah yang ditentukan.
Opsi android:
--sdk=PARAM- Jalur ke Android SDK.-v,--verbose- Mengaktifkan output panjang untuk pemecahan masalah.-V,--version- Mencetak informasi versi dan keluar.
Subperintah
key- Menekan tombol fisik, tombol navigasi, atau kode tombol Android.scroll- Men-scroll elemen penampung, secara opsional hingga elemen target muncul.swipe- Geser dari elemen UI yang cocok dengan pemilih ke arah tertentu.tap- Ketuk elemen UI yang cocok dengan pemilih.text- Mengetik teks ke dalam elemen UI yang cocok dengan pemilih.
Deskripsi
android input melakukan interaksi pengguna dan input hardware pada perangkat atau emulator yang didukung Android yang terhubung.
Agen AI dan skrip pengujian dapat menggunakan android input bersama dengan
android layout atau android screen untuk menemukan elemen UI
dan berinteraksi dengannya menggunakan gestur atau penekanan tombol.
Pemilih elemen UI
Sebagian besar subperintah input menargetkan elemen UI menggunakan ekspresi pemilih. Pemilih adalah daftar pasangan key=value atau key:value yang dipisahkan koma, yang menentukan properti yang harus dipenuhi oleh elemen target. Sertakan pemilih dalam tanda kutip tunggal untuk mencegah interpretasi shell terhadap spasi, koma, atau karakter khusus.
Pemilih cocok dengan hierarki node aksesibilitas aktif aplikasi:
- Properti string: Dicocokkan sebagai substring yang tidak peka huruf besar/kecil secara default (misalnya,
text=submitcocok dengan "Submit order"). Teruskan*untuk mencocokkan elemen apa pun dengan nilai yang tidak kosong untuk properti tersebut. Gabungkan nilai dalam garis miring untuk mencocokkannya sebagai ekspresi reguler peka huruf besar/kecil yang dapat cocok dengan bagian mana pun dari nilai (misalnya,text=/^Submit$/). Tambahkan tandaisetelah garis miring penutup untuk ekspresi reguler yang tidak peka huruf besar/kecil (misalnya,text=/^submit$/i). Koma di dalam ekspresi reguler tidak memisahkan pemilih. Untuk mencocokkan teks literal yang diawali dengan/, gunakan ekspresi reguler sepertitext=/^\/help/.text(sinonim:txt): Teks terlihat yang ditampilkan pada elemen.id(sinonim:res): Nama ID resource tampilan (misalnya,id=submit_buttonatau nama resource lengkapcom.example.app:id/submit_button).class(sinonim:clazz,cls,clz): Nama class elemen atau nama class sederhana (seperticlass=Buttonatauandroid.widget.Button).desc(sinonim:content): Deskripsi konten aksesibilitas.
- Properti interaksi: Dicocokkan sebagai nilai boolean (
trueataufalse).clickable(sinonim:click): Apakah elemen dapat diklik.checkable: Apakah elemen dapat dicentang atau diaktifkan/dinonaktifkan.scrollable(sinonim:scroll): Apakah elemen merupakan penampung yang dapat di-scroll.focusable: Apakah elemen dapat menerima fokus.longclickable(sinonim:longclick): Apakah elemen mendukung klik lama.
- Properti status: Dicocokkan sebagai nilai boolean (
trueataufalse).checked: Apakah elemen saat ini dicentang.focused: Apakah elemen saat ini memiliki fokus.selected: Menentukan apakah elemen sedang dipilih.
Perilaku pencocokan (--match)
Jika pemilih cocok dengan lebih dari satu elemen di layar:
--match=single(default): Gagal dengan error dan mencantumkan semua elemen yang cocok, sehingga memastikan interaksi tidak memicu komponen UI yang salah.--match=first: Berinteraksi dengan elemen pertama yang cocok yang ditemukan dalam hierarki UI.
Gestur dan perintah yang tersedia
tap <target>: Mengklik bagian tengah elemen yang ditargetkan.text <string> <target>: Menghapus teks yang ada dan mengetik<string>ke dalam elemen yang ditargetkan. Teruskan--submituntuk mengirim peristiwa tombol Enter/OK setelah mengetik.scroll <target>: Men-scroll elemen penampung ke arah yang ditentukan (--dir=up|down|left|right). Gunakan--until=<selector>untuk terus men-scroll hingga elemen yang cocok muncul.swipe <target>: Melakukan gestur geser mulai dari<target>ke arah (--dir=up|down|left|right), dengan--distance(pecahan layar) dan--speed(piksel per detik) opsional.key <key>: Mengirim tombol fisik atau peristiwa tombol (sepertiback,home,recents,power,volume-up,volume-down,enter,tab,esc, atau kode tombol Android bilangan bulat). Mendukung flag pengubah--shift,--alt, dan--ctrl.
Menentukan perangkat target (--device)
Jika beberapa perangkat atau emulator terhubung, teruskan --device=<serial-number>
(seperti yang dilaporkan oleh adb devices) untuk mengarahkan peristiwa input ke perangkat tertentu.
Contoh
Ketuk tombol berdasarkan teks yang terlihat:
android input tap 'text=Submit'
Ketuk elemen yang cocok dengan beberapa properti:
android input tap 'id=submit_btn,class=Button,clickable=true'
Ketuk elemen pertama yang cocok jika ada beberapa kecocokan:
android input tap --match=first 'class=android.widget.TextView'
Ketik teks ke dalam kolom input dan kirim:
android input text 'user@example.com' 'id=email_input' --submit
Men-scroll penampung ke bawah hingga item muncul:
android input scroll 'id=recycler_view' --dir=down --until='text=Settings'
Geser ke kiri pada elemen kartu:
android input swipe 'id=card_view' --dir=left
Tekan tombol Kembali di perangkat:
android input key back