Kotlin Multiplatform Development Help

兼容性与版本

Compose Multiplatform 的发布与 Kotlin 和 Jetpack Compose 的发布是分开进行的。本页包含有关 Compose Multiplatform 版本、不同版本间的兼容性以及发布周期的信息。

支持的平台

Compose Multiplatform 1.7.3 支持以下平台:

  • Android

  • iOS

  • macOS (x86-64, arm64)

  • Windows (x86-64, arm64)

  • Linux (x86-64, arm64)

  • Web 浏览器

Compose Multiplatform 桌面版的限制

Compose Multiplatform 桌面版存在以下限制:

  • 由于 Skia 绑定中使用的内存管理方案,仅支持 JDK 11 或更高版本。

  • 由于 jpackage 的限制,打包原生分发时仅支持 JDK 17 或更高版本。

  • 在 macOS 上切换键盘布局时,OpenJDK 11.0.12 存在一个已知的 问题 。此问题在 OpenJDK 11.0.15 中不可复现。

Kotlin 兼容性

只要您使用的是 Compose Multiplatform 1.6.10 或更高版本以及 Kotlin 1.7.10 或更高版本,Compose Multiplatform 就与 Kotlin 兼容。无需手动对齐它们的版本。请注意,使用任一产品的 EAP 版本仍可能存在不稳定性。

Compose Multiplatform 要求应用的 Compose Compiler Gradle 插件版本与 Kotlin 版本相同。详情请参阅 更新 Compose 编译器

Jetpack Compose 与 Compose Multiplatform 的发布周期

Compose Multiplatform 与 Google 开发的 Android 框架 Jetpack Compose 共享大量代码。我们将 Compose Multiplatform 的发布周期与 Jetpack Compose 的发布周期对齐,以确保公共代码得到充分测试和稳定。

当新版本的 Jetpack Compose 发布时,我们会:

  • 使用该发布提交作为下一个 Compose Multiplatform 版本的基础。

  • 添加对新平台功能的支持。

  • 稳定所有平台。

  • 发布新版本的 Compose Multiplatform。

Compose Multiplatform 发布与 Jetpack Compose 发布之间的间隔通常为 1-3 个月。

Compose Multiplatform 的开发版本

Compose Multiplatform 编译器插件的开发版本(例如 1.7.0-dev1776 )没有固定的发布计划,用于在正式版本之间测试更新。

这些构建版本不提供于 Maven Central 。要访问它们,请在仓库列表中添加以下行:

maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")

使用的 Jetpack Compose 构件

当您为 Android 构建应用时,Compose Multiplatform 会使用 Google 发布的构件。例如,如果您应用了 Compose Multiplatform 1.5.0 Gradle 插件并在 dependencies 中添加了 implementation(compose.material3) ,那么您的项目将在 Android 目标中使用 androidx.compose.material3:material3:1.1.1 构件(但在其他目标中使用 org.jetbrains.compose.material3:material3:1.5.0)。

下表列出了每个 Compose Multiplatform 版本使用的 Jetpack Compose 构件版本:

Compose Multiplatform 版本

Jetpack Compose 版本

Jetpack Compose Material3 版本

1.7.3

1.7.6

1.3.1

1.7.1

1.7.5

1.3.1

1.7.0

1.7.1

1.3.0

1.6.11

1.6.7

1.2.1

1.6.10

1.6.7

1.2.1

1.6.2

1.6.4

1.2.1

1.6.1

1.6.3

1.2.1

1.6.0

1.6.1

1.2.0

1.5.12

1.5.4

1.1.2

1.5.11

1.5.4

1.1.2

1.5.10

1.5.4

1.1.2

1.5.1

1.5.0

1.1.1

1.5.0

1.5.0

1.1.1

1.4.3

1.4.3

1.0.1

1.4.1

1.4.3

1.0.1

1.4.0

1.4.0

1.0.1

1.3.1

1.3.3

1.0.1

1.3.0

1.3.3

1.0.1

1.2.1

1.2.1

1.0.0-alpha14

1.2.0

1.2.1

1.0.0-alpha14

1.1.1

1.1.0

1.0.0-alpha05

1.1.0

1.1.0

1.0.0-alpha05

1.0.1

1.1.0-beta02

1.0.0-alpha03

1.0.0

1.1.0-beta02

1.0.0-alpha03

22 四月 2025