使用 atest 測試平台程式碼

Android Studio for Platform (ASfP) 與 atest 指令列工具整合，可讓您直接從 IDE 在連線的裝置或模擬器上執行測試。

必要條件

  • 使用 AOSP 原始碼開啟 ASfP 專案。
  • 成功建構程式碼，並將其刷入裝置或模擬器。
  • 使用 source build/envsetup.sh 和 lunch 初始化建構環境。

執行測試

您可以使用 ASfP 中的 atest，透過下列幾種方式執行測試：

  • 空白邊執行圖示：按一下「執行」圖示

    ，即可執行該特定測試。

  • 右鍵選單：在「Project」視窗或編輯器中，對測試檔案、類別或方法按一下滑鼠右鍵，然後選取「Run 'atest'」。

  • 使用終端機：在 ASfP 中開啟整合式終端機 (依序選取「View」>「Tool Windows」>「Terminal」)，然後直接執行 atest 指令。例如：bash atest MyTestModule atest MyTestClass#myTestMethod

查看測試結果

測試結果會顯示在 ASfP 的「Run」工具視窗中。這個視窗會顯示測試進度、通過或失敗狀態，並提供每項測試的記錄和輸出內容。

測試設定

從空白邊或按一下滑鼠右鍵選單執行測試時，ASfP 會自動建立暫時的執行或偵錯設定。您可以修改並儲存這些設定，以便使用特定選項或標記快速重新執行測試：

  1. 依序前往「Run」>「Edit Configurations」。
  2. 找出要修改的 atest 設定，或按一下「+」按鈕並選取「atest」，建立新的設定。
  3. 指定測試模組、類別和方法，並新增任何必要的 atest 指令列選項。

測試訣竅

  • 目標測試：只執行所需測試，節省時間。使用 Module:Class#Method 格式或其他 atest 篩選器。
  • 使用模擬器快照：如要在模擬器上加快測試執行速度，建議使用快照快速還原至已知良好狀態。
  • 檢查記錄：使用「Run」工具視窗中的記錄，診斷任何測試失敗情形。