CMake如何查找庫路徑（一）

CMake如何查找庫路徑（一）

若是你的代碼使用了外部庫（external libraries），而且你事先不知道這些庫的頭文件和庫文件在當前平臺的位置。那麼適當的文件夾路徑和庫的搜索路徑就應該被添加到編譯命令中去。 
CMake 經過提供find_package命令來幫助你實現這點（）。 
本文簡要介紹如何在CMake工程中使用外部庫，而後介紹如何寫本身的find module。

Contents 
- 1. 使用外部庫 
- 2. 使用CMake沒有提供find module 的外部庫 
- 3. package finding的工做機制 
- 4. 利用pkg-config 
- 5. 編寫find modules 
- 6. 執行和緩存 
- 7. 常見bugs

---

1.使用外部庫

CMake自己提供了不少經常使用庫的module來幫助查找該庫。使用命令cmake –help-module-list 
能夠查看提供了哪些module，或者到module的存放路徑下查看，在ubuntu Linux上的位置一般在／usr/share/cmake/Modules/下。

---

2.使用CMake自己沒有提供module的外部庫

假設你要使用LibXML++庫，可是CMake沒有提供該庫的module。同時你發現網上有其餘人提供了FindLibXML++.cmake。 
此時能夠下載該文件並把它丟到CMake module路徑下。

有組件的包（components）

有些庫不是隻有一個總體組成，可能包含多個依賴庫和組件。一個明顯的例子是Qt 庫，包含組建QtOpenGL和QtXML。爲了使用這些組建，使用以下命令

find_package(Qt COMPONENTS QtOpenGL QtXml REQUIRED)

• 1

在包爲可選項時能夠省略關鍵詞REQUIRED。這樣就可使用變量<PACKAGE>_<COMPONENTS>_FOUND，例如Qt_QtXml_FOUND，來檢查對應組建是否被找到。

---

3.包查找的機制

find_package()命令會查找moudle目錄下的Find <name>.cmake文件。

• 首先，CMake查找${CMAKE_MODULE_PATH}裏的全部文件夾。

• 而後， CMake查找本身的module目錄<CMAKE_ROOT>/share/cmake-x.y/Modules/.

若是找不到上述文件，CMake會查找<Name>Config.cmake或者<lower-case-name&gt-config.cmake文件，這些應該是由庫來安裝的。

前者叫作module mode後者叫作config module。不管是哪一個mode被使用，若是一個package 被找到了，都會生成一系列的變量。 
<Name>_FOUND 
<Name>_INCLUDE_DIRS 或 <Name>_INCLUDES 
<Name>_LIBRARIES 或<Name>_LIBS 
<Name>_DEFINITIONS

全部這些變量都在Find <name>.cmake文件裏替換