Compose Compiler
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2023 年 2 月 8 日 | 1.4.2 | - | - | - |
結構
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.runtime | Compose 程式設計模型和狀態管理的基本構成元素,以及 Compose Compiler 外掛程式指定的核心執行階段。 |
compose.ui | 與裝置互動所需的 Compose UI 基礎元件,包括版面配置、繪圖及輸入。 |
宣告依附元件
如要新增 Compose 的依附元件,必須將 Google Maven 存放區新增至您的專案。詳情請參閱「Google 的 Maven 存放區」一節。
在應用程式或模組的 build.gradle
檔案中,新增所需構件的依附元件:
Groovy
android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.4.7" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.4.7" } kotlinOptions { jvmTarget = "1.8" } }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有問題。
詳情請參閱 Issue Tracker 說明文件。
1.4.2 版本
1.4.2 版本
2023 年 2 月 8 日
發布 androidx.compose.compiler:compiler:1.4.2
。查看 1.4.2 版的修訂項。
新功能
- 支援 Kotlin 1.8.10
修正錯誤
- 在不可略過的 lambda 主體中新增群組,避免重組錯誤。
1.4.1 版本
1.4.1 版本
2023 年 2 月 8 日
發布 androidx.compose.compiler:compiler:1.4.1
。1.4.1 版本包含這些修訂版本。
修正錯誤
- 停用內建函式 remember 最佳化功能,因為這在先前造成了一些程式碼產生錯誤。
- 針對含有 vararg 參數的函式停用內建函式 remember。
- 修正使用預設參數的可組合項出現的錯誤略過問題。
- 新增在 Kotlin 相容性檢查失敗時顯示的防禦性備用錯誤訊息。
- 移除內嵌 lambda 產生的略過程式碼。
1.4.0 版本
2023 年 1 月 17 日
發布 androidx.compose.compiler:compiler:1.4.0
。查看 1.4.0 版的修訂項。
自 1.3.0 版以來的重要異動
- 支援 Kotlin 1.8.0
- 關閉 Intrinsic Remember
- UI 工具資料類別
Group
現在有一個isInline
欄位,指出群組是否用於呼叫內嵌的可組合函式。如果isInline
是true
,呼叫目標即為內嵌的可組合函式。不過,如果呼叫目標為來自模組的內嵌可組合函式,而且這些模組的編譯方式採用不會產生內嵌函式資訊的 Compose Compiler 外掛程式版本,那麼這個值可能會是 false ImmutableCollection
及其永久性同層級現已穩定。AnimatedContent
中的工具標籤新參數- 修正內嵌 lambda 程式碼產生錯誤
1.4.0-alpha02 版
2022 年 11 月 11 日
發布 androidx.compose.compiler:compiler:1.4.0-alpha02
。查看 1.4.0-alpha02 版的修訂項。
新功能
- 新增了對 Kotlin
1.7.21
的支援
1.4.0-alpha01 版
2022 年 11 月 9 日
發布 androidx.compose.compiler:compiler:1.4.0-alpha01
。查看 1.4.0-alpha01 版的修訂項。
修正錯誤
- 修正提前從內嵌可組合函式傳回的功能 (b/255350755)
- 修正在 Compose 中 Kotlin/JS 支援中斷的 decoy 降低錯誤 (6a40f8)。
1.3 版
1.3.2 版
2022 年 10 月 4 日
發布 androidx.compose.compiler:compiler:1.3.2
。查看 1.3.2 版的修訂項。
新功能
- 這個版包含 Kotlin 1.7.20 版更新
1.3.1 版
2022 年 9 月 7 日
發布 androidx.compose.compiler:compiler:1.3.1
。查看 1.3.1 版的修訂項。
修正錯誤
- 修正
IllegalStateException
在部分情況下 Compose Compiler 錯誤地將單元類型標示為可組合項的問題 (b/237863365)。 - 略過編譯器版本檢查時,使用者現在必須指定偏好的 Kotlin 版 (I9e5e2)
1.3.0 版
2022 年 8 月 10 日
發布 androidx.compose.compiler:compiler:1.3.0
。查看 1.3.0 版的修訂項。
1.3.0-rc02 版
2022 年 8 月 3 日
發布 androidx.compose.compiler:compiler:1.3.0-rc02
。查看 1.3.0-rc02 版的修訂項。
1.3.0-rc01 版
2022 年 7 月 27 日
發布 androidx.compose.compiler:compiler:1.3.0-rc01
。查看 1.3.0-rc01 版的修訂項。
1.3.0-beta01 版
2022 年 7 月 20 日
發布 androidx.compose.compiler:compiler:1.3.0-beta01
。查看 1.3.0-beta01 版的修訂項。
新功能
- 新增了對 Kotlin
1.7.10
的支援
1.2 版
1.2.0 版
2022 年 6 月 29 日
發布 androidx.compose.compiler:compiler:1.2.0
。查看 1.2.0 版的修訂項。
自 1.1.0 版以來的重要異動
- 支援 Kotlin 1.7.0
- 請參閱我們的網誌文章,瞭解 Compose 新的 Compose Compiler 版本管理策略。
1.2.0-rc02 版
2022 年 6 月 22 日
發布 androidx.compose.compiler:compiler:1.2.0-rc02
。查看 1.2.0-rc02 版的修訂項。
修正錯誤
- 移除了可組合項追蹤事件程式碼產生功能 (aosp/2127922)
1.2.0-rc01 版
2022 年 6 月 15 日
發布 androidx.compose.compiler:compiler:1.2.0-rc01
。查看 1.2.0-rc01 版的修訂項。
1.2.0-beta03 版
2022 年 6 月 1 日
發布 androidx.compose.compiler:compiler:1.2.0-beta03
。查看 1.2.0-beta03 版的修訂項。
1.2.0-beta02 版
2022 年 5 月 18 日
發布 androidx.compose.compiler:compiler:1.2.0-beta02
。查看 1.2.0-beta02 版的修訂項。
1.2.0-beta01 版
2022 年 5 月 11 日
發布 androidx.compose.compiler:compiler:1.2.0-beta01
。查看 1.2.0-beta01 版的修訂項。
- 這是 1.2 版的第一個 Beta 版!此版本與上一個 Alpha 版沒有差別。
新功能
- 新增了對 Kotlin
1.6.21
的支援
1.2.0-alpha08 版
2022 年 4 月 20 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha08
。查看 1.2.0-alpha08 版的修訂項。
1.2.0-alpha07 版
2022 年 4 月 6 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha07
。查看 1.2.0-alpha07 版的修訂項。
1.2.0-alpha06 版
2022 年 3 月 23 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha06
。查看 1.2.0-alpha06 版的修訂項。
1.2.0-alpha05 版
2022 年 3 月 9 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha05
。查看 1.2.0-alpha05 版的修訂項。
1.2.0-alpha04 版
2022 年 2 月 23 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha04
。查看 1.2.0-alpha04 版的修訂項。
1.2.0-alpha03 版
2022 年 2 月 9 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha03
。查看 1.2.0-alpha03 版的修訂項。
1.2.0-alpha02 版
2022 年 1 月 26 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha02
。查看 1.2.0-alpha02 版的修訂項。
1.2.0-alpha01 版
2022 年 1 月 12 日
發布 androidx.compose.compiler:compiler:1.2.0-alpha01
。查看 1.2.0-alpha01 版的修訂項。
新功能
- 新增了對 Kotlin
1.6.10
的支援。
1.1 版
1.1.1 版
2022 年 2 月 23 日
發布 androidx.compose.compiler:compiler:1.1.1
。查看 1.1.1 版的修訂項。
修正錯誤
- 修正
androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList
中的NullPointerException
(aosp/1947059、b/206677462) - 修正在 Android 上讀取剪貼簿時,由剪貼簿內容造成的當機問題 (I06020、b/197769306)
- 修正
LazyVerticalGrid
中的 RTL (aosp/1931080、b/207510535)
1.1.0 版
2022 年 2 月 9 日
發布 androidx.compose.compiler:compiler:1.1.0
。查看 1.1.0 版的修訂項。
自 1.0.0 版以來的重要變更
- 穩定支援 Android 12 的過度捲動效果
- 改善觸控目標縮放功能
- 請注意,為配合 Compose 1.0,Material 元件會擴大版面配置空間,以符合 Material 針對觸控目標尺寸所制訂的無障礙功能準則。舉例來說,即使您將觸控目標按鈕的尺寸設定為小於最小尺寸
48x48dp
,系統仍會將按鈕擴大為這個尺寸。這樣一來,Compose Material 的行為就會與 Material Design 元件相同,在混用 Views 和 Compose 時便可確保行為一致。利用 Compose Material 元件建立使用者介面時,這項異動還能確保達到觸控目標無障礙功能的最低要求。 - 穩定支援導覽邊欄
- 將先前推出的一些實驗性 API 升級為穩定版
- 支援更新版本的 Kotlin
1.1.0-rc03 版
2022 年 1 月 26 日
發布 androidx.compose.compiler:compiler:1.1.0-rc03
。查看 1.1.0-rc03 版的修訂項。
修正錯誤
- 更新為可支援 Compose Material 1.1.0-rc03
1.1.0-rc02 版
2021 年 12 月 16 日
發布 androidx.compose.compiler:compiler:1.1.0-rc02
。查看 1.1.0-rc02 版的修訂項。
依附元件更新
- Compose Compiler
1.1.0-rc02
與 Kotlin1.6.10
相容。
1.1.0-rc01 版
2021 年 12 月 15 日
發布 androidx.compose.compiler:compiler:1.1.0-rc01
。查看 1.1.0-rc01 版的修訂項。
依附元件變更
- Compose Compiler
1.1.0-rc01
與 Kotlin1.6.0
相容。 相容的
1.6.10
版本可透過buildId
8003490 的 androidx.dev SNAPSHOT 取得。下列依附元件程式碼片段可為 Compose Compiler 設定 SNAPSHOT。請將以下程式碼片段加入專案根層級的
build.gradle
檔案中:buildscript { repositories { google() jcenter() maven { url 'https://androidx.dev/snapshots/builds/8003490/artifacts/repository' } } }
針對使用 Compose 的應用程式或模組,將以下程式碼片段加入
build.gradle
檔案中:android { composeOptions { kotlinCompilerExtensionVersion = "1.2.0-SNAPSHOT" } }
1.1.0-beta04 版
2021 年 12 月 1 日
發布 androidx.compose.compiler:compiler:1.1.0-beta04
。查看 1.1.0-beta04 版的修訂項。
新功能
- 更新為可與 Kotlin
1.6.0
相容
1.1.0-beta03 版
2021 年 11 月 17 日
發布 androidx.compose.compiler:compiler:1.1.0-beta03
。查看 1.1.0-beta03 版的修訂項。
1.1.0-beta02 版
2021 年 11 月 3 日
發布 androidx.compose.compiler:compiler:1.1.0-beta02
。查看 1.1.0-beta02 版的修訂項。
1.1.0-beta01 版
2021 年 10 月 27 日
發布 androidx.compose.compiler:compiler:1.1.0-beta01
。查看 1.1.0-beta01 版的修訂項。
1.1.0-alpha06 版
2021 年 10 月 13 日
發布 androidx.compose.compiler:compiler:1.1.0-alpha06
。查看 1.1.0-alpha06 版的修訂項。
1.1.0-alpha05 版本
2021 年 9 月 29 日
發布 androidx.compose.compiler:compiler:1.1.0-alpha05
。查看 1.1.0-alpha05 版的修訂項。
1.1.0-alpha04 版
2021 年 9 月 15 日
發布 androidx.compose.compiler:compiler:1.1.0-alpha04
。查看 1.1.0-alpha04 版的修訂項。
1.1.0-alpha03 版
2021 年 9 月 1 日
發布 androidx.compose.compiler:compiler: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
,使其依附 Kotlin1.5.30
。(I74545)
1.1.0-alpha02 版
2021 年 8 月 18 日
發布 androidx.compose.compiler:compiler:1.1.0-alpha02
。查看 1.1.0-alpha02 版的修訂項。
1.1.0-alpha01 版
2021 年 8 月 4 日
發布 androidx.compose.compiler:compiler:1.1.0-alpha01
。查看 1.1.0-alpha01 版的修訂項。
1.0 版
1.0.5 版
2021 年 11 月 3 日
發布 androidx.compose.compiler:compiler:1.0.5
。查看 1.0.5 版的修訂項。
修正錯誤
- 修正追蹤 derivedStateOf 例項時的異常終止問題 (aosp/1792247)
1.0.4 版
2021 年 10 月 13 日
發布 androidx.compose.compiler:compiler:1.0.4
。查看 1.0.4 版的修訂項。
依附元件更新
- 已更新為依附 Kotlin
1.5.31
1.0.3 版
2021 年 9 月 29 日
發布 androidx.compose.compiler:compiler:1.0.3
。查看 1.0.3 版的修訂項。
依附元件更新
- 已更新為依附 Kotlin
1.5.30
1.0.2 版
2021 年 9 月 1 日
發布 androidx.compose.compiler:compiler: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.compiler:compiler:1.0.1
。查看 1.0.1 版的修訂項。
依附元件更新
- 已更新為依附 Kotlin
1.5.21
。
1.0.0 版
2021 年 7 月 28 日
發布 androidx.compose.compiler:compiler:1.0.0
。查看 1.0.0 版的修訂項。
1.0.0 的主要功能
這是 Compose 的第一個穩定版。如需詳細資訊,請參閱官方的「Compose 版本網誌」!
1.0.0-rc02 版
2021 年 7 月 14 日
發布 androidx.compose.compiler:compiler:1.0.0-rc02
。查看 1.0.0-rc02 版的修訂項。
1.0.0-rc01 版本
2021 年 7 月 1 日
發布 androidx.compose.compiler:compiler:1.0.0-rc01
。查看 1.0.0-rc01 版的修訂項。
1.0.0-beta09 版
2021 年 6 月 16 日
發布 androidx.compose.compiler:compiler:1.0.0-beta09
。查看 1.0.0-beta09 版的修訂項。
1.0.0-beta08 版
2021 年 6 月 2 日
發布 androidx.compose.compiler:compiler:1.0.0-beta08
。查看 1.0.0-beta08 版的修訂項。
1.0.0-beta07 版
2021 年 5 月 18 日
發布 androidx.compose.compiler:compiler:1.0.0-beta07
。查看 1.0.0-beta07 版的修訂項。
1.0.0-beta06 版
2021 年 5 月 5 日
發布 androidx.compose.compiler:compiler:1.0.0-beta06
。查看 1.0.0-beta06 版的修訂項。
1.0.0-beta05 版本
2021 年 4 月 21 日
發布 androidx.compose.compiler:compiler:1.0.0-beta05
。查看 1.0.0-beta05 版的修訂項。
1.0.0-beta04 版
2021 年 4 月 7 日
發布 androidx.compose.compiler:compiler:1.0.0-beta04
。查看 1.0.0-beta04 版的修訂項。
1.0.0-beta03 版
2021 年 3 月 24 日
發布 androidx.compose.compiler:compiler:1.0.0-beta03
。查看 1.0.0-beta03 版的修訂項。
1.0.0-beta02 版本
2021 年 3 月 10 日
發布 androidx.compose.compiler:compiler:1.0.0-beta02
。查看 1.0.0-beta02 版的修訂項。
1.0.0-beta01 版
2021 年 2 月 24 日
發布 androidx.compose.compiler:compiler:1.0.0-beta01
。查看 1.0.0-beta01 版的修訂項。
這是 Compose 1.0.0 Beta 版的第一個版本。
1.0.0-alpha12 版
2021 年 2 月 10 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha12
。查看 1.0.0-alpha12 版的修訂項。
1.0.0-alpha11 版
2021 年 1 月 28 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha11
。查看 1.0.0-alpha11 版的修訂項。
1.0.0-alpha10 版
2021 年 1 月 13 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha10
。查看 1.0.0-alpha10 版的修訂項。
1.0.0-alpha09 版
2020 年 12 月 16 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha09
。查看 1.0.0-alpha09 版的修訂項。
1.0.0-alpha08 版
2020 年 12 月 2 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha08
。查看 1.0.0-alpha08 版的修訂項。
1.0.0-alpha07 版
2020 年 11 月 11 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha07
。查看 1.0.0-alpha07 版的修訂項。
新功能
- 穩定性推論與傳播。Compose Compiler 外掛程式會分析要進行編譯的類型,以便在進入執行階段前推斷是否能執行特定的最佳化功能。接著將推論結果合成為類別的中繼資料,供其他模組中的編譯器使用。此外,這些推論的執行階段結果會透過中繼資料,於組合期間傳送至可組合的呼叫。這會導致需要針對可組合函式使用不同的中繼資料通訊協定,也就是說,使用 Alpha07 編譯器與使用舊版編譯器進行編譯的可組合函式,兩者不具二進位檔相容性。(aosp/1431988)
1.0.0-alpha06 版
2020 年 10 月 28 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha06
。查看 1.0.0-alpha06 版的修訂項。
1.0.0-alpha05 版
2020 年 10 月 14 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha05
。查看 1.0.0-alpha05 版的修訂項。
1.0.0-alpha04 版
2020 年 10 月 1 日
發布 androidx.compose.compiler:compiler:1.0.0-alpha04
。查看 1.0.0-alpha04 版的修訂項。
androidx.compose:compose-compiler
已重構為 androidx.compose.compiler:compiler
。這是新群組中的第一個版本。