為檢測執行元件指定不同的引數,即可設定基準測試行為。這些引數可套用至 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}