Android Studio 的學習歷程

為 Android Studio 建立歷程，可讓您使用自然語言描述每個測試 (稱為歷程) 的步驟和斷言，輕鬆編寫及維護端對端測試。Gemini 具備視覺和推理能力，可將以自然語言撰寫的步驟轉換為 Gemini 在應用程式中執行的動作，讓您輕鬆編寫及瞭解歷程。此外，您還可以編寫及說明更複雜的判斷結果，Gemini 會根據裝置上顯示的內容進行評估，判斷流程是否通過測試。

此外，由於 Gemini 會推論要執行哪些動作才能達成目標，因此即使應用程式的版面配置或行為有細微變化，路徑也不容易受到影響，在不同版本的應用程式和不同裝置設定上執行測試時，發生不穩定測試的情況也會減少。

直接在 Android Studio 中針對任何本機或遠端 Android 裝置編寫及執行歷程。IDE 提供全新的編輯器體驗，可製作路徑，並提供豐富的結果，協助您更瞭解 Gemini 的推理過程，以及路徑的執行情況。

撰寫歷程

Android Studio 提供檔案範本和全新編輯器體驗，方便您輕鬆建立及編輯歷程。路徑是使用 XML 語法編寫，可整理路徑說明和步驟。

如要建立並開始編輯歷程，請按照下列步驟操作：

  1. 在 Android Studio 的「Project」面板中，對要撰寫歷程的應用程式模組按一下滑鼠右鍵。
  2. 依序選取「New」>「Test」>「Journey File」。
  3. 在隨即顯示的對話方塊中，輸入歷程的名稱和說明。
  4. 按一下「OK」。Android Studio 會以您選擇的名稱，為路徑建立 XML 檔案。您可以直接使用「Code」檢視畫面編輯 XML，也可以使用「Design」檢視畫面，享受更優質的編輯體驗。
  5. 在「設計」檢視畫面中查看歷程時，請使用文字欄位說明歷程的每個步驟。每個步驟都可以包含您希望 Gemini 執行的說明動作，或是您希望 Gemini 評估的判斷結果。
  6. 在鍵盤上按下 Enter 鍵，即可在同一趟旅程中開始新的提示。您可以視需要針對要定義的每個歷程步驟重複這個程序。

撰寫歷程的訣竅

詳細且有條理地撰寫歷程，有助於 Gemini 更準確地執行您預期的歷程，以下是一些訣竅，可協助您更有效地編寫歷程： * 將斷言與動作分開：Gemini 會持續評估應用程式的狀態，判斷是否處於「正確」狀態，可繼續歷程。不過，您可能需要將更複雜的判斷結果定義為個別步驟。 此外，請在每個提示開頭使用「確認」、「斷言」或「檢查」等關鍵片語，讓 Gemini 知道這個步驟是為了進行判斷。* 透過滑動操作直接與 Gemini 互動：除了輕觸或鍵盤輸入等基本互動方式，Gemini 也支援需要朝特定方向滑動螢幕的操作。舉例來說，如要捲動內容或關閉部分 UI，只要說明滑動動作的方向和意圖即可。Gemini 預設會從螢幕中央滑動，但你可以引導 Gemini 從裝置螢幕的其他位置滑動。* 避免複雜的互動和設定變更：Gemini 目前不支援所有互動和設定變更，例如多指手勢、螢幕旋轉或摺疊動作。團隊正在努力提升 Gemini 的功能。

執行旅程

您可以在任何可用的本機或遠端裝置上執行歷程，與任何其他設備測試類似，Android Studio 會產生豐富的結果，協助您瞭解歷程的執行情況。

如要測試歷程，請按照下列步驟操作：

  1. 從主要工具列選取目標裝置，就像執行插樁測試一樣。
  2. 前往要測試的歷程 XML 檔案，並在編輯器中開啟。
  3. 在編輯器中，執行下列任一操作：
    1. 如果是在「設計」檢視畫面中，請按一下「執行歷程」。
    2. 如果您位於「Code」檢視畫面，請按一下 XML 中定義路徑名稱旁邊的溝槽中的「Run」。

Android Studio 會為您建立「Journeys Test」設定，並在目標裝置上執行。執行期間，Android Studio 會建構及部署應用程式，並連線至 Gemini，判斷在每個步驟中要採取哪些動作。

執行歷程時，編輯器也會顯示有限的結果，例如歷程中每個步驟執行期間的螢幕截圖、採取的動作和原因。只要將游標懸停在編輯器中的縮圖上，即可查看更多資訊。在旅程中反覆調整提示時，這項功能會很有幫助。

查看結果

Android Studio 完成測試歷程後，系統會自動顯示測試結果面板。

與您可能在 Android Studio 中執行的其他檢測測試相比，系統顯示歷程結果的方式有些不同。

  • 「測試」面板會將歷程劃分為個別步驟。你可以點選每個步驟，進一步瞭解 Gemini 的執行方式。
  • 「結果」面板會顯示豐富的資訊，協助您瞭解 Gemini 如何理解和推論您的歷程，以及如何執行。
  • 步驟中的每個動作都會顯示傳送給 Gemini 的螢幕截圖，方便您查看。
  • 每張螢幕截圖旁都會說明 Gemini 採取的動作，以及採取該動作的原因。
  • 步驟中的每個動作都會編號。

已知問題

  • 測試歷程時，系統預設會授予應用程式的所有權限。
  • 在搭載 Android 15 (API 級別 35) 的裝置上測試歷程時，裝置可能會顯示「已封鎖不安全的應用程式」警告，指出「AndroidX Crawler」不安全。如要略過這項檢查，請按一下「仍要安裝」。 或者，您也可以設定裝置端開發人員選項，然後停用「透過 USB 驗證應用程式」選項。
  • 目前「旅程」檔案不會顯示在「專案」面板的 Android 檢視畫面中。如要在專案中查看歷程檔案，請使用「Project」檢視畫面。
  • 如果旅程中的多個動作共用完全相同的提示，旅程編輯器中顯示的測試結果可能不正確。具體來說，所有使用重複提示執行的動作都會顯示與該提示最新更新例項相關聯的測試結果。如要解決這個問題，請確保每個動作都有專屬提示，例如新增不同的前置字串或後置字串。
  • 在全新的模擬器上第二次載入鍵盤時，會出現觸控筆彈出式視窗。這個彈出式視窗通常會導致與文字欄位互動的測試失敗。發生這種情況時，請關閉彈出式視窗，然後重新執行歷程。
  • 應用程式檢索器構件偶爾會出現在代理程式基本原理中。
  • 旅程執行偶爾會失敗，並顯示 IllegalStateException。發生這種情況時，您可以點選「測試結果」查看完整錯誤。

  • 如果未在頂層 build.gradle 檔案中定義 Android Gradle 外掛程式 (com.android.application)，執行歷程時可能會看到下列錯誤：

    Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'

    如要解決這個問題，請確認外掛程式定義於頂層 build.gradle 檔案中。詳情請參閱「設定 Android 建構系統」。