執行 Robo 指令碼 (Android)

本文說明如何使用 Robo 指令碼。這類測試可自動執行行動應用程式的手動 QA 工作,並啟用持續整合 (CI) 和正式發布前測試策略。舉例來說,您可以使用 Robo 指令碼測試一般使用者歷程,或提供特定使用者介面 (UI) 輸入內容,例如使用者名稱和密碼。Robo 指令碼是 Robo 測試的功能。

使用 Robo 指令碼時,您可以錄製自己在應用程式中完成工作流程的過程,然後將錄製內容上傳至 Firebase 控制台,在 Robo 測試中執行。執行附有指令碼的 Robo 測試時,Robo 會先逐步執行您預先寫好的動作,再照常檢索應用程式。

Robo 指令碼會使用 Robo 測試做為測試引擎。最基本的 Robo 指令碼是由一連串的 UI 動作組成,例如輸入文字「使用者名稱」,然後輕觸「確定」按鈕。Robo 指令碼也可以包含等待元素顯示、輕觸元素內的特定點,以及執行 Android Debug Bridge (adb) 殼層指令等動作。

相較於傳統測試架構,Robo 指令碼有以下優點:

功能 說明
高度穩健 Robo 腳本可容許應用程式版本之間存在顯著的結構和行為差異,以及應用程式不穩定。
開放式問題 Robo 指令碼完成後,基本 Robo 測試可以接手並繼續測試應用程式。這種持續測試方法可支援多種重要用途。舉例來說,您可以透過 Robo 指令碼執行自訂登入流程,讓應用程式進入特定狀態。
Recordable 您不必手動編寫 Robo 指令碼,您可以使用 Android Studio 中的 Robo 指令碼記錄器記錄這些指令碼。建立或修改 Robo 指令碼通常不需要任何行動開發知識。
彈性 Robo 指令碼可與遊戲中常見的非原生 UI 元素互動。

Robo 測試期間會視情況觸發 Robo 指令碼,讓使用者擴增 Robo 的行為,通常是為了提高涵蓋範圍或鎖定特定功能。與傳統測試架構不同,Robo 指令碼支援下列項目:

  • 各種觸發條件,例如特定應用程式套件名稱是否處於啟用狀態,或特定元素是否顯示在畫面上。
  • 執行控制項,例如執行次數上限、優先順序、相關檢索階段。
  • 非傳統動作類型 (條件式、忽略元素、關閉畫面)。

建議您盡可能使用 Robo 指令碼,因為這類指令碼很容易維護。舉例來說,你可以使用 Robo 指令碼執行下列操作:

  • 瀏覽重要工作流程,瞭解應用程式的核心功能。 舉例來說,您可以登入、在首次啟動後設定應用程式狀態,以及註冊新使用者。
  • 讓 Robo 專注於應用程式的特定部分,充分利用 Robo 測試時間。Robo 指令碼會引導 Robo 測試前往應用程式的相關部分,然後 Robo 測試會繼續執行全自動檢索。
  • 將應用程式帶入特定狀態或畫面進行分析,例如分析應用程式內訊息、隱私權政策或遊戲的特定關卡。
  • 執行端對端插樁測試,可選擇是否使用 Robo 測試,在 Robo 指令碼完成後,繼續進行全自動檢索。

使用更多進階 Robo 指令碼功能,執行下列操作:

  • 在 Robo 開始檢索受測應用程式之前或檢索完成後執行動作,例如在檢索前清除受測應用程式資料,或變更裝置設定。
  • 在檢索期間變更機器人行為,特別是:
    • 讓 Robo 忽略某些 UI 小工具或應用程式畫面。
    • 為 Robo 提供自訂動作,以便在從特定畫面返回時執行。
    • 在檢索期間遇到特定應用程式畫面時,讓 Robo 執行特定動作。
  • 全面自訂 Robo 執行檢索的方式。舉例來說,您可以結合使用條件式和非條件式動作,在整個檢索過程中讓受測應用程式保持在背景執行,同時執行裝置操作並關閉過程中出現的任何彈出式對話方塊。

請注意,Robo 指令碼無法取代所有類型的測試。您仍需進行單元測試,才能找出應用程式中的低階邏輯錯誤;這類測試通常不需要 Android 或 iOS 環境。建議您搭配使用 Robo 指令碼測試和目標插樁測試,針對業務邏輯進行特定且詳細的斷言,而這類斷言最適合以程式碼表示。

使用 Android Studio 中的 Test Lab 記錄 Robo 指令碼

Android Studio 中的 Robo 指令碼記錄器可讓您直接與裝置上的應用程式互動,藉此記錄 Robo 指令碼。如要透過 Android Studio 中的 Firebase 工具開始使用 Robo 指令碼,請按照下列操作說明進行:

  1. 開啟 Android Studio,然後選取「Tools」->「Firebase」

  2. 在 Firebase 窗格中,按一下「Record Robo Script and Use it to Guide Robo Test」

  3. 按一下「Record Robo script」(錄製 Robo 指令碼)。「Select Deployment Target」對話方塊隨即顯示。

  4. 選取要錄製 Robo 腳本的裝置。

  5. 在裝置中錄製 Robo 指令碼後,請將檔案儲存為 JSON 檔案,並放在所需位置。

  6. Firebase 控制台中開啟 Test Lab 頁面,然後上傳 JSON 指令碼檔案和應用程式 APK。

  7. 按一下「繼續」按鈕,系統會提示您選取裝置和 API 級別。測試指令碼完成後,Test Lab 會產生測試報告。

  8. (選用) 如要複製或下載測試報告的 Logcat 和影片,請按一下「查看來源檔案」

根據預設,Robo 指令碼的穩健機制可防止指令碼提早失敗。 如果您選擇 strict 執行模式,且 Robo 指令碼在任何時間點失敗,Test Lab 會放棄指令碼中的所有後續步驟,並繼續執行一般 Robo 檢索。Robo 指令碼最常因 Robo 無法在畫面上找到必要元素而失敗。為避免失敗,請確保應用程式導覽可預測,且畫面會以可判定的順序顯示。

Test Lab 中執行 Robo 指令碼

如要在 Test Lab 中執行 Robo 指令碼,請按照下列操作說明操作:

  1. Firebase 控制台中開啟 Test Lab 頁面。

  2. 在「應用程式 APK 或 AAB」欄位中上傳應用程式的 APK 或 AAB。

  3. 在「Robo 指令碼 (選用)」欄位中,上傳您錄製或手動建立的 Robo 指令碼檔案。

為本機 Robo 測試執行提供 Robo 指令碼

如要為本機 Robo 測試執行提供 Robo 指令碼,請使用下列 Robo 測試選項:

--robo-script-file <robo-script-path>

<robo-script-path> 替換為本機檔案系統中 Robo 指令碼檔案的路徑。按照本機 Robo 測試執行說明操作。

在 gcloud CLI 測試呼叫中指定 Robo 指令碼

如要在 gcloud CLI 測試呼叫中指定 Robo 指令碼,請使用下列 gcloud CLI 旗標:

--robo-script = <robo-script-path>

<robo-script-path> 換成本機檔案系統或 Cloud Storage 中 Robo 指令碼檔案的路徑,並使用 gs:// 標記。例如:

gcloud firebase test android run --app = <path_to_app_apk_file> --robo-script = <robo-script-path>

後續步驟