CMAKE_PROJECT_HOMEPAGE_URL

在 3.12 版本中添加。

顶层项目的主页 URL。

此变量保存顶层项目中通过 project() 命令在 CMakeLists.txt 文件中指定的项目主页 URL。如果顶层 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 变量。