診斷穩定性問題

如果發生效能問題，原因包括： 過度重組，您應該對應用程式的穩定性進行偵錯。本指南 概述幾種達成此目標的方法。

重要事項： 請盡量避免不必要或提早進行最佳化。 針對穩定性進行最佳化之前，請務必遵循我們的最佳做法 以及 Compose 效能

注意： 如要進一步瞭解如何評估效能，請參閱這篇文章 請參閱 Macrobenchmark 指南。

版面配置檢查器

Android Studio 的版面配置檢查器可讓您查看 在應用程式中進行重組時其中會顯示 Compose 重組或略過元件

Compose 編譯器報表

Compose 編譯器可以輸出針對下列項目的穩定性推論結果： 以及檢查 10 到 100 個威脅您可以運用這個輸出內容判斷哪些可組合函式 可略過及否以下子章節將概述如何運用 但如需更多詳細資訊，請參閱技術工具 說明文件。

警告： 只有在實際發生情況時，才使用這項技巧。 與穩定性相關的效能問題正在嘗試將整個使用者介面設為可略過 是一個早期最佳化方法，可能會導致 。

設定

根據預設，Compose 編譯器報表不會啟用。你可以透過以下方式啟用 編譯器標記。確切設定會因您的 不過，對於使用 Compose 編譯器 Gradle 外掛程式的專案，您可以 在每個模組 build.gradle 檔案中新增以下程式碼。

  android { ... }

  composeCompiler {
    reportsDestination = layout.buildDirectory.dir("compose_compiler")
    metricsDestination = layout.buildDirectory.dir("compose_compiler")
  }

現在建構專案時，系統會產生 Compose 編譯器報表。

重要事項： 請務必一律在發布子版本上執行此程式碼，以確保準確無誤 結果。

輸出內容範例

reportsDestination 會輸出三個檔案。以下是輸出內容範例 來自 JetSnack。

• <modulename>-classes.txt：此報告會顯示此類別中類別穩定性的報告 後續課程我們將逐一介紹 預先訓練的 API、AutoML 和自訂訓練範例。
• <modulename>-composables.txt：關於可重新啟動和 可略過的可組合函式模組。範例。
• <modulename>-composables.csv：可組合元件報表的 CSV 版本 方便你匯入試算表，或透過指令碼處理 範例

，瞭解如何調查及移除這項存取權。

注意： metricsDestination 設定會產生 專案中的可組合項數量及其他類似資訊。

注意： 這些報表會使用 Compose 中所述的編譯器標記 穩定性指南。

可組合函式報表

composables.txt 檔案會詳細列出指定應用程式的每個可組合函式 包括參數的穩定性 可重新啟動或可略過以下是 JetSnack：

restartable skippable scheme("[androidx.compose.ui.UiComposable]") fun SnackCollection(
  stable snackCollection: SnackCollection
  stable onSnackClick: Function1<Long, Unit>
  stable modifier: Modifier? = @static Companion
  stable index: Int = @static 0
  stable highlight: Boolean = @static true
)

這個 SnackCollection 可組合函式可完全重新啟動、可略過和 以及穩定的品質一般來說，我們會建議您這麼做，不過我們當然不是強制要求。

另一方面，我們還來看看另一個範例。

restartable scheme("[androidx.compose.ui.UiComposable]") fun HighlightedSnacks(
  stable index: Int
  unstable snacks: List<Snack>
  stable onSnackClick: Function1<Long, Unit>
  stable modifier: Modifier? = @static Companion
)

HighlightedSnacks 可組合函式無法略過。Compose 絕對不會略過 重新組成期間即使其中的參數沒有變更，也會發生這種情形。 原因是 unstable 參數 snacks。

課程報告

classes.txt 檔案內含與指定 後續課程我們將逐一介紹 預先訓練的 API、AutoML 和自訂訓練以下程式碼片段為 Snack 類別的輸出內容：

unstable class Snack {
  stable val id: Long
  stable val name: String
  stable val imageUrl: String
  stable val price: Long
  stable val tagline: String
  unstable val tags: Set<String>
  <runtime stability> = Unstable
}

以下是 Snack 的定義，供您參考：

data class Snack(
    val id: Long,
    val name: String,
    val imageUrl: String,
    val price: Long,
    val tagline: String = "",
    val tags: Set<String> = emptySet()
)

Compose 編譯器已將 Snack 標示為不穩定。這是因為 tags 參數為 Set<String>。這是不可變動的類型 不是 MutableSet。不過，Set, List 等標準的集合類別 和 Map 則是介面。因此，基礎實作可能會 仍可變動

例如，您可以編寫 val set: Set<String> = mutableSetOf("foo")。 變數是常數，且其宣告類型不可變動，但其 實作方式「仍」可變動。Compose 編譯器無法確定 這個類別的不可變動性，因為這個類別只會看到宣告的類型。因此會標示 tags 不穩定。

重要事項： 說明如何將穩定性降低到不穩定的類別中 請參閱「修正穩定性問題」指南。