CMake中添加Qt模块的合理方法

用CMake来组织的工程中要用Qt首先要设置、找到Qt相关模块。主要是通过find_package这个CMake命令。但网上很多教程都过时了，或者不够清晰灵活。因为这部分很常用，所以特别用一篇文章把我们目前在生产环境中使用的方法给大家介绍下。

设置Qt库路径

Qt版本很多，我们的开发机上一般也装有多个不同版本的Qt。个人尝试性的项目一般用最新版的Qt，而真正发布的产品一般用的是LTS版本Qt（LTS：Long Term Support，长期支持版本，目前最新的LTS是5.9）。

我们的方法是在系统中添加多个环境变量。例如我电脑上装有4个版本：Qt 5.9.4和Qt5.10.1的32位和64位库。所以有4个环境变量：

环境变量名	值
QTDIR594	C:\Qt\Qt5.9.4\5.9.4\msvc2015
QTDIR594_64	C:\Qt\Qt5.9.4\5.9.4\msvc2015_64
QTDIR5101	C:\Qt\Qt5.10.1\5.10.1\msvc2015
QTDIR5101_64	C:\Qt\Qt5.10.1\5.10.1\msvc2015_64

然后在CMakeLists中添加：

set(CMAKE_PREFIX_PATH $ENV{QTDIR594})

通过在$ENV{}里选择不同的环境变量就可以切换不同的Qt版本。

查找Qt模块

网上很多CMake查找Qt方法都是过时的Qt4的方法。现在正确的、最新的方法是：

find_package(Qt5 COMPONENTS Core Gui Qml Quick REQUIRED)

Components后面加的就是这个工程中会用到的Qt模块，例如上面就用到了Core、Gui、Qml、Quick这几个模块，也是一般一个Qt Quick程序必须用到的几个模块。

打开相关自动选项

Qt Quick程序中的QRC资源文件需要用rcc来进行预处理，生成相应.h和.cpp文件。QObject派生的C++类也需要通过moc进行处理。这些都是编译系统中所谓的Rules。CMake中通过打开下面两个选项可以自动对这些后缀的文件进行相应处理：

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

由于生成的C++文件都是放在编译目录里的（在Shadow Building中有别于源码目录），所以还需要将编译目录包含到Include目录，否则编译器会找不到这些头文件：

set(CMAKE_INCLUDE_CURRENT_DIR ON)

链接时设置相应模块

最后一步是在链接的时候把用到的Qt库写上去：

target_link_libraries(${PROJECT_NAME}  Qt5::Core Qt5::Gui Qt5::Qml Qt5::Quick)

这样就能链接上用到的Qt库了。

完整的CMake例子

上面只是着重说明了CMake关于添加Qt模块的代码，一个完整的CMake例子肯定不止上面这些。下面就贴出一个完整的例子：

cmake_policy(VERSION 3.9)
project(Demo VERSION 0.1)
cmake_minimum_required(VERSION 3.9)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

set(CMAKE_PREFIX_PATH $ENV{QTDIR594})
find_package(Qt5 COMPONENTS Core Gui Qml Quick REQUIRED)

set(HEADERS 
    appglobal.h
)

set(SOURCES 
    main.cpp
    appglobal.cpp
)

set(RESOURCES 
    qml.qrc
)

set(QMLS
    main.qml
)

add_executable(${PROJECT_NAME} ${HEADERS} ${SOURCES} ${RESOURCES} ${QMLS})
target_link_libraries(${PROJECT_NAME}  Qt5::Core Qt5::Gui Qt5::Qml Qt5::Quick)