Kotlinv2.4.0

Compose Multiplatform 1.6.10 最新变化 ​

以下是此功能版本的亮点：

请参阅 GitHub 上的此版本的完整变更列表。

依赖项 ​

破坏性变更：新的 Compose 编译器 Gradle 插件 ​

从 Kotlin 2.0.0 开始，Compose Multiplatform 需要新的 Compose 编译器 Gradle 插件。 有关详细信息，请参阅迁移指南。

跨平台 ​

资源 ​

稳定资源库 ​

资源库 API 的大部分内容现已视为稳定。

支持在多模块项目中使用 Compose Multiplatform 资源 ​

从 Compose Multiplatform 1.6.10 开始， 您可以将资源存储在任何 Gradle 模块和任何源集中，还可以发布包含资源的项目和库。

要启用多模块支持，请将您的项目更新到 Kotlin 版本 2.0.0 或更高版本，以及 Gradle 7.6 或更高版本。

多平台资源的配置 DSL ​

您现在可以微调项目中 Res 类的生成：更改该类的修饰符（modality）和分配的软件包，以及选择生成该类的条件：始终生成、从不生成或仅在显式依赖资源库时生成。

有关详细信息，请参阅文档部分。

用于生成资源 URI 的公共函数 ​

新的 getUri() 函数允许您将资源的平台相关 URI 传递给外部库，以便它们可以直接访问文件。 有关详细信息，请参阅文档。

字符串资源的复数形式 ​

您现在可以与其他多平台字符串资源一起定义复数（数量字符串）。 有关详细信息，请参阅文档。

支持三字母区域性 ​

语言限定符现在支持区域性的 alpha-3 (ISO 639-2) 代码。

用于图像和字体的实验性字节数组函数 ​

您可以试用两个允许以字节数组形式获取字体和图像的函数： getDrawableResourceBytes() 和 getFontResourceBytes()。 这些函数旨在帮助从第三方库访问多平台资源。

请参阅 拉取请求 中的详细信息。

实验性导航库 ​

基于 Jetpack Compose 的通用导航库现已推出。 有关详细信息，请参阅文档。

此版本的主要限制：

Lifecycle 库 ​

基于 Jetpack lifecycle 的通用 Lifecycle 库现已推出，请参阅文档了解详细信息。

该库最初是为支持通用导航功能而引入的，但它也提供了一个实验性的跨平台 ViewModel 实现，并包含一个可供您在项目中实现的通用 LifecycleOwner 接口。

Compose Multiplatform 还提供了一个通用的 ViewModelStoreOwner 实现。

支持 Kotlin 2.0.0 ​

Kotlin 2.0.0 与新的 Compose 编译器 Gradle 插件一同发布。 要在最新的编译器版本中使用 Compose Multiplatform，请将该插件应用于项目中的模块（有关详细信息，请参阅迁移指南）。

桌面 ​

BasicTextField2 的初步支持 ​

BasicTextField2 Compose 组件现在在桌面端目标上获得了基础级别的支持。 如果您的项目绝对需要它，或者为了进行测试，请使用它，但请记住可能存在未覆盖的边缘情况。 例如，BasicTextField2 目前不支持 IME 事件，因此您无法使用中文、日文或韩文的虚拟键盘。

计划在 Compose Multiplatform 1.7.0 版本中提供对该组件的全面支持以及对其他平台的支持。

DialogWindow 的 alwaysOnTop 标志 ​

为了避免您的对话框窗口被覆盖，您现在可以为 DialogWindow 可组合项使用 alwaysOnTop 标志。

有关详细信息，请参阅拉取请求。

iOS ​

辅助功能支持改进 ​

在此版本中：

  • 对话框和弹出窗口已与辅助功能特性正确集成，
  • 使用 UIKitView 和 UIKitViewController 创建的互操作视图现在可以被辅助功能服务访问，
  • 辅助功能 API 支持 LiveRegion 语义，
  • 支持辅助功能滚动，
  • 支持 HapticFeedback（触感反馈）。

iOS 17 及更高版本的选择容器放大镜 ​

iOS 上的 Compose Multiplatform 选择容器现在可以模拟原生放大工具。

iPhone 聊天应用的屏幕截图，其中文本放大镜处于激活状态

用于 Dialog 居中的软键盘边距 ​

Dialog 可组合项的行为现在与 Android 一致：当屏幕上出现软键盘时，对话框会考虑应用程序窗口的有效高度进行居中。 可以通过 DialogProperties.useSoftwareKeyboardInset 属性禁用此选项。

Web ​

Kotlin/Wasm 支持进入 Alpha 阶段 ​

实验性的 Compose Multiplatform for Web 现已进入 Alpha 阶段：

  • 大部分 Web 功能与 Compose Multiplatform for Desktop 一致。
  • 团队致力于推动 Web 平台走向发布。
  • 下一步是对大多数组件进行彻底的浏览器适配。

按照首个应用教程了解如何使用共享 UI 代码设置并运行 Web 应用。

基础 IME 键盘支持 ​

Compose Multiplatform 的 Web 目标现在对虚拟 (IME) 键盘有了基础支持。

Gradle 插件 ​

可以修改 macOS 最低版本 ​

在之前的版本中，如果不包含 Intel 版本，就无法将 macOS 应用上传到 App Store。 您现在可以在平台特定的 Compose Multiplatform 选项中为您的应用设置 macOS 最低版本：

kotlin
compose.desktop {
    application {
        nativeDistributions {
            macOS {
                minimumSystemVersion = "12.0"
            }
        }
    }
}

有关详细信息，请参阅拉取请求。

创建支持 Proguard 的 uber JAR 选项 ​

您现在可以使用 ProGuard Gradle 任务创建 uber JAR（包含应用程序及其所有依赖项 JAR 的复杂软件包）。

有关详细信息，请参阅缩减与混淆指南。

已知问题：MissingResourceException ​

从 Kotlin 1.9.x 切换到 2.0.0（或反之）后，您可能会遇到 org.jetbrains.compose.resources.MissingResourceException: Missing resource with path: ... 错误。 要解决此问题，请删除项目中所有的 build 目录。 这包括位于项目根目录和模块目录中的目录。