UI Automator: nedir, temel kavramlar ve nasıl çalışır

UI Automator Nedir?

UI Automator, işletim sistemi düzeyinde çalışan Android işlevsel UI testi için bir framework'tür. Cihaz ekranındaki herhangi bir öğeye, hangi uygulamaya ait olduğuna bakılmaksızın erişmek için API sağlar — sistem durum çubuğu, izin diyalogları, ana ekran ve üçüncü taraf uygulamalar dahil. Bu, onu tek bir uygulamanın ötesine geçen senaryoları test etmek için vazgeçilmez kılar.

Mimari olarak, UI Automator Accessibility Service'i kullanır — TalkBack, Switch Access ve diğer erişilebilirlik araçları tarafından kullanılan aynı hizmet. Bu hizmet aracılığıyla framework, mevcut ekranın tam UI bileşen ağacını alır ve üzerinde işlemler yapılmasına olanak tanır: dokunma, kaydırma, metin girişi ve uzun basma.

UI Automator ilk olarak Android 4.3'te (API 18) ortaya çıktı ve o zamandan beri uygulamalar arası test için Google'ın resmi aracı olarak Android Testing Support Library'nin bir parçasıdır. AndroidX Test'te, API 18'den itibaren tüm Android sürümlerini destekleyen ayrı bir yapıt olarak androidx.test.uiautomator:uiautomator sürüm 2.3.0 (2024) ile kullanılabilir.

UI Automator Nasıl Çalışır

Çalışma prensibi: UI Automator, mevcut ekranın erişilebilirlik ağacını taramaya dayanır. findObject(selector) yöntemi çağrıldığında, framework View hiyerarşisini geçer, UiSelector koşullarıyla eşleşen ilk öğeyi bulur ve bir UiObject — gerçek View ile etkileşim için bir proxy döndürür.

UI Automator Test Yaşam Döngüsü

Tipik bir UI Automator testi, fiziksel cihazı temsil eden bir UiDevice örneği alarak başlar. UiDevice, öğeleri bulma, düğme basmalarını (Ana Sayfa, Geri, Son) yönetme, ekranı döndürme ve ekran görüntüsü alma yöntemleri sağlar. UiSelector aracılığıyla bir öğe bulunduktan sonra, UiObject üzerinde işlemler gerçekleştirilir.

Temel Örnek

Aşağıdaki örnekte, test Ayarlar uygulamasını açar, metinle “Pil” öğesini bulur ve ona dokunur. UI Automator bir Activity başlatmayı gerektirmez — üçüncü taraf uygulamalar dahil cihazdaki herhangi bir ekranla çalışır.

val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())

// Ayarlar ekranını aç
device.pressHome()
device.wait(Until.hasObject(UiSelector().text("Ayarlar")), 2000)

// "Pil" öğesini bul ve dokun
val batteryItem = device.findObject(
    UiSelector().text("Pil")
)
batteryItem.clickAndWait(Until.newWindow(), 3000)

UiDevice ve UiSelector: Temel Sınıflar

UiDevice, cihazla etkileşim için ana sınıftır. Öğeleri bulma, donanım düğmesi basmalarını (Ana Sayfa, Geri, Menü, Ses) simüle etme, gücü yönetme, ekran görüntüsü alma ve belirli ekran durumlarını bekleme yöntemleri sağlar. UiDevice test başına bir kez oluşturulur ve tüm işlemler için yeniden kullanılır.

UiSelector, UI öğelerini bulmak için akıcı bir API'dir. Espresso ViewMatchers'ın aksine, UiSelector derleme gerektirmez — arama koşulları bir yöntem zinciri aracılığıyla oluşturulur: text(), className(), description(), resourceId(), index(). Birden çok koşul, mantıksal VE aracılığıyla otomatik olarak birleştirilir.

Birden Çok Koşulla Arama Örneği

Ekranda aynı metne sahip birden çok öğe olduğunda, UiSelector kriterleri birleştirmeye izin verir: kimliğe göre bir kapsayıcı bulun, ardından içinde — metin ve sınıfa göre bir öğe. Bu, istenen bileşenin benzersiz şekilde tanımlanmasını sağlar. childSelector yöntemi, arama kapsamını belirli bir kapsayıcıya daraltarak UI ağacında gezinmeyi hızlandırır.

val scrollView = device.findObject(
    UiSelector().resourceId("android:id/list")
)

// Listenin içinde, "Wi-Fi" metnine sahip öğeyi bul
val wifiItem = scrollView.findObject(
    UiSelector().text("Wi-Fi")
wifiItem.click()

UI Automator ile Uygulamalar Arası Test

Uygulamalar arası test, UI Automator'ın seçilmesinin ana nedenidir. Framework, uygulamalar arasında geçiş yapabilir, tarayıcı üzerinden OAuth girişini test edebilir, sistem diyaloglarını (izinler, uygulama seçici) kontrol edebilir ve sistem durum çubuğu, bildirim paneli ve kilit ekranıyla etkileşime girebilir.

OAuth Giriş Testi

Tipik bir uygulamalar arası test senaryosu: uygulama OAuth yetkilendirmesi için bir tarayıcı açar, kullanıcı kullanıcı adını ve şifresini girer ve tarayıcı uygulamaya geri yönlendirir. UI Automator süreçler arasında geçiş yapar, tarayıcıdaki giriş alanlarını bulur, doldurur ve “Oturum Aç” düğmesine dokunur.

// Tarayıcının görünmesini bekleme
device.wait(Until.hasObject(
    UiSelector().packageName("com.android.chrome")
), 5000)

// Tarayıcıda e-posta giriş alanını arama
val emailField = device.findObject(
    UiSelector().className("android.widget.EditText").instance(0)
)
emailField.text = "user@example.com"

Sistem Diyaloglarını Kontrol Etme

UI Automator sistem diyaloglarını kontrol edebilir ve kapatabilir — konum izinleri, bildirimler, dosya erişimi. Bu, sistemin sırayla birden çok izin istediği ilk başlatma senaryolarını test etmek için kritik öneme sahiptir. UI Automator olmadan, bu tür senaryolar otomatikleştirilemez çünkü sistem diyalogları uygulamanın sürecine ait değildir.

UI Automator vs Espresso: Yaklaşımların Karşılaştırması

Seçim UI Automator ve Espresso arasında test senaryosuna bağlıdır. Espresso, otomatik senkronizasyon ve minimum ek kodla tek bir uygulamayı test etmek için optimize edilmiştir. UI Automator, sistem, tarayıcı veya birden çok uygulamayla etkileşim gerektiren senaryolar için uygundur.

Pratikte, bu framework'ler genellikle birlikte kullanılır: Espresso, yüksek kararlılıkla ana uygulamanın UI testlerini kapsar, UI Automator ise uygulama sınırlarının ötesine geçen senaryolar için kullanılır — OAuth girişi, sistem izinleri, Share Intent ile çalışma. Bu kombinasyon, minimum test bakım maliyetiyle maksimum UI kapsamı sağlar.

Android Projesinde UI Automator Kurulumu

Entegrasyon build.gradle'a bir bağımlılık eklenerek yapılır. Framework, AndroidX Test'in bir parçasıdır ve manifest'te ek izin gerektirmez — Accessibility Service'e erişim, araçlı test başlatıldığında otomatik olarak yapılandırılır.

Gradle Bağımlılıkları

Minimum yapılandırma, uiautomator yapıtını ve standart AndroidJUnitRunner test çalıştırıcısını içerir. UI Automator testleri src/androidTest dizinine yerleştirilir ve Android API 18+ çalıştıran bir öykünücü veya fiziksel cihazda çalıştırılır.

dependencies {
    androidTestImplementation("androidx.test.uiautomator:uiautomator:2.3.0")
    androidTestImplementation("androidx.test.ext:junit:1.2.1")
    androidTestImplementation("androidx.test:runner:1.6.1")
}

UiDevice ve Test Yapılandırması

Bir UiDevice örneği elde etmek için InstrumentationRegistry.getInstrumentation() kullanılır. UiDevice, setUp() yönteminde bir kez oluşturulmalı ve cihaz kaynaklarını korumak için sınıfın tüm testlerinde yeniden kullanılmalıdır. UiDevice'in thread-safe olmadığını unutmamak önemlidir — tüm işlemler test yönteminin aynı iş parçacığında gerçekleştirilmelidir. Her testte yeni bir UiDevice oluşturmak ek yük oluşturur ve yürütmeyi yavaşlatır. beforeClass yönteminde bir kez UiDevice oluşturulması ve test sınıfının tüm testleri için yeniden kullanılması önerilir.

UI Automator'da Bekleme

Espresso'nun aksine, UI Automator'da otomatik senkronizasyon yoktur. Öğelerin görünmesini beklemek için UiDevice.wait(condition, timeout) yöntemi bir Until nesnesiyle kullanılır: Until.findObject(selector), Until.hasObject(selector), Until.gone(selector). Uygun beklemeler olmadan, yarış koşulları nedeniyle testler kararsız hale gelir — arama anında bir öğe ekranda görünmemiş olabilir. Kararlılık için en az 3–5 saniyelik bir zaman aşımı ayarlanması önerilir.