KMM项目iOS模拟器安装卡顿、真机安装致设备重启求助

在Kotlin Multiplatform Mobile（KMM）项目中遇到以下iOS端安装异常：

• iOS模拟器：Xcode卡在安装流程，仅重启模拟器才能完成安装
• iOS真机：安装后设备严重卡顿甚至重启，删除应用时也会触发系统重启

已尝试的排查操作 #

• 将Xcode及iOS模拟器更新至最新版本
• 清理Xcode的Derived Data
• 多次重装应用并切换不同模拟器配置
• 排查依赖问题但未发现异常

环境信息 #

• Kotlin版本：1.9.23
• Xcode版本：15.4
• macOS版本：14.6.1（Apple M1）

可能的解决方向 #

1. 检查KMM iOS目标编译配置

   • 验证build.gradle.kts中iOS目标的binaries配置，尝试关闭Bitcode嵌入（部分场景下Bitcode编译会引发安装异常）：

     ios {
         binaries {
             framework {
                 embedBitcode = false
             }
         }
     }
     

   • 暂时关闭debug模式下的所有非必要编译优化项，排查是否是优化逻辑导致的问题

2. 验证iOS端资源与权限配置

   • 检查Info.plist是否存在异常权限声明或无效资源引用（如错误的URL Scheme、重复键值）
   • 确认项目中是否包含超大静态资源文件，这类文件可能导致安装时系统负载过高

3. 排查KMM共享代码的Native层问题

   • 检查共享模块中直接调用iOS Native API的代码，重点排查涉及系统进程、内存管理的部分（如未释放的资源、错误指针操作）
   • 创建最小化KMM项目，逐步添加原有代码模块，定位是否由某段共享代码引发异常

4. 系统层面额外排查

   • 重置iOS模拟器内容与设置（模拟器菜单 -> Device -> Erase All Content and Settings），清除缓存异常状态
   • 真机端尝试重置所有设置（保留数据）或更新iOS系统至最新版本
   • 通过Mac的Console.app过滤Xcode、installcoordinationd相关日志，查找安装过程中的具体错误信息

内容的提问来源于stack exchange，提问作者Hossam Zaabl