如何在CMake中确定目标macOS SDK版本？

核心思路 #

要匹配源码中__MAC_OS_X_VERSION_MIN_REQUIRED的实际值，关键是让CMake准确获取最终生效的部署目标版本——不能仅依赖CMAKE_OSX_DEPLOYMENT_TARGET（它可能未被用户显式设置），需结合SDK默认值综合判断。

实现步骤 #

1. 确定最终部署目标版本 #

CMake的CMAKE_OSX_SYSROOT变量指向当前使用的SDK路径，我们可以通过解析SDK自带的SDKSettings.plist文件获取默认部署目标，再结合用户显式设置的值，得到最终生效的版本：

# 从SDK配置文件中读取默认部署目标
execute_process(
    COMMAND /usr/libexec/PlistBuddy -c "Print :DefaultDeploymentTarget" "${CMAKE_OSX_SYSROOT}/SDKSettings.plist"
    OUTPUT_VARIABLE SDK_DEFAULT_DEPLOYMENT_TARGET
    OUTPUT_STRIP_TRAILING_WHITESPACE
)

# 确定最终部署目标：优先用用户设置的CMAKE_OSX_DEPLOYMENT_TARGET，否则用SDK默认值
set(FINAL_DEPLOYMENT_TARGET "${CMAKE_OSX_DEPLOYMENT_TARGET}")
if(NOT FINAL_DEPLOYMENT_TARGET)
    set(FINAL_DEPLOYMENT_TARGET "${SDK_DEFAULT_DEPLOYMENT_TARGET}")
endif()

# 将版本字符串转为可比较的数值（如10.15→1015，11→1100）
string(REGEX REPLACE "^([0-9]+)\\.([0-9]+)$" "\\1\\2" FINAL_DEPLOYMENT_TARGET_NUM "${FINAL_DEPLOYMENT_TARGET}")
string(REGEX REPLACE "^([0-9]+)$" "\\100" FINAL_DEPLOYMENT_TARGET_NUM "${FINAL_DEPLOYMENT_TARGET_NUM}")

2. 按版本条件链接库 #

UniformTypeIdentifiers库仅在macOS 11及以上可用，因此通过数值判断决定是否链接：

if(FINAL_DEPLOYMENT_TARGET_NUM GREATER_EQUAL 1100)
    target_link_libraries(你的目标库名 PRIVATE UniformTypeIdentifiers)
endif()

3. 同步源码条件编译逻辑 #

确保CMake中的版本判断和源码里的__MAC_OS_X_VERSION_MIN_REQUIRED逻辑完全一致，比如源码中：

#if __MAC_OS_X_VERSION_MIN_REQUIRED >= 1100
// 使用UniformTypeIdentifiers的新特性代码
#else
// 旧版本兼容代码
#endif

验证方式 #

可以添加日志输出确认逻辑正确性：

message(STATUS "最终部署目标: ${FINAL_DEPLOYMENT_TARGET} (数值化: ${FINAL_DEPLOYMENT_TARGET_NUM})")

这种方式无论用户是否显式设置CMAKE_OSX_DEPLOYMENT_TARGET，都能让CMake和源码的条件判断保持同步，实现仅在目标版本支持时链接新库。

内容的提问来源于stack exchange，提问作者Bernard