原文:https://blog.csdn.net/qq_32768743/article/details/80056316 c++
寫在前面的話:強烈建議優先閱讀Qt官網文檔對cmake的使用介紹——CMake Manualgit
前言
我去年用clion寫Qt的時候,找了不少教程,也沒有什麼讓我以爲很滿意的。後來本身摸索,構建了一個我本身比較喜歡的方式。個人環境是Deepin 15.5。github
在Deepin上,獲取Qt環境最快的方式莫過於sudo apt install qtcreator-dde。它會幫你安裝qt開發包,qt集成環境等。因爲我本身很是喜歡JetBrains家的產品,如Intellij IDEA等,當它出了c++的IDE時,也很是但願能用JetBrains家的產品作Qt開發。我目前的環境是Clion 2018.1。web
一個簡單的案例
首先介紹一下建立一個Qt的工程,這和建立一個普通的C++工程是同樣的。app
接下來,咱們進行Qt工程的改造。socket
目錄結構函數
pikachu@pikachu-PC:~/src/Demo/QtDemo$ tree
.
├── CMakeLists.txt
└── src
├── CMakeLists.txt
└── main.cppui
把模板代碼貼上spa
CMakeLists.txt.net
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} )
我依賴了2個第三方的包,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)