使用 Cmake 來搭建跨平臺的應用程序框架:C++版本
- 一、前言
- 二、示例代碼說明
- 三、Linux 系統下操作
- 四、Windows 系統下操作
- 五、總結
一、前言
在上一篇文章中(使用 cmake 來搭建跨平臺的應用程序框架:C語言版本),我們以源代碼的形式,演示了利用利用 cmake 這個構建工具,來編譯跨平臺的動態庫、靜態庫和應用程序。
這篇文章描述的是同樣的功能,只不過是用 C++ 來編碼,另外,增加了一個小功能:如果在導出的庫文件中,使用另一個第三方庫。
二、示例代碼說明
1. 功能描述
示例代碼的主要目的,是用來描述如何組織一個跨平臺的應用程序結構。它的功能比較簡單,如下圖所示:
2. 文件結構
- libA: 編譯得到庫文件 libA.so/libA.a;
- libB: 編譯得到庫文件 libB.so/libB.a,它需要調用 libA 庫中的函數;
- appC:應用程序,它需要調用 libB 庫中的函數;
三、Linux 系統下操作
1. 通過 cmake 指令,生成 Makefile 文件
為了不污染源代碼,我們新建一個 build 目錄,然后在其中編譯:
- $ make build
- $ cd build
- $ cmake ..
編譯輸出結果:
2. 編譯 libA
- $ cd libA/src
- $ make
編譯結果如下:
安裝到源碼下的 output 目錄:
- $ make install
此時,相關文件被安裝到源碼路徑下 libA 的 output 目錄下:
3. 編譯 libB
由于 libB 調用了 libA 中的函數,因此需要手動把相關頭文件和庫文件復制到 libB 目錄下,當然,這個步驟也可以寫在 CMakeLists.txt 中。
然后進入 build/libB/src 目錄,執行編譯指令:
- $ cd build/libB/src
- $ make
同樣的,把 libB 生成的庫文件和頭文件,復制到源碼中的 libB/output 目錄下:
4. 編譯可執行程序 appC
由于 appC 調用了 libB 中的函數,因此需要手動把相關頭文件和庫文件復制到 appC 目錄下的 include 和 lib/linux 目錄下。
此外,由于我一直使用動態庫,所以還需要把 libA 的頭文件和庫文件也復制到 appC 目錄下。
然后進入 build/appC/src 目錄,執行編譯指令:
- $ cd build/appC/src
- $ make
執行輸出結果:
四、Windows 系統下操作
1. 生成 VS 解決方案
在 build 目錄下執行 cmake ..,得到 VS 解決方案:
打開工程文件 CppFrame.sln,右側的解決方案如圖:
2. 編譯 libA
在 libA_shared 上單擊右鍵,選擇【生成】:
可以看到,在 build\libA\src\Debug 目錄下看到編譯生成的文件:
這里有一個問題需要注意一下:在 libA/src/CMakeLists.txt 中,如果編譯動態庫,請如下設置:
如果編譯靜態庫,請如下設置:
這幾個宏定義,需要結合 ADll.h 中的定義來理解,主要是解決 Windows 平臺下的動態庫的導出與導入問題。
在下面編譯 libB 庫的時候,也需要同樣的操作。
3. 編譯 libB
由于 libB 調用了 libA 中的函數,因此,需要手動把 libA 庫相關的頭文件和庫文件復制到 libB 目錄下。
在 libB_shared 目標上,單擊【生成】,編譯輸出如下:
此時,在 build/libB/src/Debug 目錄下,看到生成的庫文件:
我們把 libB 庫文件和頭文件,手動復制到 appC 目錄下備用。
4. 編譯 appC
在 VS 的 main 目標上,單擊【生成】,編譯輸出如下:
此時,在 build\appC\src\Debug 目錄下即可看到可執行程序 main.exe。
為了執行這個程序,還需要把 libA.dll, libB.dll 復制到當前目錄下才可以,如下所示:
五、總結
這篇文章的操作過程主要以動態庫為主,如果編譯、使用靜態庫,執行過程是一樣一樣的。
本文轉載自微信公眾號「IOT物聯網小鎮」,可以通過以下二維碼關注。轉載本文請聯系IOT物聯網小鎮公眾號。