openFrameworks macOS 版本库签名问题分析与解决方案

问题背景

在 openFrameworks 2024年9月23日的 macOS 夜间构建版本中，用户报告了多个核心库的签名验证问题。具体表现为系统无法验证 pixman.xcframework 和 rtAudio.xcframework 等库的签名，导致开发者在使用这些库时遇到安全警告。

问题分析

这个问题源于 macOS 系统对框架签名验证机制的严格性。当开发者下载并尝试使用这些预编译的库时，系统会弹出警告提示签名无法验证。这种情况通常发生在以下几种情况：

1. 库在构建后被修改过
2. 签名证书已过期或无效
3. 签名与库内容不匹配

在 openFrameworks 的案例中，问题主要出在构建过程中生成的签名与最终分发版本不兼容，导致验证失败。

临时解决方案

对于急需使用这些库的开发者，社区提供了以下临时解决方案：

codesign --remove-signature libs/*/lib/macos/*.xcframework
codesign --remove-signature addons/*/libs/*/lib/macos/*.xcframework

这些命令会移除有问题的签名，使库能够正常使用，但会牺牲一些安全性验证。

长期修复方案

开发团队已经通过修改构建脚本从根本上解决了这个问题。主要变更包括：

1. 在构建过程中正确处理签名流程
2. 确保所有框架在打包前都有有效的签名或完全移除签名
3. 统一 macOS 库的目录命名规范（从 osx 改为 macos）

开发者注意事项

1. 当遇到类似签名验证问题时，可以考虑使用 codesign --remove-signature 命令临时解决
2. 建议定期更新到最新版本的 openFrameworks 以获取修复
3. 对于自定义构建，确保构建环境配置正确，特别是签名相关设置

总结

macOS 的签名验证机制是系统安全的重要组成部分，但有时也会给开发者带来不便。openFrameworks 团队通过修改构建流程解决了这个问题，同时为开发者提供了临时解决方案。随着构建系统的持续改进，这类问题将越来越少出现。