使用CMake构建Qt项目，你需要知道的关键步骤和技巧
在软件开发中，构建项目是一项至关重要的任务。构建过程将源代码转换为可执行文件或库，然后进行测试和部署。虽然构建过程可能因为工具和语言而不同，但是绝大多数构建过程都有一个共同点，那就是需要自动化和规范化。CMake 是一种流行的构建工具，可以使构建过程自动化和规范化。本文将着重介绍如何使用CMake构建Qt项目。
CMake 是一款跨平台的开源构建工具，可以自动生成多种不同平台下的构建文件（例如Unix Makefile、Visual Studio、Xcode等），并且可以自动处理这些文件。CMake通过CMakeLists.txt文件描述要构建的项目。在本文中，我将介绍使用CMake构建Qt项目的关键步骤和技巧。
步骤1： 安装必要的软件
在使用CMake构建Qt项目之前，需要安装Qt软件套件和CMake工具。Qt是一款跨平台的开源C++图形用户界面开发框架。您可以从Qt官方网站https://www.qt.io/下载Qt框架和Qt Creator IDE。您还需要安装CMake，可以从 https://cmake.org/download/ 下载。
步骤2： 配置项目文件
在使用CMake构建Qt项目之前，需要在项目根目录下创建一个CMakeLists.txt 文件。该文件会告诉CMake如何构建你的项目。项目结构应该如下：
“`
[Tutorial/
CMakeLists.txt
tutorial.h
tutorial.cpp
]
“`
CMakeLists.txt文件起到了控制CMake对您的项目进行编译的作用。一个简单的CMakeLists.txt文件如下：
“`
cmake_minimum_required(VERSION 3.15)
project(Tutorial)
find_package(Qt5 COMPONENTS Widgets REQUIRED)
add_executable(tutorial tutorial.cpp tutorial.h)
target_link_libraries(tutorial PRIVATE Qt5::Widgets)
“`
该文件的作用是：
– 设置CMake最低版本为3.15
– 创建一个名为Tutorial的项目
– 必需的包是Qt中的widgets组件
– 编译tutorial.cpp和tutorial.h作为一个可执行文件tutorial
– 将Qt Widget库链接到tutorial
步骤3： 构建项目
完成上述步骤后，您可以在目录中执行以下命令：
“`
mkdir build && cd build
cmake ..
make
“`
CMake会自动创建Unix Makefile并生成makefile所需的文件。在构建项目时，使用make命令，您可以生成可执行文件。
步骤4： 运行项目
生成的可执行文件tutorial可以在build目录下找到。要在终端中运行它，请键入：
`./tutorial`
此时，您应该能够看到窗口展示的Qt应用程序。
技巧1：CMake 变量
CMake变量可以让您配置您的项目。在CMakeLists.txt中，set()函数可以用于设置变量。例如，若要设置版本号，可以使用以下代码：
“`
set(PROJECT_VERSION_MAJOR 1)
set(PROJECT_VERSION_MINOR 0)
set(PROJECT_VERSION_PATCH 0)
set(PROJECT_VERSION
“${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}”)
“`
在这个例子中，我们设置了主要版本、其次版本和修订版本号，并创建了一个命名为PROJECT_VERSION的变量。
技巧2：自定义Qt编译选项
使用CMake编译Qt项目，可以使用自定义编译选项。例如，要添加Qt编译选项，请使用以下代码：
“`
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)
set(QT_VERSION_MAJOR “5”)
set(QT_VERSION_MINOR “15”)
set(QT_VERSION_PATCH “0”)
set(QT_VERSION “${QT_VERSION_MAJOR}.${QT_VERSION_MINOR}.${QT_VERSION_PATCH}”)
set(QT_ALL_MODULES Qt5Core Qt5Gui Qt5Widgets Qt5Sql)
set(QT_COMPONENTS Core Gui Widgets Sql)
find_package(Qt${QT_VERSION_MAJOR} COMPONENTS ${QT_ALL_MODULES} REQUIRED)
foreach(_module ${QT_COMPONENTS})
list(APPEND QT_LIBRARIES Qt${QT_VERSION_MAJOR}::${_module})
endforeach()
add_executable(tutorial tutorial.cpp tutorial.h sources.qrc form.ui)
target_link_libraries(tutorial PRIVATE ${QT_LIBRARIES})
“`
该代码的作用是：
– 启用自动moc，自动uic，自动rcc。这些编译器选项使Qt的CMake模块能够在你不必为每个Qt项目重复配置的情况下生成所需的代码。
– 设置Qt版本为5.15.0。
– 设置所有可用的Qt模块，并组合生成变量QT_LIBRARIES以链接到文件。
– 链接所有模块，并使用add_executable命令链接tutorial的源代码。
技巧3：安装遵循规定的目录结构
使用CMake构建Qt项目时，安装文件通常也是必需的。在CMakeLists.txt文件中，使用install命令可以安装生成的二进制文件、库和其他必要的文件。例如，以下代码将指导CMake将编译的文件安装在src目录下：
“`
install(TARGETS tutorial RUNTIME DESTINATION bin)
install(FILES tutorial.h DESTINATION include)
“`
最后的思考
在此文中，我介绍了CMake构建Qt项目的关键步骤和技巧，包括将CMake与Qt集成、使用CMake变量，以及将遵守规定的目录结构安装到指定位置。CMake是一种强大的构建工具，可以帮助开发人员创建可移植的源代码，并使构建过程自动化和规范化。希望这些技巧可以帮助您更好地使用CMake构建Qt项目。
