本文件說明如何使用 Robo 指令碼，這是用於自動執行行動應用程式的手動 QA 工作，並啟用持續整合 (CI) 和正式發布前測試策略的測試。舉例來說，您可以使用 Robo 指令碼測試一般使用者歷程，或提供特定使用者介面 (UI) 輸入內容，例如使用者名稱和密碼。Robo 指令碼是 Robo 測試的功能。
您可以使用 Robo 指令碼，記錄自己在應用程式中逐步操作工作流程，然後將該記錄上傳至 Firebase 主控台，以便在 Robo 測試中執行。執行已附加指令碼的 Robo 測試時，Robo 會先執行預先編寫的動作，然後再照常探索應用程式。
Robo 指令碼會使用 Robo 測試做為測試引擎。在最基本的形式中，Robo 指令碼包含一系列 UI 動作，例如「輸入文字 'username'」，然後「輕觸「確定」按鈕」。Robo 指令碼也可以包含等待元素顯示、輕觸元素中的特定位置，以及執行 Android Debug Bridge (adb) 殼層指令等動作。
相較於傳統測試架構，Robo 指令碼具備下列優點：
| 功能 | 說明 |
| 高度完善 | Robo 指令碼可容許應用程式版本和應用程式不穩定性之間的結構和行為有顯著差異。 |
| 開放式 | Robo 指令碼完成後，基本 Robo 測試可接手並繼續測試應用程式。這種持續測試方法可支援多種重要用途。舉例來說，您可以使用 Robo 指令碼執行自訂登入流程，將應用程式帶入特定狀態。 |
| 可錄製 | 您不需要手動編寫 Robo 指令碼。你可以使用 Android Studio 中的 Robo 指令碼錄製工具錄製這些內容。建立或修改 Robo 指令碼時，通常不需要具備任何行動應用程式開發知識。 |
| 彈性 | Robo 指令碼可與遊戲中常見的非原生 UI 元素互動。 |
Robo 指令碼會在 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 指令碼：
開啟 Android Studio，然後依序選取「Tools」->「Firebase」。
在 Firebase 窗格中，按一下「記錄 Robo 指令碼並用於引導 Robo 測試」。
按一下「錄製 Robo 指令碼」。畫面上會顯示「Select Deployment Target」對話方塊。
選取要記錄 Robo 指令碼的裝置。
在裝置上記錄 Robo 指令碼後，將檔案儲存為 JSON 檔案並放在所需位置。
在 Firebase 控制台中開啟「Test Lab」頁面，然後上傳 JSON 指令碼檔案和應用程式 APK。
按一下「繼續」按鈕。系統會提示您選取裝置和 API 級別。測試指令碼完成後，Test Lab 會產生測試報告。
(選用) 如要複製或下載測試報告和影片的 Logcat，請按一下「View Source Files」。
根據預設，Robo 指令碼健全機制可避免指令碼提早失敗。如果選擇 strict 執行模式，且 Robo 指令碼在任何時間點失敗，Test Lab 就會捨棄指令碼中的所有後續步驟，並繼續執行一般的 Robo 檢索作業。Robo 指令碼之所以失敗，通常是因為 Robo 在畫面上找不到必要的元素。為避免失敗，請確保應用程式導覽是可預測的，且畫面的顯示順序必須具有確定性。
在 Test Lab 中執行 Robo 指令碼
如要在 Test Lab 中執行 Robo 指令碼，請按照下列操作說明進行：
在 Firebase 主控台中開啟「Test Lab」頁面。
在「應用程式 APK 或 AAB」欄位中上傳應用程式的 APK 或 AAB。
在「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>
使用 gs:// 符號，將 <robo-script-path> 替換為本機檔案系統或 Cloud Storage 中 Robo 指令碼檔案的路徑。例如：
gcloud firebase test android run --app = <path_to_app_apk_file> --robo-script = <robo-script-path>
後續步驟
- 如要瞭解 Robo 指令碼的結構、功能、用途和動作，請參閱 Robo 指令碼參考指南。
- 執行 Robo 測試。