Qt qtcreator配置cmake
添加CMake
选择 Preferences > CMake > Tools.
可以将其设置为默认，如此新建的kit会自动选择默认cmake
完成CMake 代码（自动补全）
Qt Creator 使用通用高亮为 CMake 命令提供代码完成的特定参数。例如，CMake: set_source_files_properties 命令只建议使用源文件属性，而不建议使用测试或目标属性。
支持以下 CMake 特有的触发标记：
- $ 用于变量
- 用于生成器表达式的 $<
- 用于环境变量的 $ENV
按 Tab 或 Enter 键接受所选建议并完成代码。
调试 CMake 项目文件
通过 Qt Creator 的调试适配器协议（DAP）实现，您可以调试 CMake 项目文件。
注意：DAP 需要 CMake 3.27 或更高版本。
调试 CMake 项目文件
- 在编辑模式下，在 CMake 文件中设置断点。
- 转到调试 > 开始调试 > 开始 CMake 调试
当应用程序在断点处停止时，可以在调试模式视图中检查数据
编辑 CMake 配置文件
要打开 CMakeLists.txt 文件进行编辑，可在 “项目 ”视图中右键单击该文件，然后选择 “使用打开”>“CMake 编辑器”。
您也可以使用定位器中的 cmo 过滤器，在编辑器中打开当前运行配置的 CMakeLists.txt 文件。这与选择 “构建”>“为运行配置构建 ”时的构建目标相同。
支持以下功能：
- 当光标位于某处时按 F2：
- 文件名 - 打开文件
- CMake 函数、宏、选项、目标、CMake 的查找或包含模块、由 set 或 list 创建的局部变量或包 - 转到该项目
- 关键词补全
- 本地函数和变量、缓存变量、ENV、目标、包以及 find_package 添加的变量的代码自动补全
- 用于设置 CMake 打印属性和变量、创建 Qt 控制台和图形用户界面应用程序以及查找模块示例的预定义代码片段
- 路径补全
- 自动缩进
- 匹配括号和引号
在问题中显示警告和错误。
格式化 CMake 文件
您可以使用 cmake-format 工具和本地 .cmake-format、.py 或 .json 配置文件来格式化 CMake 文件中的任何文本，而无需用一对栅栏来防护。 您必须安装该工具，并告知 Qt Creator 安装位置。
保存文件时自动格式化 CMake 文件：
- 选择Preferences > CMake > Formatter
- 在 CMakeFormat 命令中，输入 cmake-format.exe 的路径。
- 选择 "保存文件时自动格式化 "以在保存 CMake 文件时自动格式化。
- 在限制 MIME 类型中，添加要格式化的文件的 MIME 类型，用分号分隔。 默认值为 text/x-cmake 格式的 CMake 文件。 如果该字段为空，则所有文件都会被格式化。
- 选择 "仅限当前项目中包含的文件 "复选框，只格式化属于当前项目的 CMake 文件。
管理 CMake 项目中的文件
当您在项目中添加新文件或现有文件时，Qt Creator 会自动将它们添加到 CMakeLists.txt 文件中的 qt_add_executable、add_executable 或 qt_add_library 函数中。
如果 Qt Creator 无法识别目标创建的位置，它将使用 target_sources 函数来添加文件。
对于 Qt Quick 项目，文件会添加到 qt_add_qml_module 函数中，前缀为 QML_FILES、SOURCES 或 RESOURCES 函数参数。
在 "项目 "或 "文件系统 "视图中重命名或删除文件时，Qt Creator 会在 CMakeLists.txt 文件中重命名或删除它们。
覆盖项目的 CMake 设置
覆盖当前项目的 CMake 设置：
- Go to Projects > Project Settings > CMake.
- 清除 使用全局设置。
- 为项目配置 CMake。
您的选择将覆盖在 Preferences > CMake > General中设置的值。
| Setting | Value | Read More |
|---|---|---|
| 自动运行 CMake | 在编辑项目中的 CMakeLists.txt 配置文件时，运行 CMake 刷新项目信息。 此外，在构建项目时也会刷新项目信息。 | View CMake project contents |
| 软件包管理器自动设置 | 设置Conan 或vcpkg 软件包管理器，以便与 CMake 配合使用。 | Using CMake with Package Managers |
| 在使用初始参数重新配置之前进行询问 | 选择 "使用初始变量重新配置 "时，行动前会询问。 | Re-configuring with Initial Variables |
| 重新加载 CMake 预置前询问 | 当您选择 "构建">"重新加载 CMake 预置 "时，会先询问再行动。 | CMake Presets |
| 显示源组文件夹内的子文件夹 | 在 "项目 "视图中隐藏子文件夹名称，并根据源组排列文件。 | Hide subfolder names in Projects view |
| 默认显示高级选项 | 默认在初始配置和当前配置中显示所有 CMake 变量。 | Viewing Advanced Variables |
| 使用结点进行 CMake 配置和构建操作 | 在 Windows 上，使用 CMake 配置、构建和安装操作的连接点。 | Using Junction Points on Windows |
剖析 CMake 代码
利用 CMake 3.18 及更高版本中的剖析支持，您可以找出 CMake 花在配置项目上的时间。
要在Chrome Trace Format Visualizer展示台中查看剖析信息，请选择 Analyze > CMake Profiler.
阅读 CMake 文档
安装 CMake 时，CMake 文档会以 Qt 帮助文件格式 (.qch) 安装。 它由 Qt Creator 自动注册，您可以通过以下方式查看：
- 将鼠标悬停在函数、变量、属性、策略、环境变量或 CMake 查找或包含模块上以显示工具提示
- 选择任何上述元素并按 F1 键显示其文档
- 切换到帮助模式
要在线查看文档，请在帮助模式下打开并选择（打开在线文档）。
