CMAKE_PROJECT_HOMEPAGE_URL¶
在版本 3.12 中新增。
頂層專案的首頁 URL。
此變數保存了頂層專案的首頁 URL,該 URL 是在頂層 CMakeLists.txt 檔案中透過 project()
命令指定的。如果頂層 CMakeLists.txt 包含多個 project()
呼叫,則來自該頂層 CMakeLists.txt 中最近一次呼叫的命令將決定 CMAKE_PROJECT_HOMEPAGE_URL
包含的值。例如,考慮以下頂層 CMakeLists.txt
cmake_minimum_required(VERSION 3.0)
project(First HOMEPAGE_URL "https://first.example.com")
project(Second HOMEPAGE_URL "https://second.example.com")
add_subdirectory(sub)
project(Third HOMEPAGE_URL "https://third.example.com")
以及包含以下內容的 sub/CMakeLists.txt
project(SubProj HOMEPAGE_URL "https://subproj.example.com")
message("CMAKE_PROJECT_HOMEPAGE_URL = ${CMAKE_PROJECT_HOMEPAGE_URL}")
來自頂層 CMakeLists.txt 中最近看到的 project()
命令將是 project(Second ...)
,因此這將印出
CMAKE_PROJECT_HOMEPAGE_URL = https://second.example.com
若要從目前目錄範圍或以上範圍中最近一次呼叫 project()
取得首頁 URL,請參閱 PROJECT_HOMEPAGE_URL
變數。