Compose Runtime

Compose 的狀態管理和程式設計模型的構成元素，以及 Compose Compiler 外掛程式指定的核心執行階段。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 9 月 4 日 1.7.0 - - 1.8.0-alpha01

結構

Compose 是由 androidx 中的 7 個 Maven 群組 ID 所組成。每個群組都包含一個指定功能子集，且各有一組專屬的版本資訊。

下表提供各群組的說明和每組版本資訊的連結。

群組說明
compose.animation在 Jetpack Compose 應用程式中建構動畫，提供豐富的使用者體驗。
compose.compiler透過 Kotlin 編譯器外掛程式轉換 @Composable 函式，並啟用最佳化功能。
compose.foundation透過現成的構成元素編寫 Jetpack Compose 應用程式，然後進一步擴充基礎，建構出自己的設計系統元件。
compose.material運用現成的 Material Design 元件建構 Jetpack Compose UI。這是更高層級的 Compose 進入點，用意是確保提供的元件與 www.material.io 上所述元件相符。
compose.material3運用新一代的 Material Design 3 元件建構 Jetpack Compose UI。Material 3 提供新的主題設定和元件，以及動態色彩等 Material You 個人化功能，可呼應全新的 Android 12 視覺風格和系統 UI。
compose.runtimeCompose 程式設計模型和狀態管理的基本構成元素，以及 Compose Compiler 外掛程式指定的核心執行階段。
compose.ui與裝置互動所需的 Compose UI 基礎元件，包括版面配置、繪圖及輸入。

宣告依附元件

如要新增 Compose 的依附元件，必須將 Google Maven 存放區新增至您的專案。詳情請參閱「Google 的 Maven 存放區」一節。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    implementation "androidx.compose.runtime:runtime:1.7.0"
    implementation "androidx.compose.runtime:runtime-livedata:1.7.0"
    implementation "androidx.compose.runtime:runtime-rxjava2:1.7.0"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.runtime:runtime:1.7.0")
    implementation("androidx.compose.runtime:runtime-livedata:1.7.0")
    implementation("androidx.compose.runtime:runtime-rxjava2:1.7.0")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Runtime Tracing 1.0 版

1.0.0-beta01 版

2023 年 11 月 29 日

發布 androidx.compose.runtime:runtime-tracing:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。

1.0.0-alpha05 版本

2023 年 11 月 15 日

發布 androidx.compose.runtime:runtime-tracing:1.0.0-alpha05。1.0.0-alpha05 版本包含以下修訂項目。

修正錯誤

  • 將依附元件固定至支援最低的穩定版本 (例如 compose-runtime-tracing)，並修正以下問題：compose-runtime-tracing 會將新版 Compose-runtime 引入應用程式。

1.0.0-alpha04 版本

2023 年 8 月 23 日

發布 androidx.compose.runtime:runtime-tracing:1.0.0-alpha04。1.0.0-alpha04 版本包含以下修訂項目。

新功能

  • 與最新版的 Benchmark 和 Tracing Perfetto 相容，可在應用程式啟動時 (冷啟動) 支援組合追蹤，例如：。(自 Hedgehog Beta 2 起)

API 變更

  • androidx.tracing.perfetto.Trace 已重新命名為 androidx.tracing.perfetto.PerfettoSdkTrace。(I44af8)。
  • 讓 Tracing Perfetto SDK API 與 android.os.Trace 保持一致。(I73ba0、b/282199917)
  • 在應用程式啟動時進行追蹤的先決條件。(Iad890)。
  • 合併實驗性與公開 API 檔案 (I0f2e1、b/278769092)

1.0.0-alpha02 版

2023 年 2 月 8 日

發布 androidx.compose.runtime:runtime-tracing:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 沒有功能變更。對下游依附元件 androidx.tracing:tracing-perfetto* 中的多項效能進行最佳化調整。

1.0.0-alpha01 版

2022 年 9 月 7 日

發布了 androidx.compose.runtime:runtime-tracing:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • androidx.compose.runtime:runtime-tracing 是種程式庫。搭配即將推出且支援這類程式庫的工具使用，可在 Compose 應用程式中執行更強大的追蹤功能。本初始版本為 1.0.0-alpha01。

1.8 版

1.8.0-alpha01 版

2024 年 9 月 4 日

發布 androidx.compose.runtime:runtime-*:1.8.0-alpha01。1.8.0-alpha01 版包含這些修訂版本。

1.7 版

1.7.0 版

2024 年 9 月 4 日

發布 androidx.compose.runtime:runtime-*:1.7.0。1.7.0 版包含這些修訂版本。

自 1.6.0 版以來的重要變更

  • 新增了提供根據其他組合本機值計算的本機組合的功能，根據預設可使用 compositionLocalWithComputedDefault()，或使用 providesComputed (而非 provides)，提供 lambda 用於計算值。
  • 您可以從計算值的 lambda 中存取本機組合的 currentValue 屬性，取得本機組合的值。這會取代只能透過 @Composable 函式存取的 current。(Iadbc0)。
  • 新建立的狀態物件可透過其他快照立即存取，包括全域快照和其初始狀態。套用物件的快照之前，無法查看所有後續修改。
  • mutableStateOf() 的初始狀態及其原始版本都是傳入做為 mutableStateOf() 參數的值。mutableStateListOf() 和 mutableStateMapOf() 的初始狀態為空白。
  • 新增了 Snapshot.isInSnapshot 和 Snapshot.PreexistingSnapshotId，用於啟用狀態物件，在建立物件時，可透過全域快照立即存取。
  • 您可以按照對內建快照物件所做的變更模式，立即取得自訂狀態物件。(I84a17)。
  • 為 Compose 程式庫啟用 nonSkippingGroupOptimization。這讓 Androidx 中所有無法重新啟動的可組合函式產生的程式碼更有效率。未來我們會預設啟用這項功能。I(acbc08)
  • 在同一個影格上撤銷子組合中的可組合 lambda。(98301c)。
  • 呼叫 onRelease 回呼的順序與 onForgotten 相同，(2cd790)。
  • 啟用嚴格略過模式 (ed1766)
  • 在更多情況下讓 currentCompoundHashKey 不重複 (d4a872)

1.7.0-rc01 版

2024 年 8 月 21 日

發布 androidx.compose.runtime:runtime-*:1.7.0-rc01。1.7.0-rc01 版包含這些修訂版本。

1.7.0-beta07 版

2024 年 8 月 7 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta07。1.7.0-beta07 版包含這些修訂版本。

1.7.0-beta06 版

2024 年 7 月 24 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta06。1.7.0-beta06 版包含這些修訂版本。

1.7.0-beta05 版

2024 年 7 月 10 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta05。1.7.0-beta05 版包含這些修訂版本。

1.7.0-beta04 版

2024 年 6 月 26 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta04。1.7.0-beta04 版包含這些修訂版本。

1.7.0-beta03 版

2024 年 6 月 12 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta03。1.7.0-beta03 版包含這些修訂版本。

1.7.0-beta02 版

2024 年 5 月 29 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta02。1.7.0-beta02 版包含這些修訂版本。

1.7.0-beta01 版

2024 年 5 月 14 日

發布 androidx.compose.runtime:runtime-*:1.7.0-beta01。1.7.0-beta01 版包含這些修訂版本。

1.7.0-alpha08 版

2024 年 5 月 1 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha08。1.7.0-alpha08 版包含這些修訂版本。

1.7.0-alpha07 版

2024 年 4 月 17 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha07。1.7.0-alpha07 版包含這些修訂版本。

新功能

  • 新增了提供根據其他組合本機值計算的本機組合的功能，根據預設可使用 compositionLocalWithComputedDefault()，或使用 providesComputed (而非 provides)，提供 lambda 用於計算值。
  • 您可以從計算值的 lambda 中存取本機組合的 currentValue 屬性，取得本機組合的值。這會取代只能透過 @Composable 函式存取的 current。(Iadbc0)。

API 變更

  • 新建立的狀態物件可透過其他快照立即存取，包括全域快照和其初始狀態。套用物件的快照之前，無法查看所有後續修改。
  • mutableStateOf() 的初始狀態及其原始版本都是傳入做為 mutableStateOf() 參數的值。mutableStateListOf() 和 mutableStateMapOf() 的初始狀態為空白。
  • 新增了 Snapshot.isInSnapshot 和 Snapshot.PreexistingSnapshotId，用於啟用狀態物件，在建立物件時，可透過全域快照立即存取。
  • 您可以按照對內建快照物件所做的變更模式，立即取得自訂狀態物件。(I84a17)。

修正錯誤

  • 修正了巢狀快照中的 readObserver 合併問題。這會導致巢狀衍生狀態在 snapshotFlow 中使用時失效。(Idf138)。

1.7.0-alpha06 版

2024 年 4 月 3 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha06。1.7.0-alpha06 版包含這些修訂版本。

修正錯誤

  • 修正問題：提供單一值處理 providesDefault (538f45)
  • 避免在重組工具中存取影格時鐘 (07e5c6)

1.7.0-alpha05 版

March 20, 2024

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha05。1.7.0-alpha05 版包含這些修訂版本。

修正錯誤

  • 清除已停用組合的延遲變更 (5950bc)

1.7.0-alpha04 版

2024 年 3 月 6 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha04。1.7.0-alpha04 版包含這些修訂版本。

效能提升

  • 針對每個衍生狀態評估呼叫 Snapshot.current 一次 (ee7daf)
  • 組合中的每個觀察項目會讀取 currentRecord 一次 (b882b2)
  • 移除 snapshotFlow 中意外的疊代器分配 (231e56)
  • 為 Compose 程式庫啟用 nonSkippingGroupOptimization。這讓 Androidx 中所有無法重新啟動的可組合函式產生的程式碼更有效率。未來我們會預設啟用這項功能。I(acbc08)

1.7.0-alpha03 版

2024 年 2 月 21 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha03。1.7.0-alpha03 版包含以下修訂項目。

API 變更

  • 導入替換群組以改善偵測變化 (0941b5)

效能提升

  • 改善偵測變更時的記憶體配置 (53e7fd)
  • 修正 Composer 中的記憶體流失問題 (0e097d)
  • 在重組時使用 ScopeMap 傳遞撤銷 (e19a7e)
  • 最佳化撤銷對應，只保留衍生狀態 (f11c44)
  • 將 IdentityArraySet 用法替換為 ScatterSet (db572e)
  • 在 ScopeMap 中改善 removeScope (bb0530)

1.7.0-alpha02 版

2024 年 2 月 7 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha02。1.7.0-alpha02 版包含以下修訂項目。

修正錯誤

  • 在同一個影格上撤銷子組合中的可組合 lambda。(98301c)。
  • 呼叫 onRelease 回呼的順序與 onForgotten 相同，(2cd790)。
  • 篩選未在 snapshotFlow 中觀察到的已變更狀態。(796b80)。

效能提升

  • 在已有透明的快照觀察器中修改其設定。(f60f30)。
  • 最佳化SnapshotIdSet.lowest()。(7ae149)。
  • 在 SnapshotIdSet 中使用無配置的 fold()。(532b7d)。
  • 移除疊代器分配 (83f96b)

1.7.0-alpha01 版

2024 年 1 月 24 日

發布 androidx.compose.runtime:runtime-*:1.7.0-alpha01。1.7.0-alpha01 版包含以下修訂項目。

成效最佳化

  • 在新增子項群組後新增建立版位的功能 (b5960c)
  • 最佳化快照狀態的記錄修改作業 (28c3fe)
  • 啟用嚴格略過模式 (ed1766)

修正錯誤

  • 將預設參數中繼納入考量 (096665)
  • 在更多情況下讓 currentCompoundHashKey 不重複 (d4a872)
  • 離開內嵌函式呼叫時將群組升級 (2a90fc)

1.6 版本

1.6.8 版

2024 年 6 月 12 日

發布 androidx.compose.runtime:runtime-*:1.6.8。1.6.8 版包含這些修訂版本。

1.6.7 版

2024 年 5 月 1 日

發布 androidx.compose.runtime:runtime-*:1.6.7。1.6.7 版包含這些修訂版本。

1.6.6 版

2024 年 4 月 17 日

發布 androidx.compose.runtime:runtime-*:1.6.6。自上次發布版本以來沒有任何異動。

1.6.5 版本

2024 年 4 月 3 日

發布 androidx.compose.runtime:runtime-*:1.6.5。1.6.5 版包含這些修訂版本。

1.6.4 版

March 20, 2024

發布 androidx.compose.runtime:runtime-*:1.6.4。1.6.4 版包含這些修訂版本。

1.6.3 版

2024 年 3 月 6 日

發布 androidx.compose.runtime:runtime-*:1.6.3。1.6.3 版包含這些修訂版本。

1.6.2 版

2024 年 2 月 21 日

發布 androidx.compose.runtime:runtime-*:1.6.2。1.6.2 版包含以下修訂項目。

1.6.1 版

2024 年 2 月 7 日

發布 androidx.compose.runtime:runtime-*:1.6.1。1.6.1 版包含以下修訂項目。

修正錯誤

  • 呼叫 onRelease 回呼的順序與 onForgotten 相同，(2cd790)。
  • 篩選未在 snapshotFlow 中觀察到的已變更狀態。(796b80)。

1.6.0 版

2024 年 1 月 24 日

發布 androidx.compose.runtime:runtime-*:1.6.0。1.6.0 版包含以下修訂項目。

自 1.5.0 版以來的重要變更

新功能

  • 重新擲回在重組迴圈期間省略的例外狀況 (4dff9a)

成效最佳化

  • 最佳化快照狀態的記錄修改作業 (28c3fe)
  • 最佳化 rememberSaveable (f01d79)
  • 延後重新讀取衍生狀態，直到記錄變更為止 (f38099)
  • 改善提供組合本地值 (a337ea)

修正錯誤

  • 修正運算單元資料表記憶體流失問題 (73fcfe)
  • 略過要移除的子組合的重組作業。(Ieeb99、b/254645321)
  • 只在儲存在記憶計算中時觸發 RememberObserver 生命週期。(f6b4dc)。
  • 將 $dirty 擷取範圍限制在內嵌 lambda。(acfca0)。
  • 修正可移動的內容，有時會收到錯誤組合本機的問題。(035cd6)。

1.6.0-rc01 版

2024 年 1 月 10 日

發布 androidx.compose.runtime:runtime-*:1.6.0-rc01。1.6.0-rc01 版包含以下修訂項目。

1.6.0-beta03 版

2023 年 12 月 13 日

發布 androidx.compose.runtime:runtime-*:1.6.0-beta03。1.6.0-beta03 版包含以下修訂項目。

1.6.0-beta02 版

2023 年 11 月 29 日

發布 androidx.compose.runtime:runtime-*:1.6.0-beta02。1.6.0-beta02 版包含以下修訂項目。

1.6.0-beta01 版

2023 年 11 月 15 日

發布 androidx.compose.runtime:runtime-*:1.6.0-beta01。1.6.0-beta01 版包含以下修訂項目。

API 變更

  • 在註解中傳播特定穩定性值。(274a4c)

修正錯誤

  • 在使用情境中組合本機範圍狀態時，請使用參照政策。(83361c)
  • 將 $dirty 擷取限制為內嵌 lambda。(acfca0)
  • 修正可移動的內容，有時會收到錯誤組合本機的問題。(035cd6)
  • 在 RecomposeScopeImpl 中使用更快速的非分配雜湊對應。(d79494)
  • 在「DerivedState」應用程式中使用「ObjectIntMap」。(21862e)
  • 使用 IntRef 代表 DerivedState 中的 int SnapshotThreadLocal。(04eaf4)

1.6.0-alpha08 版

2023 年 10 月 18 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha08。1.6.0-alpha08 版包含以下修訂項目。

修正錯誤

  • 只在儲存在記憶計算中時觸發 RememberObserver 生命週期。(f6b4dc)。
  • 改善撤銷清單排序作業的分配功能。(954d63)。
  • 在 SnapshotStateObserver 中使用新的非分配地圖。(4303ce)。
  • 組合停用時清除撤銷。(e001be)。

1.6.0-alpha07 版

2023 年 10 月 4 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha07。1.6.0-alpha07 版包含以下修訂項目。

API 變更

  • SnapshotStateList 現已標示為 RandomAccess，以便使用清單輔助程式直接建立索引版本。(I5210c、b/219554654)

1.6.0-alpha06 版

2023 年 9 月 20 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha06。1.6.0-alpha06 版包含以下修訂項目。

1.6.0-alpha05 版

2023 年 9 月 6 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha05。1.6.0-alpha05 版包含以下修訂項目。

1.6.0-alpha04 版本

2023 年 8 月 23 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha04。1.6.0-alpha04 版本包含以下修訂版本。

新功能

  • 重新擲回在重組迴圈期間省略的例外狀況 (4dff9a)

API 變更

  • 新增停用 ReusableComposition 的方法，可移除觀察項目，但保留節點。呼叫 setContent 即可再次啟用已停用的組合。(Ib7f31)。
  • 新增 ReusableComposition 介面，用於管理生命週期和重複使用子組合。(I812d1、b/252846775)

1.6.0-alpha03 版本

2023 年 8 月 9 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha03。1.6.0-alpha03 版包含以下修訂項目。

修正錯誤

  • 修正新的 CompositionLocalProvider 最佳化 (3118e88)
  • 修正可移動內容節點的拆解方式。(5e3d59b)。

1.6.0-alpha02 版本

2023 年 7 月 26 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha02。1.6.0-alpha02 版包含以下修訂項目。

新功能與效能強化

  • 最佳化 rememberSaveable (f01d79)
  • 延後重新讀取衍生狀態，直到記錄變更為止 (f38099)
  • 改善提供組合本地值 (a337ea)
  • 系統會將 SideEffect 標示為 @ExplicitGroupsComposable，以免產生群組。(I74815)。
  • 避免比較重複使用時的本地組合地圖 (782071)

API 變更

  • 已為 CompositionLocalProviders 新增特殊案例超載，可避免為了更快速提供多個值而增加負擔，但提供單一值時會增加負擔。(I6d640、b/288169379)

修正錯誤

  • 修正運算單元資料表記憶體流失問題 (73fcfe)
  • 修正 stateSaver 傳回空值時還原 rememberSaveable 的方式 (90748c)

1.6.0-alpha01 版本

2023 年 6 月 21 日

發布 androidx.compose.runtime:runtime-*:1.6.0-alpha01。1.6.0-alpha01 版包含以下修訂項目。

修正錯誤

  • 略過要移除的子組合的重組作業。(Ieeb99、b/254645321)
  • 套用快照時減少的分配數量。(I65c09)。
  • 如未修改快照，避免在 DerivedState 中計算 readableHash (68c565)

1.5 版本

1.5.4 版本

2023 年 10 月 18 日

發布 androidx.compose.runtime:runtime-*:1.5.4。1.5.4 版包含以下修訂項目。

1.5.3 版本

2023 年 10 月 4 日

發布 androidx.compose.runtime:runtime-*:1.5.3。1.5.3 版包含以下修訂項目。

1.5.2 版本

2023 年 9 月 27 日

發布 androidx.compose.runtime:runtime-*:1.5.2。1.5.2 版包含以下修訂項目。

1.5.1 版本

2023 年 9 月 6 日

發布 androidx.compose.runtime:runtime-*:1.5.1。1.5.1 版包含以下修訂項目。

1.5.0 版本

2023 年 8 月 9 日

發布 androidx.compose.runtime:runtime-*:1.5.0。1.5.0 版包含此連結所列的修訂項目。

API 變更

  • 移除了重組、顏色動畫和 AndroidComposeView 中的配置。(Ib2bfa)。
  • 已新增 @StateFactoryMarker 註解，以標記建立狀態且必須納入 remember 呼叫的函式。(I64550)。
  • 新增 State 和 MutableState 的基本版本 (fb3d89)
  • 新增了 Snapshot.isApplyObserverNotificationPending (I672a5)
  • 新增了 State API 的原始版本，以便在 State 物件中追蹤 Int、Long、Float 和 Double 值，而不會產生自動加上黑邊的懲處。請使用新的工廠方法 mutableIntState(Int)、mutableFloatStateOf(Float) 等，以便使用這些方法。(I48e43)。

修正錯誤

  • 略過要移除的子組合的重組作業。(Ieeb99、b/254645321)
  • 不要在 ComposerImpl 中保留快照參照 (0206f7)
  • 請勿重複套用樂曲 (f5791b)
  • 確保未初始化的衍生狀態值無效 (aa2a92)
  • 在組合處理期間呼叫 onEndChanges。(62cc8c)。
  • 修正將內容移至子組合的問題 (4beb41)
  • 修正潛在的死結 (c1a425 和 8edce0)
  • 為 Android 視窗建立的重組工具現在只會在收到 ON_STOP 通知時封鎖對 withFrameNanos 的呼叫，而非所有組合。這表示與已停止的活動相關聯的視窗會繼續針對資料變更重組，但動畫或任何其他 withFrameNanos 呼叫端都會遭到封鎖。(Id9e7f、b/240975572)
  • 先針對 LayoutNode 執行停用回呼，再處理效果 3784073
  • 修正已重新啟動 lambda 的變更標記 ea81df9
  • 修正含有節點 73fd4d8 可組合項的即時編輯迴歸問題
  • ON_STOP 應暫停影格時鐘廣播，而非組合 ae276f1
  • 針對未變更的衍生狀態撤銷 SnapshotStateObserver 範圍 84d9b1c
  • 修正在處理組合時可能發生的死結 28761fc
  • 修正將內容移至子組合 92d4156 的問題
  • 修正已重新啟動 lambda 的變更標記 (8a03e9)
  • 先針對 LayoutNode 執行停用回呼，再處理效果 (8b0fa4)
  • 修正結束節點群組時修正 endToMarker() 的問題。(d71d980)。
  • 使用目前的 SlotWriter 群組檢查停用情形 (a0b518b)
  • 移除 SlotTable.moveSlotGapTo() 中的 fill，然後移動到關閉 (81f9935)
  • 修正移動式內容時缺少的無效問題 (1d7c024)
  • 修正移動式可移動內容立即失效的問題 (8676618)

效能提升

  • 如未修改快照，請避免計算 DerivedState 中的 readableHash。(307102)。
  • 減少配置 (I65c09、d7ea77、727974 和 445808)
  • 快速取消撰寫 CoroutineScopes (a55362 和 bd382f)
  • 使用無法存取狀態記錄覆寫狀態物件記錄 (c986960)
  • 實現群組時，使用正確範圍的編輯器 (9a5e5b6)
  • 使用 IdentityArraySet 儲存快照撤銷 (7f60cca)
  • 減少快照觀察的配置 (5bc535f)

1.5.0-rc01 版

2023 年 7 月 26 日

發布 androidx.compose.runtime:runtime-*:1.5.0-rc01。1.5.0-rc01 版包含此連結所列的修訂項目。

修正錯誤

  • 延後重新讀取衍生狀態，直到記錄變更為止 (f38099)

  • 進行選用檢查，將 mutableStateOf() 呼叫遷移至其對應基元的相應特殊類型。其 Lint ID 為 AutoboxingStateCreation。先前所有專案均預設啟用這項檢查功能。如要在 Android Studio 編輯器和專案的 Lint 輸出內容中看到這項警告，請在模組的 build.gradle 或 build.gradle.kts 設定中宣告 warning "AutoboxingStateCreation" (I34f7e)，將嚴重性從資訊變更為警告 (或更高)：

        android {
        lint {
            warning "AutoboxingStateCreation"
        }
        ...
    }

1.5.0-beta03 版

2023 年 6 月 28 日

發布 androidx.compose.runtime:runtime-*:1.5.0-beta03。1.5.0-beta03 版包含以下修訂項目。

修正錯誤

1.5.0-beta02 版

2023 年 6 月 7 日

發布 androidx.compose.runtime:runtime-*:1.5.0-beta02。1.5.0-beta02 版包含以下修訂項目。

效能提升

  • 如未修改快照，請避免計算 DerivedState 中的 readableHash。(307102)。

1.5.0-beta01 版

2023 年 5 月 24 日

發布 androidx.compose.runtime:runtime-*:1.5.0-beta01。1.5.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • 移除了重組、顏色動畫和 AndroidComposeView 中的配置 (Ib2bfa)
  • 已新增 @StateFactoryMarker 註解，以標記建立狀態且必須納入 remember 呼叫的函式。(I64550)。
  • 新增 State 和 MutableState 的基本版本 (fb3d89)
  • 新增了 Snapshot.isApplyObserverNotificationPending (I672a5)

修正錯誤

  • 減少配置 (I65c09、d7ea77、727974 和 445808)
  • 不要在 ComposerImpl 中保留快照參照 (0206f7)
  • 快速取消撰寫 CoroutineScopes (a55362 和 bd382f)
  • 請勿重複套用樂曲 (f5791b)
  • 確保未初始化的衍生狀態值無效 (aa2a92)
  • 在組合處理期間呼叫 onEndChanges。(62cc8c)。
  • 修正將內容移至子組合的問題 (4beb41)
  • 修正潛在的死結 (c1a425)
  • ON_STOP 應暫停影格時鐘廣播，而非組合 (f4a2d1)
  • 修正已重新啟動 lambda 的變更標記 (8a03e9)
  • 先針對 LayoutNode 執行停用回呼，再處理效果 (8b0fa4)

外部貢獻

  • 新增了 Snapshot.isApplyObserverNotificationPending (I672a5)

1.5.0-alpha04 版

2023 年 5 月 10 日

發布 androidx.compose.runtime:runtime-*:1.5.0-alpha04。1.5.0-alpha04 版包含以下修訂項目。

API 變更

  • 新增了 State API 的原始版本，以便在 State 物件中追蹤 Int、Long、Float 和 Double 值，而不會產生自動加上黑邊的懲處。請使用新的工廠方法 mutableIntState(Int)、mutableFloatStateOf(Float) 等，以便使用這些方法。(I48e43)。

修正錯誤

  • 在組合處理期間呼叫 onEndChanges。在 Composition.dispose 期間移除的焦點節點會訂閱 onEndChanges 來重設焦點 (03d4a47)。

  • 確保未初始化的衍生狀態值失效。每個衍生狀態都會與 SnapshotStateObserver 中的依附元件清單建立關聯，每當依附元件變更時，系統就會用來撤銷與衍生狀態相關聯的範圍。依附元件變更會登錄於快照上，而快照作業可能會在衍生狀態讀取 (因為呼叫 Snapshot.notifyObjectsInitialized()) 之後發生。

    SnapshotStateObserver 中先前的衍生狀態觀察邏輯是清除舊依附元件，然後讀取新值。這會導致競爭狀況發生在已清除狀態，未登錄依附元件撤銷狀態。

    這項變更會重新排序衍生的狀態讀取和依附元件清理作業，確保撤銷作業一律在有效狀態下發生。(c472be6)。

1.5.0-alpha03 版

2023 年 4 月 19 日

發布 androidx.compose.runtime:runtime-*:1.5.0-alpha03。1.5.0-alpha03 版包含以下修訂項目。

API 變更

  • 為 Android 視窗建立的重組工具現在只會在收到 ON_STOP 通知時封鎖對 withFrameNanos 的呼叫，而非所有組合。這表示與已停止的活動相關聯的視窗會繼續針對資料變更重組，但動畫或任何其他 withFrameNanos 呼叫端都會遭到封鎖。(Id9e7f、b/240975572)

修正錯誤

  • 修正快照清單和地圖 5c1a425 中可能的死結問題
  • 先針對 LayoutNode 執行停用回呼，再處理效果 3784073
  • 修正已重新啟動 lambda 的變更標記 ea81df9
  • 修正含有節點 73fd4d8 可組合項的即時編輯迴歸問題
  • ON_STOP 應暫停影格時鐘廣播，而非組合 ae276f1
  • 針對未變更的衍生狀態撤銷 SnapshotStateObserver 範圍 84d9b1c
  • 修正在處理組合時可能發生的死結 28761fc
  • 修正將內容移至子組合 92d4156 的問題

1.5.0-alpha02 版

2023 年 4 月 5 日

發布 androidx.compose.runtime:runtime-*:1.5.0-alpha02。1.5.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • Kotlin 的 getValue 運算子現在為可組合元件 (f174f6e)

修正錯誤、提升效能

  • 使用無法存取狀態記錄覆寫狀態物件記錄 (c986960)
  • 實現群組時，使用正確範圍的編輯器 (9a5e5b6)
  • 修正結束節點群組時修正 endToMarker() 的問題。(d71d980)。
  • 使用目前的 SlotWriter 群組檢查停用情形 (a0b518b)
  • 使用 IdentityArraySet 儲存快照撤銷 (7f60cca)
  • 移除 SlotTable.moveSlotGapTo() 中的 fill，然後移動到關閉 (81f9935)
  • 修正移動式內容時缺少的無效問題 (1d7c024)
  • 修正移動式可移動內容立即失效的問題 (8676618)
  • 減少快照觀察的配置 (5bc535f)

1.5.0-alpha01 版本

2023 年 3 月 22 日

發布 androidx.compose.runtime:runtime-*:1.5.0-alpha01。1.5.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 新增 Modifier.Node#coroutineScope，允許 Modifier.Nodes 啟動協同程式 (I76ef9)
  • 實作 CompositionLocalConsumerModifierNode 介面，允許 Modifier.Nodes 讀取 CompositionLocals。(Ib44df)。

1.4 版

1.4.3 版本

2023 年 5 月 3 日

androidx.compose.runtime:runtime-*:1.4.3 發布，內容無變更。

1.4.2 版

2023 年 4 月 19 日

發布 androidx.compose.runtime:runtime-*:1.4.2。1.4.2 版本包含這些修訂版本。

修正錯誤

  • 修正快照清單和地圖 2eb6570 中可能發生的死結問題

  • 如果修改作業與直接寫入狀態記錄並行，在 SnapshotStateList 或 SnapshotStateMap 中新增內容可能會發生死結。這項變更更容易遭受 93fcae828b 所導入的變更，利用直接寫入來釋出未使用的記錄。

  • 鎖定現在會按照順序，在地圖或清單鎖定啟用時，系統永遠不會嘗試鎖定快照鎖定。

1.4.1 版本

2023 年 4 月 5 日

發布 androidx.compose.runtime:runtime-*:1.4.1。1.4.1 版本包含這些修訂版本。

修正錯誤

  • 修正結束節點群組時修正 endToMarker() 的問題。d71d980

1.4.0 版本

2023 年 3 月 22 日

發布 androidx.compose.runtime:runtime-*:1.4.0。1.4.0 版包含此連結所列的修訂項目。

自 1.3.0 版以來的重要異動

  • 針對第一個組合使用 LiveData 的初始化值 3680e25
  • 新增 ComposeNodeLifecycleCallback 以觀察 Compose 節點的生命週期。8b6a258
  • 在 ComposableMethod 7b6c7ad 中新增 parameterTypes 屬性

錯誤修正與效能提升

  • 清除 SnapshotStateObserver 中的兩個範圍索引 29f4a3e
  • 在不可略過的 lambda 主體中新增所需的群組 7d06752
  • 改善快照狀態 93fcae8 的記憶體參照特性
  • 移除本機查詢中的拳擊 0875717
  • 為不可重複使用的節點群組 (6388d8d) 使用正確的金鑰
  • 保護 SnapshotStateObserver 避免遞迴和並行套用 98cb6ba
  • 在 IdentityArraySet「get」中新增檢查索引邊界檢查方法 35a77d3
  • 更新 Compose 模組以使用 ViewTreeLifecycleOwner 擴充功能 21c2122
  • 在重組工具完成影格後傳送套用通知。98f2641
  • 修正取消重組工具時造成索引當機的問題 8f8656f
  • 如果 Composition 的父項提供者已變更 9526fcc，則一律強制重組
  • 取消工作容忍度 a55f7ed
  • 改善對大量作曲家的無效處理問題 9b7ed67
  • 修正為非本機回傳內容產生結尾群組的問題 b6f590c

1.4.0-rc01 版本

2023 年 3 月 8 日

發布 androidx.compose.runtime:runtime-*:1.4.0-rc01。1.4.0-rc01 版包含此連結所列的修訂項目。

修正錯誤

1.4.0-beta02 版本

2023 年 2 月 22 日

發布 androidx.compose.runtime:runtime:1.4.0-beta02 和 androidx.compose.runtime:runtime-saveable:1.4.0-beta02。1.4.0-beta02 版包含以下修訂項目。

1.4.0-beta01 版本

2023 年 2 月 8 日

發布 androidx.compose.runtime:runtime-*:1.4.0-beta01。1.4.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • 新增 ComposeNodeLifecycleCallback，用於觀察 Compose 節點的生命週期 (I3731b)
  • 將 @TestOnly 新增至 Composer.disableSourceInformation()，因為後者只有在測試中呼叫才安全。(I896c8)

修正錯誤

  • 移除組合本機查詢中的 Box (62f66a)
  • 改善快照狀態的記憶體參照特性 (dfb451)

1.4.0-alpha05 版本

2023 年 1 月 25 日

發布 androidx.compose.runtime:runtime:1.4.0-alpha05 和 androidx.compose.runtime:runtime-saveable:1.4.0-alpha05。1.4.0-alpha05 版包含此連結所列的修訂項目。

API 變更

  • 針對內嵌/已淘汰並隱藏的函式提供更多類型/是否可為空值選項 (I24f91)

1.4.0-alpha04 版

2023 年 1 月 11 日

發布了 androidx.compose.runtime:runtime-*:1.4.0-alpha04。1.4.0-alpha04 版包含此連結所列的修訂項目。

API 變更

  • TestMonotonicFrameClock 現在採用正確的實驗性註解。(I95c9e)

修正錯誤

  • 避免 SnapshotStateObserver 套用遞迴和並行元素 (d902fb)

1.4.0-alpha03 版

2022 年 12 月 7 日

發布 androidx.compose.runtime:runtime-*:1.4.0-alpha03。1.4.0-alpha03 版包含此連結所列的修訂項目。

API 變更

  • 在 ComposableMethod 類別中新增公開方法，類似於 java.lang.reflect.Method#getParameterTypes() (Iab0c3)

修正錯誤

  • 現在，Recomposer 套用變更之後，系統即會傳送快照套用通知 (Iad6c0、b/222093277)

1.4.0-alpha02 版

2022 年 11 月 9 日

發布 androidx.compose.runtime:runtime-*:1.4.0-alpha02。1.4.0-alpha02 版包含此連結所列的修訂項目。

1.4.0-alpha01 版

2022 年 10 月 24 日

發布 androidx.compose.runtime:runtime-*:1.4.0-alpha01。查看 1.4.0-alpha01 版的修訂項目。

API 變更

  • SnapshotStateList 和 SnapshotStateMap 現已分別採用 toList() 和 toMap() 的明確實作。這些方法在傳回儲存內容所需的內部不可變動資料時，會傳回目前的內容，且不會執行副本。例如，這個值可用於使用 snapshotFlow 產生值的流程，而不必複製資料 (Ica2bd)

1.3 版

1.3.3 版

2023 年 1 月 11 日

發布 androidx.compose.runtime:runtime-*:1.3.3。1.3.3 版包含此連結所列的修訂項目。

  • 自 1.3.2 以來沒有變更

1.3.2 版

2022 年 12 月 7 日

發布了 androidx.compose.runtime:runtime-*:1.3.2。1.3.2 版包含此連結所列的修訂項目。

修正錯誤

  • 已更新為可支援 androidx.compose.ui 1.3.2

1.3.1 版

2022 年 11 月 9 日

發布 androidx.compose.runtime:runtime-*:1.3.1。1.3.1 版包含此連結所列的修訂項目。

1.3.0 版

2022 年 10 月 24 日

發布 androidx.compose.runtime:runtime-*:1.3.0。1.3.0 版包含此連結所列的修訂項目。

自 1.2.0 版以來的重要變更

例外狀況處理/即時編輯支援

組合追蹤

可組合反射 API

執行階段修正

快照系統

1.3.0-rc01 版

2022 年 10 月 5 日

發布 androidx.compose.runtime:runtime-*:1.3.0-rc01。1.3.0-rc01 版包含此連結所列的修訂項目。

修正錯誤

  • 已修正來自運算單元資料表的 ArrayIndexOutOfBoundsException (b/249076084)

1.3.0-beta03 版

2022 年 9 月 21 日

發布 androidx.compose.runtime:runtime-*:1.3.0-beta03。1.3.0-beta03 版包含此連結所列的修訂項目。

行為破壞性變更

  • remember 和 rememberCoroutineScope 的參數，已變更為 crossinline。這樣會回報早期傳回錯誤，而不是允許提前回報，從而導致稍後回報內部錯誤。
  • 這項變更可能會導致系統回報新的編譯器錯誤，亦即需要從傳遞至這些函式的 lambda 中移除非本機回傳 (Ibea62)

1.3.0-beta02 版

2022 年 9 月 7 日

發布 androidx.compose.runtime:runtime-*:1.3.0-beta02。1.3.0-beta02 版包含此連結所列的修訂項目。

修正錯誤

1.3.0-beta01 版

2022 年 8 月 24 日

發布了 androidx.compose.runtime:runtime-*:1.3.0-beta01。1.3.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • 在 CompositionData 中新增 find 方法，讓使用這個 API 的開發人員工具能利用組合 ID，快速找出組合的子群組 (I5794f)。

1.3.0-alpha03 版

2022 年 8 月 10 日

發布 androidx.compose.runtime:runtime-*:1.3.0-alpha03。1.3.0-alpha03 版包含此連結所列的修訂項目。

1.3.0-alpha02 版

2022 年 7 月 27 日

發布 androidx.compose.runtime:runtime-*:1.3.0-alpha02。查看 1.3.0-alpha02 版的修訂項。

API 變更

  • 重新加回 ComposerKt.traceEventStart(Int, String) (I6e6de) 以確保回溯相容性

1.3.0-alpha01 版

2022 年 6 月 29 日

發布 androidx.compose.runtime:runtime-*:1.3.0-alpha01。查看 1.3.0-alpha01 版的修訂項目。

API 變更

  • 將公用程式功能移至執行階段 (I4f729)

1.2 版

1.2.1 版本

2022 年 8 月 10 日

發布 androidx.compose.runtime:runtime-*:1.2.1。查看 1.2.1 版的修訂項目。

修正錯誤

  • 修正記憶體流失問題：處置從透明數據匯報建立的巢狀數據匯報 b/239603305

1.2.0 版

2022 年 7 月 27 日

發布 androidx.compose.runtime:runtime-*:1.2.0。1.2.0 版包含此連結所列的修訂項目。

自 1.1.0 以來的重要異動

  • Compose Runtime 在 1.2.0 中引入了一些功能，另外還有許多穩定的錯誤修正。最重要的新功能是引入 movableContentOf API，此 API 可用於啟用複雜的使用者體驗，例如：共用元素轉換。movableContentOf API 可將可組合 lambda 轉換為另一種 lambda，後者會將其狀態和對應的節點移至呼叫的新位置。如果先前的呼叫離開組合，狀態會暫時保留，如果對 lambda 的新呼叫進入組合，狀態和相關聯的節點就會移至新呼叫的位置。如沒有加入新呼叫，系統會永久移除對應的狀態。同時觀察器會收到相關通知。

  • 如果在相同組合中多次呼叫 movableContentOf lambda，系統會為每個呼叫建立新的狀態和節點，當呼叫離開組合，而新的呼叫進入時，系統會依照呼叫的順序，將狀態從第一個離開的呼叫移至進入的呼叫。所有未由新呼叫宣告的狀態都會永久移除。

  • 除此之外，還有一些其他新的功能，而我們也主要著重在穩定執行階段和快照模式狀態系統上。許多記憶體流失的問題皆已移除，且程式碼路徑也已經最佳化。

  • 相關異動摘要清單如下：

1.2 的新功能

1.2 中的效能

1.2 中的錯誤錯誤

1.2.0-rc03 版

2022 年 6 月 29 日

發布 androidx.compose.runtime:runtime-*:1.2.0-rc03。1.2.0-rc03 版包含此連結所列的修訂項目。

修正錯誤

  • 系統先前會一律將衍生狀態觀察作業，同時從重組範圍和組合作業中移除，以致損壞其他可能仍在觀察衍生狀態的範圍。這項變更讓系統只會在其他範圍不再觀察衍生狀態執行個體的情況下加以移除。(b/236618362)

1.2.0-rc02 版

2022 年 6 月 22 日

發布 androidx.compose.runtime:runtime-*:1.2.0-rc02。查看 1.2.0-rc02 版的修訂項目。

1.2.0-rc01 版

2022 年 6 月 15 日

發布 androidx.compose.runtime:runtime-*:1.2.0-rc01。查看 1.2.0-rc01 版的修訂項目。

API 變更

  • Compose 程式庫中的介面現已使用 jdk8 預設介面方法建立 (I5bcf1)

1.2.0-beta03 版

2022 年 6 月 1 日

發布 androidx.compose.runtime:runtime-*:1.2.0-beta03。1.2.0-beta03 版包含此連結所列的修訂項目。

1.2.0-beta02 版

2022 年 5 月 18 日

發布 androidx.compose.runtime:runtime-*:1.2.0-beta02。1.2.0-beta02 版包含此連結所列的修訂項目。

1.2.0-beta01 版

2022 年 5 月 11 日

發布 androidx.compose.runtime:runtime-*:1.2.0-beta01。查看 1.2.0-beta01 版的修訂項目。

新功能

  • 這是 1.2 版的第一個 Beta 版！

API 變更

  • 新增了實驗性 Snapshot.unsafeEnter/unsafeLeave (I108f3)
  • 新增了實驗性 Snapshot.asContextElement() API (Iff072)
  • @ComposableTargetMarker 註解和標示 @ComposableTarget 的註解現在可藉由加上 @file 前綴，於檔案範圍使用。如果在檔案範圍使用目標註解，編譯器將假設檔案中的所有可組合函式都是用來指定相關 Applier。舉例來說，使用 @file:UiComposable 即等同於宣告所有 @Composable 函式皆指定 Compose UI Applier。如果函式需要指定其他套用器，必須針對想指定的套用器明確提供目標標記註解 (I40804)。

1.2.0-alpha08 版

2022 年 4 月 20 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha08。查看 1.2.0-alpha08 版的修訂項。

API 變更

  • 將 TracingInProgress 新增至 CompositionTracer 介面 (Ic6f12)
  • 將 recomposeScopeIdentity 新增至 Composer (I0c873)
  • 將追蹤 API (Composer.setTracer) 限制為 OptIn(InternalComposeTracingApi)。(I9187f)
  • 新增了 ResuableContentHost，讓您進一步控制為可重複使用的內容所建立的狀態生命週期。舉例來說，如果子組合暫時未處於使用狀態，系統可能會停用內容，導致忘記觸發該組合中所有已記住的狀態，例如所有可處理的效應。(I2c0f2、b/220322704)

1.2.0-alpha07 版

2022 年 4 月 6 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha07。查看 1.2.0-alpha07 版的修訂項。

API 變更

  • 新增 Snapshot.withoutReadObservation { ... } 函式。使用者可以透過該函式執行傳遞的 lambda，而無需訂閱在這個區塊中讀取的狀態值變更。如果您想利用以快照為基礎的安全執行緒寫入/讀取作業來提高成效，同時希望能夠在不造成不必要重組或重新測量的情況下讀取這個值，這項變更就非常實用。(I9f365、b/214054486)

1.2.0-alpha06 版

2022 年 3 月 23 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha06。1.2.0-alpha06 版包含此連結所列的修訂項目。

1.2.0-alpha05 版

2022 年 3 月 9 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha05。1.2.0-alpha05 版包含此連結所列的修訂項目。

外部貢獻

  • 已更新為使用 Kotlinx 協同程式 1.6.0 (I3366d)

1.2.0-alpha04 版

2022 年 2 月 23 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha04。查看 1.2.0-alpha04 版的修訂項。

API 變更

  • 新增了 ComposableTarget、ComposableTargetMarker 和 ComposableOpenTarget，這樣如果所呼叫的可組合函式指定了不適用的 Applier，就能在編譯時回報。

    在多數情況下，Compose 編譯器外掛程式能夠推論出註解，因此直接使用這些註解的情形應該相當罕見。無法推論的案例包括建立及使用自訂 Applier、抽象的可組合函式 (例如介面方法)、欄位，或是屬可組合 lambda 的全域變數 (本機變數和參數為推論得出)，或在使用 ComposeNode 或相關的可組合函式時。

    對於自訂 Applier，呼叫 ComposeNode 或 ReusableComposeNode 的可組合函式需要為函式和任何可組合的 lambda 參數類型新增 CompoableTarget 註解。不過，與其直接使用 ComposableTarget，建議您建立以 ComposableTargetMarker 加上註解的註解，再使用已標示的註解。使用 ComposableTargetMarker 加上標示的可組合註解，等同於使用屬性類別完整名稱做為套用器參數的 ComposbleTarget。如需 ComposableTargetMarker 的使用範例，請參閱 anroidx.compose.ui.UiComposable。(I38f11)

1.2.0-alpha03 版

2022 年 2 月 9 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha03。查看 1.2.0-alpha03 版的修訂項。

API 變更

  • 新增了 movableContentOf，用於將可組合 lambda 轉換為另一種 lambda，後者會將其狀態和對應的節移至呼叫它的新位置。如果先前的呼叫離開組合，狀態會暫時保留，如果對 lambda 的新呼叫進入組合，狀態和相關聯的節點就會移至新呼叫的位置。如未新增新呼叫，系統會永久移除對應的狀態。同時別忘了，觀察器會收到相關通知。

    如果在相同組合中多次呼叫 movableContentOf lambda，系統會為每個呼叫建立新的狀態和節點。隨著呼叫退出組合及新呼叫進入組合，系統會按照呼叫順序，將對應的狀態從第一個退出的呼叫移至隨後進入的呼叫。新呼叫未宣告的所有狀態都會永久移除 (Ib4850)。

  • 新增了追蹤 API 至組合，允許工具提供更詳細的可組合項功能追蹤。編譯器現在會產生追蹤 API (包含來源資訊) 的呼叫。(Ib0eb5)

    如要從發布子版本移除這些呼叫及相關聯的來源資訊，請加入以下 Proguard 規則：

      -assumenosideeffects public class androidx.compose.runtime.ComposerKt {
      boolean isTraceInProgress();
      void traceEventStart(int,java.lang.String);
      void traceEventEnd();
  }

  • 加入 InternalComposeScope，讓工具可以在重組期間辨識可組合項。(I07a3f)

1.2.0-alpha02 版

2022 年 1 月 26 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha02。1.2.0-alpha02 版包含此連結所列的修訂項目。

1.2.0-alpha01 版

2022 年 1 月 12 日

發布 androidx.compose.runtime:runtime-*:1.2.0-alpha01。查看 1.2.0-alpha01 版的修訂項。

API 變更

  • 將 identity 欄位新增至 CompositionData，以便在版面配置檢查器中產生不變的 ID。(Ic116e)

依附元件更新

  • 現在依附於 Kotlin 1.6.10。

1.1 版

1.1.1 版

2022 年 2 月 23 日

發布 androidx.compose.runtime:runtime-*:1.1.1。1.1.1 版包含此連結所列的修訂項目。

修正錯誤

1.1.0 版

2022 年 2 月 9 日

發布 androidx.compose.runtime:runtime-*:1.1.0。查看 1.1.0 版的修訂項。

自 1.0.0 版以來的重要變更

  • 穩定支援 Android 12 的過度捲動效果
  • 改善觸控目標縮放功能
  • 請注意，為配合 Compose 1.0，Material Design 元件會擴大版面配置空間，以符合 Material Design 針對觸控目標尺寸所制訂的無障礙功能準則。舉例來說，即使您將觸控目標按鈕的尺寸設定為小於最小尺寸 48x48dp，系統仍會將按鈕擴大為這個尺寸。這樣一來，Compose Material 的行為就會與 Material Design 元件相同，在混用 Views 和 Compose 時便可確保行為一致。利用 Compose Material 元件建立使用者介面時，這項異動還能確保達到觸控目標無障礙功能的最低要求。
  • 穩定支援導覽邊欄
  • 將先前推出的一些實驗性 API 升級為穩定版
  • 支援更新版本的 Kotlin

1.1.0-rc03 版

2022 年 1 月 26 日

發布 androidx.compose.runtime:runtime-*:1.1.0-rc03。1.1.0-rc03 版包含此連結所列的修訂項目。

修正錯誤

  • 更新以支援 Compose Material 1.1.0-rc03

1.1.0-rc01 版

2021 年 12 月 15 日

發布 androidx.compose.runtime:runtime-*:1.1.0-rc01。1.1.0-rc01 版包含此連結所列的修訂項目。

1.1.0-beta04 版

2021 年 12 月 1 日

發布 androidx.compose.runtime:runtime-*:1.1.0-beta04。查看 1.1.0-beta04 版的修訂項。

新功能

  • 更新為可與 Kotlin 1.6.0 相容

1.1.0-beta03 版

2021 年 11 月 17 日

發布 androidx.compose.runtime:runtime-*:1.1.0-beta03。1.1.0-beta03 版包含此連結所列的修訂項目。

1.1.0-beta02 版

2021 年 11 月 3 日

發布 androidx.compose.runtime:runtime-*:1.1.0-beta02。查看 1.1.0-beta02 版的修訂項。

API 變更

  • 快照模式程式碼過去分割成多個檔案，但仍位於相同的 JVM 類別中。(Ic6c98)

1.1.0-beta01 版

2021 年 10 月 27 日

發布 androidx.compose.runtime:runtime-*:1.1.0-beta01。1.1.0-beta01 版包含此連結所列的修訂項目。

1.1.0-alpha06 版

2021 年 10 月 13 日

發布 androidx.compose.runtime:runtime-*:1.1.0-alpha06。查看 1.1.0-alpha06 版的修訂項。

API 變更

  • 從必須跨模組呼叫的 Composer 方法中移除 InternalCompilerApi (I1aa0b)
  • Recomposer.state 已被淘汰，並由 Recomposer.currentState 取代，以便將其類型變更為 StateFlow (Ic2ab3、b/197773820)

1.1.0-alpha05 版

2021 年 9 月 29 日

發布 androidx.compose.runtime:runtime-*:1.1.0-alpha05。1.1.0-alpha05 版包含此連結所列的修訂項目。

1.1.0-alpha04 版

2021 年 9 月 15 日

發布 androidx.compose.runtime:runtime-*:1.1.0-alpha04。1.1.0-alpha04 版包含此連結所列的修訂項目。

1.1.0-alpha03 版

2021 年 9 月 1 日

發布 androidx.compose.runtime:runtime-*:1.1.0-alpha03。1.1.0-alpha03 版包含此連結所列的修訂項目。

新功能

  • Compose Compiler 現在支援舊版的 Compose Runtime (1.0)。在這項變更之前，Compose Compiler 只能與相同或後續版本的 Compose Runtime 相容。這項變更生效後，Compose Compiler 就能與舊版的 Compose Runtime (1.0) 相容 (aosp/1796968)
  • 已更新 Compose 1.1.0-alpha03，使其依附 Kotlin 1.5.30。(I74545)

1.1.0-alpha02 版

2021 年 8 月 18 日

發布 androidx.compose.runtime:runtime-*:1.1.0-alpha02。1.1.0-alpha02 版包含此連結所列的修訂項目。

1.1.0-alpha01 版

2021 年 8 月 4 日

發布 androidx.compose.runtime:runtime-*:1.1.0-alpha01。1.1.0-alpha01 版包含此連結所列的修訂項目。

1.0 版

1.0.5 版

2021 年 11 月 3 日

發布 androidx.compose.runtime:runtime-*:1.0.5。1.0.5 版包含此連結所列的修訂項目。

修正錯誤

  • 修正追蹤 derivedStateOf 例項時的異常終止問題 (aosp/1792247)。

1.0.4 版

2021 年 10 月 13 日

發布 androidx.compose.runtime:runtime-*:1.0.4。1.0.4 版包含此連結所列的修訂項目。

依附元件更新

  • 已更新為依附 Kotlin 1.5.31

1.0.3 版

2021 年 9 月 29 日

發布 androidx.compose.runtime:runtime-*:1.0.3。1.0.3 版包含此連結所列的修訂項目。

依附元件更新

  • 已更新為依附 Kotlin 1.5.30

1.0.2 版

2021 年 9 月 1 日

發布 androidx.compose.runtime:runtime-*:1.0.2。1.0.2 版包含此連結所列的修訂項目。

更新為支援 Compose 1.0.2 版。Compose 1.0.2 仍與 Kotlin 1.5.21 相容。

1.0.1 版

2021 年 8 月 4 日

發布 androidx.compose.runtime:runtime-*:1.0.1。1.0.1 版包含此連結所列的修訂項目。

依附元件更新

  • 已更新為依附 Kotlin 1.5.21。

1.0.0 版

2021 年 7 月 28 日

發布 androidx.compose.runtime:runtime-*:1.0.0。1.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

這是 Compose 的第一個穩定版本。如需詳細資訊，請參閱官方的 Compose Release 網誌！

已知問題

  • 如果使用的是 Android Studio Bumblebee Canary 4 或 AGP 7.1.0-alpha04/7.1.0-alpha05，則可能會遇到下列當機情形：

      java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"

    如需修正這個問題，請暫時將 build.gradle 檔案中的 minSdkVersion 提高到 24 以上。Android Studio Bumblebee 和 AGP 7.1 的下一個版本會修正這個問題 (b/194289155)

1.0.0-rc02 版

2021 年 7 月 14 日

發布 androidx.compose.runtime:runtime-*:1.0.0-rc02。1.0.0-rc02 版包含此連結所列的修訂項目。

  • 修正 SnapshotStateObserver 會造成突發 NullPointerExceptions 的競爭狀況問題。(aosp/1763445、aosp/1758105、b/192677711)。
  • 已修正導致 java.lang.IllegalStateException: Reading a state that was created after the snapshot was taken or in a snapshot that has not yet been applied 當機的執行階段快照問題。(b/193006595、b/192570897)

1.0.0-rc01 版

2021 年 7 月 1 日

發布 androidx.compose.runtime:runtime-*:1.0.0-rc01。1.0.0-rc01 版包含此連結所列的修訂項目。

1.0.0-beta09 版

2021 年 6 月 16 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta09。1.0.0-beta09 版包含此連結所列的修訂項目。

新增的設定檔規則

這個版本將設定檔規則新增至下列撰寫模組 (I14ed6)：

  • androidx.compose.animation
  • androidx.compose.animation-core
  • androidx.compose.foundation
  • androidx.compose.foundation-layout
  • androidx.compose.material
  • androidx.compose.material-ripple
  • androidx.compose.runtime
  • androidx.compose.ui
  • androidx.compose.ui.geometry
  • androidx.compose.ui.graphics
  • androidx.compose.ui.text
  • androidx.compose.ui.text
  • androidx.compose.ui.unit
  • androidx.compose.ui.util

什麼是設定檔規則？

  • 程式庫的設定檔規則在位於 src/main 或同等目錄中的文字檔 baseline-prof.txt 內進行指定。該檔案會每行指定一個規則，這裡的規則是指對應至程式庫方法或類別的模式。這些規則所用語法是人類可讀形式的 ART 設定檔格式的超集，使用 adb shell profman --dump-classes-and-methods ... 時會用到這類格式。這些規則會採用兩種形式之一來指定方法或類別。

  • 方法規則將採用以下模式：

    <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>

  • 類別規則將採用以下模式：

    <CLASS_DESCRIPTOR>

  • 此處的 <FLAGS> 是 H、S 和 P 之中的一或多個字元，用於指出這個方法應標記為「Hot」、「Startup」或「Post Startup」。

  • <CLASS_DESCRIPTOR> 是指定方法所屬的類別描述元。舉例來說，androidx.compose.runtime.SlotTable 類別的描述元是 Landroidx/compose/runtime/SlotTable;。

  • <METHOD_SIGNATURE> 是方法的簽名，含有該方法的名稱、參數類型和傳回類型。舉例來說，LayoutNode 上的 fun isPlaced(): Boolean 方法含有 isPlaced()Z 簽名。

  • 這些模式可包含萬用字元 (**、* 和 ?)，以便讓單一規則涵蓋多種方法或類別。

規則的用途

  • 方法中如果帶有 H 標記，表示這個方法是「Hot」方法，應該預先完成編譯。

  • 方法中如果帶有 S 標記，表示這是系統會在啟動時呼叫的方法，應該預先完成編譯，以免啟動時耗費資源處理編譯作業及解析方法。

  • 方法中如果帶有 P 標記，表示這是系統在啟動之後才會呼叫的方法。

  • 如果類別顯示在這個檔案中，表示系統會在啟動期間使用該類別，因此應該要事先在堆積中分配該類別，以免耗費載入類別的成本。

運作方式

  • 程式庫可以定義這些規則，並會包裝於 AAR 構件中。接著，系統會在建構包含這些構件的應用程式時，將這些規則合併起來，然後使用合併後的規則建構該應用程式專屬的精簡二進位 ART 設定檔。當該應用程式安裝在裝置上時，ART 便可以利用這個設定檔預先編譯特定應用程式子集，以提高應用程式效能，特別是首次執行的效能。請注意，這項設定不會對可偵錯的應用程式產生任何影響。

1.0.0-beta08 版

2021 年 6 月 2 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta08。1.0.0-beta08 版包含此連結所列的修訂項目。

API 變更

  • State<T> 現在是 State<out T> (I69049)
  • ControlledComposition API 變更為允許在重組單一傳遞中重組變更。(Iaafd1、b/184173932)。

1.0.0-beta07 版

2021 年 5 月 18 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta07。1.0.0-beta07 版包含此連結所列的修訂項目。

API 變更

  • 已加入新的 Compose 編譯器 API，讓編譯器產生的來源資訊可在來源壓縮期間移除 (Ia34e6)

  • 引入 ReusableContent，這會嘗試重複使用其內容中的節點，而不是在金鑰發生變更時更換節點。金鑰變更後，除了產生的節點和用於更新節點的值之外，系統會忽略該內容運算單元資料表內先前的值。

    加入 ReusableComposeNode，這會重複使用發出的節點，而不是在 ComposeNode 完成後取代。(I1dd86)

  • @ComposeCompilerApi已不再是 @RequiresOptIn (Iab690)

修正錯誤

  • LazyColumn/Row 現在會保留最多 2 個先前顯示項目的有效狀態 (而非加以丟棄)，即使這些項目已被捲出畫面也一樣。如此一來，當我們需要組合新項目時，元件可重複使用有效的子組合，達到提升捲動效能的效果 (Ie5555)

1.0.0-beta06 版

2021 年 5 月 5 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta06。1.0.0-beta06 版包含以下修訂項目。

API 變更

  • @ComposeCompilerApi已不再是 @RequiresOptIn (Iab690)

1.0.0-beta05 版

2021 年 4 月 21 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta05。1.0.0-beta05 版包含此連結所列的修訂項目。

API 變更

  • 已移除 @InternalComposeApi，允許錄製快照讀取和寫入 (Id134d)

修正錯誤

  • ui-test-manifest 和 ui-tooling-data 中的 AndroidManifest 檔案現在與 Android 12 相容 (I6f9de、b/184718994)

1.0.0-beta04 版

2021 年 4 月 7 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta04。1.0.0-beta04 版包含此連結所列的修訂項目。

修正錯誤

  • 在這項變更之前，系統會依據對應參數略過本機可組合函式。在此變更之後，系統就不會略過任何本地可組合函數。之所以要做這樣的更改，是因為本地函數通常會擷取父項參數，而略過參數是常見的錯誤原因。

    總結來說，建議您參考以下範例：

    @Composable fun Counter(count: Int, onCountChange: (Int) -> Unit) {
  @Composable fun ShowCount() { Text("Count: $count") }
  ShowCount()
  Button(onClick={ onCountChange(count + 1) }) {
    Text("Increment")
  }
}

    在此變更之前，即使 count 參數已更新，ShowCount 可組成的函數也會一律略過。不過現在已非如此。(I5648a)

  • 修正了 rememberSaveable() 會在與輸入參數搭配使用時將舊值還原的問題 (I1b110、b/182403380)

1.0.0-beta03 版

2021 年 3 月 24 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta03。1.0.0-beta03 版包含此連結所列的修訂項目。

API 變更

  • 淘汰 DefaultMonotonicFrameClock。現在呼叫無 MonotonicFrameClock 的 withFrameNanos 或 Recomposer.runRecomposeAndApplyChanges 會擲回 IllegalStateException (I4eb0d)

1.0.0-beta02 版

2021 年 3 月 10 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta02。查看 1.0.0-beta02 版的修訂項。

修正錯誤

1.0.0-beta01 版

2021 年 2 月 24 日

發布 androidx.compose.runtime:runtime-*:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。

這是 Compose 1.0.0 Beta 版的第一個版本。

API 變更

  • 新增 Recomposer.runRecomposeConcurrentlyAndApplyChanges 實驗性 API，以在主要畫面迴圈中重組無效的組合。(I342d0)
  • 任何標記為 @ReadOnlyComposable 的可組合項現在會驗證編譯時間，確保這些可組合項只會呼叫其他 @ReadOnlyComposable (I58961)

  • compositionLocalOf 和 staticCompositionLocalOf 的 defaultFactory 現在是必要元素，而非選用元素。

    如未提供預設工廠，這項變更可移除非空值的潛在類型錯誤。以前，這會為非空值的類型提供空值的參照。

    如果是可為空值類型，請考慮提供 { null } 做為預設工廠。

    除非能提供合理的預設值，否則我們不建議搭配不可為空值類型使用本機。如果沒有任何可行的預設值，defaultFactory lambda 應擲回例外狀況。不過，擲回例外狀況代表本機取用者會有隱含的依附元件，前提是該元件不會由類型系統強制執行 (Ifbd2a)。

  • 淘汰的符號已從 Compose 執行階段中移除 (I3252c)

  • 已移除淘汰的 emptyContent()。請改用 {} (Idb33f、b/179432510)。

  • Provider 已重新命名為 CompositionLocalProvider

    • Composition 建構函式不再接受索引鍵參數，且已淘汰。
    • currentCompositeKeyHash 已變成可組合的頂層屬性，而非可組合的頂層函式。
    • CompositionData 和 CompositionGroup 已移至 androidx.compose.runtime.tooling 命名空間
    • ComposableLambda 已成為介面而非具體類別，並且不再有類型參數。
    • ComposableLambdaN 已成為介面而非具體類別，並且不再有類型參數。
    • snapshotFlow 函式已移至 androidx.compose.runtime 命名空間。
    • SnapshotMutationPolicy 的合併方法不再是實驗性功能
    • 已移除 @TestOnly 頂層 clearRoot 函式，因為不再需要使用。
    • 已移除 keySourceInfoOf 和 resetSourceInfo 函式，因為不再需要使用。
    • 已移除 Composer.collectKeySourceInformation，因為不再需要使用。
    • 已移除 isJoinedKey、joinedKeyLeft 和 joinedKeyRight 方法。因為不再需要使用。
    • 重新整理多個頂層 API，分別歸類到不同的檔案中。由於 Kotlin 的檔案類別語意的關係，此舉會破壞二進位檔案相容性，但不影響原始碼相容性，因此對大多數使用者而言應不成問題
    • (I99b7d、b/177245490)

  • SnapshotStateObserver 已不再是實驗版 (Id2e6a)

  • 刪除一些已淘汰的 API (Ice5da、b/178633932)

  • 已進行下列 Material API 變更：

    • 已將 contentPAdding 參數新增至 Top/BottomAppBar，以自訂預設邊框間距。
    • 已依據 API 指南重新調整 BackdropScaffold 中的參數順序，將必要參數置於選用參數之前。
    • 已將 BottomNavigationItem 中的 icon 參數移至 selected 和 onClick 之後。
    • 已將 BottomNavItem 中的 alwaysShowLabels 參數重新命名為 alwaysShowLabel。
    • 在幾個元件中將 bodyContent 參數重新命名為 content。
    • 已將 ButtonDefaults.buttonColors() 中的參數重新排序。請注意，由於參數類型維持不變，因此不會造成您的程式碼產生錯誤。請務必使用具名參數或是手動更新順序，否則您的程式碼將無法正常運作。
    • 已將 secondaryVariant 參數新增至 darkColors()。此顏色通常與深色主題中的 secondary 相同，但新增這個參數是為了保持一致性和進一步自訂功能。
    • 已從公用 API 介面中移除 ElevationDefaults 和 animateElevation()，因為這些項目不常用或不實用。
    • 已將 Slider 中的 onValueChangeEnd 重新命名為 onValueChangeFinished，並將該值設為可為空值。
    • 為求一致，請將 Snackbar 中的 text 參數重新命名為 content。
    • 已將 contentPadding 參數新增至 DropdownMenuItem，以自訂預設邊框間距，並將 content 設為 RowScope 的擴充功能。
    • ModalDrawerLayout 已重新命名為 ModalDrawer。
    • BottomDrawerLayout 已重新命名為 BottomDrawer。
    • (I1cc66)

1.0.0-alpha12 版

2021 年 2 月 10 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha12。1.0.0-alpha12 版包含此連結所列的修訂項目。

API 變更

  • 從 UiApplier 移除對 ViewGroup 的支援功能，並移除已淘汰的 emitView 可組合項 (Ifb214)
  • CompositionReference 已重新命名 為 CompositionContext (I53fcb)
  • ComponentActivity.setContent 已移至 androidx.activity:activity-compose 模組中的 androidx.activity.compose.setContent。(Icf416)
  • 更新 Snapshot API，使其更符合 API 規範，並隱藏公用 API 的內部實作類別。(Id9e32)
  • 重新命名 Ambients，以便符合 Ambient -> CompositionLocal 重新命名規則。Ambient 原本名為 AmbientFoo，現在已將 CompositionLocal 命名為 LocalFoo。(I2d55d)
  • 已將 Ambient 重新命名為 CompositionLocal，environmentenvironmentOf / staticAmbientOf 則重新命名為 lightLocal / staticCompositionLocalOf。此變更有助於讓 CompositionLocal 的用途更明確：提供/擷取本機值至組合的機制。CompositionLocal 執行個體應加上 Local 的前綴，例如 val LocalFoo = compositionLocalOf { Foo() }。(Ia55b6)
  • takeMutableSnapshot 和 takeSnapshot 已變更為 Snapshot 的隨附方法。(I91f19)

  • @ComposableContract 已淘汰，並改用三個更具體的註解。

    @ComposableContract(restartable = false) 已變成 @NonRestartableComposable @ComposableContract(readonly = true) 已變成 @ReadOnlyComposable @ComposableContract(preventCapture = true) 已變成 @DisallowComposableCalls @ComposableContract(tracked = true) 已移除。(I60a9d)

  • emptyContent() 和 (@Composable () -> Unit).orEmpty() 公用程式已經淘汰，因為已經不再有良好的效能影響力或價值 (I0484d)

  • snapshotFlow 和 withMutableSnapshot 不再是實驗性質。(I6a45f)

  • Recomposer 現在可以關閉。封閉的重組工具將繼續調整，直到構成的子項協同程式完成為止。 將 Recomposer.shutDown 重新命名為「cancel」，以便與關閉對照 (Ib6d76)。

  • compose:runtime-dispatch 構件現已淘汰。目前可在 Compose:Runtime 中找到 MonotonicFrameClock，而 AndroidUiDispatcher 則可在 compose:ui 中找到。(Ib5c36)

  • Compose 編譯器外掛程式指定的 API 已經重構為採用介面，而不是具體類別。此外，介面也不會再使用類型參數。

    這項內部變更應該不會影響原始碼相容性，但屬於二進位破壞性變更 (I3b922、b/169406779)

  • 加入 SnapshotMutableState (Icfd03)

  • DisposableEffectDisposable 已重新命名為 DisposaleEffectResult (Ica7c6)

  • 移除了 Recomposer.current()。[Abstract]ComposeView 現已預設為延遲建立、以視窗為範圍的 Recomposer，並由視窗的 ViewTreeLifecycleOwner 所驅動。主機的 Lifecycle 停止時，Recomposition 和以 withFrameNanos 為基礎的動畫滴答會暫停。(I38e11)

  • Recomposer.runningRecomposers 現在會提供唯讀 RecomposerInfo 的全域 StateFlow，用於在程序中觀察進行中的組合狀態。建議使用這個 API 取代已淘汰的 Recomposer.current() (If8ebe)

  • DisposableEffectDisposable 已重新命名為 DisposaleEffectResult (I3ea68)

1.0.0-alpha11 版

2021 年 1 月 28 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha11。1.0.0-alpha11 版包含此連結所列的修訂項目。

API 變更

  • 已淘汰 onCommit、onDispose 和 onActive，並改用 SideEffect 和 DisposableEffect API (If760e)
  • emit() API 和所有超載已淘汰，並重新命名為 ComposeNode。這些 API 是相同的，只是為了遵循 Compose 的命名慣例而使用了不同的名稱 (I4137b)
  • 現已淘汰 invalidate 和 ContentReference()，並改用 CurrentRecomposeScope 和 RememberCompositionReference。(I583a8)

  • CompositionLifecycleObserver 現已淘汰，取而代之的是 RememberObserver。

    RememberObserver 是用修改後的語意和重新命名方法取代的 CompositionLifecycleObserver。針對只記錄一次的物件，您可以不假思索地改為使用新的 API，這是不變的建議做法。不過，如果參照在某個組合中已有多次記錄，系統會針對每個只呼叫一次 onEnter 的參照呼叫 onRemembered。如果子組合 (例如 WithConstraints 和 Scaffold) 使用該物件，則會多次呼叫 onEnter，導致無法保證能穩定地單次呼叫 onEnter，因此已將其從 RememberObserver 中移除。

    RememberObserver 新增 onAbandoned，如果 RememberObserver 執行個體是從傳遞至 remember 的回呼所傳回，但未記錄在組合狀態中，並因此一律不會呼叫 onRemembered，這時就會呼叫此新增項目。之所以會這樣，可能是因為例外狀況在組合完成前終止組合，或是因為產生組合的狀態已過時 (或基於其他原因不再需要使用)，導致組合遭到捨棄。如果按照上述單一參照建議提供的 RememberObserver 執行個體追蹤了外部資源，則 onForgotten 和 onAbandoned 都表示不再需要資源。如果物件正在追蹤 onRemembered 中啟動的工作或配置的資源，則可以忽略 onAbandoned，因為呼叫 onRemembered 之後便不會對其發出呼叫 (I02c36)

  • 請勿將 collectAsState() 函式標示為內嵌 (Ia73e4)

修正錯誤

  • WithConstraints 已重新設計為 BoxWithConstraints，並移至 foundation.layout。(I9420b、b/173387208)
  • 運用 TestCoroutineDispatcher 進行測試 (I532b6)

1.0.0-alpha10 版

2021 年 1 月 13 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha10。1.0.0-alpha10 版包含此連結所列的修訂項目。

破壞性變更

  • 所有 @Composable 函式都執行完畢後，可透過重新建構內部編譯器 API，針對進入「套用變更」組合階段所產生的節點進行批次變更。

    這是一項可能會影響應用程式程式碼的破壞性行為變更，因為在套用完變更之前，您都無法透過內部和實驗性 API 使用節點。這種情況通常可以採取以下變通方法：在 SideEffect 可組合項中使用這類依附元件包圍程式碼，藉此延遲程式碼的執行作業，直到節點建立並完成初始化作業。(I018da)

API 變更

  • 加入重組工具已經套用變更時的追蹤方式 (I1b3e2)

  • 展開 [Abstract]ComposeView API，回收以 Compose 為基礎的檢視畫面，處理其組合以便日後重新建立。新增 API，可用於安裝及探索視窗範圍的 Recomposers 和 CompositionReferences，以便建立子組合。

    新增 ViewCompositionStrategy，可用於設定 [Abstract]ComposeViews 的組合處理策略；預設行為是在視窗卸離時丟棄 (I860ab)

修正錯誤

  • 重組工具現在會呈現目前狀態的流程，以便監控其活動及相關成效的活動。(Ifb2b9)
  • 原生 keyEvent 現在可以透過 keyEvent.nativeKeyEvent 取得 (I87c57、b/173086397)

1.0.0-alpha09 版本

2020 年 12 月 16 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha09。1.0.0-alpha09 版包含此連結所列的修訂項目。

API 變更

  • 已從公用 API 中移除 SlotTable、SlotReader 和 SlotWriter。這些項目先前被標示為 InternalInternalAPI。現在是撰寫模組的內部。

    為了取代 ui-tooling API 而新增 CompositionData 和 CompositionGroup，用於擷取組合資訊。這些是公開工具，但不適合在 ui-tooling API 外使用，因為這些工具會提供由 ui-tooling API 解讀的原始資訊 (I31a9c)

  • Applier 類別不再視為 (Id85b0)

  • Applier 介面經過變更，將樹狀結構建構方式從由上往下簡化為由下往上。

    insert() 方法已重新命名為 insertTopDown()。

    加入新的方法 insertBottomUp()。

    套用器會根據效能表現選用 insertTopDown() 或 insertBottomUp()，將節點插入目前編輯的樹狀結構。

    對某些樹狀結構 (例如 LayoutNode 和 View) 而言，由下往上的建構方式會比由上往下更有效率。在這項變更之前，如要實作由下而上建構作業，您需要先插入一些堆疊，並必須將其複製到每個需進行由下而上效能建構作業的套用器。這項變更實施後，Applier 會覆寫 insertBottomUp() 以由下往上建構樹狀結構，而覆寫 insertTopDown() 則會由上往下建構樹狀結構。(Icbdc2)

  • Compose 支援能執行可組合叫用的屬性 getter。系統對這項支援仍維持不變，但是已變更用於將屬性 getter 宣告為 @Composable 的語法。

    現已淘汰的語法是透過將屬性本身加上註解來進行宣告：

        @Composable val someProperty: Int get() = ...

    現行正確的語法是透過將屬性的 getter 加上註解來進行宣告：

       val someProperty: Int @Composable get() = ...

    這兩種語法將可同時運作一段時間，但系統最終會將先前淘汰的語法視為編譯錯誤。(Id9197)

修正錯誤

1.0.0-alpha08 版

2020 年 12 月 2 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha08。1.0.0-alpha08 版包含此連結所列的修訂項目。

API 變更

  • 新增了針對可組合 lambda 參數命名方式和位置的 Lint 檢查，以檢查是否與 Compose 準則一致。另外也根據 Lint 檢查和指引，將部分使用 children 做為結尾 lambda 名稱的 API 遷移至 content (Iec48e)
  • 重組工具不再接受 EmbeddingContext；系統會從 performanceCoroutineContext 取得必要的排程依附元件。FrameManager 已淘汰；平台在進行整合時應初始化本身的全域快照處理程序 (I02369)。
  • RestorableStateHolder.withRestorableState 函式已重新命名為 RestorableStateProvider (I66640)

修正錯誤

  • 已淘汰名稱後綴為 Ambient 的環境 (Ambient) 屬性，並按照其他 Ambient 和 Compose API 準則，將其替換為名稱前綴為 Ambient 的新屬性。(I33440)
  • 移除舊的 ui-test 模組及其虛設常式 (I3a7cb)

1.0.0-alpha07 版

2020 年 11 月 11 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha07。查看 1.0.0-alpha07 版的修訂項。

新功能

API 變更

  • @UnionType 註解已經淘汰 (I57cde)
  • 新增了 provideDefault 做為提供環境的替代方法，僅用於在未提供任何環境值的情況下指定環境值。(Id6635、b/171024925)
  • 將 LaunchedTask 重新命名為 LaunchedImpact，以便與 SideImpact 和 Disposableimpact API 保持一致。為鼓勵採用最佳做法，系統不允許使用不含主題參數的 LaunchedEffect (Ifd3d4)
  • Applier 現已有 onBeginChanges/onEndChanges 回呼，並可在 Composer 開始/結束將變更套用至樹狀結構時被叫用。如有需要，這些可用於批次處理資源管理。(Icf476)
  • 現在，重組工具在進行建構時需要 CoroutineContext (Ic4610)
  • 對內部 SlotTable 實作所做的變更，並不會影響公用 API。(If9828)
  • 移除不使用初始值且已淘汰的 rxjava2 轉接程式 (Idb72f)

修正錯誤

  • foundation.Text 已淘汰，並由 material.Text 取代。如要瞭解不使用主題值的無預設立場基本文字 API，請參閱 androidx.compose.foundation.BasicText (If64cb)
  • BaseTextField 已淘汰，請改用 BasicTextField。(I896eb)
  • 將數個版面配置相關符號從 androidx.compose.ui 移至 androidx.compose.layout.ui。(I0fa98、b/170475424)。

外部貢獻

  • 新增了 Compose 的 runtime-rxjava3 模組。與 runtime-rxjava2 類似 (I02cbf)

1.0.0-alpha06 版

2020 年 10 月 28 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha06。1.0.0-alpha06 版包含此連結所列的修訂項目。

API 變更

  • Recomposer 現已成為 CompositionReference 以及有效的組合父項。現在只有少數情況必須使用明確的 Recomposer。(I4036f)
  • 新增了 DisposableEffect counterpart API 至 SideEffect，使用所需的 onDispose 補足 onCommit-with-params 的角色。
    • 新增了 rememberUpdatedState API，以發布重組的資料至持續進行或長期進行的程序，例如 DisposableEffects 或 LaunchedTasks。
    • (Id50b9)
  • MutableVector 現在會實作 RandomAccess (I85d73、b/170461551)
  • 新增了 SideEffect 可組合項，以套用組合的副作用至組合管理的物件。SideEffect 的用途是取代 onCommit 可組合項。(Ia77c2)
  • 新增實驗性 API RestorableStateHolder。這可允許儲存以「savedInstanceState」和「rememberSavedInstanceState」定義的子樹狀結構狀態，然後才進行處理，以於下次使用還原的狀態再次組合 (I66884、b/166586419)

修正錯誤

  • 在 ComposeTestRule 中啟用轉換功能，同時從 ComposeTestRule 中移除用於啟用閃爍游標的選項。(If0de3)

1.0.0-alpha05 版

2020 年 10 月 14 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha05。1.0.0-alpha05 版包含此連結所列的修訂項目。

API 變更

  • 實驗性 Modifier.pointerInput 暫停輸入修飾詞 (Ia77d2)
  • 透過減少每次捲動時子組合中的工作量，改善 LazyColumn/Row 的捲動效能。已為 Composition 類別新增 hasInvalidations() 方法。將重組工具的 hasPendingChanges() 方法重新命名為 hasInvalidations() (Ib2f32、b/168293643、b/167972292、b/165028371)
  • 新增 produceState API，以便從組合中啟動可隨時間推移更新單一 State<T> 值的協同程式 (Id4a57)
  • 將 launchInComposition 重新命名為 LaunchedTask，以符合 Compose API 指南 (I99a8e)
  • 自訂版面配置中的 place() 呼叫順序現在可定義子項的繪製順序 (Ibc9f6)

1.0.0-alpha04 版

2020 年 10 月 1 日

發布 androidx.compose.runtime:runtime-*:1.0.0-alpha04。1.0.0-alpha04 版包含此連結所列的修訂項目。

API 變更

  • 新增了 OwnerScope，以便收集已失效的版面配置和繪圖觀測範圍 (Ic4cf8)
  • 新增了 derivedStateOf API，以便根據計算結果建立可讀取 (及衍生自) 其他 State 物件的 State 物件 (If758b)
  • 為 SnapshotStateObserver 新增了 TestOnly API (I6e2a9)

修正錯誤

  • foundation.Box 已淘汰。請改用 foundation.layout.Box。(Ie5950、b/167680279)

1.0.0-alpha03 版

2020 年 9 月 16 日

發布了 androidx.compose.runtime:runtime-*:1.0.0-alpha03。1.0.0-alpha03 版包含此連結所列的修訂項目。

API 變更

  • CompositionCoroutineScope 已不再實作 MonotonicFrameClock。withFrameNanos 的呼叫端應明確匯入頂層函式。(Icb642、b/166778123)。

修正錯誤

  • onNode 或 waitForIdle 等全域測試函式現已淘汰，請改用依據 ComposerTestRule 定義的新對應函式 (I7f45a)
  • launchInComposition 不會再啟動未指派的協同程式 (Ief6af、b/166486000)

1.0.0-alpha02 版

2020 年 9 月 2 日

發布了 androidx.compose.runtime:runtime-*:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

API 變更

  • 新增消耗和產生快照資料變更使用的 snapshotFlow 和 withMutableSnapshot API。(I3e722)

  • 可組合函式的呼叫慣例已變更。這是二進位檔破壞性變更。所有程式庫都必須重新編譯，才能與這個版本的 Compose 編譯器外掛程式搭配使用。

    這項變更不會對原程式碼層級產生重大影響，因為只有已變更的 API 屬於明確選擇啟用的編譯器 API。(I7afd2、b/158123185)。

  • 從 EmbeddingContext (I7b9be) 中移除排程方法

  • OnPreCommit 已淘汰，onCommit 的效用現在與 onPreCommit 相同。

    現在，onCommit 和 onActive 會在已提交組合變更的同一個 Choreographer 畫面中執行，而不是在下一個 Choreographer 畫面開始時執行。(I70403)

1.0.0-alpha01 版

2020 年 8 月 26 日

發布了 androidx.compose.runtime:runtime-*:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

0.1.0-dev 版

0.1.0-dev17 版

2019 年 8 月 5 日

發布了 androidx.compose.runtime:runtime-*:0.1.0-dev17。0.1.0-dev17 版包含此連結所列的修訂項目。

API 變更

  • 自訂輸出項目現在可以宣告將其一或多個 setter 設為可略過，並在該輸出項目外獨立進行重組 (Ibbd13)

  • 移除已淘汰的 FrameManager 呼叫。

    內部的 Compose API 經過變更，可減少追蹤狀態物件 (例如 mutableStateof()) 的負載 (I80ba6)

  • state { ... } 可組合項現已淘汰，改為明確呼叫 remember { mutableStateOf(...) } 以求一目瞭然。 這樣可以減少管理狀態所需的整體 API 介面和概念數量，且符合類別屬性委派作業的 by mutableStateOf() 模式。(Ia5727)

  • Flow.collectAsState 現在會根據組合定義預設調度工具，而不是預設為 Dispatchers.Main。(I9c1d9)

  • 修正在 for 迴圈內使用某種方法儲存狀態時發生的當機問題。現已支援在 savedInstanceState() 中使用相同鍵，並已根據這項新要求調整 UiSavedStateRegistry 的 API (I4ab76、b/160042650、b/156853976、b/159026663、b/154920561)

修正錯誤

  • emitView 已淘汰。請盡可能使用 AndroidView，在 Compose 中產生 View。請注意，系統日後將不再支援直接組合 View 和 ViewGroup 的做法，除非這是組合樹狀結構的一部分，且能透過 AndroidView 完成這項作業 (I29b1e、b/163871221)。

0.1.0-dev16 版

2020 年 8 月 5 日

發布了 androidx.compose.runtime:runtime-*:0.1.0-dev16。0.1.0-dev16 版包含此連結所列的修訂項目。

API 變更

  • mutableStateOf()、ambientOf() 和 savedInstanceStateOf() 的預設異動原則已變更為 structuralEqualityPolicy()，而不是 referentialEqualityPolicy()。

    原本的預設是將決定指派給 mutableStateOf() 執行個體的新值視為變更，現在的預設是使用 ==，而不是使用 ===。

    請參閱 https://kotlinlang.org/docs/reference/equality.html

    ambientOf() 和 savedInstanceStateOf() 會在其實作中使用 mutableStateOf()，因此變更為與 mutableStateOf() 一致。

    以更符合開發人員預期的方式使用結構等式。

    例如：

    val state = mutableStateOf(1f)

    然後，

    state.value = 1f

    不會再將變更視為 state，而且在組合期間使用 state 也不再需要重組。

    這是一項突破性的變更，但在大多數情況下 (例如：使用不會覆寫 equals() 的類別時)，這不會在應用程式中有明顯的影響。

    確實會覆寫 equals() 的類別 (例如 data 類別) 可能會出現效能降低的情形，原因在於現在當這些類別的 equals() 方法指派給 mutableStateOf() 時，系統預設會呼叫這些方法。

    只要在對 mutableStateOf()、ambientOf() 和 savedInstanceStateOf() 的呼叫中新增政策參數 policy = referentialEqualityPolicy()，即可還原先前的行為。(Ic21a7)

  • Row 和 Column 現在是內嵌函式，可大幅減少使用這些項目的負擔。(I75c10)

修正錯誤

  • setViewContent 已淘汰，現應改用 setContent。(I7e497、b/160335130)。

  • 新增了 MonotonicFrameAnimationClock，讓您可使用 MonotonicFrameClock 做為 AnimationClockObservable，以消除協同程式型新版時鐘與仍使用回呼型舊版時鐘的 API 之間的差異。

    MonotonicFrameClock 等同於 ManualAnimationClock，現在為 ManualFrameClock。(I111c7、b/161247083)。

  • Modifier.stateDraggable 已經全面重新設計，並重新命名為 Modifier.swipeable。加入新的 SwipeableState 類別，並重構 DrawerState 和 BottomDrawerState，使其可從該類別沿用。[Modal/Bottom]DrawerLayout 不再使用 onStateChange 參數。(I72332、b/148023068)。

  • Modifier.plus 已淘汰，請改用 Modifier.then。「Then」可以更明確地指出先後執行順序，同時還禁止輸入會破壞鏈結且降低可讀性的 Modifier.padding().background() + anotherModifier (Iedd58、b/161529964)

  • 已新增 SubcomposeLayout。這是一種低階原始物件，如果我們想要使用僅在測量子樹狀結構組合後期可用的某些值，便可利用這個原始物件在測量期間組合子項。例如 WithConstraints 不會使用 SubcomposeLayout 導入 (I25cc8)。

  • Material FilledTextField 已重新命名為 TextField，且基礎 TextField 已重新命名為 BaseTextField，讓您可以輕鬆尋找並使用所需的最簡單的 API (Ia6242、b/155482676)

  • Modifier.drawBackground 已重新命名為 Modifier.background (I13677)

0.1.0-dev15 版

2020 年 7 月 22 日

發布了 androidx.compose.runtime:runtime-*:0.1.0-dev15。0.1.0-dev15 版包含此連結所列的修訂項目。

依附元件更新

  • 如要使用 0.1.0-dev15 版的 Compose，您必須依據上方「宣告依附元件」一節所示的新程式碼片段更新依附元件。

API 變更

  • @Model 註解現已淘汰。請使用 State 和 mutableStateOf 做為替代項目。經過審慎討論後，我們決定達成這個淘汰決定。

    理由

    原因包括但不限於：

    • 減少我們需要教授的 API 介面面積和概念
    • 更能配合其他相似的工具包 (Swift UI、React、Flutter)
    • 這是可逆轉的決定。我們日後隨時可以將 @Model 復原。
    • 移除極端情況下的用途，並且不需回答如何將 @Model 設定為系統需要處理的工作相關的難題。
    • @Model 資料類別、equals、hashcode 等等。
    • 如何讓一些屬性「觀察到」而其他屬性不會觀察到？
    • 如何指定用於觀察的結構性與參照性相等？
    • 降低系統中的「魔術指令」。可降低使用者假定系統比實際上更聰明 (例如，知道如何區別清單) 的可能性
    • 可讓您以更簡單直覺的方式觀察結果。
    • 提高從變數到類別屬性的可重構性
    • 開闢手動進行狀態專屬最佳化作業的可能性
    • 更緊密地貼近生態系統的其餘部分，並減少對不可變或我們「擁抱可變狀態」的歧義

    遷移注意事項

    幾乎所有 @Model 的使用情形，都會透過以下兩種方法之一進行轉換。以下範例中的 @Model 類別包含兩個屬性 (僅做為範例參考) 並用於可組合項。

    @Model class Position(
 var x: Int,
 var y: Int
)

@Composable fun Example() {
 var p = remember { Position(0, 0) }
 PositionChanger(
   position=p,
   onXChange={ p.x = it }
   onYChange={ p.y = it }
 )
}

    替代方法 1：使用 State<OriginalClass> 並建立副本。

    使用 Kotlin 的資料類別即可輕鬆執行這個做法。基本上就是將所有先前的 var 屬性變成資料類別的 val 屬性，再使用 state 取代 remember，然後將狀態值指派給使用資料類別 copy(...) 便利方法複製的原始屬性副本。

    請務必留意，只有在該類別的變更是在建立 State 執行個體的相同範圍內完成時，這個做法才有效。如果類別內部產生的變更在使用範圍以外，且您需要使用該觀察結果，那麼下一個做法就符合您的需求。

    data class Position(
 val x: Int,
 val y: Int
)

@Composable fun Example() {
 var p by state { Position(0, 0) }
 PositionChanger(
   position=p,
   onXChange={ p = p.copy(x=it) }
   onYChange={ p = p.copy(y=it) }
 )
}

    替代方法 2：使用 mutableStateOf 和屬性委派

    若是使用 Kotlin 的屬性委派項目和 mutableStateOf API，在組合以外建立 MutableState 執行個體，就能輕鬆執行這個做法。基本上就是原始類別的所有 var 屬性取代為 var 屬性，並使用 mutableStateOf 做為屬性委派項目。這樣做的好處是，類別的使用方式將完全不變更，只有類別內部的實作需要。不過，這個行為模式與原始範例不完全相同，因為現在每個屬性都是個別接受觀察/訂閱，因此重構完成後顯示的重組可能範圍更小 (這是好現象)。

    class Position(x: Int, y: Int) {
 var x by mutableStateOf(x)
 var y by mutableStateOf(y)
}

// source of Example is identical to original
@Composable fun Example() {
 var p = remember { Position(0, 0) }
 PositionChanger(
   position=p,
   onXChange={ p.x = it }
   onYChange={ p.y = it }
 )
}

    (I409e8、b/152050010、b/146362815、b/146342522、b/143413369、b/135715219、b/143263925、b/139653744)

  • 變更 Compose 編譯器的程式碼產生策略。在變更之前，Compose 編譯器會將呼叫轉換為可組合函式。經此變更之後，我們現在可以轉換可組合函式的主體，並在多數情況下維持呼叫位置不變。

    也就是說，與 Compose 執行階段進行通訊的大多數邏輯，都是在函式主體的開頭 (而不是在呼叫位置) 執行。

    這應該是針對所有 Compose 使用情形的原始碼相容性變更。這項變更生效後，大多數 Compose 使用者都無需更新任何程式碼。

    為了配合這項變更，所有可組合函式的 JVM 簽名皆已變更。接受單一參數的可組合函式已轉換為接受 3 個參數的函式，外加的參數為 Composer (也就是「key」整數)，是用於透過呼叫傳播中繼資料的位元遮罩整數。

    Compose 也會將預設引數轉換為可組合的函式。此舉不會引入函式本身的額外合成預設超載，因此這項變更將導致接受定義的函式變少。

    由這種情況產生的已知預期行為變更：

    1. 部分呼叫會略過先前不會略過的部分
    2. 系統現可正確訂閱及處理預設引數運算式中的可組合運算式

    這項工作包含以下最佳化作業： 1. 參數的比較結果會透過呼叫圖傳播到其他可組合函式。這將導致執行階段的比較項目更少、縮減運算單元資料表的大小，以及略過更多先前未略過的可組合函式。 2. 系統在執行階段不會再比較或儲存在編譯時間判定為「靜態」的參數。這樣可以減少比較項，並縮減運算單元資料表的大小。 3. 函式主體的控制流結構可用於盡可能減少產生的群組數量。這麼做可減少運算單元資料表大小，並降低執行階段 4 的工作負擔。如果未在函式主體內使用調度和接收器參數，則在判斷函式是否可略過時不會將這些參數納入考量。

    多數破壞性變更都是針對編譯器直接指定的 API，因此不會影響 Compose 的一般使用情形： 1. Composer::startExpr 已移除 2. Composer::endExpr 已移除 3. Composer::call 已淘汰 4. 已移除 key 的非變化版本超載。往後請使用 vararg 版。5. Pivotal 註解已淘汰。請改為使用 key。6. ScopeUpdateScope::updateScope 已變更為 Function3 而非 Function1 7. restartableFunction 和 restartableFunctionN 已更新為包含其他編譯時間參數 (I60756、b/143464846)

  • 將 sortWith 和 removeRange 新增至 MutableVector (Icccf7)

  • 新增了 CompositionLifecycleObserver 的預設方法實作 (I24289)

  • Applier 現在必須使用 clear() 方法來棄置組合 (Ibe697)

  • 已將 asMutableList() 新增至 MutableVector 不必複製整個 請參考閱讀清單，進一步瞭解 如何選擇 Kubeflow Pipelines SDK 或 TFX(I298df)

  • 新增了 RememberCoroutineScope()，可用於取得在組合中託管的 CoroutineScope，以便啟動工作來回應事件。(I0e264)

  • MutableVector 是新的集合，不會實作任何標準 Collection 介面。此集合可帶來高於其他要求的速度，而且僅供內部實作使用。(I8ebd6)

  • 已暫時移除 StableMutableList 和 StableMutableMap，避免 Compose 所需的 Kotlin 版本發生問題。這些介面將在 Compose 更新為沒有問題的 Kotlin 版本時重新加入。

    SnapshotStateList 和 SnapshotStateMap 現已公開，但會在 StableMutableList 和 StableMutableMap 還原後淘汰。(Ia7769)

  • 新增頂層 withFrameNanos 函式，用於動畫計時 (Ie34c5)

  • @Untracked 註解已淘汰。替換為 @ComposableContract(tracked=false) (Id211e)

  • RestartableFunction 和相關聯的 API 已重新命名為 ComposableLambda 等。這些 API 只會由編譯器指定為目標，因此正常來說，這不會影響來源層級相容性。重新命名的主要用意是，當這個類別出現在堆疊追蹤中，使用者能夠對其有更清晰的瞭解 (I7eb25)

  • @Composable 註解不再適用於類別 (Ia5f02)

  • Ambient<T> 現在是 @Stable，而不是 @Immutable (I0b4bb)

  • 在做出這項變更之前，Compose 編譯器外掛程式會以複雜方式攔截對 @Composable 函式 (如果有) 內建構函式的呼叫 (I5205a、b/158123804)

  • Recompose 可組合項不再是實用的抽象層。多數重組作業應該都是因為 MutableState 指派項目才會執行。除此之外，建議您使用 invalidate 函式來觸發針對目前範圍的重組作業 (Ifc992)。

  • 「觀察」已不能成為實用的抽象層。如果需要複製，其實作可透過直接建立執行可組合項 lambda 參數的可組合函式取代。例如：@Composable fun Observe(body: @Composable () -> Unit) = body() (I40d37)

  • @Direct 已淘汰，並改用 @ComposableContract(restartable=false) (If4708)

  • 為最近引入的 StateFlow 新增轉接程式，以便預先填入初始值，讓傳回的狀態不可為空值 (I61dd8、b/156233789)

  • 新增了 Flow 的轉接程式。使用範例：val value by flow.collectAsState() (If2198、b/153375923)

  • [Mutable]State 屬性委派運算子已移至擴充功能，以支援 Kotlin 1.4 屬性委派最佳化作業。呼叫端必須新增匯入作業才能繼續使用 by state { ... } 或 by mutableStateOf(...) (I5312c)

  • androidx.compose.ViewComposer 已移至 androidx.ui.node.UiComposer androidx.compose.Emittable 已移除。它對 ComponentNode 來說是多餘的。androidx.compose.ViewAdapters 已移除。系統已不再支援這些項目。Compose.composeInto 已淘汰，請改用 setContent 或 setViewContent。Compose.disposeComposition 已淘汰，請改為對 setContent 傳回的 Composition 使用 dispose 方法。 androidx.compose.Compose.subcomposeInto 已移至 androidx.ui.core.subcomposeInto ComponentNode#emitInsertAt 已重新命名為 ComponentNode#insertAt ComponentNode#emitRemoveAt 已重新命名為 ComponentNode#removeitModeAt ComponentNode#emitMode 已重新命名為 ComponentNode#move (Idef00)

  • 將 ComposeFlags.COMPOSER_PARAM 標記更新為 true，這會變更 Compose 外掛程式的程式碼產生策略。大致上來說，這會導致系統產生附加合成參數的 @Composable 函式，這個參數會傳遞至後續的 @Composable 呼叫中，藉此讓執行階段妥善管理執行作業。這是二進位檔的重大破壞性變更，但應在所有 Compose 的合法使用情況中，保留來源層級的相容性。(I7971c)

  • 對環境 API 做出破壞性變更。詳情請參閱記錄和 Ambient<T> 說明文件 (I4c7ee、b/143769776)

  • 新增了 ui-livedata - 專為 LiveData 設計的新構件 (有轉接程式)。使用範例：val value by liveData.observeAsState() (Ie9e8c、b/150465596)

  • 不含明確初始值的 Rx 轉接程式已淘汰。使用空值不一定是最佳預設值，舉例來說，假如您使用的是 List，最好開頭是 emptyList() 或任何其他合理的預設值 (I00025、b/161348384)

  • 新增了 ui-rxjava2 - 專為 RxJava2 設計的新構件 (有轉接程式)。使用範例：val value by observable.subscribeAsState() (Ifab4b、b/153369097)

  • savedInstanceState() 現在可以搭配可為空值類型使用 (I6847f、b/153532190)

  • 新增 listSaver() 和 mapSaver()，以更簡單的方式寫入自訂 Saver 物件 (I8cf68、b/152331508)

  • 新函式：savedInstanceState() 和 rememberSavedInstanceState()。這些與 state() 和 remember() 相似，但可以利用已儲存的執行個體狀態支援建構 (If1987、b/152025209)

修正錯誤

  • runOnIdleCompose 已重新命名為 runOnIdle (I83607)
  • 已將 LayoutNode 設為實驗性 API (I4f2e9)
  • androidx.ui.foundation.TextFieldValue 和 androidx.ui.input.EditorValue 已淘汰。使用該類型的 TextField、FilledTextField 和 CoreTextField 可組合項也已淘汰。請改用 androidx.ui.input.TextFieldValue (I4066d、b/155211005)
  • 移除已淘汰的 DrawBackground API，改為透過修飾詞提供 drawBackground 擴充功能。重構色彩、筆刷與繪製 drawBackground 的實作，減少程式碼路徑，並移除建立 Modifier 做為部分組成元件的要求。(I0343a)
  • 已更新較高層級的 Composer API，將原有顯示 Canvas 改為顯示 CanvasScope。如此一來，取用者就不必維護自己的 Paint 物件。如果取用者仍要求 Canvas 存取權，則可以使用 drawCanvas 擴充功能方法，這種方法可提供回呼，透過基礎 Canvas 發出繪圖指令 (I80afd)。
  • WithConstraints 結尾的 lambda API 已變更。現在，除了兩個參數外，這還具有接收器範圍。除了能夠設定限制與 layoutDirection 之外，該範圍還可以提供 Dp 中的 minWidth、maxWidth、minHeight 和 maxHeight 屬性 (I91b9a、b/149979702)
  • 新增了對稱式邊框間距修飾詞。(I39840)
  • 已更新 wrapContentWidth 和 wrapContentHeight 必須使用垂直或水平對齊，而非使用任何對齊。引力調整器已更新為接受垂直或水平對齊。更新 Row、Column 和 Stack，藉此支援自訂的持續對齊方式 (Ib0728)
  • ui-text 模組已重新命名為 ui-text-core (I57dec)
  • 改善 DrawModifier API：
    • 已製作 Draw() ContentDrawScope 的接收器範圍
    • 移除了 Draw() 的所有參數
    • DrawScope 的介面與之前的 CanvasScope 介面相同
    • ContentDrawScope 含有 DrawContent() 方法 (Ibaced、b/152919067)
  • ColoredRect 已淘汰，請改用 Box(Modifier.preferredSize(width, height).drawBackground(color))。(I499fa、b/152753731)。
  • 將修飾詞和運算子替換成工廠擴充功能函式 (I225e4)
  • RowScope 和 ColumnScope 構件現在已可從 Row 和 Column 之外存取。(I3a641)
  • 將 LayoutFlexible 重新命名為 LayoutWeight。將 tight 參數重新命名為 fill。(If4738)
  • WithConstraints 取得 LayoutDirection 參數 (I6d6f7)
  • 已將 background 重新命名為 DrawBackground，並成為預設加以記憶 (Ia0bd3)
  • 以不同函式取代 ButtonStyle，並移除文字 (字串) 超載。如需使用資訊，請參閱更新後的範例。(If63ab、b/146478620、b/146482131)
  • runOnIdleCompose 和 runOnUiThread 現已成為全域函式，而非 ComposeTestRule 中的方法 (Icbe8f)

外部貢獻

  • 從 Compose 執行階段移植層移除不需要的 API，例如 Looper 和 Handler (I6847d)
  • 淘汰沒有初始值的 Flow<T>.collectAsState()。請改用 StateFlow<T>，或傳遞明確的初始值。(I63f98、b/157674865)