撰寫
透過可組合函式描述 UI 的形狀和資料依附元件,以程式輔助方式定義 UI。
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 基礎元件,包括版面配置、繪圖及輸入。 |
版本
下表是每個群組的目前版本。
Maven 群組 ID | 最新版 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|---|
compose.animation | 2025 年 8 月 13 日 | 1.9.0 | - | - | 1.10.0-alpha01 |
compose.compiler | 2024 年 8 月 7 日 | 1.5.15 | - | - | - |
compose.foundation | 2025 年 8 月 13 日 | 1.9.0 | - | - | 1.10.0-alpha01 |
compose.material | 2025 年 8 月 13 日 | 1.9.0 | - | - | 1.10.0-alpha01 |
compose.material3 | 2025 年 8 月 13 日 | 1.3.2 | - | 1.4.0-beta02 | 1.5.0-alpha02 |
compose.runtime | 2025 年 8 月 13 日 | 1.9.0 | - | - | 1.10.0-alpha01 |
compose.ui | 2025 年 8 月 13 日 | 1.9.0 | - | - | 1.10.0-alpha01 |
宣告依附元件
如要新增 Compose 的依附元件,必須將 Google Maven 存放區新增至您的專案。詳情請參閱「Google 的 Maven 存放區」一節。
在應用程式或模組的 build.gradle
檔案中,新增所需構件的依附元件:
Groovy
android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
BOM
如要瞭解最新版 BOM,請前往 Compose BOM 對應頁面。
公告事項
日期 | 公告 |
---|---|
2025 年 8 月 13 日 | 2025 年 8 月的 Compose 物料清單 (BOM) 已發布,其中包含 Jetpack Compose 1.9 的穩定版!Android 的現代 UI 工具包推出更新,導入多項新功能,例如進階陰影、2D 捲動 API,以及更優異的清單效能。如要進一步瞭解所有新功能和改善項目,請參閱完整網誌文章! |
2025 年 4 月 23 日 | Compose 1.8 版現已推出!這個 Android 現代 UI 工具包版本提供自動填入等新功能、多項文字改善項目,以及可見度追蹤功能。您也可以用新的方式為可組合項的大小和位置製作動畫。此外,我們也將許多實驗性 API 升級為穩定版,並修正多項錯誤。如要進一步瞭解這個版本的所有新功能和改善項目,請參閱完整網誌文章! |
2024 年 9 月 4 日 | 1.7 版 Jetpack Compose 推出多項功能,無論您要建構的板型規格為何,都能加快 Android 開發速度並簡化作業。我們也分享了有關 Android 生態系統擴大支援 Compose 的消息。 |
2024 年 1 月 24 日 | Jetpack Compose 1.6 現已成為 Compose 2024 年 1 月物料清單的穩定版!這個版本主要著重於提升效能,我們會持續遷移修飾符,並改善 API 主要部分的效率。 |
2023 年 6 月 26 日 | 自 Compose 1.5.0-beta01 版起,Compose aar 位於 `*-android` 構件下方。在 1.6.0-alpha01 中,Compose POM 檔案已更新,預設會指向 `-android` 構件,以便在不支援 Gradle 模組中繼資料的建構系統中解析依附元件。 |