Compose Multiplatform 在 iOS 17 以下设备启动崩溃问题分析

问题背景

JetBrains 的 Compose Multiplatform 是一个跨平台的 UI 框架，允许开发者使用 Kotlin 编写可在多个平台上运行的 UI 代码。近期有开发者报告，在使用特定版本的 Compose Multiplatform 插件时，iOS 设备（特别是 iOS 17 以下版本）会在应用启动时崩溃。

问题表现

当开发者使用以下配置时会出现问题：

• Compose Multiplatform 插件版本：1.6.10-dev1580 或 1.6.10-dev1593
• 目标设备：运行 iOS 15.1 的 iPad Pro（arm64 架构）

崩溃时的错误信息显示：

Symbol not found: _OBJC_CLASS_$_UITextLoupeSession
Referenced from: /private/var/containers/Bundle/Application/<UUID>/App.app/App
Expected in: /System/Library/Frameworks/UIKit.framework/UIKit

技术分析

这个崩溃的根本原因是符号缺失问题。UITextLoupeSession 是 iOS 17 引入的一个 UIKit 类，用于处理文本放大镜（Loupe）功能。当应用在 iOS 17 以下版本运行时，系统框架中不存在这个类，导致动态链接器无法找到符号而崩溃。

值得注意的是，这个问题在使用较新版本的 Compose Multiplatform（如 2.6.2）时不会出现，这表明开发团队已经在新版本中修复了这个问题。

解决方案

对于遇到此问题的开发者，有以下几种解决方案：

1. 升级 Compose Multiplatform 版本：使用 2.6.2 或更高版本可以避免此问题。

2. 设置最低部署目标：如果必须使用有问题的版本，可以尝试将 iOS 部署目标设置为 iOS 17 或更高版本。

3. 等待官方修复：开发团队已经注意到这个问题，并可能在未来的版本中提供向后兼容的解决方案。

最佳实践建议

对于跨平台开发项目，特别是针对多个 iOS 版本时，建议：

• 定期更新框架版本以获取最新的兼容性修复
• 在 CI/CD 流程中加入多版本 iOS 设备的测试
• 仔细阅读框架的版本发布说明，了解已知问题和兼容性限制
• 考虑使用条件编译或运行时检查来处理不同版本的 API 差异

总结

Compose Multiplatform 作为新兴的跨平台框架，在快速迭代过程中难免会出现一些平台兼容性问题。这次 iOS 17 以下版本的崩溃问题提醒我们，在采用新技术时需要关注其在不同平台和版本上的表现。通过及时更新框架版本和遵循最佳实践，可以最大限度地减少这类问题的发生。