cmake使用筆記


cmake使用筆記

以前一直使用MakeFile,看過一些開源項目後,瞭解到了cmake,它是一個跨平臺的編譯工具,不但能生成類unix系統下的makefile還能生成windows下project文件,這使得熟悉某個集成開發環境(IDE)的開發者能夠用標準的方式建構他的軟件,這種能夠使用各平臺的原生建構系統的能力是 CMake 和 SCons 等其餘相似系統的區別之處。c++

基本使用方法

cmake所的全部語句寫在CMakeLists.txt中,
由於cmake生成makefile或project而後在編譯時會生成不少中間文件,打亂項目文件結構,因此咱們通常新建一個build目錄,在裏面編譯。
基本操做只須要二步便可 :
一、cmake CMakeLists.txt文件目錄
二、make
三、若是配置了安裝路徑,還能夠進行make install 等.
Alt textredis

相較於makefile的優勢

目前我的體感上的優勢。
一、跨平臺。
二、語法相較於makefile簡潔很多,makefile有的,cmake基本都有。
三、編譯顯示自帶進度,顏色,看着很舒服,(固然makefile確定也能實現,省了很多事罷了)。
Alt textsql

下面講講經常使用語句:windows

經常使用語法

cmake_minimum_required

CMake要求的最低版本async

project

項目名稱tcp

cmake_minimum_required (VERSION 2.8.7)
project (test_project)

PROJECT_SOURCE_DIR

項目根目錄,也就是CmakeLists.txt目錄的絕對路徑。工具

set

設置變量
例如優化

###
# variables
###
set(SOURCES_DIRECTORY ${PROJECT_SOURCE_DIR}/sources)
set(OPEN_SOURCES_DIRECTORY ${PROJECT_SOURCE_DIR}/open_sources)
set(INCLUDES_DIRECTORY ${PROJECT_SOURCE_DIR}/includes)

set(MUDUO_LOGGER_INCLUDES ${INCLUDES_DIRECTORY}/muduo_logger)
set(MUDUO_NETWORK_INCLUDES ${INCLUDES_DIRECTORY}/muduo_network)
set(CPP_REDIS_INCLUDES ${OPEN_SOURCES_DIRECTORY}/cpp_redis/includes)

include_directories

包含頭文件路徑,相似於makfilede的-I
例如ui

###
# includes
###
include_directories(${INCLUDES_DIRECTORY}
         ${MUDUO_LOGGER_INCLUDES} 
         ${MUDUO_NETWORK_INCLUDES}
         ${SOURCES_DIRECTORY}/sip_server
         ${CPP_REDIS_INCLUDES}
         ${OPEN_SOURCES_DIRECTORY}/includes
         ${OPEN_SOURCES_DIRECTORY}/includes/mysql++)

連接路徑,相似於makfilede的-L

###
# libraries
###
link_directories("${PROJECT_SOURCE_DIR}/library")
link_directories("${OPEN_SOURCES_DIRECTORY}/library")

經常使用變量

CMAKE_CURRENT_LIST_DIR

表示正在處理的CMakeLists.txt 文件的所在的目錄的絕對路徑(2.8.3 以及之後版本才支持)

CMAKE_ARCHIVE_OUTPUT_DIRECTORY

用於設置 ARCHIVE 目標的輸出路徑

CMAKE_LIBRARY_OUTPUT_DIRECTORY

用於設置 LIBRARY 目標的輸出路徑

CMAKE_RUNTIME_OUTPUT_DIRECTORY

用於設置 RUNTIME 目標的輸出路徑

LIBRARY_OUTPUT_PATH

用於設置 庫文件 的輸出路徑

EXECUTABLE_OUTPUT_PATH

用於設置 可執行文件的輸出路徑

例如

###
# outputs
###
#set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib)
#set(CMAKE_PKGCONFIG_OUTPUT_DIRECTORY ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/pkgconfig)
#set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)

set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/library)
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

編譯連接標誌

CMAKE_C_FLAGS

CMAKE_C_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO]

C 編譯標誌相關變量。

CMAKE_CXX_FLAGS

CMAKE_CXX_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO]

C++ 編譯標誌相關變量。

CMAKE_C_FLAGS 或CMAKE_CXX_FLAGS 能夠指定編譯標誌
CMAKE_C_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO]或 CMAKE_CXX_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO] 則指定特定構建類型的編譯標誌,這些編譯標誌將被加入到 CMAKE_C_FLAGS 或 CMAKE_CXX_FLAGS 中去,例如,若是構建類型爲 DEBUG,那麼 CMAKE_CXX_FLAGS_DEBUG 將被加入到 CMAKE_CXX_FLAGS中去

還有連接標誌相關變量,做用相似
CMAKE_EXE_LINKER_FLAGS
CMAKE_EXE_LINKER_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO]
CMAKE_MODULE_LINKER_FLAGS
CMAKE_MODULE_LINKER_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO]
CMAKE_SHARED_LINKER_FLAGS
CMAKE_SHARED_LINKER_FLAGS_[DEBUG|RELEASE|MINSIZEREL|RELWITHDEBINFO]

###
# compilation options
###
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11 -g -W -Wall -Wextra -O3")

連接部分

add_library

添加要生成的庫文件
語法:add_library(<name> [STATIC | SHARED | MODULE] [EXCLUDE_FROM_ALL] source1source2 … sourceN)

用於指定從一組源文件 source1 source2 … sourceN 編譯出一個庫文件且命名爲 name,默認是靜態庫.
例如

###
#library
###
add_library(async_logging ${muduo_logger_sources})

add_library(muduo_server ${muduo_network_sources})

add_executable

add_executable 命令
語法:add_executable(<name> [WIN32] [MACOSX_BUNDLE][EXCLUDE_FROM_ALL] source1 source2 … sourceN)
用於指定從一組源文件 source1 source2 … sourceN 編譯出一個可執行文件且命名爲 name

###
# executable
###
add_executable(sip_server ${test_excutable })
add_executable(mysql_use_test ${mysql_use_test_sources})

語法: target_link_libraries(<target> [item1 [item2 […]]][[debug|optimized|general] ] …)
用於指定 target 連接的依賴項 item1 item2 …。
例如:

###
# link librarys
###
target_link_libraries(async_logging pthread)

target_link_libraries(muduo_server async_logging)
target_link_libraries(muduo_server pthread)

target_link_libraries(test_excutable async_logging
                                 muduo_server
                                 pthread
                                 cpp_redis
                                 tacopie)

其餘

add_subdirectory

若是想添加一個子項目或者模塊,能夠用它進行構建的子目錄
語法:add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])

add_subdirectory(${OPEN_SOURCES_DIRECTORY}/cpp_redis)

Debug和Release版本

暫很少詳述,簡單介紹一下。
debug 版的項目生成的可執行文件須要有調試信息而且不須要進行優化,、
release 版的不須要調試信息但須要優化。這些特性在 gcc/g++ 中是經過編譯時的參數來決定的,若是將優化程度調到最高須要設置參數-O3,最低是 -O0 即不作優化;添加調試信息的參數是 -g -ggdb ,若是不添加這個參數,調試信息就不會被包含在生成的二進制文件中。

PROJECT(main)
CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
SET(CMAKE_SOURCE_DIR .)

SET(CMAKE_CXX_FLAGS_DEBUG"$ENV{CXXFLAGS} -O0 -Wall -g -ggdb")
SET(CMAKE_CXX_FLAGS_RELEASE"$ENV{CXXFLAGS} -O3 -Wall")

AUX_SOURCE_DIRECTORY(. DIR_SRCS)
ADD_EXECUTABLE(main ${DIR_SRCS})

兩個變量 CMAKE_CXX_FLAGS_DEBUG 和CMAKE_CXX_FLAGS_RELEASE, 分別用於 debug 和 release 的編譯選項。編輯 CMakeList.txt 後須要執行 ccmake 命令生成 Makefile 。在進入項目的根目錄,輸入 "ccmake ." 進入一個圖形化界面。

調試手段

message

打印信息,相似於 echo/printf ,主要用於查cmake文件的語法錯誤。

set(mysql_use_test_sources ${SOURCES_DIRECTORY}/test_sources/mysql_user_accounts.cpp)
message("mysql_use_test_sources : ${mysql_use_test_sources}")

CMAKE_VERBOSE_MAKEFILE

顯示詳細的原始編譯信息,主要用於定位一些連接錯誤,看看庫路徑什麼的是否配置對。

# print compile info
set(CMAKE_VERBOSE_MAKEFILE ON)

或者執行make時
$ make VERBOSE=1
或者
$ export VERBOSE=1
$ make
你講能看到以下所示詳細編譯信息
Alt text

cmake示例

cmake_minimum_required (VERSION 2.8.7)
project (ws_tcp_server)

###
# variables
###
set(SOURCES_DIRECTORY ${PROJECT_SOURCE_DIR}/sources)
set(OPEN_SOURCES_DIRECTORY ${PROJECT_SOURCE_DIR}/open_sources)
set(INCLUDES_DIRECTORY ${PROJECT_SOURCE_DIR}/includes)

set(MUDUO_LOGGER_INCLUDES ${INCLUDES_DIRECTORY}/muduo_logger)
set(MUDUO_NETWORK_INCLUDES ${INCLUDES_DIRECTORY}/muduo_network)
set(CPP_REDIS_INCLUDES ${OPEN_SOURCES_DIRECTORY}/cpp_redis/includes)

###
# includes
###
include_directories(${INCLUDES_DIRECTORY}
         ${MUDUO_LOGGER_INCLUDES} 
         ${MUDUO_NETWORK_INCLUDES}
         ${CPP_REDIS_INCLUDES})

###
# libraries
###
link_directories("${PROJECT_SOURCE_DIR}/library")

###
# outputs
###
#set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib)
#set(CMAKE_PKGCONFIG_OUTPUT_DIRECTORY ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/pkgconfig)
#set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)

set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/library)
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

###
# compilation options
###
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DMYSQLPP_MYSQL_HEADERS_BURIED -std=c++11 -g -W -Wall -Wextra -O3")

# print compile info
#set(CMAKE_VERBOSE_MAKEFILE ON)

###
# sources file
###
set(MUDUO_NETWORK_SOURCES_DIRECTORY ${SOURCES_DIRECTORY}/muduo_network)
set(MUDUO_LOGGER_SOURCES_DIRECTORY ${SOURCES_DIRECTORY}/muduo_logger)
set(TEST_EXUTE_SOURCES_DIRECTORY ${SOURCES_DIRECTORY}/test_exute)

foreach(dir ${MUDUO_LOGGER_SOURCES_DIRECTORY})
  # get directory sources and headers
  file(GLOB s_${dir} "${dir}/*.cpp")
  file(GLOB h_${dir} "${dir}/*.hpp")

  # set async_logger sources
  set(muduo_logger_sources ${s_${dir}} ${h_${dir}})
endforeach()

foreach(dir ${MUDUO_NETWORK_SOURCES_DIRECTORY})
  # get directory sources and headers
  file(GLOB s_${dir} "${dir}/*.cpp")
  file(GLOB h_${dir} "${dir}/*.hpp")

  # set muiduo_network sources
  set(muduo_network_sources ${s_${dir}} ${h_${dir}})
endforeach()

#message("muduo_network_sources: ${muduo_network_sources}")

set(test_exute_sources
    ${WS_SERVER_SOURCES_DIRECTORY}/test_exute.cpp
    ${WS_SERVER_SOURCES_DIRECTORY}/main.cpp)

#message("test_exute_sources : ${test_exute_sources}")

###
#library
###
add_library(async_logging ${muduo_logger_sources})
add_library(muduo_server ${muduo_network_sources})

###
# executable
###
add_executable(test_exute ${test_exute_sources})

小結

這些是到目前對cmake使用,所用到的一些基本語法,和基本編譯調試手段的一點筆記,後續若有新玩法另加。

相關文章
相關標籤/搜索