Xcode中因Team ID不一致导致SDL2 Framework链接失败

在Xcode中编译基于SDL2的C++基础应用时，遇到代码签名错误，无法通过启用强化验证的方式解决（禁用强化验证不适用于分发场景）。报错核心信息为：
not valid for use in process: mapping process and mapped file (non-platform) have different Team IDs

完整错误日志：

dyld[3678]: Library not loaded: @rpath/SDL2.framework/Versions/A/SDL2
  Referenced from: <35CBD752-6A32-3581-9662-6DE363C74AB5> /Users/alexei/Library/Developer/Xcode/DerivedData/sdltest-fbdltneqiwmnclcteotuuilnactn/Build/Products/Debug/sdltest
  Reason: tried: '/Users/alexei/Library/Developer/Xcode/DerivedData/sdltest-fbdltneqiwmnclcteotuuilnactn/Build/Products/Debug/SDL2.framework/Versions/A/SDL2' (no such file), '/Library/Frameworks/SDL2.framework/Versions/A/SDL2' (code signature in <3F99A8E0-46D9-3192-9F62-E2C522BF5A24> '/Library/Frameworks/SDL2.framework/Versions/A/SDL2' not valid for use in process: mapping process and mapped file (non-platform) have different Team IDs), '/System/Library/Frameworks/SDL2.framework/Versions/A/SDL2' (no such file, not in dyld cache)

解决方案 #

1. 重新签名SDL2框架 #

• 打开终端，用你的开发者Team ID重新签名系统目录下的SDL2框架：

  codesign --force --deep --sign "你的Team ID" /Library/Frameworks/SDL2.framework
  

  （Team ID可在Xcode的Signing & Capabilities面板或Apple开发者后台获取）

2. 将SDL2框架嵌入应用包 #

• 在Xcode项目的General面板中，找到Frameworks, Libraries, and Embedded Content区域，把SDL2.framework的Embed选项设置为Embed & Sign
• 编译后SDL2框架会被复制到应用包的Contents/Frameworks目录下，运行时优先加载包内签名匹配的版本，避免调用系统目录下的框架

3. 验证项目签名配置 #

• 确认项目Signing & Capabilities面板中，Team已正确选择，签名证书状态有效
• 确保Enable Hardened Runtime选项已勾选（满足分发要求），无需为SDL2添加额外权限，除非应用有特殊需求

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