简 述：　随笔记一下在 Win10 上使用 CLion + CMake 开发 Qt 配置；

  1. Win10 + CLion + CMake + MSVC（Visual Studio）+ Qt
  2. Win10 + CLion + CMake + GCC（MinGW）+ Qt

[TOC]

本文初发于 “偕臧的小站“，同步转载于此。


关联博文

Windows 系统


背景

​ 预先安装 Win10、QtCrator、CMake 以及 CLion。若想使用 CLion 开发 Qt 就必须告知 Clion 和准备编译构建的项目，一些必要的参数配置。

​ 💻： win10 21H1 📎 Qt 5.12.11 📎 Visual Studio 2017 📎 Qt Creator 4.15.0


预先配置项

配置 CMAKE_PREFIX_PATH（Qt 路径）

​ CMAKE_PREFIX_PATH 的值为告知此项目使用的 Qt 的版本；即 Qt 安装路径。以下三种方式任选其一即可。

  • 新建项目时填写


  • 手动写在 CMakeLists.txt 中

    set(CMAKE_PREFIX_PATH "C:/Qt/Qt5.12.11/5.12.11/msvc2017")

  • 在设置中的 CMake 配置中的 CMake option: 中写参数

    -DCMAKE_PREFIX_PATH=C:/Qt/Qt5.12.11/5.12.11/msvc2017

配置 ToolChians（工具链）

当选中正确的 Environment 时，后面系类会自动检测出来正确的配置。可参考下图

  • 配置 MSVC（Visual Studio） 模式

  • 配置 gcc（MinGW）模式


配置构建 CMake 环境

​ 告知系统使用哪一个 ToolChinas (工具集合)来处理此项目文件。是 MSCVC 还是 gcc 相关系的？


CLion 中运行 Qt 项目

​ 经过上面的准备工作，最后在运行 CLion，按照步骤可看到最后成功运行。

  1. 配置 ToolChians、CMake
  2. 切换想要构建生成的配置方案（Debug/Relase/RelWithDebInfo/MinSizeRel、MSVC/MinGW）
  3. 执行编译 CMakeLists.txt 文件，生成 Makefile 文件；
  4. 编译上一步生成的 Makefile 文件，编译源文件、链接系统文件、生成目标二进制程序
  5. 加载所需要的系统和三方动态库等、运行生成的目标二进制程序
  6. 看到窗口运行成功
  7. 个人配置的集中生成目标文件的集中模式（可忽略此）

CMake 调用 Qt 语法

​ CLion 自动生成的 CMakeLists.txt 文件配置内容，如下，简单介绍 CMake 语法。更详细的注释，可参考另一项目的此文件。

cmake_minimum_required(VERSION 3.20)         # 最低 cmake 版本
project(XTest)                               # 此项目名称

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_AUTOMOC ON)                        # 启用 qt moc 的支持
set(CMAKE_AUTORCC ON)                        # 启用 qrc 资源文件的支持
set(CMAKE_AUTOUIC ON)                        # 启用 qt uic 的支持

set(CMAKE_PREFIX_PATH "C:/Qt/Qt5.12.11/5.12.11/msvc2017")  # Qt 的安装路径

find_package(Qt5 COMPONENTS                  # 查找 Qt5 的如下库
        Core
        Gui
        Widgets
        REQUIRED)

add_executable(XTest main.cpp)               # 生成目标文件 XTest
target_link_libraries(XTest                  # 链接 Qt5 的如下二进制库
        Qt5::Core
        Qt5::Gui
        Qt5::Widgets
        )
        
if (WIN32)                             # 可忽略，大意为未配置或尝试找不到 Qt 安装目录，则警告
    set(DEBUG_SUFFIX)
    if (CMAKE_BUILD_TYPE MATCHES "Debug")
        set(DEBUG_SUFFIX "d")
    endif ()
    set(QT_INSTALL_PATH "${CMAKE_PREFIX_PATH}")
    if (NOT EXISTS "${QT_INSTALL_PATH}/bin")
        set(QT_INSTALL_PATH "${QT_INSTALL_PATH}/..")
        if (NOT EXISTS "${QT_INSTALL_PATH}/bin")
            set(QT_INSTALL_PATH "${QT_INSTALL_PATH}/..")
        endif ()
    endif ()
    if (EXISTS "${QT_INSTALL_PATH}/plugins/platforms/qwindows${DEBUG_SUFFIX}.dll")
        add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
                COMMAND ${CMAKE_COMMAND} -E make_directory
                "$<TARGET_FILE_DIR:${PROJECT_NAME}>/plugins/platforms/")
        add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
                COMMAND ${CMAKE_COMMAND} -E copy
                "${QT_INSTALL_PATH}/plugins/platforms/qwindows${DEBUG_SUFFIX}.dll"
                "$<TARGET_FILE_DIR:${PROJECT_NAME}>/plugins/platforms/")
    endif ()
    foreach (QT_LIB Core Gui Widgets)
        add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
                COMMAND ${CMAKE_COMMAND} -E copy
                "${QT_INSTALL_PATH}/bin/Qt5${QT_LIB}${DEBUG_SUFFIX}.dll"
                "$<TARGET_FILE_DIR:${PROJECT_NAME}>")
    endforeach (QT_LIB)
endif ()