CMAKE_PROJECT_HOMEPAGE_URL

於 3.12 版本新增。

頂層專案的首頁 URL。

此變數保存專案的首頁 URL,該 URL 是由頂層 CMakeLists.txt 檔案中的 project() 命令所指定。如果頂層 CMakeLists.txt 包含多個 project() 呼叫,則最近一次從該頂層 CMakeLists.txt 呼叫的 project() 將決定 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 變數。