本文將介紹如何使用 CMake 構建項目、編譯生成庫文件，并將頭文件和庫文件整理到統一的目錄中以便在其他項目中使用。

---

1. 項目結構

假設我們正在構建一個名為 rttr 的開源庫，初始的項目結構如下：

D:\WorkCode\Demo\rttr-master\|- src\                   (源代碼)|- include\               (可能的頭文件目錄，部分項目不提供該目錄)|- CMakeLists.txt         (CMake 配置文件)|- build\                 (生成文件的輸出目錄，自己創建)

目標：

1. 使用 CMake 編譯項目。
2. 將生成的庫文件和頭文件整理到一個 install 目錄中：

D:\WorkCode\Demo\rttr-master\install\|- include\            (整理后的頭文件目錄)|- lib\                (整理后的庫文件目錄)

---

2. 使用 CMake 構建項目

步驟 1：配置 CMake 構建環境

使用以下命令克隆項目的主代碼庫：

git clone https://github.com/your/repo.git

將 https://github.com/your/repo.git 替換為實際的倉庫地址。例如：

git clone https://github.com/rttrorg/rttr.git

如果項目依賴于子模塊，使用以下命令獲取子模塊：

git submodule update --init --recursive

進入 build 目錄，使用 CMake 配置構建環境：

cd D:\WorkCode\Demo\rttr-master\build
cmake .. -DCMAKE_INSTALL_PREFIX=D:/WorkCode/Demo/rttr-master/install

參數說明：

• ..：指定上一級目錄為源代碼目錄。
• -DCMAKE_INSTALL_PREFIX：設置安裝路徑，構建完成后文件會整理到該路徑下。

步驟 2：編譯項目

使用以下命令編譯項目：

cmake --build . --config Release

參數說明：

• --config Release：指定生成 Release 版本的庫文件（適用于多配置生成器，如 MSVC）。

步驟 3：安裝文件

運行以下命令將頭文件和庫文件整理到指定目錄：

cmake --install . --config Release

---

3. 檢查整理結果

安裝完成后，檢查 install 目錄中的內容：

D:\WorkCode\Demo\rttr-master\install\|- include\            (包含所有頭文件，例如 `rttr/registration.h`)|- lib\                (包含所有庫文件，例如 `rttr_core.lib` 或 `rttr_core.dll`)

如果項目沒有提供 include 目錄，可能需要手動從源碼中復制相關頭文件。

---

4. 手動整理頭文件和庫文件

如果 cmake --install 沒有正確生成 include 或 lib 目錄，可以手動整理：

頭文件

1. 從項目的源碼目錄復制頭文件：

   D:\WorkCode\Demo\rttr-master\src\
   

   或

   D:\WorkCode\Demo\rttr-master\include\
   

   將其放入：

   D:\WorkCode\Demo\rttr-master\install\include\
   

庫文件

1. 從 build 目錄中找到生成的庫文件（例如 Release 或 Debug 目錄）：

   D:\WorkCode\Demo\rttr-master\build\Release\rttr_core.lib
   

2. 將庫文件復制到：

   D:\WorkCode\Demo\rttr-master\install\lib\
   

---

5. 在其他項目中使用整理后的庫

整理完成后，可以在其他項目中通過以下方式引用整理好的 RTTR 庫。

CMake 示例配置

# 更改編譯器的代碼頁
add_compile_options(/source-charset:utf-8 /execution-charset:utf-8)# 設置 RTTR 的安裝路徑
set(RTTR_ROOT D:/WorkCode/Demo/rttr-master/install)# 包含頭文件
include_directories(${RTTR_ROOT}/include)# 鏈接庫文件
target_link_libraries(${PROJECT_NAME} PRIVATE ${RTTR_ROOT}/lib/rttr_core.lib)

---

6. 驗證項目配置

編寫一個簡單的測試程序，驗證是否能夠成功包含頭文件并鏈接庫文件。

測試代碼

#include <rttr/registration>
#include <iostream>class MyClass {
public:MyClass(int val) : value(val) {}int GetValue() const { return value; }void SetValue(int val) { value = val; }private:int value;
};RTTR_REGISTRATION
{rttr::registration::class_<MyClass>("MyClass").constructor<int>().property("value", &MyClass::GetValue, &MyClass::SetValue);
}int main() {auto myClassType = rttr::type::get_by_name("MyClass");if (myClassType.is_valid()) {std::cout << "RTTR integration successful!" << std::endl;// 動態創建對象rttr::variant obj = myClassType.create({42});if (obj.is_valid()) {// 訪問屬性rttr::property prop = myClassType.get_property("value");std::cout << "Initial Value: " << prop.get_value(obj).to_int() << std::endl;// 修改屬性prop.set_value(obj, 100);std::cout << "Updated Value: " << prop.get_value(obj).to_int() << std::endl;}} else {std::cout << "RTTR integration failed." << std::endl;}return 0;
}

編譯測試

使用上述 CMake 配置，運行程序，如果輸出：

RTTR integration successful!

說明配置正確。

---

總結

1. 使用 cmake --install 可以自動整理頭文件和庫文件。
2. 如果整理失敗，可以手動從源碼中復制頭文件，并將庫文件移動到 lib 目錄。
3. 在其他項目中使用時，通過 include_directories 和 target_link_libraries 配置頭文件和庫文件路徑。
4. 如果遇到編碼問題，那么更改編譯器的代碼頁。