如何通过CMake正确向Xcode项目添加动态库至Frameworks目录？

错误根源分析 #

• 误用-framework链接选项：你要链接的libRadeonImageFilters.1.7.1.dylib和libOpenImageIO.1.6.dylib是普通动态库，并非Xcode标准的.framework包结构，用-framework会让链接器错误地将其识别为Framework，导致链接失败。
• 检查条件错误：第二个库的存在性判断误用了LIB_RADEON_IMAGE_FILTERS变量，而非对应的LIB_OPEN_IMAGE，可能导致OpenImageIO未找到时无法触发错误提示。
• 缺失库复制逻辑：CMake默认不会自动将依赖动态库复制到Xcode项目的Frameworks文件夹，需手动配置构建后复制规则。

修复后的CMake脚本 #

set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)

# 查找RadeonImageFilters动态库，用REQUIRED简化存在性检查
find_library(LIB_RADEON_IMAGE_FILTERS 
    NAMES libRadeonImageFilters.1.7.1.dylib 
    PATHS "../RadeonProImageProcessingSDK/OSX/Dynamic"
    REQUIRED
)

# 查找OpenImageIO动态库，修正变量对应关系
find_library(LIB_OPEN_IMAGE 
    NAMES libOpenImageIO.1.6.dylib 
    PATHS "../RadeonProRenderSharedComponents/OpenImageIO/OSX/bin"
    REQUIRED
)

# 直接链接动态库，移除错误的-framework参数
target_link_libraries(${PROJECT_NAME} 
    ${LIB_RADEON_IMAGE_FILTERS}
    ${LIB_OPEN_IMAGE}
)

# 针对Xcode配置：将动态库复制到Bundle的Frameworks目录
if(XCODE)
    # 设置运行时库搜索路径，确保程序能找到Frameworks里的库
    set_target_properties(${PROJECT_NAME} PROPERTIES
        MACOSX_BUNDLE TRUE
        INSTALL_RPATH "@executable_path/../Frameworks"
    )

    # 构建完成后复制RadeonImageFilters到Frameworks
    add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
        COMMAND ${CMAKE_COMMAND} -E copy_if_different
        ${LIB_RADEON_IMAGE_FILTERS}
        $<TARGET_FILE_DIR:${PROJECT_NAME}>/../Frameworks/
    )

    # 构建完成后复制OpenImageIO到Frameworks
    add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
        COMMAND ${CMAKE_COMMAND} -E copy_if_different
        ${LIB_OPEN_IMAGE}
        $<TARGET_FILE_DIR:${PROJECT_NAME}>/../Frameworks/
    )
endif()

关键修复点说明 #

1. 移除-framework参数：直接传递找到的库路径给target_link_libraries，让链接器正确识别为普通动态库。
2. 简化存在性检查：使用find_library的REQUIRED参数，替代手动if判断，库未找到时CMake会自动终止并提示错误。
3. 添加构建后复制逻辑：通过add_custom_command在项目构建完成后，将依赖库复制到Xcode项目对应的Frameworks目录，解决文件夹为空的问题。
4. 配置运行时路径：设置INSTALL_RPATH确保程序运行时能正确加载Frameworks目录下的动态库。

验证步骤 #

1. 删除原有CMake缓存和构建目录，重新运行CMake生成Xcode项目。
2. 打开生成的Xcode项目，检查Frameworks文件夹是否已包含目标动态库。
3. 构建项目，链接错误应消失，运行时程序可正常加载依赖库。

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