目錄
文件目錄說明
操作:Linux系統下編譯
編譯動態庫
編譯、運行可執行文件
Windows系統中使用VSCode開發
創建MSVC工程
執行cmake配置
編譯動態庫
編譯、運行可執行程序
Windows只用VS2019來開發
生成VS2019解決方案
使用VS2019編譯動態庫
編譯、運行可執行程序
之前分享過一篇關于 cmake 的入門文章:《使用 cmake 來搭建跨平臺的應用程序框架:C語言版本》,那篇文章重點是描述如何利用 cmake 來編譯或者構建跨平臺的工程,并沒有涉及到團隊協作開發方面的內容。
這篇文章提供了一個簡潔易懂的 cmake 工程模板,可以滿足一個小團隊的合作開發,無論是在代碼安全性,還是開發效率上,都能滿足基本的開發需求。
本文詳細描述了文件結構和操作流程,如何在Linux系統使用命令行來編譯,如何在Windows系統中使用VSCode 和Visual Studio 2019來進行開發和編譯。
使用這個cmake模板之后,代碼的結構非常的清晰,編譯過程中產生的中間文件也不會污染源代碼。
無論是開發一些個人項目,或者是在一些小團隊中使用是綽綽有余了。
示例代碼中核心的兩個文件就是:app.cmake和lib.cmake,幾乎每一行都有注釋。
文末有下載鏈接。
在團隊開發工作中,每個人負責不同的模塊。
從代碼保密的角度看,除了項目負責人(或者說項目整合人員)有權限獲取一個項目中的所有代碼之外,每個開發者通常只擁有自己負責的模塊。
每個開發者在編譯自己的模塊時,需要把輸出文件(頭文件、庫文件、文檔)等,匯總到一個中央倉庫中,方便整合人員進行集成編譯。
因此,示例代碼如下圖所示:

CMakeLists.txt:是最外層的 cmake 文件;
install:是所有模塊編譯結果的安裝目錄,便于項目整合人員集成編譯;
myapp:是一個可執行程序的模板;
mymath:是一個動態鏈接庫的模板;
再來看一下mymath內部的文件組織結構:

build:存放編譯過程中產生的中間文件,不會污染源代碼。當然了,如果使用 git 來進行版本管理,需要把這個目錄添加到 .gitignore 文件中;
lib.cmake:比較重要的 cmake 文件,這個模板的核心價值就在這個文件中;
source:存放源代碼,并且區分了 linux 和 windows 系統,在不同的系統上編譯,會自動編譯對應目錄下的 C 文件;
include:存放頭文件;
myapp目錄內部結構與mymath幾乎是一樣的,這里就不贅述了。
這兩個模塊的編譯結果會自動輸出到install目錄,如下圖所示:

在install目錄內:
include:匯總了所有模塊的頭文件;
library:匯總了所有模塊輸出的庫文件;
bin:匯總了所有的可執行程序(一些單元測試程序根據自己的需要是否輸出此目錄);
【本文作者】公-眾-號:“IOT物聯網小鎮”,是道哥在工作之余個人維護的分享平臺,十多年的嵌入式開發老兵,專注于嵌入式 + Linux 領域,玩過單片機、搞過智能家居、研究過 PLC 和 工業機器人。厚積薄發、換位思考,以讀者的角度來總結文章。每一篇輸出,不僅僅是干貨的呈現,更是引導你一步一步的深入思考,從底層邏輯來提升自己。
刪除install下所有文件和目錄,得到一個干凈的目錄。
創建build目錄,存放中間文件:
$ cd demo_cmake\mymath
$ mkdir build
編譯
$ cd build
$ cmake ..
$ make
成功編譯后,在install目錄里可以看到編譯的輸出結果:
demo_cmake\install\include\mymath\mymath.h
demo_cmake\install\library\linux\debug\libmymath.so
$ cd demo_cmake\myapp
$ mkdir build
$ cd build
$ cmake ..
$ make
查看install目錄下的輸出結果:
demo_cmake\install\bin\linux\debug\myapp
$ cd demo_cmake\install\bin\linux\debug
$ ./myapp
執行結果如下圖:

在VSCode IDE中,通過菜單【File】-【Open Folder】,打開文件夾demo_cmake。
因為demo_cmake目錄下存在一個頂層CMakeLists.txt文件,所以VSCode偵測到之后會自動進行cmake配置,同時會創建目錄build來存放所有的中間文件。
有些VSCode版本會跳出一個提示窗,讓用戶選擇進行cmake配置,如下一步中所示。
可以同時按下:【ctrl】 + 【shift】 + 【p】,重新進行cmake配置:

同時按下【shift】+【F7】,(或者按下VSCode最下方 【Build】右側的編譯目標),彈出窗口:

查看install目錄中的輸出文件:
demo_cmake\install\library\windows\debug\mymath.lib
demo_cmake\install\bin\windows\debug\mymath.dll
同時按下【shift】+【F7】,選擇編譯myapp。
查看install目錄:
demo_cmake\install\bin\windows\debug\myapp

打開命令行窗口: x64 Native Tools Command Prompt for VS 2019
> cd demo_cmake
> md build
> cd build
> cmake ..
輸出如圖:

此時,可以看到解決方案:demo_cmake\build\demo_cmake.sln。
使用VS2019打開解決方案文件:

在工程mymath上單擊右鍵,選擇【重新生成】,在輸出信息區可以看到生成了文件:
demo_cmake\install\library\windows\debug\mymath.lib
demo_cmake\install\bin\windows\debug\mymath.dll
在工程myapp上單擊右鍵,選擇【重新生成】。
在輸出信息區可以看到生成了文件:
demo_cmake\install\bin\windows\debug\myapp.exe

我們知道,在Windows平臺上,VS2019只是一個IDE而已,它的底層是調用MSBuild來執行編譯動作的。
MSBuild的角色與cmake非常類似,使用起來也比較方便,以后再總結一篇關于MSBuild的模板工程。

