Espresso boşta kalma kaynakları

Boşta bekleyen kaynak, sonuçları bir kullanıcı arayüzü testindeki sonraki işlemleri etkileyen eşzamansız bir işlemi temsil eder. Boşta bekleyen kaynakları Espresso'ya kaydederek uygulamanızı test ederken bu eşzamansız işlemleri daha güvenilir bir şekilde doğrulayabilirsiniz.

Boşta bekleyen kaynakların ne zaman gerekli olduğunu belirleme

Espresso, gelişmiş bir senkronizasyon özellikleri seti sunar. Ancak çerçevenin bu özelliği, yalnızca MessageQueue üzerinde mesaj yayınlayan işlemler için geçerlidir (ör. içeriğini ekranda çizen bir View alt sınıfı).

Espresso, arka plan iş parçacığında çalışanlar da dahil olmak üzere diğer eşzamansız işlemlerden haberdar olmadığından bu durumlarda senkronizasyon garantisi veremez. Espresso'nun uygulamanızın uzun süreli işlemlerinden haberdar olması için her birini boşta bekleyen kaynak olarak kaydetmeniz gerekir.

Uygulamanızın eşzamansız çalışmasının sonuçlarını test ederken boşta bekleyen kaynakları kullanmazsanız testlerinizin güvenilirliğini artırmak için aşağıdaki kötü geçici çözümlerden birini kullanmanız gerekebilir:

  • Thread.sleep() adlı kişiye aramalar ekleniyor. Testlerinize yapay gecikmeler eklediğinizde test paketinizin yürütülmesi daha uzun sürer ve testleriniz daha yavaş cihazlarda yürütüldüğünde yine de başarısız olabilir. Ayrıca, uygulamanızın gelecekteki bir sürümde daha fazla zaman alan eşzamansız işler yapması gerekebileceğinden bu gecikmeler iyi ölçeklenmez.
  • Yeniden deneme sarmalayıcıları uygulama: Bu sarmalayıcılar, uygulamanızın eşzamansız çalışmaya devam edip etmediğini zaman aşımı gerçekleşene kadar tekrar tekrar kontrol etmek için bir döngü kullanır. Testlerinizde maksimum yeniden deneme sayısı belirleseniz bile her yeniden yürütme, sistem kaynaklarını (özellikle de CPU'yu) tüketir.
  • Bir veya daha fazla iş parçacığının, başka bir iş parçacığında yürütülen belirli sayıda işlem tamamlanana kadar beklemesine olanak tanıyan CountDownLatch örneklerini kullanma. Bu nesneler için bir zaman aşımı süresi belirtmeniz gerekir. Aksi takdirde uygulamanız süresiz olarak engellenebilir. Mandal kullanımı, kodunuza gereksiz karmaşıklık da ekleyerek bakımını zorlaştırır.

Espresso, bu güvenilir olmayan geçici çözümleri testlerinizden kaldırmanıza ve bunun yerine uygulamanızın eşzamansız çalışmasını boşta bekleyen kaynaklar olarak kaydetmenize olanak tanır.

Yaygın kullanım alanları

Testlerinizde aşağıdaki örneklere benzer işlemler gerçekleştirirken boşta bekleyen kaynak kullanmayı düşünün:

  • İnternetten veya yerel bir veri kaynağından veri yükleme.
  • Veritabanları ve geri çağırmalarla bağlantı kurma.
  • Hizmetleri yönetme: Bir sistem hizmeti veya IntentService örneği kullanarak.
  • Bit eşlem dönüşümleri gibi karmaşık iş mantığı işlemlerini gerçekleştirme

Bu işlemler, testlerinizin doğruladığı bir kullanıcı arayüzünü güncelliyorsa boşta bekleyen kaynakları kaydetmek özellikle önemlidir.

Boşta bekleyen kaynak uygulaması örnekleri

Aşağıdaki listede, uygulamanıza entegre edebileceğiniz boşta bekleyen kaynakların birkaç örnek uygulaması açıklanmaktadır:

CountingIdlingResource
Etkin görevlerin sayısını tutar. Sayaç sıfır olduğunda ilişkili kaynak boşta kabul edilir. Bu işlev, Semaphore işlevine çok benzer. Çoğu durumda bu uygulama, test sırasında uygulamanızın eşzamansız çalışmasını yönetmek için yeterlidir.
UriIdlingResource
CountingIdlingResource parametresine benzer ancak kaynağın boşta olarak kabul edilmesi için sayacın belirli bir süre boyunca sıfır olması gerekir. Bu ek bekleme süresi, ardışık ağ isteklerini hesaba katar. Bu durumda, ileti dizinizdeki bir uygulama, önceki bir isteğe yanıt aldıktan hemen sonra yeni bir istekte bulunabilir.
IdlingThreadPoolExecutor
Oluşturulan iş parçacığı havuzlarında çalışan toplam görev sayısını takip eden özel bir ThreadPoolExecutor uygulaması. Bu sınıf, etkin görevlerin sayacını korumak için CountingIdlingResource kullanır.
IdlingScheduledThreadPoolExecutor
Özel bir ScheduledThreadPoolExecutor uygulaması. IdlingThreadPoolExecutor sınıfıyla aynı işlevleri ve özellikleri sunar ancak gelecekte yürütülmek üzere planlanan veya düzenli olarak yürütülmek üzere planlanan görevleri de takip edebilir.

Kendi boşta bekleyen kaynağınızı oluşturma

Uygulamanızın testlerinde boşta bekleyen kaynakları kullanırken özel kaynak yönetimi veya günlük kaydı sağlamanız gerekebilir. Bu gibi durumlarda, önceki bölümde listelenen uygulamalar yeterli olmayabilir. Bu durumda, bu boşta bekleyen kaynak uygulamalarından birini genişletebilir veya kendi uygulamanızı oluşturabilirsiniz.

Kendi boşta bekleyen kaynak işlevinizi uyguluyorsanız aşağıdaki en iyi uygulamaları, özellikle de ilkini göz önünde bulundurun:

Boşta kalma kontrolleri dışında boşta kalma durumuna geçişleri çağırın.
Uygulamanız boşta kaldıktan sonra, isIdleNow() uygulamalarının dışında onTransitionToIdle() yöntemini çağırın. Bu sayede Espresso, belirli bir boşta bekleyen kaynağın boşta olup olmadığını belirlemek için ikinci bir gereksiz kontrol yapmaz.

Aşağıdaki kod snippet'i bu öneriyi göstermektedir:

fun isIdle() {
    // DON'T call callback.onTransitionToIdle() here!
}

fun backgroundWorkDone() {
    // Background work finished.
    callback.onTransitionToIdle() // Good. Tells Espresso that the app is idle.

    // Don't do any post-processing work beyond this point. Espresso now
    // considers your app to be idle and moves on to the next test action.
}

Boşta bekleyen kaynakları ihtiyaç duymadan önce kaydedin.

Boşta bekleyen kaynaklarla ilişkili senkronizasyon avantajları, yalnızca Espresso'nun ilgili kaynağın isIdleNow() yöntemini ilk kez çağırmasından sonra geçerli olur.

Aşağıdaki listede bu özelliğin birkaç örneği gösterilmektedir:

  • @Before ile ek açıklama eklenmiş bir yöntemde boşta bekleyen kaynak kaydederseniz boşta bekleyen kaynak, her testin ilk satırında geçerli olur.
  • Bir testte boşta bekleyen kaynak kaydederseniz boşta bekleyen kaynak, Espresso tabanlı bir sonraki işlem sırasında geçerli olur. Bu davranış, sonraki işlem boşta bekleyen kaynağı kaydeden ifadeyle aynı testte olsa bile gerçekleşir.
Boşta bekleyen kaynakları kullanmayı bitirdikten sonra kaydını iptal edin.

Sistem kaynaklarını korumak için artık ihtiyacınız olmayan boşta bekleyen kaynakların kaydını hemen iptal etmeniz gerekir. Örneğin, @Before ile ek açıklama eklenmiş bir yönteme boşta bekleyen kaynak kaydederseniz bu kaynağın kaydını @After ile ek açıklama eklenmiş ilgili bir yöntemde iptal etmeniz önerilir.

Boşta bekleyen kaynakları kaydetmek ve kaydını silmek için boşta bekleyen kayıt defteri kullanın.

Uygulamanızın boşta bekleyen kaynakları için bu kapsayıcıyı kullanarak boşta bekleyen kaynakları gerektiğinde tekrar tekrar kaydedebilir ve kaydını silebilir, aynı zamanda tutarlı davranışlar gözlemleyebilirsiniz.

Boşta bekleyen kaynaklarda yalnızca basit uygulama durumunu koruyun.

Örneğin, uyguladığınız ve kaydettiğiniz boşta bekleyen kaynaklar View nesnelerine referans içermemelidir.

Boşta bekleyen kaynakları kaydetme

Espresso, uygulamanızın boşta bekleyen kaynaklarını yerleştirebileceğiniz bir kapsayıcı sınıfı sağlar. IdlingRegistry adlı bu sınıf, uygulamanıza minimum ek yük getiren bağımsız bir yapıdır. Bu sınıf, uygulamanızın sürdürülebilirliğini artırmak için aşağıdaki adımları uygulamanıza da olanak tanır:

  • Uygulamanızın testlerinde, içerdiği boşta bekleyen kaynaklar yerine IdlingRegistry için bir referans oluşturun.
  • Her derleme değişkeni için kullandığınız boşta bekleyen kaynak koleksiyonundaki farklılıkları koruyun.
  • Boşta bekleyen kaynakları, bu hizmetlere referans veren kullanıcı arayüzü bileşenleri yerine uygulamanızın hizmetlerinde tanımlayın.

Boşta bekleyen kaynakları uygulamanıza entegre etme

Uygulamaya boşta bekleyen kaynakları birkaç farklı şekilde ekleyebilirsiniz. Ancak belirli bir yaklaşım, uygulamanız için kapsüllemeyi korurken belirli bir boşta bekleyen kaynağın temsil ettiği belirli bir işlemi belirtmenize olanak tanır.

Uygulamanıza boşta bekleyen kaynaklar eklerken boşta bekleyen kaynak mantığını uygulamanın kendisine yerleştirmenizi ve testlerinizde yalnızca kayıt ve kayıt iptali işlemlerini gerçekleştirmenizi kesinlikle öneririz.

Bu yaklaşımı izleyerek üretim kodunda yalnızca test amaçlı bir arayüz kullanma gibi olağan dışı bir durum oluştursanız da boşta bekleyen kaynakları mevcut kodunuzun etrafına sarmalayarak uygulamanızın APK boyutunu ve yöntem sayısını koruyabilirsiniz.

Alternatif yaklaşımlar

Uygulamanızın üretim kodunda boşta bekleyen kaynak mantığının bulunmasını istemiyorsanız başka geçerli entegrasyon stratejileri de vardır:

  • Gradle'ın ürün türleri gibi derleme değişkenleri oluşturun ve boşta bekleyen kaynakları yalnızca uygulamanızın hata ayıklama derlemesinde kullanın.
  • Uygulamanızın boşta bekleyen kaynak bağımlılık grafiğini testlerinize eklemek için Dagger gibi bir bağımlılık ekleme çerçevesi kullanın. Dagger 2 kullanıyorsanız ekleme işleminin kendisi bir alt bileşenden kaynaklanmalıdır.
  • Uygulamanızın testlerinde boşta bekleyen bir kaynak uygulayın ve uygulamanızın bu testlerde senkronize edilmesi gereken bölümünü gösterin.

    Dikkat: Bu tasarım kararı, boşta bekleyen kaynaklara bağımsız bir referans oluşturuyor gibi görünse de en basit uygulamalar dışındaki tüm uygulamalarda kapsüllemeyi de bozar.

Ek kaynaklar

Android testlerinde Espresso kullanımı hakkında daha fazla bilgi için aşağıdaki kaynaklara göz atın.

Örnekler