Xcode打包SDL2项目可执行文件报错：无法找到SDL2.framework

兄弟，这个坑我之前踩过好几次！你的问题本质很明确：你打包的App没有把SDL2框架嵌入到自身的安装包内，而是默认依赖目标机器全局安装的/Library/Frameworks/SDL2.framework，那没装的机器自然找不到了。咱们一步步来彻底解决：

第一步：把SDL2.framework嵌入到App Bundle中 #

1. 打开Xcode，选中左侧导航栏最顶部的项目图标，然后切换到你的Target（注意不是Project级别，是具体的应用target）
2. 切到General标签页，往下滑找到Frameworks, Libraries, and Embedded Content区域
3. 如果SDL2.framework不在列表里，点击+号添加它；如果已经在列表里，直接看下一步
4. 找到SDL2.framework那一行，把它的Embed选项从Do Not Embed改成Embed & Sign——这一步是关键，告诉Xcode把框架打包进App里

第二步：修正框架的运行路径（Runpath） #

接下来要告诉系统，运行时去App内部找框架，而不是全局路径：

1. 还是在target设置里，切换到Build Settings标签页
2. 在搜索框里输入Install Path，找到对应的设置项，把它的值改成@executable_path/../Frameworks——这个路径指向App包内的Contents/Frameworks文件夹
3. 再搜索LD_RUNPATH_SEARCH_PATHS，确保里面包含@executable_path/../Frameworks（一般Xcode默认会有，但检查一下更稳妥）

第三步：重新打包验证 #

1. 先清理一下旧的构建缓存：点击Product > Clean Build Folder（快捷键Cmd+Shift+K）
2. 重新执行Product > Archive打包
3. 从Archive界面导出App时，选择Export as a macOS App，跟着向导完成导出
4. 把导出的App拷贝到一台没有安装SDL2.framework的Mac上测试，应该就能正常启动了

额外排查小技巧 #

如果还是报错，用这几招排查：

• 右键导出的App，选择Show Package Contents，进入Contents/Frameworks文件夹，确认SDL2.framework确实在里面
• 用终端命令检查可执行文件的依赖路径：

  otool -L /path/to/your/App.app/Contents/MacOS/YourAppExecutableName
  

  输出里看SDL2的路径，应该是@rpath/SDL2.framework/Versions/A/SDL2，同时rpath列表里包含@executable_path/../Frameworks
• 确认你的SDL2.framework是通用架构（支持x86_64和arm64），不然在M系列芯片的Mac上可能跑不起来

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