# 1.6 指定編譯器
**NOTE**:*此示例代碼可以在 https://github.com/dev-cafe/cmake-cookbook/tree/v1.0/chapter-01/recipe-06 中找到,其中有一個C++/C示例。該配置在CMake 3.5版(或更高版本)下測試沒問題,并且已經在GNU/Linux、macOS和Windows上進行了測試。*
目前為止,我們還沒有過多考慮如何選擇編譯器。CMake可以根據平臺和生成器選擇編譯器,還能將編譯器標志設置為默認值。然而,我們通常控制編譯器的選擇。在后面的示例中,我們還將考慮構建類型的選擇,并展示如何控制編譯器標志。
## 具體實施
如何選擇一個特定的編譯器?例如,如果想使用Intel或Portland Group編譯器怎么辦?CMake將語言的編譯器存儲在` CMAKE_<LANG>_COMPILER`變量中,其中` <LANG> `是受支持的任何一種語言,對于我們的目的是`CXX`、`C`或`Fortran`。用戶可以通過以下兩種方式之一設置此變量:
1. 使用CLI中的`-D`選項,例如:
```shell
$ cmake -D CMAKE_CXX_COMPILER=clang++ ..
```
2. 通過導出環境變量`CXX`(C++編譯器)、`CC`(C編譯器)和`FC`(Fortran編譯器)。例如,使用這個命令使用`clang++`作為`C++`編譯器:
```shell
$ env CXX=clang++ cmake ..
```
到目前為止討論的示例,都可以通過傳遞適當的選項,配置合適的編譯器。
**NOTE**:*CMake了解運行環境,可以通過其CLI的`-D`開關或環境變量設置許多選項。前一種機制覆蓋后一種機制,但是我們建議使用`-D`顯式設置選項。顯式優于隱式,因為環境變量可能被設置為不適合(當前項目)的值。*
我們在這里假設,其他編譯器在標準路徑中可用,CMake在標準路徑中執行查找編譯器。如果不是這樣,用戶將需要將完整的編譯器可執行文件或包裝器路徑傳遞給CMake。
**TIPS**:*我們建議使用`-D CMAKE_<LANG>_COMPILER`CLI選項設置編譯器,而不是導出`CXX`、`CC`和`FC`。這是確保跨平臺并與非POSIX兼容的唯一方法。為了避免變量污染環境,這些變量可能會影響與項目一起構建的外部庫環境。*
## 工作原理
配置時,CMake會進行一系列平臺測試,以確定哪些編譯器可用,以及它們是否適合當前的項目。一個合適的編譯器不僅取決于我們所使用的平臺,還取決于我們想要使用的生成器。CMake執行的第一個測試基于項目語言的編譯器的名稱。例如,`cc`是一個工作的`C`編譯器,那么它將用作`C`項目的默認編譯器。GNU/Linux上,使用Unix Makefile或Ninja時, GCC家族中的編譯器很可能是`C++`、`C`和`Fortran`的默認選擇。Microsoft Windows上,將選擇Visual Studio中的`C++`和`C`編譯器(前提是Visual Studio是生成器)。如果選擇MinGW或MSYS Makefile作為生成器,則默認使用MinGW編譯器。
## 更多信息
我們的平臺上的CMake,在哪里可以找到可用的編譯器和編譯器標志?CMake提供`--system-information`標志,它將把關于系統的所有信息轉儲到屏幕或文件中。要查看這個信息,請嘗試以下操作:
```shell
$ cmake --system-information information.txt
```
文件中(本例中是`information.txt`)可以看到`CMAKE_CXX_COMPILER`、`CMAKE_C_COMPILER`和`CMAKE_Fortran_COMPILER`的默認值,以及默認標志。我們將在下一個示例中看到相關的標志。
CMake提供了額外的變量來與編譯器交互:
* `CMAKE_<LANG>_COMPILER_LOADED `:如果為項目啟用了語言`<LANG>`,則將設置為`TRUE`。
* `CMAKE_<LANG>_COMPILER_ID`:編譯器標識字符串,編譯器供應商所特有。例如,`GCC`用于GNU編譯器集合,`AppleClang`用于macOS上的Clang, `MSVC`用于Microsoft Visual Studio編譯器。注意,不能保證為所有編譯器或語言定義此變量。
* `CMAKE_COMPILER_IS_GNU<LANG> `:如果語言`<LANG>`是GNU編譯器集合的一部分,則將此邏輯變量設置為`TRUE`。注意變量名的`<LANG>`部分遵循GNU約定:C語言為`CC`, C++語言為`CXX`, Fortran語言為`G77`。
* `CMAKE_<LANG>_COMPILER_VERSION`:此變量包含一個字符串,該字符串給定語言的編譯器版本。版本信息在`major[.minor[.patch[.tweak]]]`中給出。但是,對于`CMAKE_<LANG>_COMPILER_ID`,不能保證所有編譯器或語言都定義了此變量。
我們可以嘗試使用不同的編譯器,配置下面的示例`CMakeLists.txt`。這個例子中,我們將使用CMake變量來探索已使用的編譯器(及版本):
```cmake
cmake_minimum_required(VERSION 3.5 FATAL_ERROR)
project(recipe-06 LANGUAGES C CXX)
message(STATUS "Is the C++ compiler loaded? ${CMAKE_CXX_COMPILER_LOADED}")
if(CMAKE_CXX_COMPILER_LOADED)
message(STATUS "The C++ compiler ID is: ${CMAKE_CXX_COMPILER_ID}")
message(STATUS "Is the C++ from GNU? ${CMAKE_COMPILER_IS_GNUCXX}")
message(STATUS "The C++ compiler version is: ${CMAKE_CXX_COMPILER_VERSION}")
endif()
message(STATUS "Is the C compiler loaded? ${CMAKE_C_COMPILER_LOADED}")
if(CMAKE_C_COMPILER_LOADED)
message(STATUS "The C compiler ID is: ${CMAKE_C_COMPILER_ID}")
message(STATUS "Is the C from GNU? ${CMAKE_COMPILER_IS_GNUCC}")
message(STATUS "The C compiler version is: ${CMAKE_C_COMPILER_VERSION}")
endif()
```
注意,這個例子不包含任何目標,沒有要構建的東西,我們只關注配置步驟:
```shell
$ mkdir -p build
$ cd build
$ cmake ..
...
-- Is the C++ compiler loaded? 1
-- The C++ compiler ID is: GNU
-- Is the C++ from GNU? 1
-- The C++ compiler version is: 8.1.0
-- Is the C compiler loaded? 1
-- The C compiler ID is: GNU
-- Is the C from GNU? 1
-- The C compiler version is: 8.1.0
...
```
當然,輸出將取決于可用和已選擇的編譯器(及版本)。
- Introduction
- 前言
- 第0章 配置環境
- 0.1 獲取代碼
- 0.2 Docker鏡像
- 0.3 安裝必要的軟件
- 0.4 測試環境
- 0.5 上報問題并提出改進建議
- 第1章 從可執行文件到庫
- 1.1 將單個源文件編譯為可執行文件
- 1.2 切換生成器
- 1.3 構建和鏈接靜態庫和動態庫
- 1.4 用條件句控制編譯
- 1.5 向用戶顯示選項
- 1.6 指定編譯器
- 1.7 切換構建類型
- 1.8 設置編譯器選項
- 1.9 為語言設定標準
- 1.10 使用控制流
- 第2章 檢測環境
- 2.1 檢測操作系統
- 2.2 處理與平臺相關的源代碼
- 2.3 處理與編譯器相關的源代碼
- 2.4 檢測處理器體系結構
- 2.5 檢測處理器指令集
- 2.6 為Eigen庫使能向量化
- 第3章 檢測外部庫和程序
- 3.1 檢測Python解釋器
- 3.2 檢測Python庫
- 3.3 檢測Python模塊和包
- 3.4 檢測BLAS和LAPACK數學庫
- 3.5 檢測OpenMP的并行環境
- 3.6 檢測MPI的并行環境
- 3.7 檢測Eigen庫
- 3.8 檢測Boost庫
- 3.9 檢測外部庫:Ⅰ. 使用pkg-config
- 3.10 檢測外部庫:Ⅱ. 自定義find模塊
- 第4章 創建和運行測試
- 4.1 創建一個簡單的單元測試
- 4.2 使用Catch2庫進行單元測試
- 4.3 使用Google Test庫進行單元測試
- 4.4 使用Boost Test進行單元測試
- 4.5 使用動態分析來檢測內存缺陷
- 4.6 預期測試失敗
- 4.7 使用超時測試運行時間過長的測試
- 4.8 并行測試
- 4.9 運行測試子集
- 4.10 使用測試固件
- 第5章 配置時和構建時的操作
- 5.1 使用平臺無關的文件操作
- 5.2 配置時運行自定義命令
- 5.3 構建時運行自定義命令:Ⅰ. 使用add_custom_command
- 5.4 構建時運行自定義命令:Ⅱ. 使用add_custom_target
- 5.5 構建時為特定目標運行自定義命令
- 5.6 探究編譯和鏈接命令
- 5.7 探究編譯器標志命令
- 5.8 探究可執行命令
- 5.9 使用生成器表達式微調配置和編譯
- 第6章 生成源碼
- 6.1 配置時生成源碼
- 6.2 使用Python在配置時生成源碼
- 6.3 構建時使用Python生成源碼
- 6.4 記錄項目版本信息以便報告
- 6.5 從文件中記錄項目版本
- 6.6 配置時記錄Git Hash值
- 6.7 構建時記錄Git Hash值
- 第7章 構建項目
- 7.1 使用函數和宏重用代碼
- 7.2 將CMake源代碼分成模塊
- 7.3 編寫函數來測試和設置編譯器標志
- 7.4 用指定參數定義函數或宏
- 7.5 重新定義函數和宏
- 7.6 使用廢棄函數、宏和變量
- 7.7 add_subdirectory的限定范圍
- 7.8 使用target_sources避免全局變量
- 7.9 組織Fortran項目
- 第8章 超級構建模式
- 8.1 使用超級構建模式
- 8.2 使用超級構建管理依賴項:Ⅰ.Boost庫
- 8.3 使用超級構建管理依賴項:Ⅱ.FFTW庫
- 8.4 使用超級構建管理依賴項:Ⅲ.Google Test框架
- 8.5 使用超級構建支持項目
- 第9章 語言混合項目
- 9.1 使用C/C++庫構建Fortran項目
- 9.2 使用Fortran庫構建C/C++項目
- 9.3 使用Cython構建C++和Python項目
- 9.4 使用Boost.Python構建C++和Python項目
- 9.5 使用pybind11構建C++和Python項目
- 9.6 使用Python CFFI混合C,C++,Fortran和Python
- 第10章 編寫安裝程序
- 10.1 安裝項目
- 10.2 生成輸出頭文件
- 10.3 輸出目標
- 10.4 安裝超級構建
- 第11章 打包項目
- 11.1 生成源代碼和二進制包
- 11.2 通過PyPI發布使用CMake/pybind11構建的C++/Python項目
- 11.3 通過PyPI發布使用CMake/CFFI構建C/Fortran/Python項目
- 11.4 以Conda包的形式發布一個簡單的項目
- 11.5 將Conda包作為依賴項發布給項目
- 第12章 構建文檔
- 12.1 使用Doxygen構建文檔
- 12.2 使用Sphinx構建文檔
- 12.3 結合Doxygen和Sphinx
- 第13章 選擇生成器和交叉編譯
- 13.1 使用CMake構建Visual Studio 2017項目
- 13.2 交叉編譯hello world示例
- 13.3 使用OpenMP并行化交叉編譯Windows二進制文件
- 第14章 測試面板
- 14.1 將測試部署到CDash
- 14.2 CDash顯示測試覆蓋率
- 14.3 使用AddressSanifier向CDash報告內存缺陷
- 14.4 使用ThreadSaniiser向CDash報告數據爭用
- 第15章 使用CMake構建已有項目
- 15.1 如何開始遷移項目
- 15.2 生成文件并編寫平臺檢查
- 15.3 檢測所需的鏈接和依賴關系
- 15.4 復制編譯標志
- 15.5 移植測試
- 15.6 移植安裝目標
- 15.7 進一步遷移的措施
- 15.8 項目轉換為CMake的常見問題
- 第16章 可能感興趣的書
- 16.1 留下評論——讓其他讀者知道你的想法