monkeyrunner
çalıştıran iş istasyonu tarafından erişilebilen bir cihazı veya emülatörü temsil eden monkeyrunner sınıfı.
Bu sınıf, bir Android cihazı veya emülatörü kontrol etmek için kullanılır. Yöntemler, kullanıcı arayüzü etkinlikleri gönderir, bilgileri alır, uygulamaları yükleyip kaldırır ve uygulamaları çalıştırır.
Normalde MonkeyDevice
örneği oluşturmanız gerekmez. Bunun yerine, bir cihaz veya emülatöre bağlantıdan yeni bir nesne oluşturmak için
MonkeyRunner.waitForConnection()
kullanırsınız. Örneğin,
newdevice = MonkeyDevice()
şunu kullanırsınız:
newdevice = MonkeyRunner.waitForConnection()
Özet
Sabitler | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
dize | AŞAĞI |
DOWN etkinliği göndermek için bunu press() veya touch()
type bağımsız değişkeniyle kullanın.
|
|||||||||
dize | YÜKSELİŞ |
UP etkinliği göndermek için bunu press() veya touch()
öğesinin type bağımsız değişkeniyle birlikte kullanın.
|
|||||||||
dize | AŞAĞI_VE_YUKARI |
Hemen ardından bir UP etkinliği göndermek isterseniz press() veya touch()
için type bağımsız değişkeniyle bunu kullanın.
|
Yöntemler | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Intent'i, sanki bir uygulamadan geliyormuş gibi bu cihaza yayınlar.
|
||||||||||
|
Bu cihazın ekranında bir sürükleme hareketini (dokunma, basılı tutma ve hareket ettirme) simüle eder.
|
||||||||||
|
Bir sistem ortam değişkeninin adı verildiğinde, değişkenin bu cihaz için değeri döndürülür.
Kullanılabilir değişken adları, bu yöntemin
ayrıntılı açıklamasında listelenmiştir.
|
||||||||||
|
.
adb shell getprop <key>. This is provided for use
by platform developers.
API eşdeğeri |
||||||||||
|
BundleFile içindeki Android uygulamasını veya test paketini bu cihaza yükler. Uygulama veya test paketi zaten yüklüyse değiştirilir.
|
||||||||||
|
Belirtilen bileşeni Android araçları altında çalıştırır ve sonuçları, tam biçimi çalıştırılan bileşen tarafından belirtilen bir sözlükte döndürür. Bileşen
bu cihazda mevcut olmalıdır.
|
||||||||||
|
Türe göre belirtilen anahtar etkinliğini, keycode tarafından belirtilen anahtara gönderir.
|
||||||||||
|
Bu cihazı, bootloadType tarafından belirtilen bootloader'da yeniden başlatır.
|
||||||||||
|
Belirtilen paketi, verileri ve önbelleği de dahil olmak üzere bu cihazdan siler.
|
||||||||||
|
Bir
adb kabuk komutu yürütür ve varsa sonucu döndürür.
|
||||||||||
|
Sağlanan bağımsız değişkenlerden oluşturulan bir Intent göndererek bu cihazda bir etkinlik başlatır.
|
||||||||||
MonkeyImage
|
Bu cihazın ekran arabelleğinin tamamını yakalayarak geçerli ekranın ekran
görüntüsünü içeren
MonkeyImage
nesnesini oluşturur.
|
||||||||||
|
Türe göre belirtilen dokunma etkinliğini x ve y ile belirtilen ekran konumuna gönderir.
|
||||||||||
|
Mesajdaki karakterleri, cihazın klavyesine yazılmış gibi bu cihaza gönderir. Bu,
DOWN_AND_UP önemli etkinlik türünü kullanarak message içindeki her bir tuş kodu için press() çağırmaya eşdeğerdir.
|
||||||||||
|
Bu cihazın ekranını uyandırır.
|
Sabitler
dize AŞAĞI
dize YUKARI
dize DOWN_AND_UP
Herkese açık yöntemler
void broadcastIntent ( string uri, string işlem, string verileri, string mimetype, yiterable kategoriler sözlük ekstralar, component bileşeni, iterable flag'leri
Intent'i, sanki bir uygulamadan geliyormuş gibi bu cihaza yayınlar. Bağımsız değişkenler hakkında daha fazla bilgi için Intent
politikasına bakın.
Bağımsız Değişkenler
Uri |
Intent'in URI'si.
(bkz. Intent.setData() ).
|
---|---|
işlem |
Bu Intent işlemi (Intent.setAction() bölümüne bakın).
|
veri |
Bu Intent'in veri URI'si (bkz. Intent.setData() ).
|
mime türü |
Intent'in MIME türü (bkz. Intent.setType() ).
|
kategori |
Bu Intent'in kategorilerini tanımlayan dizeler içeren yinelenebilir bir veri yapısı (bkz. Intent.addCategory() ).
|
ekstralar |
Bu Intent için ek verilerin bir sözlüğü (örnek için Intent.putExtra() bölümüne bakın).
Her sözlük öğesinin anahtarı bir dize olmalıdır. Öğenin değeri, herhangi bir basit veya yapılandırılmış veri türü olabilir. |
bileşen |
Bu Intent'in bileşeni (bkz. ComponentName ).
Bu bağımsız değişkeni kullanmak Intent'i belirli bir Android paketindeki belirli bir sınıfa yönlendirir.
|
bayraklar |
Intent'in nasıl işlendiğini kontrol eden işaretler içeren yinelenebilir bir veri yapısı (bkz. Intent.setFlags() ).
|
void sürükle ( tuple başlangıç, tuple bitiş, kayan süre, tamsayı adım)
Bu cihazın ekranında bir sürükleme hareketini (dokunma, basılı tutma ve hareket ettirme) simüle eder.
Bağımsız Değişkenler
başlat | Sürükleme hareketinin tuple (x, y) biçimindeki başlangıç noktası. Burada x ve y,tam sayıdır. |
---|---|
bitiş değeri | Sürükleme hareketinin tuple (x, y) biçimindeki bitiş noktası. Burada x ve y,tam sayıdır. |
süre | Sürükleme hareketinin saniye cinsinden süresi. Varsayılan değer 1,0 saniyedir. |
adım | Noktaların interpolasyonu sırasında uygulanacak adım sayısı. Varsayılan değer 10'dur. |
object getMülk (dize anahtarı)
Bir sistem ortam değişkeninin adı verildiğinde, değişkenin bu cihaz için değeri döndürülür.
Bağımsız Değişkenler
anahtar | Sistem ortam değişkeninin adı. Kullanılabilir değişken adları Tablo 1. Mülk değişkeni adları bölümüne bakabilirsiniz. |
---|
İlerlemeler
- Değişkenin değeri. Veri biçimi, istenen değişkene göre değişir.
object getSystemproperty (dize anahtarı)
getProperty()
ile eş anlamlı.
Bağımsız Değişkenler
anahtar | Sistem ortam değişkeninin adı. Kullanılabilir değişken adları Tablo 1. Mülk Değişken Adları bölümünü inceleyin. |
---|
İlerlemeler
- Değişkenin değeri. Veri biçimi, istenen değişkene göre değişir.
void installPackage (dize yolu)
BundleFile içindeki Android uygulamasını veya test paketini bu cihaza yükler. Uygulama veya test paketi zaten yüklüyse değiştirilir.
Bağımsız Değişkenler
yol |
Yüklenecek .apk dosyasının tam nitelikli yolu ve dosya adı.
|
---|
dictionary instrument ( string className, dictionary args)
Belirtilen bileşeni Android araçlarıyla çalıştırır ve sonuçları, tam biçimi çalıştırılan bileşen tarafından belirtilen bir sözlükte döndürür. Bileşen bu cihazda mevcut olmalıdır.
Android'in test durumu sınıflarından birini kullanan bir test durumu başlatmak için bu yöntemi kullanın. Android test çerçevesiyle birim testi hakkında daha fazla bilgi edinmek için Testing Fundamentals (Temel Testleri) bölümüne bakın.
Bağımsız Değişkenler
sınıfAdı |
Bu cihazda önceden yüklü olan bir Android bileşeninin adı, standart paket adı/sınıfadı biçimindedir. Burada paket adı, bu cihazdaki bir .apk dosyasının Android paket adıdır ve sınıf adı, bu dosyadaki bir Android bileşeninin (Activity, ContentProvider, Service veya BroadcastReceiver) sınıf adıdır. Hem paket adı hem de sınıfadı tam olmalıdır. Ayrıntılı bilgi için ComponentName sayfasını inceleyin.
|
---|---|
bağımsız değişkenler | İşaretleri ve değerlerini içeren bir sözlük. Bunlar, başlatıldığında bileşene iletilir. İşaret bir değer almazsa sözlük değerini boş bir dizeye ayarlayın. |
İlerlemeler
-
Bileşenin çıkışını içeren bir sözlük. Sözlüğün içeriği bileşenin kendisi tarafından tanımlanır.
assetName bağımsız değişkeninde sınıf adı olarak
InstrumentationTestRunner
kullanırsanız sonuç sözlüğü "stream" tek anahtarını içerir. "stream" değeri,InstrumentationTestRunner
komut satırından çalıştırılmış gibi test çıkışını içeren bir dizedir. Bu çıkışın biçimi Diğer IDE'lerde Test Etme bölümünde açıklanmıştır.
void bas (dize adı, tamsayı tür)
type
tarafından belirtilen önemli etkinliği, keycode
tarafından belirtilen anahtara gönderir.
Bağımsız Değişkenler
ad |
Gönderilecek anahtar kodunun adı. Anahtar kodu adlarının listesi için KeyEvent politikasına bakın. Tam sayı değerini değil, anahtar kodu adını kullanın.
|
---|---|
tür |
Gönderilecek önemli etkinliğin türü.
DOWN , UP ve DOWN_AND_UP değerlerine izin verilir.
|
void yeniden başlat (dize bootloadType)
Bu cihazı, bootloadType
tarafından belirtilen bootloader'da yeniden başlatır.
Bağımsız Değişkenler
içine | Yeniden başlatmanın yapılacağı bootloader türü. İzin verilen değerler "bootloader", "recovery" veya "None" şeklindedir. |
---|
void removePackage (dize paketi)
Belirtilen paketi, verileri ve önbelleği de dahil olmak üzere bu cihazdan siler.
Bağımsız Değişkenler
paket |
Bu cihazdaki bir .apk dosyasının Android paket adı.
|
---|
object kabuk (string cmd)
Bir adb
kabuk komutu yürütür ve varsa sonucu döndürür.
Bağımsız Değişkenler
cmd |
adb kabuğunda yürütülecek komut. Bu komutların biçimi, Android Debug Bridge konusunda açıklanmıştır.
|
---|
İlerlemeler
- Varsa komutun sonuçları. Sonuçların biçimi komut tarafından belirlenir.
void startActivity ( string uri, string işlem, string verileri, string mimetype, yiterable kategoriler sözlük ekstralar, component bileşeni, iterable flag'leri
Sağlanan bağımsız değişkenlerden oluşturulan bir Intent göndererek bu cihazda bir etkinlik başlatır.
Bağımsız Değişkenler
Uri |
Intent'in URI'si.
(bkz. Intent.setData() ).
|
---|---|
işlem |
Intent işlemi (bkz. Intent.setAction() ).
|
veri |
Intent veri URI'si (bkz. Intent.setData() ).
|
mime türü |
Intent'in MIME türü (bkz. Intent.setType() ).
|
kategori |
Intent'in kategorilerini tanımlayan dizeler içeren yinelenebilir bir veri yapısı (bkz. Intent.addCategory() ).
|
ekstralar |
Intent için ek verilerin bir sözlüğü (örnek için bkz. Intent.putExtra() ).
Her sözlük öğesinin anahtarı bir dize olmalıdır. Öğenin değeri, herhangi bir basit veya yapılandırılmış veri türü olabilir. |
bileşen |
Intent bileşeni
(bkz. ComponentName ). Bu bağımsız değişkeni kullanmak
Intent'i belirli bir Android paketindeki belirli bir sınıfa yönlendirir.
|
bayraklar |
Intent'in nasıl işlendiğini kontrol eden işaretler içeren yinelenebilir bir veri yapısı (bkz. Intent.setFlags() ).
|
MonkeyImage
Snapshot al
()
Bu cihazın ekran arabelleğinin tamamını yakalayarak mevcut ekranın ekran görüntüsünü elde eder.
İlerlemeler
- Geçerli ekranın görüntüsünü içeren bir MonkeyImage nesnesi.
void dokunma ( tam sayı x, tamsayı y, dize türü)
Türe göre belirtilen dokunma etkinliğini x ve y ile belirtilen ekran konumuna gönderir.
Bağımsız Değişkenler
x | Dokunmanın gerçek cihaz pikselleri cinsinden yatay konumu, ekranın sol tarafından mevcut yönünde başlar. |
---|---|
y | Dokunmanın gerçek cihaz piksel cinsinden dikey konumu (ekranın üst kısmından geçerli yönde) |
tür |
Gönderilecek önemli etkinliğin türü.
DOWN , UP ve DOWN_AND_UP değerlerine izin verilir.
|
void type (dize mesajı)
Mesajdaki karakterleri, cihazın klavyesine yazılmış gibi bu cihaza gönderir. Bu, DOWN_AND_UP
önemli etkinlik türünü kullanarak message
içindeki her bir tuş kodu için press()
çağırmaya eşdeğerdir.
Bağımsız Değişkenler
mesaj | Gönderilecek karakterleri içeren bir dize. |
---|
void uyanma ()
Bu cihazın ekranını uyandırır.
Ek
Mülk Grubu | Özellik | Açıklama | Notlar |
---|---|---|---|
build |
board |
Cihazın sistem kartı için kod adı |
Build ürününü inceleyin
|
brand |
İşletim sisteminin özelleştirildiği operatör veya sağlayıcı. | ||
device |
Cihaz tasarımının adı. | ||
fingerprint |
Şu anda çalışan derlemenin benzersiz tanımlayıcısı. | ||
host |
|||
ID |
Değişiklik listesi numarası veya etiketi. | ||
model |
Cihazın son kullanıcı tarafından görülebilen adı. | ||
product |
Genel ürün adı. | ||
tags |
Derlemeyi açıklayan "imzasız" ve "hata ayıklama" gibi virgülle ayrılmış etiketler. | ||
type |
Derleme türü (ör. "user" veya "eng"). | ||
user |
|||
CPU_ABI |
CPU türü ve ABI kuralı biçiminde, yerel kod talimatı grubunun adı. | ||
manufacturer |
Ürün/donanım üreticisi. | ||
version.incremental |
Yazılımın bu sürümünü temsil etmek için kaynak kontrol sistemi tarafından kullanılan dahili kod. | ||
version.release |
Yazılımın bu sürümünün kullanıcı tarafından görülebilen adı. | ||
version.sdk |
OS'in bu sürümüyle ilişkilendirilmiş, kullanıcı tarafından görülebilen SDK sürümü. | ||
version.codename |
Mevcut geliştirme kod adı veya yazılımın bu sürümü yayınlandıysa "REL". | ||
display |
width |
Cihazın piksel olarak ekran genişliği. |
Ayrıntılar için DisplayMetrics sayfasını ziyaret edin.
|
height |
Cihazın piksel cinsinden ekran yüksekliği. | ||
density |
Ekranın mantıksal yoğunluğu. Bu, DIP (Yoğunluktan Bağımsız Piksel) birimlerini cihazın çözünürlüğüne göre ölçeklendiren bir faktördür. DIP, inç başına 160 piksel ekranda 1 DIP, bir piksele eşit olacak şekilde ayarlanır. Örneğin,
160 dpi ekranda yoğunluk = 1,0 iken 120 dpi ekranda = 0,75.
Değer, gerçek ekran boyutuna tam olarak uymaz ancak ekran DPI değerindeki büyük değişikliklere uyum sağlayacak şekilde ayarlanır. Ayrıntılı bilgi için |
||
am.current |
package |
Şu anda çalışan paketin Android paket adı. |
am.current tuşları, o anda çalışan Etkinlik hakkında bilgi döndürür.
|
action |
Geçerli etkinliğin işlemi. Bu, bir paket manifestindeki action öğesinin name özelliğiyle aynı biçime sahiptir.
|
||
comp.class |
Geçerli Etkinliği başlatan bileşenin sınıf adı. Ayrıntılı bilgi için comp.package sayfasını inceleyin. |
||
comp.package |
Mevcut Etkinliği başlatan bileşenin paket adı. Bileşenler, paket adı ve paketin içerdiği sınıfın adıyla belirtilir. | ||
data |
Geçerli Etkinliği başlatan Intent'te yer alan veriler (varsa). | ||
categories |
Mevcut Etkinliği başlatan Intent tarafından belirtilen kategoriler. | ||
clock |
realtime |
Derin uyku süresi de dahil olmak üzere, cihazın yeniden başlatılmasından bu yana geçen milisaniye sayısı. |
Daha fazla bilgi için SystemClock belgesine göz atın.
|
uptime |
Derin uyku süresi dahil değil, cihazın yeniden başlatılmasından bu yana geçen milisaniye sayısı | ||
millis |
UNIX döneminden beri geçen geçerli süre (milisaniye cinsinden). |