剖析 Microbenchmark

根據預設，Microbenchmark 可針對已執行的程式碼，提供時間和配置資訊。如要調查受評估的程式碼為何執行緩慢，可以在附加 CPU 分析器後執行基準測試。

如要選取分析器設定，請新增檢測執行器引數 androidx.benchmark.profiling.mode，並搭配 MethodTracing、StackSampling 或 None 其中一個引數，如以下程式碼片段所示。

如要進一步瞭解選項，請參閱「選擇錄製設定」。根據該說明文章的定義，MethodTracing 相當於的「Java 追蹤法」，而 StackSampling 相當於「Java 抽樣法」。

android {
    defaultConfig {
        // must be one of: 'None', 'StackSampling', or 'MethodTracing'
        testInstrumentationRunnerArguments["androidx.benchmark.profiling.mode"]= 'StackSampling'
    }
}

android {
    defaultConfig {
        // must be one of: 'None', 'StackSampling', or 'MethodTracing'
        testInstrumentationRunnerArguments["androidx.benchmark.profiling.mode"] = "StackSampling"
    }
}

您剖析基準測試時，系統會將輸出的 .trace 檔案連同 JSON 結果，一併複製到主機目錄。如要在 Android Studio 的 CPU 分析器中檢查剖析結果，請依序選取「File」>「Open」。如要進一步瞭解如何解讀追蹤記錄，請參閱「檢查追蹤記錄」。

MethodTracing

如要嘗試將程式碼最佳化，很適合使用方法追蹤功能，因為這有助找出執行時間較長的方法。這樣一來，您就能聚焦於改善對效能影響最大的方法。

系統會在程式碼評估完成後依序執行剖析作業，讓測試輸出準確的時間和剖析結果。

StackSampling

如要找出會耗費大量資源的方法，又不希望因方法追蹤造成效能負擔，就適合使用取樣追蹤功能。但如果應用程式是在系統擷取呼叫堆疊後進入方法，且方法會在下次擷取前結束，那麼系統就不會記錄方法呼叫。如要妥善追蹤生命週期較短的方法，請使用方法追蹤功能，而非取樣追蹤功能。

透過堆疊取樣功能，基準測試會在暖機完成後對呼叫堆疊取樣。您可以使用檢測引數控管取樣頻率和取樣期間長度。

在 Android 10 (API 29) 以上版本中，堆疊取樣會使用 Simpleperf 對應用程式呼叫進行呼叫，包括 C++ 程式碼。在 Android 9 (API 28) 以下版本中，應用程式會使用 Debug.startMethodTracingSampling 擷取堆疊範例。

您可以新增其他檢測引數，設定這個剖析模式：

• androidx.benchmark.profiling.sampleFrequency

  • 每秒要擷取的堆疊樣本數量。
  • 引數類型：整數
  • 預設值為每秒 1000 個樣本。

• androidx.benchmark.profiling.sampleDurationSeconds

  • 執行基準的時間長度。
  • 引數類型：整數
  • 預設值為 5 秒。

None

這個引數不會擷取剖析檔案，但系統仍會測量時間和配置作業的資訊。