cmake write_basic_package_version_file指令详解

最新推荐文章于 2026-06-25 07:28:05 发布

原创最新推荐文章于 2026-06-25 07:28:05 发布 · 695 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

在 CMake 中，write_basic_package_version_file 命令用于生成一个基本的包版本文件，这个文件通常被用来描述软件包的版本信息，以便在 find_package 命令中进行版本匹配。

使用方法

write_basic_package_version_file(
    <output_file>
    VERSION <version>
    COMPATIBILITY SameMajorVersion
    [ARCH_INDEPENDENT]
)

参数解释

<output_file>：生成的包版本文件的输出路径。
< version >：指定软件包的版本号。
COMPATIBILITY：指定包的兼容性级别，通常使用 SameMajorVersion 表示与主版本号兼容。
ARCH_INDEPENDENT：可选参数，表示生成的包版本文件与硬件体系结构无关（适用于跨平台软件包）。

示例
假设我们有一个名为 MyLib 的库，版本号为 1.2.3，我们希望生成一个包版本文件 MyLibConfigVersion.cmake：

include(CMakePackageConfigHelpers)

set(PACKAGE_VERSION 1.2.3)
set(INSTALL_CMAKE_DIR "cmake" CACHE PATH "Installation directory for CMake files")

write_basic_package_version_file(
    "${CMAKE_CURRENT_BINARY_DIR}/MyLibConfigVersion.cmake"
    VERSION ${PACKAGE_VERSION}
    COMPATIBILITY SameMajorVersion
)

在这个示例中，write_basic_package_version_file 命令生成了一个名为 MyLibConfigVersion.cmake 的文件，内容如下：

# Configuration file for MyLib package
set(MyLib_VERSION 1.2.3)

include(CMakeFindDependencyMacro)

if(NOT MyLib_FIND_VERSION)
  set(MyLib_FIND_VERSION "${MyLib_VERSION}")
endif()

if("${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION}" LESS "3.0")
  include(CMakeFindBinUtils)
else()
  include(CMakeFindPackageMode)
endif()

include("${CMAKE_CURRENT_LIST_DIR}/MyLibTargets.cmake")