使用下列檢測引數設定程式庫的行為。這些引數可新增到 Gradle 設定,或是透過指令列執行檢測時直接套用。如果使用 Gradle,請將引數新增至 testInstrumentationRunnerArguments
:
android {
defaultConfig {
// ...
testInstrumentationRunnerArguments["androidx.benchmark.enabledRules"] = "BaselineProfile"
}
}
如果是直接透過指令列呼叫,請使用 -P android.testInstrumentationRunnerArguments.[name of the argument]
。
./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile
androidx.benchmark.compilation.enabled
允許在效能評定的每次疊代之間停用編譯。根據預設,系統會在每個效能評定之間重新安裝並重新編譯目標應用程式,以遵循傳入 measureRepeated 的 CompilationMode。舉例來說,停用此功能後,在執行測試套裝組合前如果要完整編譯目標應用程式,就可以同時略過重新安裝和編譯,並可以依照完整編譯的目標執行所有效能評定。
- 引數類型:布林值
- 預設為:
true
androidx.benchmark.dryRunMode.enable
允許在單一迴圈中執行基準測試,以確認運作正常。這可與一般測試搭配使用,作為驗證的一部分。
- 引數類型:布林值
- 預設為:
false
androidx.benchmark.enabledRules
將篩選器限為只有一個測試類型 - 基準設定檔產生或 Macrobenchmark 測試。另外也支援使用逗號分隔的清單。
- 引數類型:字串
- 可用選項:
Macrobenchmark
BaselineProfile
- 預設為:未指定
androidx.benchmark.fullTracing.enable (實驗性)
啟用 androidx.tracing.perfetto
追蹤點,例如 Jetpack Compose 組成追蹤。
請注意,這只會影響不使用 StartupMode.COLD
的時機,原因是啟用追蹤點會喚醒目標程序。
- 引數類型:布林值
- 預設為:
false
androidx.benchmark.suppressErrors
接受以半形逗號分隔的錯誤清單來轉換成警告。
- 引數類型:字串清單
- 可用選項:
DEBUGGABLE
LOW-BATTERY
EMULATOR
NOT-PROFILEABLE
- 預設為:空白清單
additionalTestOutputDir
設定 JSON 基準報告和剖析結果儲存在裝置上的位置。
- 引數類型:檔案路徑字串
- 預設為:測試 APK 的外部目錄