CMAKE_PROJECT_HOMEPAGE_URL¶
3.12 版本新增。
顶层项目的首页 URL。
此变量保存顶层 CMakeLists.txt 文件中由 project()
命令指定的项目首页 URL。如果顶层 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
变量。