添加共享库项目后Xcode导出归档失败的技术问询

你遇到的导出失败，本质是归档结构不符合Developer ID分发的要求：

• Xcode在处理Developer ID导出时，要求归档的Products目录下只能包含要分发的主应用包（Applications/MyApp.app），而你的归档里额外多了@rpath目录存放独立的共享库。
• 这些游离的共享库会让Xcode判定当前归档不是一个标准的应用归档，进而触发IDEDistributionMethodManagerErrorDomain Code=2错误，表面上提示method不匹配，实际是归档结构非法。

出现这个问题的根源是CMake配置的共享库target没有被正确关联到主应用的嵌入流程：默认的add_library(SHARED)会让Xcode把共享库作为独立产物归档到@rpath目录，而不是仅嵌入到App的Frameworks目录中。

1. 修改CMake配置，让共享库仅嵌入主应用 #

针对每个新增的共享库target，添加以下配置，确保库被正确关联到主应用，且不会生成独立的归档产物：

project(MyNewlyAddedProject VERSION ${CMAKE_PROJECT_VERSION} LANGUAGES CXX)

# General settings
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_INCLUDE_CURRENT_DIR ON)

if(APPLE)
    enable_language(OBJCXX)
    # 配置共享库的路径和嵌入属性
    set_target_properties(MyNewlyAddedProject PROPERTIES
        # 设置运行时搜索路径，匹配App内Frameworks位置
        INSTALL_RPATH "@executable_path/../Frameworks"
        BUILD_WITH_INSTALL_RPATH ON
        # 开启代码签名（与主应用一致）
        XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "${CODE_SIGN_IDENTITY}"
        XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY YES
        # 强制生成dSYM（可选，完善符号表）
        XCODE_ATTRIBUTE_DEBUG_INFORMATION_FORMAT "dwarf-with-dsym"
    )
    # 将共享库关联到主应用target（替换成你的主应用target名称）
    target_link_libraries(MyApp PRIVATE MyNewlyAddedProject)
    # 告诉Xcode把这个库嵌入到主应用的Frameworks目录
    set_target_properties(MyApp PROPERTIES
        XCODE_EMBED_FRAMEWORKS "${XCODE_EMBED_FRAMEWORKS};$<TARGET_FILE:MyNewlyAddedProject>"
    )
endif()

set(SOURCES 
    src/PluginMain.cpp              src/PluginMain.h
)
source_group(TREE ${CMAKE_CURRENT_SOURCE_DIR} PREFIX "Plugins" FILES ${SOURCES})

add_library(MyNewlyAddedProject SHARED ${SOURCES})

2. 清理并重新归档 #

• 删除之前的旧归档文件
• 重新执行归档命令：

  xcodebuild -project MyProject.xcodeproj -scheme ProjectName -configuration Release -archivePath <archive_path> archive
  

  此时检查归档结构，Products目录下应该只有Applications/MyApp.app，不再有@rpath目录。

3. 重新执行导出命令 #

使用原有的exportOptionsPlist重新执行导出，此时Xcode能识别这是标准的应用归档，即可正常完成Developer ID导出。

• 用otool -L MyApp.app/Contents/MacOS/MyApp再次检查主可执行文件的依赖路径，确保@rpath/libMyNewlyAddedProject.dylib存在且路径正确。
• 确认主应用的Frameworks目录下包含所有新增的共享库，且没有重复的独立产物。

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