qt cmake

原文：https://blog.csdn.net/qq_32768743/article/details/80056316 

寫在前面的話：強烈建議優先閱讀Qt官網文檔對cmake的使用介紹——CMake Manual

前言
我去年用clion寫Qt的時候，找了不少教程，也沒有什麼讓我以爲很滿意的。後來本身摸索，構建了一個我本身比較喜歡的方式。個人環境是Deepin 15.5。

在Deepin上，獲取Qt環境最快的方式莫過於sudo apt install qtcreator-dde。它會幫你安裝qt開發包，qt集成環境等。因爲我本身很是喜歡JetBrains家的產品，如Intellij IDEA等，當它出了c++的IDE時，也很是但願能用JetBrains家的產品作Qt開發。我目前的環境是Clion 2018.1。

一個簡單的案例
首先介紹一下建立一個Qt的工程，這和建立一個普通的C++工程是同樣的。

 

接下來，咱們進行Qt工程的改造。

目錄結構

pikachu@pikachu-PC:~/src/Demo/QtDemo$ tree
.
├── CMakeLists.txt
└── src
├── CMakeLists.txt
└── main.cpp

把模板代碼貼上

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(QtDemo)
add_subdirectory(src)

src/CMakeLists.txt

cmake_minimum_required(VERSION 3.7)
set(TARGET_NAME QtDemo)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)
file(GLOB_RECURSE SOURCES "*.cpp")
file(GLOB_RECURSE HEADERS "*.h")
file(GLOB_RECURSE FORMS "*.ui")
file(GLOB_RECURSE RESOURCES "*.qrc")
find_package(PkgConfig REQUIRED)
set(QT Core Gui Widgets Network DBus Sql)
find_package(Qt5 REQUIRED ${QT})
pkg_check_modules(3rd_lib REQUIRED
dtkwidget dframeworkdbus
)
add_executable(${TARGET_NAME} ${SOURCES} ${HEADERS} ${FORMS} ${RESOURCES})
target_include_directories(${TARGET_NAME} PUBLIC ${3rd_lib_INCLUDE_DIRS} )
target_link_libraries(${TARGET_NAME} ${3rd_lib_LIBRARIES} )
qt5_use_modules(${TARGET_NAME} ${QT})
set(CMAKE_INSTALL_PREFIX /usr)
install(TARGETS ${TARGET_NAME} DESTINATION bin)

 

使用了DTK的模板代碼

#include <DApplication>
#include <DUtil>
#include <DMainWindow>
#include <DWidgetUtil>
#include <DLog>
#include <zconf.h>

DWIDGET_USE_NAMESPACE
DCORE_USE_NAMESPACE
int main(int argc, char *argv[]) {
DLogManager::registerConsoleAppender();
DLogManager::registerFileAppender();
DApplication::loadDXcbPlugin();
DApplication app(argc, argv);
app.setAttribute(Qt::AA_UseHighDpiPixmaps);
const QString socket_path(QString("QtDemo_%1").arg(getuid()));
if (app.setSingleInstance(socket_path)) {
app.setTheme("light");
app.loadTranslator();
const QString descriptionText = QApplication::tr("A simple Qt Demo by CLion 2018.1 and CMake");
const QString acknowledgementLink = "https://github.com/PikachuHy";
app.setOrganizationName("pikachu");
app.setApplicationName("QtDemo");
app.setApplicationDisplayName(QObject::tr("Qt Demo"));
app.setApplicationVersion("1.0.0");
app.setProductName(QApplication::tr("Qt Demo"));
app.setApplicationDescription(descriptionText);
app.setApplicationAcknowledgementPage(acknowledgementLink);

DMainWindow window;
window.setFixedWidth(600);
Dtk::Widget::moveToCenter(&window);
window.show();
return app.exec();
}
qDebug() << "app has started";
return 0;
}

 

分析與解釋

首先是目錄結構，我是在根目錄下又套了一個src目錄，爲何這樣作呢？

天然，這是有使用Qt的緣由在的。Qt本身有一個moc編譯器，會自動生成一些代碼。下面的代碼就是讓Qt自動生成相關的代碼，無需咱們本身干預。

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

另外一個是CLion自己的緣由。CLion會爲每一個項目建立如cmake-build-debug這樣的配置文件，而我經常是使用後綴名來匹配文件，若是不隔離，會致使函數重定義的問題。創建一個src目錄能夠很好的解決這個問題。搜索文件的代碼以下

file(GLOB_RECURSE SOURCES "*.cpp")
file(GLOB_RECURSE HEADERS "*.h")
file(GLOB_RECURSE FORMS "*.ui")
file(GLOB_RECURSE RESOURCES "*.qrc")

一般，咱們會用到Qt的不少模塊，在cmake中怎麼體現呢？我在尋找了好久後，發現了一個很是簡潔的寫法。你只須要在set(QT ...)這裏添加你須要的模塊便可。代碼以下：

set(QT Core Gui Widgets Network DBus Sql)
find_package(Qt5 REQUIRED ${QT})
qt5_use_modules(${TARGET_NAME} ${QT})

嗯，看樣子仍是很好的。但是，使用C++，常常要用到的是它的生態，如何使用第三方庫呢？在這裏，我是這樣定義的，先看代碼：

find_package(PkgConfig REQUIRED)
pkg_check_modules(3rd_lib REQUIRED
dtkwidget dframeworkdbus
)
target_include_directories(${TARGET_NAME} PUBLIC ${3rd_lib_INCLUDE_DIRS} )
target_link_libraries(${TARGET_NAME} ${3rd_lib_LIBRARIES} )

我依賴了２個第三方的包，dtkwidget和dframeworkdbus，以及定義一個3rd_lib的變量，而後經過target_include_directories和target_link_libraries用在項目中。若是須要添加新的庫，也僅僅是在pkg_check_modules(3rd_lib REQUIRED ...)中，寫上你庫的名字，很是方便。

若是你對QtCreator的配置文件.pro文件很熟悉的話，你會很驚訝的發現，我用CMake的寫法和用pro文件的寫法有諸多相似的地方。爲何呢？由於我經常須要在QtCreator和CLion兩個IDE之間切換，以便我更好的利用兩個IDE的優點，(QtCreator對Qt良好的支持，CLion對重構的良好支持)。

對CMakeLists.txt的介紹就到這裏了，若是你對它的代碼還有什麼疑問，能夠參考附錄中的註釋。

附：
CMakeLists.txt

# 需用使用的最小的CMake版本
cmake_minimum_required(VERSION 3.7)
# 本次構建的可執行文件名稱
set(TARGET_NAME QtDemo)
# 本次使用C++標準版本
set(CMAKE_CXX_STANDARD 17)
# 字面意思，包含當前目錄，能夠方便開發
set(CMAKE_INCLUDE_CURRENT_DIR ON)
# 開啓Qt代碼自動生成，再也不需用本身手寫了。按順序，分別是`Q_OBJECT`宏展開，資源文件，界面文件。
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)
# 簡單粗暴的把源碼蒐集起來。按順序，分別是實現文件，頭文件，界面文件，資源文件
file(GLOB_RECURSE SOURCES "*.cpp")
file(GLOB_RECURSE HEADERS "*.h")
file(GLOB_RECURSE FORMS "*.ui")
file(GLOB_RECURSE RESOURCES "*.qrc")
# 使用第三方庫須要用到的一個包
find_package(PkgConfig REQUIRED)
# 使用Qt的模塊，寫法和.pro文件相似
set(QT Core Gui Widgets Network DBus Sql)
find_package(Qt5 REQUIRED ${QT})
# 使用的第三方模塊
pkg_check_modules(3rd_lib REQUIRED
dtkwidget dframeworkdbus
)
add_executable(${TARGET_NAME} ${SOURCES} ${HEADERS} ${FORMS} ${RESOURCES})
target_include_directories(${TARGET_NAME} PUBLIC ${3rd_lib_INCLUDE_DIRS} )
target_link_libraries(${TARGET_NAME} ${3rd_lib_LIBRARIES} )
# 在CMake中使用Qt最快捷的方式，一句代碼搞定
qt5_use_modules(${TARGET_NAME} ${QT})
# 字面意思，安裝文件的前綴
set(CMAKE_INSTALL_PREFIX /usr)
# 安裝可執行文件
install(TARGETS ${TARGET_NAME} DESTINATION bin)

 

 

CMAKE_MINIMUM_REQUIRED(VERSION 2.8)

# 項目名
PROJECT(VRVDZWDYWTX CXX)


# 增長 QT 支持
SET(CMAKE_INCLUDE_CURRENT_DIR ON)
SET(CMAKE_AUTOMOC ON)
SET(CMAKE_AUTOUIC ON)

set(CMAKE_SKIP_BUILD_RPATH FALSE) 
# 幫助信息
SET(${PROJECT_NAME}_HELP_MSG "\n編譯選項：
       cmake -DDDM_INSTALL_PREFIX=</absolute/path> \\
             -DCOMMON_SRCS=<relative/path/from/current/to/common-ddm> \\
             -DPLATFROM=<RUN_ON_UBUNTU|RUN_ON_FANGDE|RUN_ON_FANGDE32|RUN_ON_YINHE|RUN_ON_ZHONGBIAO|RUN_ON_ZBx86> \\
             -DCMAKE_BUILD_TYPE=<Debug|Release>\\
             <relative/path/to/${PROJECT_NAME}> ")


# 檢查相關設置
INCLUDE (../CommonCode.cmake)

## 檢查變量是否認義
IF (NOT DEFINED COMMON_SRCS)
    MESSAGE(FATAL_ERROR "COMMON-DDM 源碼到該 build 目錄的相對路徑沒有指定. ${${PROJECT_NAME}_HELP_MSG}")
ENDIF()

## COMMON_DDM 項目的源碼路徑
SET(COMMON_PATH ${CMAKE_BINARY_DIR}/${COMMON_SRCS})

## 設置安裝路徑
IF (NOT DEFINED DDM_INSTALL_PREFIX)
    GET_DEFUAT_INSTALL(DDM_INSTALL_PREFIX)
ENDIF()

## 檢查目標平臺
IF (NOT DEFINED PLATFROM)
    MESSAGE(FATAL_ERROR "沒有指定目標平臺。${${PROJECT_NAME}_HELP_MSG}")
ENDIF()
GET_PLATFROM(${PLATFROM} TGT_PF ${${PROJECT_NAME}_HELP_MSG})
ADD_DEFINITIONS(-D${TGT_PF})
MESSAGE(STATUS "${PROJECT_NAME} 目標平臺爲：${TGT_PF}")

## RPATH 設置
GET_RPATH(${TGT_PF} ${PROJECT_NAME} TGT_RPATH ${${PROJECT_NAME}_HELP_MSG})
SET(CMAKE_INSTALL_RPATH "${TGT_RPATH}")
SET(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)
MESSAGE(STATUS "${PROJECT_NAME} RPATH 爲：${TGT_RPATH}")


# COMMON_DDM 項目的源碼路徑
SET(COMMON_PATH ${CMAKE_BINARY_DIR}/${COMMON_SRCS})

# 源文件列表
SET(${PROJECT_NAME}_SRC src/main.cpp
                        src/server.cpp 
                        src/webinterface.cpp
                        ${COMMON_PATH}/common/SoImport/SoImport.cpp
                        ${COMMON_PATH}/common/common/common.cpp)
SET(${PROJECT_NAME}_HDR src/server.h
                        src/webinterface.h
                        ${COMMON_PATH}/common/SoImport/SoImport.h
                        ${COMMON_PATH}/common/common/common.h)

# RPATH
SET(CMAKE_INSTALL_RPATH "${DDM_INSTALL_PREFIX}/lib/vrvlib")
SET(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)

# 可執行程序及依賴庫
FIND_PACKAGE(Qt5Widgets CONFIG REQUIRED)
FIND_PACKAGE(Qt5Gui     CONFIG REQUIRED)
FIND_PACKAGE(Qt5Network CONFIG REQUIRED)
FIND_PACKAGE(Qt5Xml     CONFIG REQUIRED)

ADD_EXECUTABLE(${PROJECT_NAME} ${${PROJECT_NAME}_SRC} ${${PROJECT_NAME}_HDR})

TARGET_LINK_LIBRARIES(${PROJECT_NAME} Qt5::Widgets Qt5::Gui Qt5::Network Qt5::Xml)
TARGET_LINK_LIBRARIES(${PROJECT_NAME} rt pthread)


# 頭文件路徑
INCLUDE_DIRECTORIES(${CMAKE_CURRENT_SOURCE_DIR}/src)
INCLUDE_DIRECTORIES(${COMMON_PATH})
INCLUDE_DIRECTORIES(${COMMON_PATH}/common)
INCLUDE_DIRECTORIES(${COMMON_PATH}/libs)

# Flags 選項
SET(CMAKE_CXX_FLAGS " -Wall")
SET(CMAKE_CXX_FLAGS_DEBUG   " $ENV{CXXFLAGS} -O0 -Wall -g ")

# 安裝選項
INSTALL(TARGETS ${PROJECT_NAME}
        DESTINATION ${DDM_INSTALL_PREFIX}
        PERMISSIONS OWNER_READ OWNER_WRITE OWNER_EXECUTE GROUP_READ GROUP_EXECUTE WORLD_READ WORLD_EXECUTE)