Microbenchmark 檢測引數

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

透過 Android Studio 執行基準測試時，設定檢測引數的步驟如下：

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 次測量執行基準測試。為盡量減少 Microbenchmark 超載，迴圈平均功能已停用。

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

為您推薦

• 注意：系統會在 JavaScript 關閉時顯示連結文字
• Macrobenchmark 檢測引數
• 剖析 Microbenchmark
• 建立基準設定檔 {:#create-profile-rules}