MonkeyDevice

Class monkeyrunner yang menunjukkan perangkat atau emulator dapat diakses oleh workstation yang menjalankan monkeyrunner.

Class ini digunakan untuk mengontrol perangkat Android atau emulator. Metode ini mengirim peristiwa UI, mengambil informasi, menginstal dan menghapus aplikasi, serta menjalankan aplikasi.

Biasanya Anda tidak diwajibkan untuk membuat instance dari MonkeyDevice. Sebagai gantinya, Anda akan menggunakan MonkeyRunner.waitForConnection() untuk membuat objek baru dari koneksi ke perangkat atau emulator. Misalnya, sebagai ganti menggunakan:

    newdevice = MonkeyDevice()
    

Anda akan menggunakan:

    newdevice = MonkeyRunner.waitForConnection()
    

Ringkasan

Konstanta
string DOWN Gunakan ini dengan argumen type dari press() atau touch() untuk mengirim peristiwa DOWN.
string UP Gunakan ini dengan argumen type dari press() atau touch() untuk mengirim peristiwa UP.
string DOWN_AND_UP Gunakan ini dengan argumen type dari press() atau touch() untuk mengirim peristiwa DOWN diikuti dengan peristiwa UP.
Metode
void broadcastIntent (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, iterable flags)
Menyiarkan Intent ke perangkat ini, seolah-olah Intent tersebut berasal dari aplikasi.
void drag (tuple start, tuple end, float duration, integer steps)
Menyimulasikan gestur tarik (sentuh, tahan, dan pindah) pada layar perangkat ini.
object getProperty (string key)
Nama variabel lingkungan sistem, menampilkan nilainya untuk perangkat ini. Nama-nama variabel yang tersedia tercantum dalam deskripsi mendetail dari metode ini.
object getSystemProperty (string key)
. API yang setara dengan adb shell getprop <key>. This is provided for use by platform developers.
void installPackage (string path)
Menginstal aplikasi Android atau paket pengujian yang dimuat di dalam packageFile ke perangkat ini. Jika aplikasi atau paket pengujian sudah terinstal, file tersebut akan ditimpa.
dictionary instrument (string className, dictionary args)
Menjalankan komponen yang ditentukan dalam instrumentasi Android, dan menampilkan hasilnya dalam kamus yang format pastinya ditentukan oleh komponen yang sedang dijalankan. Komponen tersebut harus sudah tersedia di perangkat ini.
void press (string name, dictionary type)
Mengirim peristiwa tombol yang ditentukan menurut jenis tombol yang ditentukan oleh kode tombol.
void reboot (string into)
Me-reboot perangkat ini ke bootloader yang ditentukan oleh bootloadType.
void removePackage (string package)
Menghapus paket yang ditentukan dari perangkat ini, termasuk data dan cache-nya.
object shell (string cmd)
Menjalankan perintah shell adb dan menampilkan hasilnya, jika ada.
void startActivity (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, flags)
Memulai Aktivitas pada perangkat ini dengan mengirimkan Intent yang dibuat dari argumen yang disediakan.
MonkeyImage takeSnapshot()
Menangkap seluruh buffer layar perangkat ini, menghasilkan objek MonkeyImage yang berisi screenshot dari tampilan saat ini.
void touch (integer x, integer y, integer type)
Mengirim peristiwa sentuh yang ditentukan berdasarkan jenis ke lokasi layar yang ditentukan oleh x dan y.
void type (string message)
Mengirim karakter yang termuat dalam pesan ke perangkat ini, seolah-olah karakter tersebut telah diketik di keyboard perangkat. Ini setara dengan memanggil press() untuk setiap kode tombol dalam message menggunakan jenis peristiwa tombol DOWN_AND_UP.
void wake ()
Mengaktifkan layar perangkat ini.

Konstanta

string DOWN

Nilai press() atau touch(). Menentukan bahwa jenis peristiwa DOWN harus dikirim ke perangkat, terkait dengan menekan tombol atau menyentuh layar.

string UP

Nilai press() atau touch(). Menentukan bahwa jenis peristiwa UP harus dikirim ke perangkat, terkait dengan melepas tombol atau mengangkat dari layar.

string DOWN_AND_UP

Nilai press(), touch(), atau type(). Menentukan bahwa jenis peristiwa DOWN diikuti oleh jenis peristiwa UP harus dikirim ke perangkat, terkait dengan mengetik tombol atau mengklik layar.

Metode publik

void broadcastIntent ( string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, iterable flags)

Menyiarkan Intent ke perangkat ini, seolah-olah Intent tersebut berasal dari aplikasi. Lihat Intent untuk mengetahui informasi selengkapnya tentang argumen.

Argumen
uri URI untuk Intent. (lihat Intent.setData()).
action Tindakan untuk Intent ini (lihat Intent.setAction()).
data URI data untuk Intent ini (lihat Intent.setData()).
mimetype Jenis MIME untuk Intent (lihat Intent.setType()).
categories Struktur data iterable berisi string yang menentukan kategori untuk Intent (lihat Intent.addCategory()).
extras Kamus data tambahan untuk Intent (lihat Intent.putExtra() untuk mengetahui contohnya).

Kunci untuk setiap item kamus harus berupa string. Nilai item dapat berupa jenis data sederhana atau terstruktur.

component Komponen untuk Intent ini (lihat ComponentName). Menggunakan argumen ini akan mengarahkan Intent ke class tertentu dalam paket Android tertentu.
flags Struktur data iterable berisi flag yang mengontrol bagaimana Intent diproses (lihat Intent.setFlags()).

void drag ( tuple start, tuple end, float duration, integer steps)

Menyimulasikan gestur tarik (sentuh, tahan, dan pindah) pada layar perangkat ini.

Argumen
start Titik awal gestur tarik, dalam bentuk tuple (x,y) di mana x dan y adalah integer.
end Titik akhir gestur tarik, dalam bentuk tuple (x,y) di mana x dan y adalah integer.
duration Durasi gestur tarik dalam hitungan detik. Defaultnya adalah 1 detik.
steps Jumlah langkah yang harus diambil saat menambah titik. Defaultnya adalah 10.

object getProperty (string key)

Nama variabel lingkungan sistem, menampilkan nilainya untuk perangkat ini.

Argumen
key Nama variabel lingkungan sistem. Nama-nama variabel yang tersedia tercantum dalam Tabel 1. Nama variabel properti di akhir topik ini.
Hasil
  • Nilai variabel. Format data bervariasi sesuai dengan variabel yang diminta.

object getSystemProperty (string key)

Sinonim untuk getProperty().

Argumen
key Nama variabel lingkungan sistem. Nama-nama variabel yang tersedia tercantum dalam Tabel 1. Nama Variabel Properti.
Hasil
  • Nilai variabel. Format data bervariasi sesuai dengan variabel yang diminta.

void installPackage (string path)

Menginstal aplikasi Android atau paket pengujian yang dimuat di dalam packageFile ke perangkat ini. Jika aplikasi atau paket pengujian sudah terinstal, file tersebut akan ditimpa.

Argumen
path Lokasi dan nama file yang memenuhi syarat untuk menginstal file .apk.

dictionary instrument ( string className, dictionary args)

Menjalankan komponen yang ditentukan dengan instrumentasi Android, dan menampilkan hasilnya dalam kamus yang format pastinya ditentukan oleh komponen yang sedang dijalankan. Komponen tersebut harus sudah tersedia di perangkat ini.

Gunakan metode ini untuk memulai kasus pengujian yang menggunakan salah satu class kasus pengujian Android. Lihat Dasar-Dasar Pengujian untuk mempelajari lebih lanjut pengujian unit dengan framework pengujian Android.

Argumen
className Nama komponen Android yang sudah terinstal di perangkat ini, dalam packagename/classname standar, di mana packagename adalah nama paket Android dari file .apk pada perangkat ini, dan classname adalah nama class dari komponen Android (Activity, ContentProvider, Service, atau BroadcastReceiver) dalam file tersebut. Baik packagename dan classname harus sepenuhnya memenuhi syarat. Lihat ComponentName untuk mengetahui informasi selengkapnya.
args Kamus yang berisi flag dan nilainya. Nilai tersebut akan diteruskan ke komponen saat dimulai. Jika flag ini tidak mengambil nilai, setel nilai kamusnya ke string yang kosong.
Hasil
  • Kamus berisi output komponen. Konten kamus ditentukan oleh komponen itu sendiri.

    Jika Anda menggunakan InstrumentationTestRunner sebagai nama class dalam argumen componentName, kamus hasil berisi satu kunci "stream". Nilai "stream" adalah string yang berisi output pengujian, seolah-olah InstrumentationTestRunner dijalankan dari command line. Format output ini dijelaskan dalam Pengujian di IDE Lainnya.

void press (string name, integer type)

Mengirim peristiwa tombol yang ditentukan menurut type ke kunci yang ditentukan oleh keycode.

Argumen
name Nama kode tombol yang akan dikirim. Lihat KeyEvent untuk mengetahui daftar nama kode tombol. Gunakan nama kode tombol, bukan nilai bilangan bulatnya.
type Jenis peristiwa tombol yang akan dikirim. Nilai yang diizinkan adalah DOWN, UP, dan DOWN_AND_UP.

void reboot (string bootloadType)

Me-reboot perangkat ini ke bootloader yang ditentukan oleh bootloadType.

Argumen
into Jenis bootloader untuk reboot. Nilai yang diizinkan adalah "bootloader", "recovery", atau "None".

void removePackage (string package)

Menghapus paket yang ditentukan dari perangkat ini, termasuk data dan cache-nya.

Argumen
package Nama paket Android dari file .apk pada perangkat ini.

object shell (string cmd)

Menjalankan perintah shell adb dan menampilkan hasilnya, jika ada.

Argumen
cmd Perintah yang akan dijalankan di shell adb. Bentuk perintah ini dijelaskan dalam topik Android Debug Bridge.
Hasil
  • Hasil perintah, jika ada. Format hasil ditentukan oleh perintah.

void startActivity ( string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, iterable flags)

Memulai Aktivitas pada perangkat ini dengan mengirimkan Intent yang dibuat dari argumen yang disediakan.

Argumen
uri URI untuk Intent. (lihat Intent.setData()).
action Tindakan untuk Intent (lihat Intent.setAction()).
data URI data untuk Intent (lihat Intent.setData()).
mimetype Jenis MIME untuk Intent (lihat Intent.setType()).
categories Struktur data iterable berisi string yang menentukan kategori untuk Intent (lihat Intent.addCategory()).
extras Kamus data tambahan untuk Intent (lihat Intent.putExtra() untuk mengetahui contohnya).

Kunci untuk setiap item kamus harus berupa string. Nilai item dapat berupa jenis data sederhana atau terstruktur.

component Komponen untuk Intent (lihat ComponentName). Menggunakan argumen ini akan mengarahkan Intent ke class tertentu dalam paket Android tertentu.
flags Struktur data iterable berisi flag yang mengontrol bagaimana Intent diproses (lihat Intent.setFlags()).

MonkeyImage takeSnapshot ()

Menangkap seluruh buffer layar perangkat ini, menghasilkan screenshot dari tampilan saat ini.

Hasil
  • Objek MonkeyImage yang berisi gambar tampilan saat ini.

void touch ( integer x, integer y, string type)

Mengirim peristiwa sentuh yang ditentukan berdasarkan jenis ke lokasi layar yang ditentukan oleh x dan y.

Argumen
x Posisi horizontal sentuhan pada piksel perangkat sebenarnya, mulai dari sisi kiri layar dalam orientasi saat ini.
y Posisi vertikal sentuhan pada piksel perangkat sebenarnya, mulai dari sisi atas layar dalam orientasi saat ini.
type Jenis peristiwa tombol yang akan dikirim. Nilai yang diizinkan adalah DOWN, UP, dan DOWN_AND_UP.

void type (string message)

Mengirim karakter yang termuat dalam pesan ke perangkat ini, seolah-olah karakter tersebut telah diketik di keyboard perangkat. Ini setara dengan memanggil press() untuk setiap kode tombol dalam message menggunakan jenis peristiwa tombol DOWN_AND_UP.

Argumen
message String berisi karakter yang akan dikirim.

void wake ()

Mengaktifkan layar perangkat ini.


Lampiran

Tabel 1.Nama variabel properti yang digunakan dengan getProperty() dan getSystemProperty().

Grup Properti Properti Deskripsi Catatan
build board Nama kode untuk board sistem perangkat Lihat Build
brand Operator atau penyedia yang disesuaikan.untuk OS
device Nama desain perangkat.
fingerprint ID unik untuk build yang sedang berjalan.
host
ID Nomor atau label changelist.
model Nama perangkat yang bisa dilihat oleh pengguna akhir.
product Nama produk secara keseluruhan.
tags Tag yang dipisahkan koma yang menjelaskan build, seperti "unsigned" dan "debug".
type Jenis build, seperti "user" atau "eng".
user
CPU_ABI Nama set petunjuk kode native, dalam bentuk jenis CPU plus konvensi ABI.
manufacturer Produsen produk/hardware.
version.incremental Kode internal yang digunakan oleh sistem kontrol sumber untuk mewakili versi software.
version.release Nama versi software yang dapat dilihat oleh pengguna.
version.sdk Versi SDK yang berhubungan dengan versi OS yang dapat dilihat oleh pengguna.
version.codename Namakode pengembangan saat ini, atau "REL" jika versi software telah dirilis.
display width Lebar tampilan perangkat dalam piksel. Lihat DisplayMetrics untuk mengetahui detailnya.
height Tinggi tampilan perangkat dalam piksel.
density Kepadatan logis tampilan. Ini adalah faktor yang menskalakan unit DIP (Piksel Kepadatan Mandiri) ke resolusi perangkat. DIP disesuaikan, sehingga 1 DIP setara dengan satu piksel pada layar 160 piksel per inci. Misalnya, pada layar 160 dpi, kepadatan = 1,0, sedangkan pada layar 120 dpi, kepadatan = 0,75.

Nilai tidak mengikuti ukuran layar sebenarnya, tetapi disesuaikan agar sesuai dengan perubahan besar pada DPI tampilan. Untuk mengetahui detail selengkapnya, lihat density.

am.current package Nama paket Android dari paket yang sedang berjalan. Kunci am.current menampilkan informasi tentang Aktivitas yang sedang berjalan.
action Tindakan aktivitas saat ini. Action memiliki format yang sama dengan atribut name dari elemen action dalam manifes paket.
comp.class Nama class komponen yang memulai Aktivitas saat ini. Lihat paket comp.package untuk detail selengkapnya.
comp.package Nama paket komponen yang memulai Aktivitas saat ini. Komponen yang ditentukan oleh nama paket dan nama class dalam paket.
data Data (jika ada) yang dimuat dalam Intent yang memulai Aktivitas saat ini.
categories Kategori yang ditentukan oleh Intent yang memulai Aktivitas saat ini.
clock realtime Jumlah milidetik sejak perangkat di-reboot, termasuk waktu tidur (deep sleep). Lihat SystemClock untuk informasi selengkapnya.
uptime Jumlah milidetik sejak perangkat di-reboot, tidak termasuk waktu tidur (deep sleep).
millis Waktu saat ini sejak epoch UNIX, dalam milidetik.