為檢測執行元件指定不同的引數,即可設定基準測試行為。這些引數可套用至 Gradle 設定,或透過指令列在檢測執行期間直接新增。
如要在透過 Android Studio 執行基準測試時設定檢測引數,請按照下列步驟操作:
- 按一下「Edit」,然後選取要編輯的設定,即可編輯執行設定。
- 如要編輯檢測引數,請按一下「Instrumentation arguments」欄位旁邊的 。
- 按一下 ,然後新增必要的檢測引數。
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
為您推薦
- 注意:系統會在 JavaScript 關閉時顯示連結文字
- Macrobenchmark 檢測引數
- 剖析 Microbenchmark
- 建立基準設定檔 {:#create-profile-rules}