cmake write_basic_package_version

cmake write_basic_package_version_file指令详解

在 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")