QT的cmake项目工程配置

QT的项目工程默认使用的是qmake,这本来也没什么问题。但是由于要用到vcpkg这个工具来管理第三方库，好像这个 vcpkg工具只能在cmake的项目中才能使用。

于是这里记录下QT的cmake工程配置，需要注意的是需要额外配置个项：

-DCMAKE_PREFIX_PATH=D:\Qt\Qt5.10.0\5.10.0\msvc2015\lib\cmake 
-DCMAKE_TOOLCHAIN_FILE=F:\vcpkg\scripts\buildsystems\vcpkg.cmake -Wno-dev

另外需要注意的是，在QT的环境中可以直接运行能出来界面没问题。

在其他环境下，得先记得先打包导出才行! 之前就是忘了这个差点以为代码配置问题。

Qml的打包和QT传统的打包方式也是不同的。

QT的打包可以用这个：

D:\Qt\Qt5.10.0\5.10.0\msvc2015\bin\windeployqt.exe -no-angle -no-opengl-sw test.exe

QML的应用打包，通过cd命令到你的exe存放的地方，并输入下面的命令：

windeployqt  -qmldir   "源码路径"     test.exe   --release

命令执行完后，在你exe生成的目录里生成qt的依赖文件。 如果你的源码使用了三方库或者生成了动态链接库，那么需要手动将需要的dll文件复制到目录下，实际运行试试，是不是可以正常运行。

CmakeLists.txt 配置模板如下：

这里面每一项的含义，好像都能看懂。总之比makefile好看多了，再也不愿回到makefile了。

需要多总结多记，看的多用的多了就熟了吧。

预定义变量

PROJECT_NAME项目名称
PROJECT_SOURCE_DIR工程的根目录
PROJECT_BINARY_DIR 执行cmake命令的目录
PROJECT_BINARY_DIR 执行cmake命令的目录
CMAKE_CURRENT_SOURCE_DIR 当前CMakeLists.txt文件所在目录
CMAKE_C_FLAGS设置C编译选项
CMAKE_CXX_FLAGS设置C++编译选项
CMAKE_C_COMPILER设置C编译器
CMAKE_CXX_COMPILER设置C++编译器
EXECUTABLE_OUTPUT_PATH设置编译后可执行文件目录
LIBRARY_OUTPUT_PATH设置生成的库文件目录

常用规则

cmake_minimum_required(VERSION 3.16) 指令cmake 版本
project(hello_world) 设置工程名
include_directories(${PROJECT_SOURCE_DIR}/include) 添加头文件路径
link_directories(${PROJECT_SOURCE_DIR}/lib) 添加链接库的路径
add_subdirectory(module)添加 module 子目录, 此目录下也要有CMakeLists.txt文件
add_executable(project1 main.c)指定编译的可执行文件
add_library(lib1 SHARED library.c library.h)指定生成的库文件，SHARED是生成动态库，STATIC后生成静态库 add_compile_options() 添加编译选项
target_link_libraries()指定动态链接库
install()指定make install的目录

set(XXXX YYYYYY)用于设置和修改变量
${XXXX} 使用变量

添加子目录
add_subdirectory(dir)

添加指定目录下可识别的源码文件到变量
aux_source_directory(path _SRC)

过滤部分文件
list(REMOVE_ITEM _SRC file1 file2 ...)

复制文件
configure_file(src_file dst COPYONLY)

添加可执行文件
add_executable(target file1 file2 ...)
如果只是定义目标，暂时不包含源文件可以这样定义:add_executable(target "")

添加动态库
add_library(libname SHARED ${LIB_SRC})

添加静态库
add_library(libname STATIC ${LIB_SRC})

添加头文件目录
INCLUDE_DIRECTORIES()

添加链接目录
link_directories(dir1 dir2 dir3 ...)

设置链接库
target_link_libraries(target library1 library2 ...)

设置目标输出名称(需要写在ADD_xxx后面）
SET_TARGET_PROPERTIES(target PROPERTIES OUTPUT_NAME new_name)

设置构建时不清理已有目标
SET_TARGET_PROPERTIES(target PROPERTIES CLEAN_DIRECT_OUTPUT 1)

添加宏
add_definitions(-Dxxx -Dxxx)

设置编译选项
add_compile_options
set(CMAKE_CXX_FLAGS "-std=c++11 ${CMAKE_CXX_FLAGS}")

为指定目标设置编译选项
SET_TARGET_PROPERTIES(target PROPERTIES COMPILE_FLAGS "-Dxxx -fxxx")

使能汇编
ENABLE_LANGUAGE( ASM)

交叉编译
SET(CMAKE_SYSTEM_NAME Linux)
SET(CMAKE_C_COMPILER /opt/arm-linux-gcc)
SET(CMAKE_CXX_COMPILER /opt/arm-linux-g++)

设置链接脚本
set_target_properties(${TARGET_NAME} PROPERTIES LINK_DEPENDS ${LINKER_SCRIPT})

常用环境变量
工程顶层目录
PROJECT_SOURCE_DIR

编译目录
CMAKE_BINARY_DIR

PROJECT_SOURCE_DIR：工程的根目录
PROJECT_BINARY_DIR：运行cmake命令的目录，通常为${PROJECT_SOURCE_DIR}/build
PROJECT_NAME：返回通过 project 命令定义的项目名称
CMAKE_CURRENT_SOURCE_DIR：当前处理的 CMakeLists.txt 所在的路径
CMAKE_CURRENT_BINARY_DIR：target 编译目录
CMAKE_CURRENT_LIST_DIR：CMakeLists.txt 的完整路径
EXECUTABLE_OUTPUT_PATH：重新定义目标二进制可执行文件的存放位置
LIBRARY_OUTPUT_PATH：重新定义目标链接库文件的存放位置

过滤不相关的文件举例：

#过滤不相关的源文件
set(FILE_PATH
        ${CMAKE_CURRENT_SOURCE_DIR}/src
        )
list(REMOVE_ITEM SRC_FILES ${FILE_PATH}/ae_kqueue.c)
list(REMOVE_ITEM SRC_FILES ${FILE_PATH}/ae_epoll.c)
list(REMOVE_ITEM SRC_FILES ${FILE_PATH}/ae_evport.c)
list(REMOVE_ITEM SRC_FILES ${FILE_PATH}/ae_select.c)

cmake_minimum_required(VERSION 3.12)

project(test VERSION 0.3.19)

#宏定义在这里添加
add_definitions(
        -D_ENABLE_LOGGING
)

####################  QT dependencies ####################
#QT相关的配置
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

set(QT_VERSION 5)
set(REQUIRED_LIBS Core Quick Widgets)
set(REQUIRED_LIBS_QUALIFIED Qt5::Core Qt5::Quick Qt5::Widgets)

####################  set output directory ####################
set(BUILD_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../../build)
set(LIB_DIR ${BUILD_DIR}/lib/Release)
set(LIB_FIX)
if (CMAKE_BUILD_TYPE MATCHES "Debug")
    set(LIB_DIR ${BUILD_DIR}/lib/Debug)
    set(LIB_FIX _d)
endif ()

get_filename_component(ABSOLUTE_PATH ${LIB_DIR} ABSOLUTE)
set(LIB_DIR ${ABSOLUTE_PATH})

set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${LIB_DIR})
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${LIB_DIR})
set(CMAKE_PDB_OUTPUT_DIRECTORY ${LIB_DIR})
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${LIB_DIR})

set(LIB_DIR_FIX ${LIB_DIR})
option(USE_VS_BUILD "use visual studio build." OFF)
if (USE_VS_BUILD)
    set(LIB_DIR_FIX ${LIB_DIR}/bin/Debug)
endif ()

####################  set include path ####################
include_directories(
        ${CMAKE_CURRENT_SOURCE_DIR}/source/cpp/mydir1
        ${CMAKE_CURRENT_SOURCE_DIR}/source/cpp/mydir2
        ${CMAKE_CURRENT_SOURCE_DIR}/source/cpp
        ${BUILD_DIR}/include
)

####################  scan source files ####################
aux_source_directory(${CMAKE_CURRENT_SOURCE_DIR}/source/cpp/mydir1 SRC_FILES)
aux_source_directory(${CMAKE_CURRENT_SOURCE_DIR}/source/cpp/mydir2 SRC_FILES)
aux_source_directory(${CMAKE_CURRENT_SOURCE_DIR}/source/cpp SRC_FILES)


set(RESOURCE_SOURCES
        source/qml/qml.qrc
        #        source/image/image.qrc
        )
#set(QML_SOURCES
#        source/qml/main.qml)

####################  version config ####################
if (MSVC)
    set(MY_VERSIONINFO_RC "${CMAKE_CURRENT_BINARY_DIR}/VersionInfo.rc")
    configure_file("${CMAKE_CURRENT_SOURCE_DIR}/resource.rc.in"
            "${MY_VERSIONINFO_RC}")
endif ()

add_executable(${PROJECT_NAME} ${SRC_FILES} ${QML_SOURCES} ${RESOURCE_SOURCES} ${MY_VERSIONINFO_RC})

####################  set target properties ####################
set_target_properties(${PROJECT_NAME} PROPERTIES DEBUG_POSTFIX _d)

set_property(TARGET ${PROJECT_NAME} PROPERTY WIN32_EXECUTABLE true)

####################  set target dependencies ####################
find_package(Qt${QT_VERSION} COMPONENTS ${REQUIRED_LIBS} REQUIRED)
find_package(g3log CONFIG REQUIRED)

###################其他第三方库链接配置##############################

set(MY_CLIENT_LIB ${LIB_DIR_FIX}/mymodule1${LIB_FIX}.lib)
set(OTHER_CLIENT_LIB ${LIB_DIR_FIX}/libothermodule${LIB_FIX}.lib)

set(THIRD_LIBS
        g3log
        ${MY_CLIENT_LIB }
        ${OTHER_CLIENT_LIB }
        )

target_link_libraries(${PROJECT_NAME} PRIVATE ${REQUIRED_LIBS_QUALIFIED} ${THIRD_LIBS})

过程：

"D:\Program Files\JetBrains\CLion 2021.3.3\bin\cmake\win\bin\cmake.exe" -DCMAKE_BUILD_TYPE=Debug "-DCMAKE_MAKE_PROGRAM=D:/Program Files/JetBrains/CLion 2021.3.3/bin/ninja/win/ninja.exe" -DCMAKE_PREFIX_PATH=D:\Qt\Qt5.10.0\5.10.0\msvc2015\lib\cmake -DCMAKE_TOOLCHAIN_FILE=F:\vcpkg\scripts\buildsystems\vcpkg.cmake -Wno-dev -G Ninja E:\work\test
-- The C compiler identification is MSVC 19.0.24215.1
-- The CXX compiler identification is MSVC 19.0.24215.1
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/bin/cl.exe - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/bin/cl.exe - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Looking for pthread.h
-- Looking for pthread.h - not found
-- Found Threads: TRUE  
-- Found G3LOG: F:/vcpkg/installed/x86-windows/include  
-- Configuring done
-- Generating done
-- Build files have been written to: E:/work/test/cmake-build-debug

[Finished]

引用：

配置CLion作为Qt5开发环境 - apocelipes - 博客园

CMake 输出路径的设置 ,当前目录,安装拷贝_恋恋西风的博客-CSDN博客_cmake 输出路径

C++开源库 - 包管理工具Vcpkg安装使用教程 - fengMisaka - 博客园