萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

CMake 從入門到實戰:跨平台構建系統配置全流程指南

CMake 是高階構建配置工具,根據平台/編譯器生成 Makefile 或 VS 專案。掌握 CMakeLists.txt 編寫,即可掌控編譯、測試、安裝、打包全生命週期。

核心工作流

  1. 編寫 CMakeLists.txt (源碼根目錄)
  2. mkdir build && cd build
  3. cmake .. (生成構建文件)
  4. cmake --build . / make / 打開 .sln 編譯
  5. ctest / make test 運行測試
  6. cmake --install . / make install 安裝
  7. cpack / make package 生成安裝包

GUI 操作

CMake GUI 介面
  1. 源碼路徑 / 構建路徑 (自動創建)
  2. Configure → 選擇生成器 (Visual Studio / Unix Makefiles / Ninja...)
  3. Generate → 生成專案文件
  4. Open Project / 命令行構建
Configure 後生成文件
Generate 後構建文件

官方教程逐步實戰

Step 1: 最簡單可執行文件

cmake_minimum_required(VERSION 2.8)
project(Tutorial)
add_executable(Tutorial tutorial.cxx)

cmake .. && make → 生成 Tutorial.exe。

make 編譯輸出

運行結果

Step 2: 子目錄靜態庫 + 鏈接

# MathFunctions/CMakeLists.txt
add_library(MathFunctions mysqrt.cxx)

# 根 CMakeLists.txt
include_directories("${PROJECT_SOURCE_DIR}/MathFunctions")
add_subdirectory(MathFunctions)
add_executable(Tutorial tutorial.cxx)
target_link_libraries(Tutorial MathFunctions)

構建過程:先編譯靜態庫 libMathFunctions.a,再鏈接主程序。

生成器選擇

Step 3: 安裝規則 + 測試用例

# 安裝目標
install(TARGETS Tutorial DESTINATION bin)
install(TARGETS MathFunctions DESTINATION lib)
install(FILES MathFunctions.h TutorialConfig.h DESTINATION include)

# 測試用例
enable_testing()
add_test(NAME TutorialRuns COMMAND Tutorial 25)

# 參數化測試宏
macro(do_test arg expected_output)
  add_test(NAME TutorialComp${arg} COMMAND Tutorial ${arg})
  set_tests_properties(TutorialComp${arg} PROPERTIES PASS_REGULAR_EXPRESSION ${expected_output})
endmacro()
do_test(25 "25 is 5")
do_test(-25 "-25 is 0")

make install 輸出至 CMAKE_INSTALL_PREFIX (默認 C:/Program Files/Tutorial / /usr/local):

make install 輸出

安裝目錄樹

make test / ctest 運行所有測試:

ctest 測試結果

進階常用指令速查

指令用途
set(VAR value)定義變量
option(OPT "desc" ON/OFF)用戶可選選項
add_definitions(-DFOO)編譯器宏定義
include_directories(dir)頭文件搜索路徑
target_include_libraries(tgt PRIVATE/PUBLIC/INTERFACE dir)現代目標專用/傳遞依賴 (現代 CMake 推薦)
find_package(Pkg REQUIRED)尋找第三方庫 (OpenCV, Boost, Qt...)
add_custom_target/command自定義構建步驟
configure_file(in.out)模板生成配置文件

現代 CMake (3.0+) 核心思想

  • Target-based: 圍繞 target 設置屬性 (target_compile_options, target_link_libraries, target_include_directories),自動傳遞依賴,避免全局汙染。
  • 範圍可見性: PRIVATE (僅內部), PUBLIC (接口+內部), INTERFACE (僅接口)。
  • 不再手寫路徑: 用 target_link_libraries(MyTarget PUBLIC Pkg::Pkg) 導入 find_package 發現的現代目標。

學習資源:官方教程、Modern CMake、cmake-examples。

copyright © 萬盛學電腦網 all rights reserved