Jetpack Compose 2026 年 11 月版已是穩定版!這個版本將核心 Compose 模組升級至 1.13 版 (請參閱完整的 BOM 對應),並更新文字、圖形、版面配置、效能等,同時也淘汰一些重要功能,並變更行為,請務必留意。
如要將專案更新至這個版本,請將 Compose BOM 版本升級至 2026.11.01。請注意,這項升級需要 Kotlin 2.2 (或更新版本) 和 compileSdk 37.1。
implementation(platform("androidx.compose:compose-bom:2026.11.01"))
圖形
我們會持續在 Compose 中加入許多新的圖像功能。Compose 1.13 推出多邊形、漸進式模糊處理,以及直接在對話方塊和彈出式視窗上設定模糊處理屬性的功能。
漸進式模糊
Jetpack Compose 1.13 推出漸進式模糊功能,可讓元素從清晰流暢地轉換為模糊。漸進式模糊效果是以繪製階段 lambda 為基礎,使用 Modifier.blur { ... } 和 BlurRadiusSpec。您可以實作線性漸層 (例如垂直或水平轉換)、放射漸層 (用於焦點聚光燈效果),甚至傳遞自訂 AGSL RuntimeShaders,以驅動動態、程序性模糊地圖。
無論是使用 BlurredEdgeTreatment.Unbounded 將標題圖片的底部邊緣融入背景,還是使用放射狀聚光燈追蹤觸控座標,漸進式模糊處理都能讓您在 Android 上輕鬆實現優質、觸感豐富的景深效果。
Modifier.blur { blurRadiusSpec = BlurRadiusSpec.linearGradient( start = DpOffset.Zero, end = DpOffset(size.width, size.height), stops = listOf( BlurStop(fraction = 0f, radius = 0.dp), BlurStop(fraction = 0.5f, radius = 0.dp), BlurStop(fraction = 0.75f, radius = 14.dp), BlurStop(fraction = 1f, radius = 28.dp), ), ) }
多邊形和變形
Compose 1.13 在 androidx.compose.foundation:foundation 中新增了 PolygonShape 和 MorphPolygonShape。目前為止,在 Compose 中建立圓角多邊形、星形和形狀變形,都需要直接使用 androidx.graphics:graphics-shapes,也就是新增依附元件、建立適當像素大小的 RoundedPolygon、將其轉換為 Path,並編寫自己的 Shape,使其符合版面配置邊界。
PolygonShape 是常規 Compose Shape,因此可與 Modifier.clip 或任何元件的形狀參數搭配使用,並自動解析為版面配置大小。MorphPolygonShape 會在繪製時讀取進度 lambda,在兩個多邊形形狀之間建立動畫效果,不需重組。只有在 Compose UI 外部,或需要原始 RoundedPolygon 幾何圖形時,才直接使用 graphics-shapes。您不需要新增 graphics-shapes 即可使用 PolygonShape,因為 foundation 已依附於該程式庫。
var recording by remember { mutableStateOf(false) } val progress by animateFloatAsState(if (recording) 1f else 0f) val shape = remember { MorphPolygonShape( start = PolygonShape.circle(), end = PolygonShape.star( numPoints = 9, innerRadiusRatio = 0.8f, outerRounding = CornerRounding.fraction(0.5f), ), progress = { progress }, ) } Box( Modifier .size(96.dp) .clip(shape) .background(MaterialTheme.colorScheme.primary) .clickable { recording = !recording } )
背景模糊和彈出式視窗屬性
您現在可以直接在 DialogProperties (以及 PopupProperties 上的 blurBehindRadius/scrimAlpha) 設定 blurBehindRadius、backgroundBlurRadius、scrimAlpha 和 windowShape (將對話方塊背景模糊效果裁剪為圓角)。
您也可以透過 WindowInfo.isCrossWindowBlurEnabled 查詢系統跨視窗模糊處理狀態。
提升圖像效能
快取功能改善
在 Compose 1.13 中,靜態圖示的算繪效率更高。VectorPainter 會自動在繪圖器之間共用及重複使用光柵化繪圖快取,以相同的大小和設定算繪相同的靜態 ImageVector,避免重複分配點陣圖和光柵化。如要盡可能提高快取效率,請在組合中重複使用 ImageVector 執行個體,而非重新建立。這項最佳化功能預設為啟用,並透過 ComposeUiFlags.isVectorDrawCacheSharingEnabled 執行。
修飾符邊框改善項目
Modifier.border 現在提供更快速、更高效能的實作,並新增對所有形狀類型的執行階段著色器 (ShaderBrush 搭配 RuntimeShader) 支援,並在算繪邊框時一致使用外框大小。
如要進一步瞭解 Compose 和 Android 平台的所有新圖形功能,請觀看 2026 年 Android 開發人員高峰會的演講:
Material 3 1.5.0
Compose Material 3 1.5.0 版現已穩定,並推出下列功能:
Slider和RangeSlider已遷移至SliderState的有狀態模型。- 新的表現力元件,包括
ToggleButtons、WavyProgressIndicators和TimePickers。 BottomAppBar、TopAppBar variants和BasicAlertDialog等 API 升級為穩定版。material3-ripple構件,具有內嵌焦點環。
在這個版本中,我們將實驗性註解減少 52%,從 120 個降至 58 個。此外,我們也將幾乎所有新的表達元件升級為穩定版。Material 3 已推出六年,Compose Material 2 程式庫已淘汰,不再主動維護。建議您從 Material 2 遷移至 Material 3,取得最新的 Android 錯誤修正和設計語言。立即將依附元件升級至 Material 3 1.5.0,在應用程式中加入這些全新生動元件。如要進一步瞭解所有新元件、效能更新和行為變更,請參閱網誌文章。
文字
遷移至以狀態為基礎的 BasicTextField
以值為基礎的 BasicTextField 和 Material 2 TextField 已正式淘汰。這項異動旨在引導您改用更強大的狀態型 BasicTextField 和 TextFieldState API。
如果您使用的是 Material 3,現有的值型 TextField 超載在 1.5.0 中尚未淘汰,但建議您遷移至狀態型 TextField 和 OutlinedTextField 超載,充分利用同步狀態、改善效能和即將推出的功能。如果您仍在使用 Material 2,請直接遷移至 Material 3 的狀態式文字欄位。
原生支援儲存及還原格式化樣式,因此遷移至 TextFieldState 後,您將獲得更優異的現成效能,以及更安全的同步狀態模型。這個版本也從復原/重做記錄和變更追蹤緩衝區中移除實驗性註解。此版本已淘汰 VisualTransformation 等舊版公用程式,改用 OutputTransformation 和 InputTransformation 等簡化替代方案,包括內建的長度限制篩選器。
如要進一步瞭解如何遷移至狀態式文字欄位,請觀看 2026 年 Android 開發人員高峰會的這場演講:
每行行高
在單一段落中顯示多語言文字或混合字型大小時,統一的行距可能會導致較高的文字 (例如緬甸文、高棉文或泰文) 與相鄰行碰撞。Compose 1.13 推出 LineHeightStyle.Mode.PerLine,可獨立計算每行的行高。這樣一來,含有較高字符或較大 Span 的行就能動態展開,以符合自然邊界,不會裁剪或干擾段落的其他部分。
可合併的 FontVariation.Settings
Compose 1.13 在 FontVariation.Settings 中新增合併超載,可輕鬆定義基本可變字型設定,並動態覆寫特定軸 (例如粗細、傾斜或寬度),不必重新分配或重建整個設定清單。
// Define a shared base configuration for your variable font val baseVariation = FontVariation.Settings(FontVariation.weight(400), FontVariation.width(100f)) // Easily override or combine specific axes inline val boldVariation = baseVariation.merge(FontVariation.weight(700)) val condensedVariation = baseVariation.merge(FontVariation.width(85f))
效能
效能靜態分析技能
我們新增了 Jetpack Compose 效能靜態分析技能,可針對七大類別 (狀態和穩定性、延遲版面配置、版面配置、圖形、動畫、效果和執行緒,以及 Modifier.Node 遷移) 提供免設定的程式碼稽核和生成功能,讓您能對任何 PR、檔案或畫面執行獨立檢查,確保符合目前的最佳做法。歡迎立即透過 Android CLI 試用!
computedStateOf
1.13 版推出新的狀態運算機制 computedStateOf。它提供 derivedStateOf 的輕量替代方案,適用於條件檢查和從其他頻繁變更的狀態 (例如捲動位置和動畫門檻) 計算出的篩選狀態。由於不快取計算結果,因此負擔比 derivedStateOf 更少,尤其是當計算結果因其中一個參照狀態變更而失效時。
當計算結果變更時,這兩種狀態變化都會使組合失效,但輸入狀態變更時則不會。這類函式通常用於將頻繁變更的狀態轉換為不常變更的狀態,避免組合階層因不影響的狀態變更而失效。請將 derivedStateOf 保留給需要大量運算或快取的情況。一般來說,建議使用 computedStateOf 而非 derivedStateOf 進行狀態運算。
在 Perfetto 中追蹤重組
重組追蹤是一項新功能,可為現有的組合追蹤作業加入狀態讀取和狀態寫入的新資訊,讓您全面掌握導致重組的狀態變更。對於影響組合結構的每次讀取和寫入,系統會記錄狀態的字串表示法和堆疊追蹤,精確指出發生變更的程式碼行。
請注意,記錄額外資料以追蹤重組作業會增加負擔,因此在調查應用程式效能時,請務必停用這項功能。
主要基準
在 Pixel 6 上,Compose 1.13 在所有基準啟動和捲動基準測試中,與 Compose 1.12.1 的卡頓率皆為 0%。在冷啟動時,Compose 1.13 的初始顯示時間 (147.65 毫秒) 仍比 View (152.87 毫秒) 快
由於資料流程啟動和 GPU 著色器工作的差異,View 的完整顯示時間 (180.32 毫秒) 仍比 Compose (202.79 毫秒) 快。Compose 的捲動影格時間長度 (P50) 為 3.51 毫秒,View 則為 3.06 毫秒,整體效能在有效測試執行中保持穩定一致。我們持續投入大量資源,改善所有成效指標,並著重於啟動指標。如要查看完整結果,請參閱說明文件。
如要進一步瞭解效能,請觀看 2026 年 Android 開發人員高峰會的講座:
版面配置
穩定版 FlexBox 和 Grid
FlexBox 和 Grid 版面配置 (在 Compose 1.11 中宣布) 已正式從實驗版升級為穩定版。這些 API 可用於正式環境,是包裝格線和回應式設計的高效能替代方案。FlexBox 也新增了 maxItemsInEachLine 設定,可讓您在啟用換行功能時,限制一行中的項目數量。
FlexBox 會取代 Flow 版面配置 (FlowRow 和 FlowColumn),建議您在新的程式碼中使用 FlexBox,而非 Flow 版面配置。如需版面配置容器的詳細比較,請參閱「版面配置容器」。
ConstraintLayout 和 MotionLayout 淘汰
隨著 Compose 推出更現代化的版面配置和動畫工具,以及新的 Shared Element API,我們正式淘汰 Compose (androidx.constraintlayout:constraintlayout-compose 構件) 中的 ConstraintLayout 和 MotionLayout。
這些新替代方案提供高效能解決方案,可簡化 Compose 原生複雜使用者介面的建構程序。建議您將 ConstraintLayout Compose 用途遷移至上述替代方案。
Stable LazyLayoutCacheWindow
LazyLayoutCacheWindow 穩定後,所有主要延遲集合系列 (清單、格線和交錯格線) 都能直接使用強大的快取和視窗式預先擷取功能。這項功能可改善 Lazy 版面配置在螢幕外組合的效能。
這個版本的主要亮點包括:
- 簡化 API 設定:快取視窗設定已從捲動狀態容器 (例如
rememberLazyListState) 直接移至版面配置可組合項 (LazyColumn、LazyVerticalGrid 等),讓預先擷取和快取成為直接的版面配置考量。 - 視窗式預先擷取:以預設的視窗式預先擷取引擎取代舊版項目式預先擷取,根據可視區域指標動態計算前方視窗,並可自訂前方和後方視窗,保留螢幕外組合。
如要瞭解 Instagram Direct 如何透過使用 LazyLayoutCacheWindow 受益,請參閱個案研究網誌文章,並查看說明文件瞭解詳情。
動畫
Compose 1.13 穩定 DeferredTransition,並推出新的可組合函式 CapturedAnimatedVisibility。
CapturedAnimatedVisibility
AnimatedVisibility 會持續組成內容,直到退出動畫結束為止,因此在退出動畫期間,必須保留傳出內容和狀態。如果內容取決於已消失的狀態,可能會導致畫面閃爍。舉例來說,關閉詳細資料窗格會將所選項設為 null,因此現有內容不會顯示任何資訊。您可能會在動畫中看到空白或閃爍,如果使用 !!,則會發生當機,或者您必須自行保留舊值。
Compose 1.13 推出 CapturedAnimatedVisibility。這個可組合項不需要呼叫端在結束期間管理狀態,因為當 visible 變成 false 時,它會擷取最後一個影格的快照。您可以立即清除狀態,結束動畫仍會顯示畫面上的內容。
@Composable fun TrackDetails(track: Track?) { // `track` becomes null as soon as the details are closed. CapturedAnimatedVisibility // removes the content right away and animates a snapshot of its last frame instead. CapturedAnimatedVisibility( visible = track != null, enter = fadeIn() + expandVertically(), exit = fadeOut(tween(800)) + shrinkVertically(tween(800)), ) { if (track != null) { TrackCard(track) } } }
立即釋出狀態也能降低退出成本:在我們的基準測試中,退出時的效能 (以影格時間計算) 比 AnimatedVisibility 快 7% 到 8%。如果現有內容需要保持運作,或您需要在子項上使用 Modifier.animateEnterExit(),請繼續使用 AnimatedVisibility,否則建議使用 CapturedAnimatedVisibility。
測試中的自訂失敗處理
偵錯失敗的 UI 測試 (尤其是在 CI 環境中) 時,通常需要檢查斷言失敗時的螢幕狀態和語意階層。Compose 1.13 透過 ComposeUiTestConfig 中的 TestFailurePolicy 導入原生失敗處理管道,自動診斷測試。
TestFailurePolicy可讓您:
- 擷取內建構件:將
screenshotCaptureMode和uiHierarchyCaptureMode設為CaptureMode.Enabled,以便在測試失敗時自動傾印視覺螢幕截圖和 UI 語意樹。 - 執行自訂失敗處理常式:註冊一或多個
TestFailureHandler執行個體來處理FailureContext,這會提供根error和任何產生的artifacts。這樣一來,您就能上傳螢幕截圖,或將失敗遙測資料轉送至外部報表工具。 - 為整個測試套件設定擷取功能:透過
testInstrumentationRunnerArguments(androidx.compose.ui.test.failure.isScreenshotCaptureEnabled和androidx.compose.ui.test.failure.isUiHierarchyCaptureEnabled) 在build.gradle.kts中全域啟用螢幕截圖和 UI 階層擷取功能,不必修改個別測試檔案,同時保留覆寫個別測試的功能。
val customConfig = ComposeUiTestConfig( failurePolicy = TestFailurePolicy( screenshotCaptureMode = TestFailurePolicy.CaptureMode.Enabled, uiHierarchyCaptureMode = TestFailurePolicy.CaptureMode.Enabled, failureHandlers = listOf( TestFailureHandler { context -> val screenshot = context.artifacts.firstOrNull { it.type == FailureArtifact.Type.Screenshot } // Process or upload the artifact and context.error } ) ) ) @Test fun myTest() = runComposeUiTest(config = customConfig) { // Test content }
適應技能
使用更新後的自動調整技能,針對摺疊式裝置和電腦最佳化 Compose UI!
在摺疊式裝置上打造免持桌面體驗:將內容呈現在直立螢幕上,並將控制項放在平放的下半部,讓手指不會遮擋畫面。
這項技能也有助於讓應用程式在電腦上感覺像原生應用程式,提供鍵盤快速鍵、工具提示和自訂游標,以及經過驗證的模式,防止使用者旋轉或展開裝置時遺失狀態。歡迎立即透過 Android CLI 試用!
觀看這場 Android 開發人員高峰會演講,瞭解如何提升折疊式裝置和電腦支援:
準確計算巢狀捲動速度
針對採用混合 UI 架構的應用程式,我們解決了在 Android View 捲動容器 (例如 ScrollView、NestedScrollView 或 CoordinatorLayout) 內巢狀結構的 Compose 中快速捲動時,有時會計算錯誤速度的問題。現在系統會準確計算速度交接,避免突然停止或捲動不流暢,確保在 View 和 Compose 邊界之間能順暢滑動。
行為變更:
Modifier.onFocusedBoundsChanged 現已淘汰
Modifier.onFocusedBoundsChanged 已在 Compose 1.12 中淘汰,並在 1.13 中移除實作,因此執行修飾符不會產生任何效果。舊版實作在許多情況下無法可靠地回報焦點邊界,且有效能問題。
內建的捲動容器 (例如 LazyColumn 和 Modifier.verticalScroll) 即使不使用這個 API,也能將焦點內容帶入檢視畫面,因此不受影響。
如要取得焦點元素的邊界,請從自訂 Modifier.Node 呼叫 FocusTargetModifierNode.getFocusedRect()。當您要求邊界時,它會傳回邊界,而不是透過回呼回報每項變更。如要回應焦點變更,請使用 Modifier.onFocusChanged。如要在自訂容器中捲動焦點項目,請將 onFocusChanged 與 BringIntoViewRequester 搭配使用。
行為變更:Android 平台互動音效
現在,使用 Modifier.clickable 設定的可點擊元素 (或以其為基礎建構的元件) 會自動播放標準 Android 互動音效,並遵循使用者的系統音效設定。先前,Compose 可點擊元素需要手動叫用音效,才能與傳統 Android View 保持一致。這項更新可確保互動元素提供即時音訊回饋,並在 Android 平台上提供原生體驗。
樣式更新
在 Google I/O 大會上,我們預先介紹了不需分支原始碼,就能自訂元件的新方法。在 Compose 1.13 中,這個基礎架構已演變成無特定意見的樣式引擎。屬性定義已移至設計系統層,而非由框架硬式編碼視覺屬性,讓團隊能完全自主宣告自訂品牌符記 (stylePropertyOf / styleLocalOf)。
由於架構有所變更,Styles API 在 Compose 1.13 中仍處於實驗階段。我們正積極與合作夥伴和 Material 3 合作,在正式發布前,改善樣式合併和開發人員人體工學。在轉換期間,我們已移除「樣式」的說明文件和技能。
全新 Compose Web 程式庫,可輕鬆遷移 WebView (Alpha 版)
在 Compose 中嵌入網路內容,是應用程式遷移作業的最後一個難題。使用 AndroidView 的舊版實作方式可能會導致捲動卡頓、設定變更或導覽期間狀態遺失,以及互通轉譯負擔。
為消除這項阻礙,我們將推出兩個程式庫,分別以 androidx.web 的兩個互補原始物件為基礎建構:
WebContent(現已在androidx.web:web:1.0.0-alpha01中推出):一種狀態容器,可將網頁狀態 (包括捲動位置、表單輸入、導覽記錄和 JavaScript 狀態) 與檢視區塊階層分離,因此在設定變更和導覽後仍可保留,不會洩漏Activity。
@Composable // Assumes `webContent` is already created and retained (e.g., in a ViewModel or via `retain`) fun WebContentPage(webContent: WebContent, startUrl: String, modifier: Modifier = Modifier) { key(webContent) { AndroidView( factory = { context -> webContent.attach(context, ::WebContentView).apply { settings.javaScriptEnabled = true if (url == null) loadUrl(startUrl) } }, modifier = modifier, onRelease = { view -> // The view must leave the hierarchy before WebContent is detached. (view.parent as? ViewGroup)?.removeView(view) webContent.detach() }, ) } }
WebSurface(即將推出):專為WebContent最佳化的可組合項,可略過AndroidView互通性負擔。
歡迎立即匯入 androidx.web:web:1.0.0-alpha01 試用 API,並密切關注近期推出的 WebSurface Alpha 版。
全新 Jetpack Compose A2UI 轉譯器
執行階段 LLM 回覆不應限於純文字。新的 Jetpack Compose A2UI 轉譯器會實作開放式 Agent-to-UI (A2UI) 通訊協定。
implementation("androidx.compose.material3:material3-a2ui:1.0.0-alpha02")
AI 代理可在執行階段建立豐富的互動式 UI,並轉譯為原生 Compose 元件,不需執行任意程式碼。轉譯器會處理訊息剖析和結構定義驗證,並將代理資料饋送至 Compose 快照狀態。您可以使用現成的基本目錄,也可以插入自己的可組合項和設計系統。請參閱說明文件,或觀看 Android 開發人員高峰會的演講,瞭解如何開始使用。
說明文件更新
我們推出了新說明文件,涵蓋錨定可拖曳、Navigation3 深層連結和 AppState。
祝您編寫愉快!
Compose 1.13 更新了文字、圖形、版面配置、效能等,讓應用程式開發更輕鬆,也更具表現力!如要查看 BOM 版本之間的完整變更,請使用 BOM 比較工具查看差異。
如要進一步瞭解 Compose 的新功能,請觀看 Android 開發人員高峰會的最新演講。
我們一向重視您的意見,歡迎透過Issue Tracker,針對這些異動提供意見回饋,或告訴我們您希望接下來看到哪些功能。祝編寫愉快!
-
產品最新消息今天,Android Auto 和內建 Google 服務、搭載 Android Automotive OS 的車輛,正式結束遊戲類別的 Beta 版測試,全面開放使用。
-
產品最新消息我們很高興看到開發人員持續將應用程式和體驗帶到車輛專用 Android!過去一年,Android Auto 和內建 Google 服務的車輛,在應用程式生態系統中持續展現強勁成長和動能。
Jan Kleinert, Noam Gefen, Thomas Weathers • 閱讀時間:3 分鐘 -
產品最新消息Jetpack Compose 推出近 5 年來,我們致力提供各種功能、效能和工具,協助您在各種 Android 裝置上打造出色的 UI。
Nick Butcher • 閱讀時間:2 分鐘
每週透過電子郵件接收最新的 Android 開發人員洞察資訊。