原文地址：https://cslam.cn/archives/c9f565b5.html
本文記錄一下 CMake 變量的定義、原理及其使用。CMake 變量包含 Normal Variables、Cache Variables。通過 set 指令可以設置兩種不同的變量。也可以在 CMake 腳本中使用和設置環(huán)境變量。set(ENV{<variable>} <value>...)，本文重點講述 CMake 腳本語言特有的兩種變量。
Normal Variables
通過 set(<variable> <value>... [PARENT_SCOPE])這個命令來設置的變量就是 Normal Variables。例如 set(MY_VAL “666”) ，此時 MY_VAL 變量的值就是 666。
Cache Variables
通過 set(<variable> <value>... CACHE <type> <docstring> [FORCE])這個命令來設置的變量就是 Cache Variables。例如 set(MY_CACHE_VAL "666" CACHE STRING INTERNAL)，此時 MY_CACHE_VAL 就是一個 CACHE 變量。
? 作用域屬于整個 CMakeLists.txt 文件，當該文件包含了 add_subdirectory()、include()、macro()、function()語句時，會出現(xiàn)兩種不同的效果。
假設，我們在工程根目錄 CMakeLists.txt 文件中使用 add_subdirectory(src) 包含另一個 src 目錄，在 src 目錄中有另一個 CMakeLists.txt 文件。在終端運行的目錄結構如下：
$ tree.├── CMakeLists.txt└── src └── CMakeLists.txt1 directory, 2 files
以根目錄 CMake 文件為父目錄，src 目錄為子目錄，此時子目錄 CMake 文件會拷貝一份父目錄文件的 Normal 變量。需要說明的是，我們在子目錄中如果想要修改父目錄 CMake 文件包含的 Normal 變量。必須通過 set(… PARENT_SCOPE) 的方式。下面通過例子來說明。
在父 / 根目錄的 CMakeLists.txt 文件內容如下:
cmake_minimum_required(VERSION 3.10)message("父目錄 CMakeLists.txt 文件")set(MY_VAL "666")message("第一次在父目錄 MY_VAL=${MY_VAL}")add_subdirectory(src) message("第二次在父目錄，MY_VAL=${MY_VAL}")
在子目錄 src/CMakeLists.txt 文件內容如下：
cmake_minimum_required(VERSION 3.10)message("進入子目錄 src/CMakeLists.txt 文件")message("在子目錄，MY_VAL=${MY_VAL}")message("退出子目錄")
運行結果：
$ cmake .父目錄 CMakeLists.txt 文件第一次在父目錄 MY_VAL=666進入子目錄 src/CMakeLists.txt 文件在子目錄，MY_VAL=666退出子目錄第二次在父目錄，MY_VAL=666
從結果可以看出，在子目錄 CMake 文件中可以直接使用父目錄定義的 MY_VAL 變量的值 666。當在子目錄 CMake 文件中修改 MY_VAL 變量值，看看在父目錄中 MY_VAL 的值如何變化。下面僅僅在子目錄 CMake 文件中加入一行代碼 set(MY_VAL "777"), 最后的子目錄 CMake 文件代碼如下：
cmake_minimum_required(VERSION 3.10)message("進入子目錄 src/CMakeLists.txt 文件")set(MY_VAL "777") # 剛剛加入的message("在子目錄，MY_VAL=${MY_VAL}")message("退出子目錄")
運行結果：
$ cmake .父目錄 CMakeLists.txt 文件第一次在父目錄 MY_VAL=666進入子目錄 src/CMakeLists.txt 文件在子目錄，MY_VAL=777退出子目錄第二次在父目錄，MY_VAL=666
我們發(fā)現(xiàn)在 src/CMakeLists.txt 中打印的 MY_VAL 的值是 777，然后退出子目錄回到根目錄后，打印 MY_VAL 的值仍然是 666。這就說明了：子目錄的 CMakeLists.txt 文件僅僅是拷貝了一份父目錄的 Normal 變量，即使在子目錄 CMake 文件中修改了 MY_VAL 變量，那也只是子目錄自己的變量，不是父目錄的變量。因為 Normal 變量的作用域就是以 CMakeLists.txt 文件為基本單元。那么我們如何在子目錄 CMake 文件中修改父目錄 CMake 文件的 Normal 變量呢? 我們需要在子目錄 CMakeLists.txt 文件中設置 MY_VAL 時，加上 PARENT_SCOPE 屬性。即用如下代碼: set(MY_VAL "777" PARENT_SCOPE)，子目錄 CMakeLists.txt 文件如下：
cmake_minimum_required(VERSION 3.10)message("進入子目錄 src/CMakeLists.txt 文件")set(MY_VAL "777" PARENT_SCOPE) # 修改處message("在子目錄，MY_VAL=${MY_VAL}")message("退出子目錄")
運行結果:
$ cmake .父目錄 CMakeLists.txt 文件第一次在父目錄 MY_VAL=666進入子目錄 src/CMakeLists.txt 文件在子目錄，MY_VAL=666退出子目錄第二次在父目錄，MY_VAL=777
可以看出在第二次回到父目錄時，MY_VAL 的值已經(jīng)變成了 777。同理，對于 function() 最開始的結論也適用。代碼如下：
cmake_minimum_required(VERSION 3.10)message("父目錄 CMakeLists.txt 文件")set(MY_VAL "666")
message("第一次在父目錄 MY_VAL=${MY_VAL}")# 函數(shù)定義function(xyz test_VAL) # 函數(shù)定義處！ set(MY_VAL "888" PARENT_SCOPE) message("functions is MY_VAL=${MY_VAL}")endfunction(xyz)xyz(${MY_VAL}) # 調用函數(shù)message("第二次在父目錄，MY_VAL=${MY_VAL}")
運行結果:
父目錄 CMakeLists.txt 文件第一次在父目錄 MY_VAL=666functions is MY_VAL=666第二次在父目錄，MY_VAL=888
可以看出在該函數(shù)中使用 MY_VAL 這個變量值，其實就是一份父目錄變量的值拷貝，此時打印值為 666。在 函數(shù)中修改值，那么也是用 set(${MY_VAL} 888 PARENT_SCOPE)。此時，退出函數(shù)第二次打印變量值時。該值就是在函數(shù)中修改好的值 888。 本質講，對于 function() 而言，剛剛說到的父目錄其實不是嚴格正確的。因為函數(shù)定義可以是在其他 .cmake 模塊文件中定義的。也可以在其他 CMakeLists.txt 文件中調用，因此準確的說，這里的父目錄應該改為『調用函數(shù)的地方所屬的 CMakeLists.txt 』，我們做的這個實驗是在根目錄 CMakeLists.txt 文件中定義了函數(shù)，又在本文件中使用了。因此之前的說法理解其意思即可。對于 add_subdirectory() 而言，其實也是說調用的地方。下面的 include()、macro() 例子會涉及到，將 function() 放在一個外部的 .cmake 文件中。那里也會說明 function() 與 macro() 的不同。
現(xiàn)在在上面的根目錄中加入了一個 cmake_modules 目錄。目錄中有一個 Findtest.cmake 文件。新的目錄結構如下:
$ tree.├── CMakeLists.txt├── cmake_modules│ └── Findtest.cmake└── src └── CMakeLists.txt
2 directories, 3 files在根目錄中的 CMakeLists.txt 文件包含的代碼如下:
cmake_minimum_required(VERSION 3.10)message("父目錄 CMakeLists.txt 文件")set(MY_VAL "666")message("第一次在父目錄 MY_VAL=${MY_VAL}")# 使用 include() 文件的宏list(APPEND CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake_modules) include(Findtest) # 從 CMAKE_MODULE_PATH 包含的路徑中搜索 Findtest.cmake 文件#test(${MY_VAL}) # 調用宏#xyz(${MY_VAL}) # 調用函數(shù)#find_package(test REQUIRED) # 從 CMAKE_MODULE_PATH 包含的路徑中搜索 Findtest.cmake 文件 與 include () 兩者的效果是一樣的！message("第二次在父目錄，MY_VAL=${MY_VAL}")message("include test=${test_VAL}") #message("macro_val=${macro_val}")
cmake_modules/Findtest.cmake 文件內容如下:
# 該文件定義了一個函數(shù)以及一個宏message("進入 Findtest.cmake 文件")set(test_VAL "222") # 驗證根目錄 CMake 文件能夠訪問這個變量set(MY_VAL "000") # 測試 include() 效果# 宏定義macro(test MY_VA) # 定義一個宏！ set(macro_val "1") # 宏內部定義變量 message("macro is MY_VAL=${MY_VA}") set(MY_VAL "999") # 直接修改的就是調用該宏所處的文件中的 Normal 變量endmacro(test)# 函數(shù)定義function(xyz test_VAL) set(MY_VAL "888" PARENT_SCOPE) # 修改 調用者的 變量 message("function is MY_VAL=${MY_VAL}")endfunction(xyz)
運行結果：
$ cmake .父目錄 CMakeLists.txt 文件第一次在父目錄 MY_VAL=666進入 Findtest.cmake 文件第二次在父目錄，MY_VAL=000include test=222
從結果可以看出，include() 內部是可以修改調用者 MY_VAL 變量。include() 包含的文件內定義的變量 test_VAL，也可以在調用 include() 的 CMakeLists.txt 文件中直接訪問，同樣的對于 macro() 也適用，在根目錄 CMake 文件中調用宏，即取消 test(${MY_VAL}) 以及 message(“macro_val=${macro_val}”) 部分的注釋，此時最后輸出結果 ：
$ cmake .父目錄 CMakeLists.txt 文件第一次在父目錄 MY_VAL=666進入 Findtest.cmake 文件macro is MY_VAL=000第二次在父目錄，MY_VAL=999include test=222macro_val=1
可以看出，這次輸出的結果在第二次進入父目錄后，MY_VAL 變量的值就是 999 了。注意到在根目錄中 CMakeLists.txt 中 注釋語句中有一個 find_package() ，這個和 include() 其實都是一樣的結果。
結合 include() 、macro() 最后結果，能夠得出一個結論：通過 include() 和 macro() 相當于把這兩部分包含的代碼直接加入根目錄 CMakeLists.txt 文件中去執(zhí)行，相當于他們是一個整體。因此變量直接都是互通的。這就有點像 C/C++ 中的 #include 包含頭文件的預處理過程了。這一點其實與剛開始講的 function() 、add_subdirectory() 完全不同，在函數(shù)以及 add_subdirectory() 中，他們本身就是一個不同的作用域范圍，僅僅通過拷貝調用者的 Normal 值 (僅僅在調用 add_subdirectory() / function() 之前的 Normal 變量)，如果要修改調用者包含的 Normal 變量，那么只能通過 set(MY_VAL "某個值" PARENT_SCOPE)注明我們修改的是調用者 Normal 值。雖然在 C/C++ 中，可以通過指針的方式，通過函數(shù)可以修改外部變量值，但是在 CMake 腳本語言中 function() 雖然能夠傳入形式參數(shù)，但是者本質上就是 C/C++ 中的值拷貝。而不是引用。上面所說的 Normal 變量其實就是一個局部變量。
相當于一個全局變量，我們在同一個 cmake 工程中都可以使用。Cache 變量有以下幾點說明:
下面通過一個例子來說明以上三點:
首先看一下目錄樹結構:
$ tree.├── CMakeLists.txt└── src └── CMakeLists.txt1 directory, 2 files
根目錄 CMakeLists.txt 文件內容如下:
cmake_minimum_required(VERSION 3.10)set(MY_GLOBAL_VAR "666" CACHE STRING INTERNAL )message("第一次在父目錄 CMAKE_INSTALL_PREFIX=${CMAKE_INSTALL_PREFIX}")message("第一次在父目錄 MY_GLOBAL_VAR=${MY_GLOBAL_VAR}")add_subdirectory(src)message("第二次在父目錄 CMAKE_INSTALL_PREFIX=${CMAKE_INSTALL_PREFIX}")message("第二次在父目錄 MY_GLOBAL_VAR=${MY_GLOBAL_VAR}")set(CMAKE_INSTALL_PREFIX "-->usr" )message("第三次在父目錄 CMAKE_INSTALL_PREFIX=${CMAKE_INSTALL_PREFIX}")
src/CMakeLists.txt 文件內容如下:
cmake_minimum_required(VERSION 3.10)message("子目錄,CMAKE_INSTALL_PREFIX=${CMAKE_INSTALL_PREFIX}")message("子目錄,MY_GLOBAL_VAR=${MY_GLOBAL_VAR}")set(CMAKE_INSTALL_PREFIX "/usr" CACHE STRING INTERNAL FORCE)set(MY_GLOBAL_VAR "777" CACHE STRING INTERNAL FORCE )
運行結果:
$ cmake .第一次在父目錄 CMAKE_INSTALL_PREFIX=/usr/local第一次在父目錄 MY_GLOBAL_VAR=666子目錄,CMAKE_INSTALL_PREFIX=/usr/local子目錄,MY_GLOBAL_VAR=666第二次在父目錄 CMAKE_INSTALL_PREFIX=/usr第二次在父目錄 MY_GLOBAL_VAR=777第三次在父目錄 CMAKE_INSTALL_PREFIX=-->usr
程序說明：首先在根目錄中打印一下當前的 Cache 變量 CMAKE_INSTALL_PREFIX 值，主要看看默認值是什么，然后在子目錄 src/CMakeLists.txt 中再次打印和修改該 Cache 值，目的是熟悉修改全局 Cache 變量，當返回根目錄 CMakeLists.txt 文件中再次執(zhí)行第二次打印該 Cache 值時，主要看一看在子目錄中修改后的效果。接著在根目錄中設定一個 CMAKE_INSTALL_PREFIX 的 Normal 同名變量，此時第三次打印 CMAKE_INSTALL_PREFIX 的值，此時是為了證明，當有與 Cache 同名的 Normal 變量出現(xiàn)時，CMake 會優(yōu)先使用 Normal 屬性的值。通過設定 MY_GLOBAL_VAR 主要是為了說明可以自己設定全局 Cache 變量。最后的結果如上面顯示，當我們再次執(zhí)行 cmake . 的時候，程序結果如下:
$ cmake .第一次在父目錄 CMAKE_INSTALL_PREFIX=/usr第一次在父目錄 MY_GLOBAL_VAR=777子目錄,CMAKE_INSTALL_PREFIX=/usr子目錄,MY_GLOBAL_VAR=777第二次在父目錄 CMAKE_INSTALL_PREFIX=/usr第二次在父目錄 MY_GLOBAL_VAR=777第三次在父目錄 CMAKE_INSTALL_PREFIX=-->usr
可以發(fā)現(xiàn)第一次在父目錄打印 CMAKE_INSTALL_PREFIX 和 MY_GOLBAL_VAR 時，他們的結果是上次cmake .后生成的值，存儲在 CMakeCache.txt 中，自己可以找到，解決方案就是可以把 CMakeCache.txt 文件刪除，然后在 cmake .我們以后在實際使用時要注意這個坑。對于修改 Cache 變量的另一種方式就是cmake -D CMAKE_INSTALL_PREFIX=/usr?？梢宰约候炞C。這里說一個重要的點，就是在終端中輸入的 cmake -D var=value . 如果 CMake 中默認有這個 var Cache 變量，那么此時就是賦值，沒有的話，CMake 就會默認創(chuàng)建了一個全局 Cache 變量然后賦值。(tips: $CACHE{VAR}表示獲取 CACHE 緩存變量的值)。例子如下:(目錄結構同上)
根目錄 CMakeLists.txt :
cmake_minimum_required(VERSION 3.10)set(MY_GLOBAL_VAR "666")message("第一次在父目錄 MY_GLOBAL_VAR=$CACHE{MY_GLOBAL_VAR}")add_subdirectory(src)message("第二次在父目錄局部 MY_GLOBAL_VAR=${MY_GLOBAL_VAR}")message("第二次在父目錄全局 MY_GLOBAL_VAR=$CACHE{MY_GLOBAL_VAR}")
src/CMakeLists.txt :
cmake_minimum_required(VERSION 3.10)message("子目錄,MY_GLOBAL_VAR=${MY_GLOBAL_VAR}")set(MY_GLOBAL_VAR "777" CACHE STRING INTERNAL FORCE )
運行結果：
第一次在父目錄 MY_GLOBAL_VAR=8子目錄,MY_GLOBAL_VAR=666第二次在父目錄局部 MY_GLOBAL_VAR=666第二次在父目錄全局 MY_GLOBAL_VAR=777
有了上面的基礎，相信這個例子很快能看明白。
