產品最新消息

Jetpack Compose 2026 年 11 月版本的新功能

10 分鐘讀物
查看 Meghan Mehta 的個人資料
Meghan Mehta Android 開發人員服務代表

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),
        ),
    )
}
image5_size.png
線性漸層套用至相片底部 75% 的區域。

多邊形和變形

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 的行就能動態展開,以符合自然邊界,不會裁剪或干擾段落的其他部分。

image10.png
比較 Mode.Fixed (預設,左側) 與 Mode.PerLine (右側) 在多語言版面配置中防止文字重疊的效果。

可合併的 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 試用!

Jetpack Compose 效能技能

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 毫秒) 快

image4_size.png

由於資料流程啟動和 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 版面配置。如需版面配置容器的詳細比較,請參閱「版面配置容器」。

FlexBox 版面配置回應螢幕設定變更
FlexBox 版面配置會回應螢幕設定變更。
使用 Grid 建立彈性且可調整的二維版面配置
使用格線建立彈性且自動調整的二維版面配置。

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)
        }
    }
}
關閉詳細資料會將 track 設為 null。
關閉詳細資料會將曲目設為空值。使用 AnimatedVisibility (左) 時,資訊卡會消失,沒有任何動畫效果。CapturedAnimatedVisibility (右) 則會以動畫形式呈現最後一個影格。

立即釋出狀態也能降低退出成本:在我們的基準測試中,退出時的效能 (以影格時間計算) 比 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 試用!

Jetpack Compose Adaptive 技能

觀看這場 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,針對這些異動提供意見回饋,或告訴我們您希望接下來看到哪些功能。祝編寫愉快!

作者:
繼續閱讀