Macrobenchmark 檢測引數

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

使用下列檢測引數設定程式庫的行為。這些引數可新增到 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

允許在效能評定的每次疊代之間停用編譯。根據預設,系統會在每個效能評定之間重新安裝並重新編譯目標應用程式,以遵循傳入 measureRepeatedCompilationMode。舉例來說,停用此功能後,在執行測試套裝組合前如果要完整編譯目標應用程式,就可以同時略過重新安裝和編譯,並可以依照完整編譯的目標執行所有效能評定。

  • 引數類型:布林值
  • 預設為: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 的外部目錄