一、CMake入門

下面是使用 Qt 用 C++ 編寫的控制臺應(yīng)用程序的典型文件：CMakeLists.txt

1.構(gòu)建一個控制臺應(yīng)用程序

# 指定應(yīng)用程序所需的CMake最低版本（Qt本身至少需要CMake版本3.16）
cmake_minimum_required(VERSION 3.16)

# 設(shè)置項(xiàng)目名稱和默認(rèn)項(xiàng)目版本，同時告訴CMake該程序是用C++編寫的
project(helloworld VERSION 1.0.0 LANGUAGES CXX)

# 設(shè)置變量CMAKE_CXX_STANDARD，指定C++版本（QT6需要支持c++ 17或更新版本的編譯器）
# 設(shè)置變量CMAKE_CXX_STANDARD_REQUIRED，如果編譯器太舊，讓CMake打印一個錯誤
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 設(shè)置CMake查找Qt6，并導(dǎo)入模塊Core
# 如果CMake找不到模塊，設(shè)置標(biāo)志REQUIRED讓CMake終止
# 如果成功，CMake將設(shè)置一些變量，這些變量記錄在模塊變量中（見變量參考Module variables）
# 為了能找到依賴包，CMake可以設(shè)置變量CMAKE_PREFIX_PATH包含Qt6安裝前綴
find_package(Qt6 REQUIRED COMPONENTS Core)

# qt_standard_project_setup命令為一般的QT應(yīng)用程序設(shè)置項(xiàng)目范圍的默認(rèn)值
# 除此之外，該命令將CMAKE_AUTOMOC變量設(shè)置為ON，指示CMake自動設(shè)置規(guī)則，以便在需要時透明地調(diào)用Qt的元對象編譯器(moc)。
qt_standard_project_setup()

# add_executable命令告訴CMake從指定源文件構(gòu)建一個可執(zhí)行文件（而不是庫）
# 注意，這里通常不列出頭文件。這與qmake不同，qmake需要顯式列出頭文件，以便元對象編譯器(moc)處理它們。
# 對于比較復(fù)雜的項(xiàng)目需要改為調(diào)用qt_add_executable()，它是內(nèi)置add_executable()命令的包裝器，提供了額外的邏輯來自動處理諸如在靜態(tài)Qt構(gòu)建中鏈接Qt插件、特定于平臺的庫名定制等。
# 要創(chuàng)建庫，使用qt_add_library。
add_executable(helloworld
    main.cpp
)

# 最后告訴CMake, helloworld可執(zhí)行文件通過引用由上面的find_package()調(diào)用導(dǎo)入的Qt6::Core目標(biāo)來使用Qt的Core模塊。這不僅可以為鏈接器添加正確的參數(shù)，還可以確保將正確的include目錄、編譯器定義傳遞給c++編譯器。PRIVATE關(guān)鍵字對于可執(zhí)行目標(biāo)并不是嚴(yán)格必要的，但是指定它是一種良好的實(shí)踐。
# 如果helloworld是一個庫而不是可執(zhí)行文件，則應(yīng)該指定PRIVATE或PUBLIC(如果庫在頭文件中提到了來自Qt6::Core的內(nèi)容，則為PUBLIC，否則為PRIVATE)
target_link_libraries(helloworld PRIVATE Qt6::Core)

2.構(gòu)建一個界面應(yīng)用程序

cmake_minimum_required(VERSION 3.16)

project(helloworld VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_standard_project_setup()

add_executable(helloworld
    mainwindow.ui
    mainwindow.cpp
    main.cpp
)

target_link_libraries(helloworld PRIVATE Qt6::Widgets)

# 最后，我們在應(yīng)用程序目標(biāo)上設(shè)置屬性，效果如下:
# 防止在Windows上創(chuàng)建控制臺窗口。
# 在macOS上創(chuàng)建應(yīng)用程序包。
set_target_properties(helloworld PROPERTIES
    WIN32_EXECUTABLE ON
    MACOSX_BUNDLE ON
)

3.構(gòu)建子目錄項(xiàng)目

• 項(xiàng)目目錄結(jié)構(gòu)

<project root>
├── CMakeLists.txt
└── src
    └── app
        ├── CMakeLists.txt
        ├── main.cpp
        ├── mainwindow.cpp
        ├── mainwindow.h
        └── mainwindow.ui

• 頂層CMakeLists.txt，包含整個項(xiàng)目的設(shè)置并調(diào)用add_subdirectory，頂層CMakeLists.txt設(shè)置的變量在子目錄項(xiàng)目中可見

cmake_minimum_required(VERSION 3.16)

project(helloworld VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_standard_project_setup()

add_subdirectory(src/app)

• 子目錄項(xiàng)目CMakeLists.txt

add_executable(helloworld
    mainwindow.ui
    mainwindow.cpp
    main.cpp
)

target_link_libraries(helloworld PRIVATE Qt6::Widgets)

set_target_properties(helloworld PROPERTIES
    WIN32_EXECUTABLE ON
    MACOSX_BUNDLE ON
)

4.構(gòu)建庫和使用庫

• 項(xiàng)目目錄結(jié)構(gòu)

<project root>
├── CMakeLists.txt
└── src
    ├── app
    │   ├── ...
    │   └── main.cpp
    └── businesslogic
        ├── CMakeLists.txt
        ├── businesslogic.cpp
        └── businesslogic.h

• 庫項(xiàng)目文件（src/businesslogic/CMakeLists.txt）

# add_library命令創(chuàng)建businesslogic庫，STATIC表示靜態(tài)庫，SHARED表示動態(tài)庫
add_library(businesslogic STATIC
    businesslogic.cpp
)

target_link_libraries(businesslogic PRIVATE Qt6::Core)

# 通過調(diào)用target_include_directories，確保businesslogic目錄的絕對路徑被自動添加為使用我們的庫的所有目標(biāo)的包含路徑。
# 這使我們在main.cpp中不用使用相對路徑來定位businesslogic.h。相反，我們可以直接寫#include <businesslogic.h>
target_include_directories(businesslogic INTERFACE ${CMAKE_CURRENT_SOURCE_DIR})

最后，我們必須將庫的子目錄添加到頂級項(xiàng)目文件中:

add_subdirectory(src/app)
add_subdirectory(src/businesslogic)

• 使用庫

target_link_libraries(helloworld PRIVATE
    businesslogic
    Qt6::Widgets)

5.添加資源

qt_add_resources(helloworld imageresources
    PREFIX "/images"
    FILES logo.png splashscreen.png
)

用法：

logoLabel->setPixmap(QPixmap(":/images/logo.png"));

6.添加翻譯

qt_add_translations(helloworld
    TS_FILES helloworld_de.ts helloworld_fr.ts)

要更新.ts文件中的條目，構(gòu)建update_translations目標(biāo):

$ cmake --build . --target update_translations

要手動觸發(fā).qm文件的生成，構(gòu)建release_translations目標(biāo):

$ cmake --build . --target release_translations

二、CMake命令參考（CMake Command Reference）

• Qt6::Core

  CMake命令	描述
  qt_add_big_resources	將大型二進(jìn)制資源編譯為目標(biāo)代碼
  qt_add_binary_resources	從 Qt 資源文件列表創(chuàng)建 RCC 文件
  qt_add_executable	創(chuàng)建并最終確定指定平臺類型的應(yīng)用程序目標(biāo)
  qt_add_library	創(chuàng)建并完成庫
  qt_add_plugin	創(chuàng)建 Qt 插件目標(biāo)
  qt_add_resources	將二進(jìn)制資源編譯為源代碼
  qt_allow_non_utf8_sources	防止強(qiáng)制將源文件視為適用于 Windows 的 UTF-8
  qt_android_add_apk_target	定義運(yùn)行安卓部署qt以生成APK的構(gòu)建目標(biāo)
  qt_android_apply_arch_suffix	將目標(biāo)二進(jìn)制文件的名稱配置為包含特定于體系結(jié)構(gòu)的后綴
  qt_android_generate_deployment_settings	生成 androiddeployqt 所需的部署設(shè)置文件
  qt_deploy_qt_conf	在部署時編寫 qt.conf 文件
  qt_deploy_runtime_dependencies	部署可執(zhí)行文件所需的Qt插件，Qt和非Qt庫
  qt_disable_unicode_defines	防止在目標(biāo)上自動設(shè)置某些與 Unicode 相關(guān)的編譯器定義
  qt_extract_metatypes	防止在目標(biāo)上自動設(shè)置某些與 Unicode 相關(guān)的編譯器定義
  qt_finalize_project	處理與Qt項(xiàng)目相關(guān)的各種常見平臺特定任務(wù)
  qt_finalize_target	處理與Qt目標(biāo)相關(guān)的各種常見平臺特定任務(wù)
  qt_generate_deploy_app_script	為應(yīng)用程序生成部署腳本
  qt_generate_moc	對輸入文件調(diào)用 moc
  qt_import_plugins	指定要為靜態(tài)Qt構(gòu)建導(dǎo)入的自定義插件集
  qt_set_finalizer_mode	自定義目標(biāo)最終確定的各個方面
  qt_standard_project_setup	將項(xiàng)目范圍的默認(rèn)設(shè)置設(shè)置為標(biāo)準(zhǔn)排列
  qt_wrap_cpp	從源文件創(chuàng)建.moc文件

• Qt6::DBus

  CMake命令	描述
  qt_add_dbus_adaptor	將項(xiàng)目范圍的默認(rèn)設(shè)置設(shè)置為標(biāo)準(zhǔn)排列
  qt_add_dbus_interface	生成實(shí)現(xiàn) D-Bus 接口描述文件接口的C++源
  qt_add_dbus_interfaces	生成實(shí)現(xiàn) D-Bus 接口描述文件接口的C++源
  qt_generate_dbus_interface	從頭文件生成 D-Bus 接口

• Qt6::InterfaceFramework

  CMake命令	描述
  qt_ifcodegen_extend_target	使用從 qface IDL 文件生成的文件擴(kuò)展目標(biāo)
  qt_ifcodegen_generate	從 qface IDL 文件生成文件
  qt_ifcodegen_import_variables	從 qface IDL 文件生成文件，并提供變量以在 CMake 中使用
  qt_set_ifcodegen_variable	將變量設(shè)置為 ifcodegen 模板中的給定 c 值

• Qt6::LinguistTools

  CMake命令	描述
  qt_add_lrelease	添加目標(biāo)以將Qt語言學(xué)家.ts文件轉(zhuǎn)換為.qm文件
  qt_add_lupdate	添加目標(biāo)以生成或更新Qt語言學(xué)家.ts文件
  qt_add_translation	添加目標(biāo)以生成或更新Qt語言學(xué)家.ts文件
  qt_add_translations	添加目標(biāo)以更新Qt Linguist .ts文件并將其轉(zhuǎn)換為.qm文件
  qt_create_translation	設(shè)置Qt語言學(xué)家翻譯工具鏈

• Qt6::Qml

  CMake命令	描述
  qt_add_qml_module	設(shè)置Qt語言學(xué)家翻譯工具鏈
  qt_add_qml_plugin	定義與 QML 模塊關(guān)聯(lián)的插件
  qt_deploy_qml_imports	部署可執(zhí)行文件所需的 QML 模塊的運(yùn)行時組件
  qt_generate_deploy_qml_app_script	為 QML 應(yīng)用程序生成部署腳本
  qt_generate_foreign_qml_types	在 QML 模塊中注冊來自一個目標(biāo)的類型
  qt_import_qml_plugins	確保為靜態(tài)構(gòu)建導(dǎo)入目標(biāo)所需的 QML 插件
  qt_query_qml_module	檢索有關(guān) QML 模塊的信息
  qt_target_compile_qml_to_cpp
  qt_target_qml_sources	檢索有關(guān) QML 模塊的信息

• Qt6::RemoteObjects

  CMake命令	描述
  qt_add_repc_merged	從 Qt 遠(yuǎn)程對象 .rep 文件為源和副本類型創(chuàng)建C++頭文件
  qt_add_repc_replicas	從 Qt 遠(yuǎn)程對象 .rep 文件為副本類型創(chuàng)建C++頭文件
  qt_add_repc_sources	從 Qt 遠(yuǎn)程對象 .rep 文件為源類型創(chuàng)建C++頭文件
  qt_reps_from_headers	從 QObject 頭文件創(chuàng)建 .rep 文件

• Qt6::Scxml

  CMake命令	描述
  qt_add_statecharts

• Qt6::ShaderTools

  CMake命令	描述
  Qt Shader Tools Build System Integration	編譯著色器并將其添加到Qt資源

• Qt6::Widgets

  CMake命令	描述
  qt_wrap_ui	編譯著色器并將其添加到Qt資源

• Qt6::WebEngineCore

  CMake命令	描述
  qt_add_webengine_dictionary	將 hunspell 字典格式轉(zhuǎn)換為 bdict 二進(jìn)制格式

三、CMake變量參考（CMake Variable Reference）

1.模塊變量（Module variables）

2.安裝變量（Installation variables）

3.項(xiàng)目變量（Project variables）

• Qt6::Core

• Qt6::Qml

• Qt6::InterfaceFramework

四、CMake屬性參考（CMake Property Reference）

• Qt6::Core

  目標(biāo)屬性

源文件屬性文章來源地址http://www.zghlxwxcb.cn/news/detail-615589.html

• Qt6::DBus

源文件屬性

• Qt6::Qml

源文件屬性

到了這里，關(guān)于CMake+QT使用教程的文章就介紹完了。如果您還想了解更多內(nèi)容，請?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！