ISPC项目在macOS上构建LLVM 18.1+版本时需注意libunwind依赖问题
在构建ISPC编译器时,开发团队发现当使用macOS系统编译LLVM 18.1及以上版本时,会出现一个关键的构建错误。这个问题源于LLVM运行时库配置的变化,需要特别处理libunwind的依赖关系。
问题背景
LLVM 18.1版本引入了一个新的构建要求:当启用LIBCXXABI_USE_LLVM_UNWINDER选项时,必须在LLVM_ENABLE_RUNTIMES中明确指定libunwind。这个变化导致在macOS系统上构建ISPC时会出现配置错误,错误信息明确指出缺少必要的运行时库配置。
技术细节
libunwind是LLVM项目中的一个重要组件,负责处理程序栈展开和异常处理。在LLVM 18.1之前,这个依赖关系可能是隐式处理的,但从18.1版本开始,构建系统要求显式声明这一依赖。
构建错误具体表现为CMake配置阶段失败,系统会提示:
LIBCXXABI_USE_LLVM_UNWINDER is设置为ON,但未在LLVM_ENABLE_RUNTIMES中指定libunwind
解决方案
对于ISPC项目,开发团队已经通过两种方式解决了这个问题:
-
在alloy.py构建脚本中,通过提交修复了这个问题,确保在构建LLVM 18.1+时正确包含libunwind依赖。
-
对于superbuild(目前ISPC推荐的发布构建方式),也需要进行相应的配置调整。虽然这个问题仅影响LLVM 18.1及更高版本,但对早期版本进行相同的配置修改也不会产生负面影响。
构建建议
对于需要在macOS上构建ISPC的开发者和用户,建议:
-
如果使用LLVM 18.1或更高版本,确保构建配置中正确处理了libunwind依赖关系。
-
即使构建较早版本的LLVM,也可以预先包含libunwind配置,这不会影响构建结果,但可以提高构建系统的兼容性。
-
关注ISPC项目的构建脚本更新,特别是alloy.py和superbuild相关的配置变更。
这个问题展示了LLVM生态系统中的一个常见挑战:随着LLVM版本的演进,构建要求和依赖关系可能会发生变化,需要构建系统维护者及时跟进调整。ISPC团队对此类问题的快速响应确保了项目在不同平台和LLVM版本上的持续兼容性。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0216
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03