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 变量。