本指南說明如何使用 Firebase Test Lab 準備及執行檢測設備測試。如要使用本指南,您需要使用 Espresso 或 UI Automator Android 測試架構,編寫檢測設備測試。檢測設備測試在實體裝置上最多可執行 45 分鐘,在虛擬裝置上最多可執行 60 分鐘。
在後續步驟中,您會將應用程式的 APK 和測試 APK 上傳至 Firebase。
(選用) 將螢幕截圖程式庫新增至應用程式
Firebase Test Lab 包含一個程式庫 (testlab-instr-lib),可用於處理您在執行檢測設備測試時,透過 AndroidX 的 ScreenCapture 擷取的任何螢幕截圖,例如使用 Espresso 測試架構編寫的測試。本節說明如何使用 AndroidX 程式庫建立 ScreenCapture
物件,以及如何使用 testlab-instr-lib 處理這些物件。
執行插樁測試後,您可以在 Firebase 控制台中查看擷取的螢幕截圖。
試用範例應用程式
下載 NotePad 範例應用程式,試用這項功能。NotePad 專案已納入擷取螢幕截圖的功能。
步驟 1:將螢幕截圖程式庫新增至專案
在測試專案的根層級設定 Gradle 檔案 (
settings.gradle.kts
或settings.gradle
) 中,將 Google 的 Maven 存放區新增至每個repositories
區段: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() } } // ...
在模組 (應用程式層級) Gradle 檔案 (通常是
<project>/<app-module>/build.gradle.kts
或<project>/<app-module>/build.gradle
) 中,新增截圖程式庫的依附元件。Test Labdependencies { // ... // Add Test Lab's instrumentation test screenshot library: androidTestImplementation("com.google.firebase:testlab-instr-lib:0.2") // ...
在測試的
AndroidManifest.xml
檔案中,於<instrumentation>
元素內的 meta-data 標記中註冊FirebaseScreenCaptureProcessor
。您也可以在 AndroidJUnitRunner 中將處理器指定為引數 (如需操作說明,請參閱 AndroidJUnitRunner 參考說明文件)。<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> ...
在應用程式的
AndroidManifest.xml
檔案中,於<manifest>
元素內新增下列程式碼:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
在
AndroidManifest.xml
檔案中,於<manifest>
標記內新增下列程式碼,指定應用程式的系統權限。如果您在Android 10 (API 級別 29) 以上版本上進行測試,請省略WRITE_EXTERNAL_STORAGE
權限 (應用程式不需要這項權限,即可在裝置上讀取及寫入螢幕截圖)。<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:在測試期間擷取螢幕截圖
在測試期間,只要想擷取螢幕截圖,請呼叫 AndroidX 程式庫的 Screenshot.capture()
方法。這會產生 ScreenCapture
物件。在 ScreenCapture
物件上呼叫 process()
時,系統會使用 AndroidManifest.xml
中註冊的 ScreenCaptureProcessor 處理該物件。請注意,如果未註冊任何處理器,系統會使用 BasicScreenCaptureProcessor
。由於您已註冊 FirebaseScreenCaptureProcessor
,系統會透過 FirebaseScreenCaptureProcessor
處理螢幕截圖,並在您使用 Firebase Test Lab 執行測試時,將螢幕截圖連同結果一併提供給您。
建立 ScreenCapture
的用途範例:
在 API Build.VERSION_CODES.JELLY_BEAN_MR2 以上版本中擷取全螢幕畫面:
Screenshot.capture()
在任何 API 級別取得 Activity 的
ScreenCapture
。請注意,對於低於 Build.VERSION_CODES.JELLY_BEAN_MR2 的裝置,這是唯一選項。@Rule public ActivityTestRule<MainActivity> activityRule = new ActivityTestRule<>(MainActivity.class); ... Screenshot.capture(activityRule.getActivity()); ...
處理 ScreenCapture 的應用情境範例
透過
FirebaseScreenCaptureProcessor
處理ScreenCapture
:Screenshot.capture().process();
透過指定的
ScreenCaptureProcessor
處理ScreenCapture
(這樣您就能略過註冊處理器的步驟):Set<ScreenCaptureProcessor> processors = new HashSet<>(); processors.add(new FirebaseScreenCaptureProcessor()); Screenshot.capture().process(processors);
設定
ScreenCapture
的名稱和格式,然後使用已註冊的處理器處理:Screenshot.capture().setName("myscreenshot").setFormat(CompressFormat.JPEG).process();
步驟 3:建構及執行測試
建構應用程式和測試 APK (如需操作說明,請參閱「測試應用程式」)。
將 APK 檔案上傳至 Firebase 管理中心的Test Lab資訊主頁。
最後,執行測試。
步驟 4:查看測試螢幕截圖
測試完成後,您可以在Firebase控制台中查看所有擷取的螢幕截圖。
在「測試」分頁中,選取已完成的測試,然後按一下「結果」分頁。
再次選取測試,然後按一下隨即顯示的「螢幕截圖」分頁。
(選用) 啟用其他測試功能
您可以在測試中啟用下列功能,然後使用 Test Lab 執行測試:
啟用自動化調度管理工具
Android Test Orchestrator 是一種工具,可獨立執行應用程式的每項檢測測試。Test Lab 一律使用最新版 Orchestrator。
如要為 Test Lab 啟用 Orchestrator,請在檢測測試設定中,依序點選「其他選項」 >「使用 Orchestrator 執行」。
使用 Orchestrator 的優點如下:
- 沒有共用狀態。每項測試都會在自己的檢測作業執行個體中執行,因此測試之間不會累積共用狀態。
- 偶發當機。如果測試停止運作,只會終止該檢測作業,套件中的其他測試仍可執行。
請注意,使用 Orchestrator 時,每項測試都會執行自己的檢測作業執行個體,也就是說,應用程式程序會在每個測試案例結束後重新啟動。因此執行時間可能會增加,進而影響配額用量或計費時間,甚至可能導致您超出裝置的逾時限制。如果縮短應用程式的啟動時間,這項負擔就會減少。
如要設定 Orchestrator 的其他選項,請透過 environmentVariables
欄位指定。舉例來說,如要使用 clearPackageData
,請在 gcloud 中使用這個選項:
--environment-variables clearPackageData=true
啟用分片
測試資料分割會將一組測試分成多個子群組 (資料分割),並在獨立狀態下分別執行。Test Lab 會使用多部裝置平行執行每個分片,並在更短的時間內完成整組測試。
舉例來說,如果您建立 N 個分片,系統會為您選取的每個裝置啟動 N 個相同裝置,並在每個裝置上執行部分測試。Test Lab也就是說,每個裝置可能會執行多個測試案例。不過,非分片測試案例會導致每個裝置執行一次測試。如要瞭解 Test Lab 概念,請參閱重要概念。
如要在 Firebase 控制台中啟用測試分片,請按照下列步驟操作:
在檢測測試設定中,按一下「其他選項」。
在「分片」部分中,輸入要執行的分片數量。
測試分片的計費方式
Test Lab 會運用 AndroidJUnitRunner 的內建分片機制實作分片。如要避免系統針對啟動的空白資料分割 (未指派測試案例的資料分割) 收取費用,建立的資料分割數量應少於測試案例總數。視每個測試案例的執行時間而定,建議每個分片指派 2 到 10 個測試案例。
如要進一步瞭解帳單,請參閱「用量、配額和帳單」。