VERSION¶
共享库目标的版本号。
对于共享库,VERSION 和 SOVERSION 可分别用于指定构建版本和 ABI 版本。当构建或安装时,如果平台支持符号链接且链接器支持 so-names,则会创建适当的符号链接。如果只指定了其中一个,则缺失的会被假定为具有相同的版本号。对于可执行文件,VERSION 可用于指定构建版本。当构建或安装时,如果平台支持符号链接,则会创建适当的符号链接。
一个常见的约定是同时指定 VERSION 和 SOVERSION,使得 SOVERSION 与 VERSION 的第一个组件匹配。
set_target_properties(mylib PROPERTIES VERSION 1.2.3 SOVERSION 1)
其思想是,对 ABI 的重大更改会同时增加 SOVERSION 和主 VERSION 号。
Windows 版本¶
对于 Windows 上的共享库和可执行文件,VERSION 属性会被解析以提取 <major>.<minor> 版本号。这些数字被用作二进制文件的图像版本。
Mach-O 版本¶
对于 Mach-O 系统(例如 macOS、iOS)上的共享库和可执行文件,SOVERSION 属性对应于兼容性版本,VERSION 对应于当前版本(除非提供了 Mach-O 特定的覆盖,如下所述)。有关示例,请参阅 FRAMEWORK 目标属性。
对于共享库,MACHO_COMPATIBILITY_VERSION 和 MACHO_CURRENT_VERSION 属性可分别用于覆盖兼容性版本和当前版本。请注意,SOVERSION 仍将用于形成 install_name,并且 SOVERSION 和 VERSION 也可能影响文件和符号链接名称。
Mach-O 二进制文件的版本可以通过 otool -L <binary> 命令进行检查。