2.2 KiB
wmake_with_bear
项目说明
compile_commands.json常被用于帮助各种language server（例如常见的cland，ccls等）理解如何编译项目，以便提供代码导航、补全和分析等功能。
本项目的目标是帮助OpenFOAM项目生成compile_commands.json。bear工具专门用来生成该文件，它需要包裹构建命令make，以获取各种编译选项。而OpenFOAM原生的编译工具wmake是对make的包装，因此有道理认为wmake可以与bear结合，以生成compile_commands.json。
事实上com版的OpenFOAM发行已经考虑到了这一点，它提供了-with-bear选项来调用bear，但是本项目希望更加通用，同时支持com和org，甚至是foam-extend版。好消息是这三个主流分支在wmake工具链的底层逻辑上还有一定共性。
安装和使用
依赖
显然该项目依赖bear，一般可以使用系统的包管理器安装，或者通过conda之类的工具安装预编译的版本，当然也可以自行源码编译。 具体可以参考rizsotto/Bear
安装
项目的安装很简单：
$ # activate your of environment, then in any place, clone the project and run install script
$ git clone --depth 1 https://github.com/zhyang-dev/wmake_with_bear.git
$ cd wmake_with_bear && ./install
使用
上述安装命令会在$WM_PROJECT_DIR/wmake目录下创建一个wmake_with_bear以及别名bwmake，
这样在希望生成compile_commands.json的项目中，使用bwmake替换wmake就能调用wmake同时生成该json文件。
测试
下面以icoFoam为例测试。
bwmake的使用跟wmake使用基本相同，但是bwmake能够生成compile_commands.json。
在OpenFOAM-v2012中使用bwmake编译icoFoam的效果如下图所示。
在VSCode中使用clangd作为language server，可以发现能够正常代码提示。
已测试环境：
- OpenFOAM-v2406 on Ubuntu-24.04 with bear 3.1.3
- OpenFOAM-v2012 on Ubuntu-20.04 with bear 2.4.3
- OpenFOAM-v2012 on Ubuntu-16.04 with bear 2.1.5
- OpenFOAM-11 on Ubuntu-20.04 with bear 2.4.3
- OpenFOAM-6 on Ubuntu-18.04 with bear 2.3.11