iOS 16.1中SwiftUI集成Unity框架出现“Oddly Stepping”运行时错误

问题背景 #

之前将Unity作为库集成到SwiftUI项目中运行正常，升级iOS 16.1后出现运行时崩溃：编译无报错，但启动Unity时触发汇编层面的错误，新建同类集成项目也复现该问题。控制台持续输出：

warning: UnityFramework was compiled with optimization - stepping may behave oddly; variables may not be available.

尝试手动关闭优化无效，仅取消Scheme的Debug模式（切换为Release）后项目可正常启动。

解决步骤 #

• 强制修改UnityFramework的Debug优化配置
  找到UnityFramework的Target，进入Build Settings：

  1. 搜索Optimization Level，将Debug模式下的选项强制设置为None [-O0]
  2. 搜索Debug Information Format，设置为DWARF with dSYM File
     注：若UnityFramework是导出的预编译库，需重新导出Unity项目时，在Player Settings的iOS选项中开启Debug模式禁用优化的开关。

• 调整主项目Scheme的Debug参数
  打开主项目Scheme编辑界面（Cmd+<）：

  1. 切换到Run -> Info标签，确认Debug模式下的Build Configuration为Debug
  2. 进入Arguments标签，检查是否存在冲突的环境变量，若有UNITY_DEBUG_ENABLE这类变量，暂时移除或设为0

• 添加iOS 16.1兼容代码
  在初始化UnityFramework的代码前，添加Debug模式下的兼容处理：

  #if DEBUG
      // 临时禁用Unity Debug检测，规避iOS 16.1兼容性bug
      setenv("UNITY_DISABLE_DEBUG", "1", 1)
  #endif
  

• 彻底清理缓存后重新编译

  1. 执行Cmd+Shift+K清理项目编译缓存
  2. 删除Xcode的Derived Data（路径：~/Library/Developer/Xcode/DerivedData）
  3. 重新编译主项目与UnityFramework

内容的提问来源于stack exchange，提问作者jakob witsch