CMAKE_PROJECT_DESCRIPTION

在 3.9 版本中新增。

頂層專案的描述。

此變數保存專案的描述,該描述由頂層 CMakeLists.txt 檔案中的 project() 命令指定。如果頂層 CMakeLists.txt 包含多個 project() 呼叫,則來自該頂層 CMakeLists.txt 中最近一次呼叫的命令將決定 CMAKE_PROJECT_DESCRIPTION 包含的值。例如,考慮以下頂層 CMakeLists.txt:

cmake_minimum_required(VERSION 3.0)
project(First DESCRIPTION "I am First")
project(Second DESCRIPTION "I am Second")
add_subdirectory(sub)
project(Third DESCRIPTION "I am Third")

以及具有以下內容的 sub/CMakeLists.txt

project(SubProj DESCRIPTION "I am SubProj")
message("CMAKE_PROJECT_DESCRIPTION = ${CMAKE_PROJECT_DESCRIPTION}")

來自頂層 CMakeLists.txt 中最近一次看到的 project() 命令將是 project(Second ...),因此它會列印:

CMAKE_PROJECT_DESCRIPTION = I am Second

若要從目前目錄範圍或以上的最近一次 project() 呼叫取得描述,請參閱 PROJECT_DESCRIPTION 變數。