Bu kılavuz, Firebase Test Lab kullanılarak bir enstrümantasyon testinin nasıl hazırlanacağını ve çalıştırılacağını açıklamaktadır. Bu kılavuzu kullanmak için Espresso veya UI Automator Android test çerçevelerini kullanan bir enstrümantasyon testine (siz veya ekibiniz tarafından yazılmış) ihtiyacınız olacaktır. Enstrümantasyon testleri, fiziksel cihazlarda 45 dakikaya kadar, sanal cihazlarda ise 60 dakikaya kadar çalıştırılabilir.
Sonraki adımlarda uygulamanızın APK'sını ve testinizin APK'sını Firebase'e yükleyeceksiniz.
(İsteğe bağlı) Ekran görüntüsü kitaplığını uygulamanıza ekleyin
Firebase Test Lab, Espresso test çerçevesi kullanılarak yazılan testler gibi enstrümantasyon testlerini çalıştırırken AndroidX'in ScreenCapture'ı ile aldığınız ekran görüntülerini işlemek için kullanabileceğiniz bir kitaplık (testlab-instr-lib) içerir. Bu bölümde AndroidX kitaplığıyla ScreenCapture
nesnelerinin nasıl oluşturulacağı ve bunların testlab-instr-lib kullanılarak nasıl işleneceği açıklanmaktadır.
Enstrümantasyon testiniz çalıştırıldıktan sonra yakalanan ekran görüntülerini Firebase konsolunda görüntüleyebilirsiniz.
Örnek bir uygulamayı deneyin
Bu işlevi denemek için NotePad örnek uygulamasını indirin. Ekran görüntüsü alma özelliği zaten NotePad projesine dahil edilmiştir.
1. Adım. Ekran görüntüsü kitaplığını projenize ekleyin
Test projenizin kök düzeyindeki ayarlar Gradle dosyasında (
settings.gradle.kts
veyasettings.gradle
), herrepositories
bölümüne Google'ın Maven deposunu ekleyin:pluginManagement { repositories { // Add the following line: google() // Google's Maven repository mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { // Add the following line: google() // Google's Maven repository mavenCentral() } } // ...
Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Test Laboratuvarı için bir bağımlılık ekleyin ekran görüntüsü kitaplığı.dependencies { // ... // Add Test Lab's instrumentation test screenshot library: androidTestImplementation("com.google.firebase:testlab-instr-lib:0.2") // ...
Testinizin
AndroidManifest.xml
dosyasındaFirebaseScreenCaptureProcessor
<instrumentation>
öğesi içindeki bir meta veri etiketine kaydedin. Bunun yerine işlemciyi AndroidJUnitRunner'da bir argüman olarak da belirtebilirsiniz (nasıl yapılacağına ilişkin talimatlar için AndroidJUnitRunner referans belgelerine bakın).<instrumentation // Check that you have the following line (if not, add it): android:name="androidx.test.runner.AndroidJUnitRunner" // Specifies AndroidJUnitRunner as the test runner android:targetPackage="com.your.package.name"> // Add the following: <meta-data android:name="screenCaptureProcessors" android:value="com.google.firebase.testlab.screenshot.FirebaseScreenCaptureProcessor" /> </instrumentation> ...
Uygulamanızın
AndroidManifest.xml
dosyasındaki<manifest>
öğesinin içine aşağıdaki satırları ekleyin:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
AndroidManifest.xml
dosyanızda,<manifest>
etiketinin içine aşağıdaki satırları ekleyerek uygulamanızın sistem izinlerini belirtin. Android 10 (API düzeyi 29) veya üzeri bir sürümde test yapıyorsanızWRITE_EXTERNAL_STORAGE
iznini atın (uygulamanız, ekran görüntülerini cihaza okumak ve yazmak için bu izne ihtiyaç duymaz).<manifest ... > <!-- WRITE_EXTERNAL_STORAGE is not needed on Android 10 (API level 29) or higher. --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.INTERNET"/> ... </manifest>
2. Adım. Testiniz sırasında ekran görüntüleri alın
Testinizin ekran görüntüsü almak istediğiniz herhangi bir noktasında AndroidX kitaplığından Screenshot.capture()
yöntemini çağırın. Bu bir ScreenCapture
nesnesi üretir. ScreenCapture
nesnesinde process()
öğesini çağırdığınızda, AndroidManifest.xml
dosyanızda kayıtlı ScreenCaptureProcessor kullanılarak işlenir. Hiçbir işlemci kayıtlı değilse BasicScreenCaptureProcessor
kullanıldığını unutmayın. FirebaseScreenCaptureProcessor
kaydettiğinizden beri, ekran görüntüleriniz FirebaseScreenCaptureProcessor
aracılığıyla işlenecek ve Firebase Test Lab ile testinizi çalıştırdığınızda sonuçlarınızla birlikte kullanımınıza sunulacaktır.
ScreenCapture
oluşturmaya yönelik örnek kullanım durumları:
API Build.VERSION_CODES.JELLY_BEAN_MR2 ve üzeri sürümlerde tam ScreenCapture çekin:
Screenshot.capture()
Etkinliğin
ScreenCapture
herhangi bir API düzeyinde alın. Build.VERSION_CODES.JELLY_BEAN_MR2'nin altındaki cihazlar için tek seçeneğin bu olduğunu unutmayın.@Rule public ActivityTestRule<MainActivity> activityRule = new ActivityTestRule<>(MainActivity.class); ... Screenshot.capture(activityRule.getActivity()); ...
ScreenCapture'ın işlenmesine yönelik örnek kullanım durumları
FirebaseScreenCaptureProcessor
aracılığıyla birScreenCapture
işleyin:Screenshot.capture().process();
Belirli bir
ScreenCaptureProcessor
aracılığıylaScreenCapture
işleyin (bu, işlemciyi kaydetmeyi atlamanıza olanak tanır):Set<ScreenCaptureProcessor> processors = new HashSet<>(); processors.add(new FirebaseScreenCaptureProcessor()); Screenshot.capture().process(processors);
ScreenCapture
adını ve formatını ayarlayın ve kayıtlı işlemciyi kullanarak işleyin:Screenshot.capture().setName("myscreenshot").setFormat(CompressFormat.JPEG).process();
3. Adım. Testinizi oluşturun ve çalıştırın
Uygulamanızı oluşturun ve APK'ları test edin (talimatlar için Uygulamanızı test etme bölümüne bakın).
APK dosyalarını Firebase konsolunun Test Lab kontrol paneline yükleyin.
Son olarak testinizi çalıştırın.
4. Adım. Test ekran görüntülerinizi görüntüleyin
Testiniz tamamlandıktan sonra Firebase konsolunda çekilen ekran görüntülerini görüntüleyebilirsiniz.
Testler sekmesinde tamamladığınız testi seçin ve ardından Sonuçlar sekmesine tıklayın.
Testinizi tekrar seçin ve ardından beliren Ekran Görüntüleri sekmesine tıklayın.
(İsteğe bağlı) Ek test özelliklerini etkinleştirin
Testinizi Test Lab ile çalıştırmadan önce testinizde aşağıdaki özellikleri etkinleştirebilirsiniz:
Orkestratörü Etkinleştir
Android Test Orchestrator , uygulamanızın enstrümantasyon testlerinin her birini bağımsız olarak çalıştıran bir araçtır. Test Lab her zaman Orchestrator'ın en son sürümünü kullanır.
Test Laboratuvarı için Orkestratör'ü etkinleştirmek üzere enstrümantasyon testi kurulumunda Ek seçenekler > Orkestratörle Çalıştır öğesine tıklayın.
Orchestrator'ı kullandığınızda aşağıdakilerden yararlanırsınız:
- Paylaşılan durum yok. Her test kendi enstrümantasyon örneğinde çalışır, böylece testler arasında paylaşılan bir durum birikmez.
- İzole çökmeler. Bir test çökerse yalnızca o enstrümantasyon sonlandırılır ve paketinizdeki diğer testler çalışmaya devam edebilir.
Orchestrator'ı kullandığınızda her testin kendi enstrümantasyon örneğini çalıştırdığını, bunun da uygulama işleminin her test senaryosundan sonra yeniden başlatıldığı anlamına geldiğini unutmayın. Bunun sonucunda ortaya çıkan artan çalışma süreleri , kota kullanımınızı veya faturalanan sürenizi etkileyebilir ve cihazlarınızın zaman aşımı sınırlarını aşmanıza neden olabilir. Uygulamanızın başlangıç süresini kısaltırsanız bu ek yük de kısalır.
Orkestratör için ek seçenekler ayarlamak üzere bunları environmentVariables
alanı aracılığıyla belirtin. Örneğin clearPackageData
kullanmak için gcloud'da şu seçeneği kullanın:
--environment-variables clearPackageData=true
Parçalamayı etkinleştir
Test parçalama, bir dizi testi ayrı ayrı çalışan alt gruplara (parçalara) böler. Test Lab, her bir parçayı birden fazla cihaz kullanarak paralel olarak otomatik olarak çalıştırır ve tüm test setini daha kısa sürede tamamlar.
Örneğin, seçtiğiniz her cihaz için N parça oluşturursanız Test Lab, N adet özdeş cihazı çalıştırır ve her cihazda testlerin bir alt kümesini çalıştırır. Bu, parçalanmış test senaryolarının cihaz başına birden fazla test yürütülmesiyle sonuçlanabileceği anlamına gelir. Bununla birlikte, parçalanmayan test senaryoları cihaz başına bir test yürütülmesiyle sonuçlanır. Test Laboratuvarı kavramlarını öğrenmek için bkz. Anahtar kavramlar .
Firebase konsolunda test parçalamayı etkinleştirmek için şu adımları izleyin:
Alet testi kurulumunda Ek seçenekler'e tıklayın.
Parçalama bölümünde çalıştırmak istediğiniz parça sayısını girin.
Test parçaları için faturalandırma
Test Lab , AndroidJUnitRunner'ın yerleşik parçalama mekanizmasından yararlanarak parçalarınızı uygular. Boş parçaların (atanan test senaryoları olmayan parçalar) döndürülmesi karşılığında ücret alınmasını önlemek için oluşturduğunuz parça sayısı, toplam test senaryosu sayısından az olmalıdır. Her test senaryosunun ne kadar süre çalıştırılacağına bağlı olarak, genellikle parça başına 2-10 test senaryosu atamak iyi bir fikirdir.
Faturalandırma hakkında daha fazla bilgi için Kullanım, kotalar ve faturalandırma konusunu okuyun.