iOS真机运行C++游戏引擎程序崩溃：dyld库加载失败求助

核心原因 #

报错里的/usr/local/lib/libGameGears.dylib是Mac系统专属路径，iOS真机系统不存在这个目录；同时你的动态库**安装名称（Install Name）**被设置为该路径，导致dyld在真机运行时无法定位到库文件。另外，iOS真机要求动态库必须嵌入到App Bundle内部，不能依赖系统外部路径。

具体解决步骤 #

1. 修改动态库的Install Name #

• 打开引擎Xcode工程，选中libGameGears.dylib目标，进入Build Settings
• 找到Dynamic Library Install Name选项，将值修改为@rpath/libGameGears.dylib
  • @rpath是运行时路径占位符，后续会通过Xcode配置指向App Bundle内部的库目录

2. 配置主App项目的运行时搜索路径 #

• 打开主App项目的Build Settings，找到Runpath Search Paths
• 添加@executable_path/Frameworks（这是iOS App Bundle中嵌入框架的默认路径），确保勾选对应iOS真机配置（如Debug-iphoneos、Release-iphoneos）

3. 确保动态库被嵌入到App Bundle #

• 进入主App项目的Build Phases
  • 点击+号，选择New Copy Files Phase，将Destination设为Frameworks，把libGameGears.dylib添加到该阶段
  • 若已有Embed Frameworks阶段，直接确认libGameGears.dylib在列表中，且勾选Code Sign On Copy（iOS真机要求签名）

4. 验证动态库的目标架构 #

• 用终端命令检查libGameGears.dylib是否包含iOS真机支持的架构（如arm64）：

  lipo -info /path/to/libGameGears.dylib
  

  输出需包含arm64，若没有，在引擎项目的Build Settings中把Architectures设为Standard Architectures (arm64, arm64e)，并确保iOS真机配置下架构正确

5. 清理并重新编译 #

• 执行Xcode的Product > Clean Build Folder
• 重新编译引擎和主App项目，再部署到iOS真机测试

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