Microbenchmark 檢測引數

為檢測執行器指定不同的引數,藉此設定基準的行為。這些可套用至您的 Gradle 設定,或是透過指令列執行檢測時直接新增。

additionalTestOutputDir

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

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

androidx.benchmark.dryRunMode.enable

允許在單一迴圈中執行基準測試,以確認運作正常。這可與一般測試搭配使用,作為驗證的一部分。

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

androidx.benchmark.iterations

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

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

androidx.benchmark.output.enable

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

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

androidx.benchmark.profiling.mode

允許在執行基準測試時擷取追蹤檔。請參閱剖析基準瞭解可用選項。

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

androidx.benchmark.suppressErrors

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

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

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

重新設定在啟動期間支援基準化程式碼的循環行為。在沒有暖機循環的情況下,針對 10 次測量執行基準測試。為盡量減少微基準測試的超載,已停用循環平均。

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