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

允許在效能評定的每次疊代之間停用編譯。根據預設，系統會在每個效能評定之間重新安裝並重新編譯目標應用程式，以遵循傳入 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 的外部目錄