Microbenchmark 檢測引數

為檢測執行元件指定不同的引數,即可設定基準測試行為。這些引數可套用至 Gradle 設定,或透過指令列在檢測執行期間直接新增。

如要在透過 Android Studio 執行基準測試時設定檢測引數,請按照下列步驟操作:

  1. 按一下「Edit」,然後選取要編輯的設定,即可編輯執行設定。
    圖 1.編輯執行設定。
  2. 如要編輯檢測引數,請按一下「Instrumentation arguments」欄位旁邊的
    圖 2.編輯檢測引數。
  3. 按一下 ,然後新增必要的檢測引數。
    圖 3.新增檢測引數。

additionalTestOutputDir

設定 JSON 基準報告和剖析結果儲存在裝置上的位置。

  • 引數類型:檔案路徑字串
  • 預設為:測試 APK 的外部目錄

androidx.benchmark.dryRunMode.enable

在單一迴圈中執行基準測試,確認其可正常運作。您可將這個引數與一般測試搭配使用,做為驗證的一部分。

  • 引數類型:布林值
  • 預設為:false

androidx.benchmark.iterations

覆寫以時間為準的目標疊代次數,協助確保工作量穩定一致。這種做法通常只適合已啟用剖析功能的情況,確保在比較不同實作項目/執行作業時,剖析追蹤記錄中執行的工作量皆一致。在其他情況下,這種做法可能會降低測量的準確度或穩定性。

  • 引數類型:整數
  • 預設為:未指定

androidx.benchmark.junit4.SideEffectRunListener

在基準測試執行期間,如果您執行不相關的背景工作,可能會取得不一致的基準測試結果。

如要在基準測試期間停用背景工作,請將 listener 檢測引數類型設為 androidx.benchmark.junit4.SideEffectRunListener

  • 引數類型:字串
  • 可用選項:
    • androidx.benchmark.junit4.SideEffectRunListener
  • 預設為:未指定

androidx.benchmark.output.enable

可將結果 JSON 檔案寫入外部儲存空間。

  • 引數類型:布林值
  • 預設為:true

androidx.benchmark.profiling.mode

允許在執行基準測試時擷取追蹤記錄檔案。請參閱「剖析 Microbenchmark」,瞭解可用選項。

  • 引數類型:字串
  • 可用選項:
    • MethodTracing
    • StackSampling
    • None
  • 預設為:None

androidx.benchmark.suppressErrors

接受以半形逗號分隔的錯誤清單來轉換成警告。

  • 引數類型:字串清單
  • 可用選項:
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • CODE-COVERAGE
    • UNLOCKED
    • SIMPLEPERF
    • ACTIVITY-MISSING
  • 預設為:空白清單

androidx.benchmark.startupMode.enable (已淘汰)

重新設定迴圈行為,在啟動期間支援基準測試程式碼。在沒有暖機迴圈的情況下,系統會針對 10 次測量執行基準測試。為盡量減少 Microbenchmark 超載,迴圈平均功能已停用。

  • 引數類型:布林值
  • 預設為:false