CLion 中的 Makefile 项目:现已公开!
您有 Makefile 项目吗?获取免费的 EAP 版本并立即尝试。与我们分享您的反馈!
在此博客文章中,我们将回答:
-
后台工作原理是什么?
-
如何在 CLion 中开始使用 Makefile 项目?
-
如果出现问题而项目无法正确加载,该怎么办?
-
有哪些已知问题和局限性?
我们的实现方法
不久前,我们介绍了我们的发现以及在 CLion 中支持 Makefile 项目的方法。
在那篇博客中,我们概述了各种现代 C++ IDE 和编辑器首选处理 Makefile 的方法:
-
编译包装器用于包装实际的编译器调用,然后执行完整的构建并提取项目信息。
-
在执行任何构建过程之前,将使用 LD_PRELOAD 环境变量并加载特定的动态库,以拦截编译器调用并收集项目信息。
-
解析
make
命令的输出,通常与--just-print
选项一起使用以避免实际构建。
第三个选项提供了几个非常重要的好处:
-
它不会影响构建过程。
-
与完整的项目构建相比,它使我们可以更快地收集信息。
-
这将是一个“便携式”选项,因为 IDE 理论上可以从记录在另一台计算机上的 Make 输出开始。
因此,我们采用了第三种方法并实现了原型设计。我们已经与一系列项目中进行了测试,您可以在我们的 Confluence 页面上找到项目列表。我们希望它也能与其他各种项目应用。现在轮到您尝试一下使用您的 Makefile 项目并与我们分享反馈!
如何在 CLion 中开始使用 Makefile 项目
要在 CLion 中打开 Makefile 项目:
-
在项目中选择文件 | 打开(File | Open)。
-
您可以将文件夹作为项目打开,CLion 将搜索顶级 Makefile(以及 CMakeList.txt 或 compile_commands.json 文件)并建议将其作为项目打开。或者在 Open 对话框中直接将 CLion 指向 Makefile。
-
CLion 可能会要求您清理项目。这是必需的,因为 Make 构建是增量的,在未清理的项目上运行时,只会编译更新的文件,因此重新加载项目将无法正常进行并会丢失所有未更改的文件。
-
CLion 现在将尝试加载项目。
-
成功加载项目后,您可以在 CLion 中开始使用它,并从其提供的所有智能 IDE 功能中受益。
如果默认设置不适合您,您可以调整一些重要设置。
转到设置/偏好 | 构建、执行、部署 | Makefile 设置 ( Settings/Preferences | Build, Execution, Deployment | Makefile settings):
在这里您可以更改:
-
用于加载 Makefile 项目的工具链。支持所有本地工具链(Clang、GCC、MinGW、Cygwin、WSL)。Visual Studio 工具链依赖于 NMake,当前不支持该工具,但是如果您使用 GNU Make 构建项目,将可以在 CLion 中使用。远程模式尚未包括在内。
-
用于在 CLion 中调用
make
命令以提取项目信息的参数。 -
在 CLion 中与
make
命令一起使用 Build 和 Clean Make 目标以提取项目信息。对于 Build,空字段表示 CLion 将采用项目的 Makefile 中指定的第一个目标。
以下是在 CLion 中使用 Makefile 项目的一些最终技巧:
提示 1:CLion 在您的 Makefile 项目中搜索目标,以便您可以立即在运行/调试配置中开始使用它们:
并且如果CLion无法找到您的 Make 目标,则可以创建 Make 类型的自定义构建目标并在配置中使用它:
提示 2:支持源外版本,但您可能需要在项目加载后调用工具| Makefile |更改项目根目录 (Tools | Makefile | Change Project Root),以在项目视图中更好地显示您的源。
提示 3:目前,CLion 不会在文件更改(例如添加新文件)时自动更新或重新加载项目。
更新后,Makefile 上的通知将出现,这样您就不会忘记重新加载项目。但是,如果您的项目使用了配置步骤,请不要忘记先调用它以更新 Makefile 并获取通知。
如果出现问题而项目无法正确加载,该怎么办?
我们已经与一系列项目中进行了测试,您可以在我们的 Confluence 页面上找到项目列表。我们希望它在包括您在内的许多其他项目应用。但是,如果遇到任何问题,请采取以下行动:
-
在设置/偏好 | 构建、执行、部署 | Makefile 设置 ( Settings/Preferences | Build, Execution, Deployment | Makefile settings)中检查您正在使用的工具链:您应该能够在所选环境中构建项目。
-
在设置/偏好 | 构建、执行、部署 | Makefile 设置 ( Settings/Preferences | Build, Execution, Deployment | Makefile settings)中检查重新加载参数和构建目标。大多数成功运行的项目都可以使用默认参数,但您可能需要在这种情况下进行一些更改。
-
尝试工具 | Makefile | 清理并重新加载 Makefile 项目(Tools | Makefile | Clean and Reload Makefile Project)。
-
如果上述步骤无济于事,请尝试从系统目录中的 /makefiles中清理项目。例如,我的 macOS 上的 postgres 项目可以在~/Library/Caches/JetBrains/CLion2020.2/makefiles/postgres.dc29ef09中找到。清理后请重新加载项目。
-
最后,如果以上所有提示对您都不起作用,请转到帮助 | 诊断工具 | 调试日志设置…(Help | Diagnostic Tools | Debug Log Settings… ),并通过添加com.jetbrains.cidr.cpp.makefile 来打开调试日志,然后重现问题并将日志提交给我们的跟踪器或支持。
已知问题和局限性
使用的算法中最脆弱的部分是从
make
命令的输出中提取编译命令。我们发现某些情况下会发生问题:
-
项目禁止打印目录。因此,该算法无法正确检测正在构建的源文件。
-
编译器未知,或者无法正确提取编译标志。
我们采用了几种启发法来克服测试项目中遇到的情况。
用户还可以在提取项目信息时控制用于调用
make
命令的参数:设置/偏好 | 构建、执行、部署 | Makefile | 参数(Settings/Preferences | Build, Execution, Deployment | Makefile | Arguments)。接下来可以期待什么?
-
Makefile 支持插件:该插件提供代码高亮显示功能以及对构建 make 项目的一些支持。计划是重新设计并将其捆绑到 CLion(CPP-16933)中。
-
稍后将为 Makefile 项目启用单元测试集成(CPP-20718)。
-
添加将 Makefile 链接到现有项目的功能(CPP-20733)。
-
更改工具链或影响项目加载的其他设置应触发重新加载(CPP-18982)。
-
为了扩展对 GNU Autotool 项目的支持,允许用户为 Makefile 项目(CPP-16924)设置”预配置”步骤。
-
支持非 GNU Makes(NMake、BSD)(CPP-18723)。
-
用编译包装器实现该方法,并使它与当前的包装器结合使用。
但在此之前,我们计划完善当前的原型并解决各种问题。所以,您的反馈对我们非常重要且宝贵。
请在我们的问题跟踪器中报告您遇到的任何问题。
查看我们在以下提供了在原型中测试过的项目列表:CLion 中的 Makefile 项目。
您的 CLion 团队
JetBrains
The Drive to Develop
JetBrains
The Drive to Develop