使用CMake生成Xcode项目，归档iOS应用缺失dylib及资源

这个问题我之前帮好几个开发者排查过，核心原因是Xcode的归档（Archive）流程和常规构建的触发逻辑不一样——CMake默认的install指令不会在归档阶段自动执行，而且iOS应用的Bundle结构有特定要求，光靠install复制文件还不够。下面是具体的解决步骤：

1. 给C++动态库配置iOS兼容属性 #

首先，针对你的每个C++动态库目标，必须设置iOS环境下的关键属性，确保它能被正确嵌入到App Bundle中：

# 假设你的动态库目标是my_cpp_lib
add_library(my_cpp_lib SHARED src/lib.cpp)

# 配置iOS动态库的核心属性
set_target_properties(my_cpp_lib PROPERTIES
    INSTALL_NAME_DIR "@rpath"          # 让动态库使用@rpath作为安装路径，符合iOS规范
    BUILD_WITH_INSTALL_RPATH ON        # 构建时就启用RPATH
    XCODE_ATTRIBUTE_SDKROOT iphoneos   # 指定iOS SDK
    XCODE_ATTRIBUTE_SUPPORTED_PLATFORMS "iphoneos iphonesimulator"  # 支持真机和模拟器
)

接着，在你的应用目标中关联动态库，并设置应用的运行路径指向Bundle内的Frameworks目录：

add_executable(MyiOSApp MACOSX_BUNDLE src/app.mm)

# 关联动态库
target_link_libraries(MyiOSApp PRIVATE my_cpp_lib)

# 配置应用Bundle的关键属性
set_target_properties(MyiOSApp PROPERTIES
    INSTALL_RPATH "@executable_path/Frameworks"  # 运行时从Frameworks目录找动态库
    BUILD_WITH_INSTALL_RPATH ON
    MACOSX_BUNDLE_GUI_IDENTIFIER "com.yourcompany.MyiOSApp"  # 必须设置的Bundle ID
    MACOSX_BUNDLE_BUNDLE_VERSION "1.0"
    MACOSX_BUNDLE_SHORT_VERSION_STRING "1.0"
)

2. 让归档阶段自动触发CMake的install逻辑 #

常规构建时install能复制文件，但归档阶段Xcode默认不会执行这个目标。你可以通过自定义目标，把install关联到归档流程中：

# 先定义你的install规则：把动态库放到App的Frameworks目录，资源放到Resources目录
install(TARGETS my_cpp_lib
    LIBRARY DESTINATION "${CMAKE_INSTALL_PREFIX}/MyiOSApp.app/Frameworks"
)

install(FILES resources/asset.png
    DESTINATION "${CMAKE_INSTALL_PREFIX}/MyiOSApp.app/Resources"
)

# 关键：创建自定义目标，让归档时自动执行install
if(XCODE)
    add_custom_target(ArchiveInstall
        COMMAND "${CMAKE_COMMAND}" --build "${CMAKE_BINARY_DIR}" --target install
        DEPENDS install
        COMMENT "Running install for archive..."
    )
    # 让应用目标的归档流程依赖这个自定义目标
    add_dependencies(MyiOSApp ArchiveInstall)
endif()

或者更直接：让Xcode自动嵌入动态库和资源，跳过install的依赖：

# 让Xcode自动把动态库嵌入到App Bundle的Frameworks目录
set_target_properties(MyiOSApp PROPERTIES
    XCODE_EMBED_FRAMEWORKS "my_cpp_lib"
    XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY YES  # 嵌入后自动签名
)

# 直接把资源文件添加到应用Bundle的Resources目录
target_sources(MyiOSApp PRIVATE resources/asset.png)
set_source_files_properties(resources/asset.png PROPERTIES
    MACOSX_PACKAGE_LOCATION Resources
)

3. 验证配置的正确性 #

重新生成Xcode项目：

cmake -G Xcode -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_SYSROOT=iphoneos -DCMAKE_INSTALL_PREFIX=../install ..

然后归档验证：

1. 打开Xcode，选择Product > Archive
2. 归档完成后，右键归档文件 > Show in Finder
3. 右键.xcarchive文件 > Show Package Contents，检查Products/Applications/MyiOSApp.app/Frameworks和Resources目录下是否有对应的文件

常见坑点提醒 #

• 架构兼容性：确保动态库编译了iOS所需的架构（arm64真机、x86_64模拟器），可以用以下指令指定：

  set(CMAKE_OSX_ARCHITECTURES "arm64;x86_64" CACHE STRING "iOS architectures" FORCE)
  

• 代码签名：iOS应用和动态库都需要正确签名，要么在CMake中设置CODE_SIGN_IDENTITY属性，要么在Xcode手动配置签名信息。
• 路径问题：归档时Xcode会使用临时目录，CMAKE_INSTALL_PREFIX建议设置为相对路径，避免找不到目标文件。

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