产品资讯

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 界面中或需要原始 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 中的重组跟踪

重组跟踪是一种新方法,可利用有关状态读取和状态写入的新信息来增强现有组合跟踪,从而让您全面了解导致重组的状态更改。对于影响组合的每次读取和写入,它都会记录状态的字符串表示和堆栈轨迹,以精确定位发生更改的确切代码行。

请注意,记录用于重组跟踪的其他数据会增加开销,因此在调查应用的性能时,请务必停用该功能。

Hero 基准

在 Pixel 6 上,Compose 1.13 在所有基准启动和滚动基准测试中均与 Compose 1.12.1 相当,卡顿率为 0%。在冷启动时,Compose 1.13 的初步显示所用时间 (147.65 ms) 仍然比 View (152.87 ms) 更快

image4_size.png

由于数据流启动和 GPU 着色器工作方面的差异,View 的完全显示时间仍然更快(180.32 毫秒,而 Compose 为 202.79 毫秒)。Compose 的滚动帧时长 (P50) 为 3.51 毫秒,而 View 的滚动帧时长为 3.06 毫秒,在有效测试运行中,整体性能保持稳定且一致。我们继续投入大量资源来改进所有性能指标,重点是启动指标。如需查看完整结果,请参阅文档。

如需详细了解性能,请观看 2026 年 Android 开发者峰会上的演讲:

布局

稳定的 FlexBox 和网格

FlexBox 和 Grid 布局(在 Compose 1.11 中发布)已正式从实验阶段进入稳定阶段。这些 API 是可用于生产用途的高性能替代方案,适用于换行网格和自适应设计。FlexBox 还新增了配置 maxItemsInEachLine,让您可以在启用换行功能时限制一行中的内容数量。

FlexBox 取代了流式布局(FlowRow 和 FlowColumn),我们建议在新代码中使用 FlexBox,而不是流式布局。如需详细比较布局容器,请参阅布局容器。

FlexBox 布局响应屏幕配置更改
FlexBox 布局响应屏幕配置更改。
使用 Grid 实现灵活且自适应的二维布局
使用 Grid 实现灵活且自适应的二维布局。

ConstraintLayout 和 MotionLayout 弃用

随着 Compose 中引入了更现代的布局和动画工具以及新的共享元素 API,我们将正式弃用 Compose(androidx.constraintlayout:constraintlayout-compose 工件)中的 ConstraintLayout 和 MotionLayout。

这些较新的替代方案提供了高性能的解决方案,可让您以更简化的方式构建 Compose 原生的复杂界面。我们建议您将 ConstraintLayout Compose 用法迁移到上述替代方案。

稳定的 LazyLayoutCacheWindow

LazyLayoutCacheWindow 的稳定版本直接为所有主要延迟加载集合系列(列表、网格和交错网格)带来了强大的缓存和基于窗口的预提取功能。此功能可提高屏幕外组合的延迟布局性能。

此版本的主要亮点包括:

  • 简化的 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。
关闭详细信息会将轨道设置为 null。使用 AnimatedVisibility(左侧)时,卡片会消失,没有任何动画效果。CapturedAnimatedVisibility(右侧)会为其最后一帧添加动画效果。

立即释放状态还可以降低退出成本:在我们的基准测试中,退出期间的性能在帧时间方面比使用 AnimatedVisibility 快 7-8%。如果现有内容需要保持有效,或者您需要在其子项上使用 Modifier.animateEnterExit(),请继续使用 AnimatedVisibility,否则最好使用 CapturedAnimatedVisibility。

测试中的自定义失败处理

调试失败的界面测试(尤其是在 CI 环境中)通常需要检查断言失败的确切时刻的屏幕状态和语义层次结构。Compose 1.13 通过 ComposeUiTestConfig 中的 TestFailurePolicy 引入了原生失败处理流水线,以自动执行测试诊断。

借助 TestFailurePolicy,您可以:

  • 捕获内置工件:将 screenshotCaptureMode 和 uiHierarchyCaptureMode 设置为 CaptureMode.Enabled,以便在测试失败时自动转储视觉屏幕截图和界面语义树。
  • 运行自定义失败处理程序:注册一个或多个 TestFailureHandler 实例来处理 FailureContext,后者提供根 error 和任何生成的 artifacts。这样,您就可以上传屏幕截图或将故障遥测数据转发到外部报告工具。
  • 在整个测试套件中配置捕获:通过 testInstrumentationRunnerArguments(androidx.compose.ui.test.failure.isScreenshotCaptureEnabled 和 androidx.compose.ui.test.failure.isUiHierarchyCaptureEnabled)在 build.gradle.kts 中全局启用屏幕截图和界面层次结构捕获,而无需修改单个测试文件,同时保留在每个测试中替换这些设置的功能。
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 界面!

在可折叠设备上打造免触摸桌面模式体验,在竖立的屏幕上呈现内容,在平放的下半部分放置控件,让手指远离视图。
该技能还将帮助您通过键盘快捷键、提示和自定义光标,让您的应用在桌面上具有原生体验,并提供经过验证的模式,防止用户旋转或展开设备时状态丢失。立即通过 Android CLI 试用!

Jetpack Compose 自适应技能

观看此 Android 开发者峰会演讲,了解如何提升可折叠设备和桌面设备支持:

准确计算嵌套滚动速度

对于采用混合界面架构的应用,我们解决了一个问题:在嵌套于 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 中嵌入 Web 内容是应用迁移过程中的最后几个难点之一。使用 AndroidView 的旧版实现可能会导致滚动卡顿、配置更改或导航期间状态丢失,以及互操作渲染开销。

为了消除这种不便,我们推出了两个库,它们基于androidx.web中的两个互补原语构建:

  • WebContent(现已在 androidx.web:web:1.0.0-alpha01 中推出):一种状态容器,可将 Web 状态(包括滚动位置、表单输入、导航记录和 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 渲染程序实现了开放式智能体到界面 (A2UI) 协议。

implementation("androidx.compose.material3:material3-a2ui:1.0.0-alpha02")

AI 智能体可在运行时创建丰富的交互式界面,这些界面会呈现为原生 Compose 组件,而无需执行任意代码。渲染程序负责处理消息解析和架构验证,并将代理数据馈送到 Compose 快照状态。您可以使用现成的基本目录,也可以插入自己的可组合项和设计系统。请参阅相关文档,或观看 Android 开发者峰会上的演讲。

文档更新

我们提供了新的文档,涵盖锚定可拖动项、Navigation3 深层链接和 AppState。

祝编程顺利!

Compose 1.13 带来了文本、图形、布局、性能等方面的更新,让应用开发变得比以往更轻松、更具表现力!如需查看 BOM 版本之间的完整变更,请使用 BOM 比较工具查看差异。

如需详细了解 Compose 的新变化,请观看 Android 开发者峰会上的最新演讲。

我们一如既往地重视您的意见,因此请通过我们的问题跟踪器分享您对这些变更的反馈,或告诉我们您希望接下来看到哪些改进。祝编程顺利!

作者:
继续阅读