使用 CMake 构建基于 Qt 的项目

先天无极编程圣体

于 2024-10-01 07:43:17 发布

阅读量1k

点赞数 30

文章标签： qt 开发语言

本文链接：https://blog.csdn.net/qq_43689451/article/details/142667188

版权

在使用 CMake 构建基于 Qt 的项目时，通常需要进行一些特定的配置来确保 Qt 库的正确使用。以下是如何配置 CMake 构建系统以支持 Qt 的步骤和说明：

1. 安装依赖

首先，确保你已经安装了以下内容：

Qt 库（包括 Qt 开发工具）
CMake

在大多数 Linux 发行版上，可以使用包管理器安装。例如，Ubuntu 上可以使用以下命令：

sudo apt-get install qtbase5-dev qtchooser qt5-qmake cmake

在 Windows 或 macOS 上，可以使用 Qt 安装程序来安装 Qt SDK，并通过 CMake 配置路径。

2. CMake 最小配置

你需要在项目的 CMakeLists.txt 文件中进行以下基本配置：

2.1. 设置最低版本要求并引入 Qt 模块

cmake_minimum_required(VERSION 3.10)

# 项目信息
project(MyQtProject VERSION 1.0 LANGUAGES CXX)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 查找 Qt5 库
find_package(Qt5 COMPONENTS Widgets REQUIRED)

2.2. 添加头文件、源文件和 UI 文件

在 CMake 中，需要显式指定哪些源文件和 UI 文件会被编译：

set(SOURCES
    main.cpp
    mainwindow.cpp
)

set(HEADERS
    mainwindow.h
)

set(UIS
    mainwindow.ui
)

2.3. 配置 Qt 自动处理（MOC、UIC、RCC）

Qt 使用的 moc、uic 和 rcc 工具用于处理信号与槽、UI 文件以及资源文件。CMake 提供了一些命令来自动处理这些工具。

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

2.4. 链接 Qt 库并生成可执行文件

add_executable(MyQtApp
    ${SOURCES}
    ${HEADERS}
    ${UIS}
)

# 链接 Qt 库
target_link_libraries(MyQtApp Qt5::Widgets)

3. 完整的 `CMakeLists.txt` 示例

以下是一个完整的 CMakeLists.txt 文件示例，假设你正在创建一个简单的 Qt GUI 应用程序：

cmake_minimum_required(VERSION 3.10)

# 设置项目名称和版本
project(MyQtProject VERSION 1.0 LANGUAGES CXX)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 启用 Qt 的自动生成工具
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

# 查找 Qt5 必要组件
find_package(Qt5 COMPONENTS Widgets REQUIRED)

# 添加源文件、头文件和 UI 文件
set(SOURCES
    main.cpp
    mainwindow.cpp
)

set(HEADERS
    mainwindow.h
)

set(UIS
    mainwindow.ui
)

# 添加可执行文件
add_executable(MyQtApp
    ${SOURCES}
    ${HEADERS}
    ${UIS}
)

# 链接 Qt 库
target_link_libraries(MyQtApp Qt5::Widgets)

4. 编译项目

在项目的根目录下运行以下命令进行构建：

mkdir build
cd build
cmake ..
make

这将在 build 目录中生成可执行文件。

5. 其他注意事项

其他 Qt 模块：根据项目需要，你可以在 find_package 中添加其他 Qt 模块，例如 Qt5::Core、Qt5::Gui 等。
跨平台支持：CMake 和 Qt 都是跨平台的，使用这种配置，你可以在不同操作系统（如 Windows、Linux 和 macOS）上轻松构建你的项目。

这样，你就可以使用 CMake 来管理和构建你的 Qt 项目了。
rcc 是 Qt 的 资源编译器（Resource Compiler），用于将资源文件（如图片、音频、图标等）打包到 Qt 应用程序的可执行文件中。它的主要作用是将 Qt 资源文件（.qrc） 转换为可执行的 C++ 代码，这样资源就可以直接嵌入到应用程序内部，而不需要单独的文件访问。

使用 `rcc` 的典型场景

在 Qt 项目中，通常需要将应用程序使用的资源文件集成到项目中。资源文件通常通过一个 *.qrc 文件来组织，这个文件描述了需要包含到程序中的资源。rcc 工具会根据这个 .qrc 文件生成一个 C++ 文件，将所有资源嵌入到程序中。

例如，假设有一个 resources.qrc 文件，其中包含图片资源：

`resources.qrc`

<RCC>
    <qresource>
        <file>images/logo.png</file>
        <file>images/background.jpg</file>
    </qresource>
</RCC>

这个 .qrc 文件列出了需要嵌入的图片文件 logo.png 和 background.jpg。

使用 `rcc` 编译资源

当你使用 CMake 时，通常可以通过 set(CMAKE_AUTORCC ON) 让 CMake 自动处理 rcc，但你也可以手动调用 rcc 来编译资源文件。

在 Qt 项目中，rcc 通常是这样用的：

编写 .qrc 资源文件，列出要包含的所有资源。
在 CMake 或 qmake 项目中，引用 .qrc 文件，确保这些资源文件在构建时被处理。
rcc 将 .qrc 文件转换为 C++ 代码，并将其编译为项目的一部分。

在 CMake 中，配置 rcc 可以通过以下方式实现：

set(CMAKE_AUTORCC ON)

当启用 CMAKE_AUTORCC 时，CMake 会自动处理 .qrc 文件，并调用 rcc 来编译资源。你只需要在 CMakeLists.txt 文件中引用 .qrc 文件，例如：

set(SOURCES
    main.cpp
    mainwindow.cpp
    resources.qrc # 引用资源文件
)

add_executable(MyQtApp ${SOURCES})
target_link_libraries(MyQtApp Qt5::Widgets)