Open AIDoc

简体中文

繁體中文
日本語
한국어

简体中文

繁體中文
日本語
한국어

Appearance

Compose Multiplatform 1.6.0 中的新特性 ​

以下是 Compose Multiplatform 1.6.0 版本的亮点：

依赖项 ​

此版本的 Compose Multiplatform 基于以下 Jetpack Compose 库：

破坏性变更 ​

默认裁剪设置了行高的文本内边距 ​

随着对 LineHeightStyle.Trim 的新增支持，Compose Multiplatform 在文本内边距裁剪方式上与 Android 保持一致。关于详情，请参见此拉取请求。

这与 1.6.0-alpha01 版本 中 compose.material 的变更保持一致：

  • Android 上 includeFontPadding 参数默认变为 false。关于此变更的更深入理解，请参见有关不在 Compose Multiplatform 中实现此标志的讨论。
  • 默认行高样式已更改为 Trim.None 和 Alignment.Center。Compose Multiplatform 现在支持 LineHeightStyle.Trim 并将 Trim.None 作为默认值实现。
  • 已将显式 lineHeight 添加到 Typography 的 TextStyle 中，这导致了下一个破坏性变更。

在 MaterialTheme 中使用 fontSize 需要 lineHeight ​

这仅影响 material 组件。material3 已有此限制。

如果您在 MaterialTheme 中为 Text 组件设置了 fontSize 属性但未包含 lineHeight，则实际行高将不会被修改以匹配字体。现在，每次设置对应的 fontSize 时，您都必须显式指定 lineHeight 属性。

Jetpack Compose 现在建议不要直接设置字体大小：

为支持非标准文本大小，我们鼓励用户遵循 Material 设计系统并使用不同的类型比例，而不是直接更改字体大小。或者，用户可以像这样覆盖行高：style = LocalTextStyle.current.copy(lineHeight = TextUnit.Unspecified)，或完全创建自定义的 Typography。

资源组织的新方法 ​

如果您一直在使用 Compose Multiplatform 1.6.0 预览版中的 resources API，请熟悉当前版本的文档：1.6.0-beta01 更改了资源文件应如何存储在项目文件夹中以供项目代码使用的方式。

跨平台 ​

改进的 resources API（所有平台） ​

这个新的实验性的 API 新增了对字符串和字体的支持，并允许您更方便地在通用 Kotlin 中共享和访问资源：

  • 资源可以根据为其设计的特定设置或约束进行组织，支持：
    • 区域设置
    • 图像分辨率
    • 深色和浅色主题
  • Compose Multiplatform 现在为每个项目生成一个 Res 对象，以提供直接的资源访问。

要深入了解资源限定符以及新 resources API 的更深入概述，请参见图像和资源。

UI 测试 API（实验性的，所有平台） ​

用于 Compose Multiplatform UI 测试的实验性的 API 已适用于桌面和 Android，现在支持所有平台。您可以编写并运行通用测试，以验证您的应用程序 UI 在框架支持的所有平台上的行为。该 API 使用与 Jetpack Compose 相同的查找器、断言、操作和匹配器。

基于 JUnit 的测试仅在桌面项目中受支持。

关于设置说明和测试示例，请参见测试 Compose Multiplatform UI。

Jetpack Compose 和 Material 3 的变更（所有平台） ​

Jetpack Compose 1.6.1 ​

合并最新版本的 Jetpack Compose 对所有平台的性能产生了积极影响。关于详情，请参见 Android 开发者博客上的公告。

此版本的其他值得注意的特性：

  • 默认字体内边距的更改仅对 Android 目标生效。但是，请务必考虑此更改的副作用。
  • Compose Multiplatform 之前已支持其他目标中的鼠标选择。在 1.6.0 中，这也包括 Android。

尚未移植到 Compose Multiplatform 的 Jetpack Compose 特性：

JetBrains 团队正在致力于在即将发布的 Compose Multiplatform 版本中采纳这些特性。

Compose Material 3 1.2.0 ​

版本亮点：

  • 一个新的实验性的组件 Segmented Button，支持单选和多选。
  • 扩展的颜色集，提供了更多的表面选项，使在 UI 中强调信息变得更容易。
    • 实现说明：ColorScheme 对象现在是不可变的。如果您的代码当前直接修改 ColorScheme 中的颜色，则现在需要利用 copy 方法来更改颜色。
    • 现在有多个表面颜色和表面容器选项，而不是单一的表面值，以实现更灵活的颜色管理。

关于 Material 3 变更的更多详情，请参见 Material Design 博客上的发布文章。

为弹窗、对话框和下拉菜单提供独立的平台视图 (iOS, 桌面) ​

有时，弹窗元素（例如，工具提示和下拉菜单）不应受初始可组合画布或应用窗口的限制，这一点很重要。如果可组合视图不占据整个屏幕但需要产生一个警报对话框时，这尤其相关。在 1.6.0 中，有一种可靠的方法可以实现这一点。

请注意，弹窗和对话框仍无法在其自身边界之外绘制任何内容（例如，最顶层容器的阴影）。

iOS (稳定版) ​

在 iOS 上，此特性默认启用。 要切换回旧行为，请将 platformLayers 参数设置为 false：

kotlin
ComposeUIViewController(
    configure = {
        platformLayers = false
    }
) {
    // 您的 Compose 代码
}

桌面 (实验性的) ​

要在桌面端使用此特性，请设置 compose.layers.type 系统属性。支持的值：

  • WINDOW，用于将 Popup 和 Dialog 组件创建为单独的无装饰窗口。
  • COMPONENT，用于将 Popup 或 Dialog 作为同一窗口中的单独 Swing 组件创建。它仅适用于离屏渲染，其中 compose.swing.render.on.graphics 设置为 true（参见 1.5.0 Compose Multiplatform 发布说明中的增强的 Swing 互操作部分）。请注意，离屏渲染仅适用于 ComposePanel 组件，不适用于全窗口应用程序。

使用 COMPONENT 属性的代码示例：

kotlin
@OptIn(ExperimentalComposeUiApi::class)
fun main() = SwingUtilities.invokeLater {
    System.setProperty("compose.swing.render.on.graphics", "true")
    System.setProperty("compose.layers.type", "COMPONENT")

    val window = JFrame()
    window.defaultCloseOperation = WindowConstants.EXIT_ON_CLOSE

    val contentPane = JLayeredPane()
    contentPane.layout = null

    val composePanel = ComposePanel()
    composePanel.setBounds(200, 200, 200, 200)
    composePanel.setContent {
      ComposeContent()
    }
    composePanel.windowContainer = contentPane  // 将整个窗口用于对话框
    contentPane.add(composePanel)

    window.contentPane.add(contentPane)
    window.setSize(800, 600)
    window.isVisible = true
  }

@Composable
fun ComposeContent() {
    Box(Modifier.fillMaxSize().background(Color.Green)) {
        Dialog(onDismissRequest = {}) {
            Box(Modifier.size(100.dp).background(Color.Yellow))
        }
    }
}

Dialog（黄色）将被完整绘制，不受父级 ComposePanel（绿色）边界的限制：

Dialog outside the bounds of the parent panel

支持文本装饰线条样式 (iOS, 桌面, Web) ​

Compose Multiplatform 现在允许使用 PlatformTextStyle 类设置文本的下划线样式。

该类在公共源代码集中不可用，需要在平台特有的代码中使用。

设置点状下划线样式的示例：

kotlin
Text(
  "Hello, Compose",
  style = TextStyle(
    textDecoration = TextDecoration.Underline,
    platformStyle = PlatformTextStyle (
      textDecorationLineStyle = TextDecorationLineStyle.Dotted
    )
  )
)

您可以使用实线、双实线、点状、虚线和波浪线样式。关于所有可用选项，请参见源代码。

访问系统上安装的字体 (iOS, 桌面, Web) ​

您现在可以从 Compose Multiplatform 应用访问系统上安装的字体：使用 SystemFont 类加载具有适当字体样式和字重的字体：

kotlin
import androidx.compose.ui.text.platform.SystemFont

FontFamily(SystemFont("Menlo", weight = 700))
FontFamily(SystemFont("Times New Roman", FontWeight.Bold))
FontFamily(SystemFont("Webdings"))

在桌面端，您可以使用 FontFamily 函数仅通过指定字体族名称来加载所有可能的字体样式（关于详尽示例，请参见代码示例）：

kotlin
FontFamily("Menlo")

iOS ​

辅助功能支持 ​

适用于 iOS 的 Compose Multiplatform 现在允许残障人士以与原生 iOS UI 相同的舒适度与 Compose UI 进行交互：

  • 屏幕阅读器和 VoiceOver 可以访问 Compose UI 的内容。
  • Compose UI 支持与原生 UI 相同的导航和交互手势。

这也意味着您可以将 Compose Multiplatform 的语义数据提供给辅助功能服务和 XCTest framework。

关于实现和自定义 API 的详情，请参见对 iOS 辅助功能的支持。

更改可组合视图的不透明度 ​

ComposeUIViewController 类现在多了一个配置选项，可以更改视图背景的不透明度以使其透明。

透明背景会对性能产生负面影响，因为它会导致额外的混合步骤。

kotlin
val appController = ComposeUIViewController(configure = {
      this.opaque = false
}) {
    App()
}

透明背景可以帮助您实现的效果示例：

Compose opaque = false demo

通过双击和三击在 SelectionContainer 中选择文本 ​

以前，适用于 iOS 的 Compose Multiplatform 只允许用户通过多次轻触在文本输入字段中选择文本。现在，双击和三击手势也适用于选择 SelectionContainer 内 Text 组件中显示的文本。

与 UIViewController 的互操作 ​

一些未实现为 UIView 的原生 API，例如 UITabBarController 或 UINavigationController，无法使用现有互操作机制嵌入到 Compose Multiplatform UI 中。

现在，Compose Multiplatform 实现了 UIKitViewController 函数，允许您在 Compose UI 中嵌入原生 iOS 视图控制器。

文本字段中类似原生的光标行为（通过长按/单击） ​

Compose Multiplatform 现在更接近原生 iOS 文本字段中光标的行为：

  • 文本字段中单击后光标的位置将更精确地确定。
  • 在文本字段中长按并拖动会导致移动光标，而不是像 Android 上那样进入选择模式。

Desktop ​

对改进的互操作混合的实验性支持 ​

过去，使用 SwingPanel 包装器实现的互操作视图总是矩形的，并且总是在前景，位于任何 Compose Multiplatform 组件之上。这使得任何弹窗元素（下拉菜单、Toast 通知）都难以使用。通过新的实现，此问题已解决，您现在可以在以下用例中依赖 Swing：

  • 裁剪。您不再受矩形形状的限制：裁剪和阴影修饰符现在可以与 SwingPanel 正确配合使用。

    kotlin
    // 启用实验性混合所需的标志 
System.setProperty("compose.interop.blending", "true")

SwingPanel(
    modifier = Modifier.clip(RoundedCornerShape(6.dp))
    //...
)

    您可以看到 JButton 在没有此特性时被裁剪的方式（左侧），以及使用实验性混合时的裁剪方式（右侧）：

    Correct clipping with SwingPanel

  • 重叠。现在可以在 SwingPanel 之上绘制任何 Compose Multiplatform 内容，并像往常一样与其交互。在这里，“Snackbar”位于带有可点击的 OK 按钮的 Swing 面板之上：

    Correct overlapping with SwingPanel

关于已知限制和更多详情，请参见拉取请求的描述。

Web ​

Kotlin/Wasm artifact 在框架的稳定版本中可用 ​

Compose Multiplatform 的稳定版本现在支持 Kotlin/Wasm 目标。切换到 1.6.0 后，您无需在依赖项列表中指定 compose-ui 库的特定 dev-wasm 版本。

要构建带有 Wasm 目标的 Compose Multiplatform 项目，您需要使用 Kotlin 1.9.22 及更高版本。

已知问题：缺失的依赖项 ​

在默认项目配置下可能会缺失几个库：

  • org.jetbrains.compose.annotation-internal:annotation 或 org.jetbrains.compose.collection-internal:collection

    如果某个库依赖于 Compose Multiplatform 1.6.0-beta02，则它们可能会缺失，因为 1.6.0-beta02 与 1.6.0 不二进制兼容。要找出是哪个库，请运行此命令（将 shared 替换为您主模块的名称）：

    shell
    ./gradlew shared:dependencies

    将该库降级到依赖于 Compose Multiplatform 1.5.12 的版本，或请求库作者将其升级到 Compose Multiplatform 1.6.0。

  • androidx.annotation:annotation:... 或 androidx.collection:collection:...

    Compose Multiplatform 1.6.0 依赖于 collection 和 annotation 库，这些库仅在 Google Maven 版本库中可用。

    要使此版本库可用于您的项目，请将以下行添加到模块的 build.gradle.kts 文件中：

    kotlin
    repositories {
    //...
    google()
}

Copyright © 2025 Open AIDoc.