Pod安装生成聚合目标而非Framework目标的问题排查

问题现象 #

• 为包含vendored xcframework的项目添加podspec后，执行pod install，该Pod被识别为aggregate target而非标准Framework target
• 代码中添加import Lightstreamer_iOS_Client时，提示“No such module”

问题排查与修复 #

1. Podspec核心问题修正 #

你的Podspec存在几处可能导致识别异常的问题，修正后的版本如下：

Pod::Spec.new do |spec|
  spec.name         = "Lightstreamer_iOS_Client"
  spec.version      = "4.3.2"
  spec.summary      = "Lightstreamer Client for iOS."
  spec.description  = <<-DESC
  Lightstreamer iOS客户端功能包括：
  * 连接Lightstreamer Server 7.0及以上版本
  * 订阅数据项并接收实时更新，有效控制带宽
  * 通过移动推送通知（MPN）接收更新
  * 向元数据适配器发送实时消息
  * 网络异常时自动重连和恢复订阅
                  DESC

  spec.homepage     = "http://www.lightstreamer.com"
  spec.documentation_url  = "https://lightstreamer.com/api/ls-ios-client/4.3.2/"
  spec.license      = {
    :type => "Lightstreamer Software License Agreement",
    :file => "Lightstreamer Software License Agreement.txt"
  }
  spec.author             = { "Lightstreamer" => "support@lightstreamer.com" }
  spec.social_media_url   = "https://twitter.com/lightstreamer"
  spec.platform     = :ios
  spec.ios.deployment_target = '9.0'
  # 匹配Podfile中使用的Git源，确保路径一致性
  spec.source = { :git => "https://github.com/developerOnjoyride/Lightstreamer_iOS_Client", :branch => "CocoapodsSupport" }
  # 精准指定xcframework内的头文件，避免通配符干扰识别
  spec.source_files = 'Lightstreamer_iOS_Client.xcframework/ios-arm64/*.h', 'Lightstreamer_iOS_Client.xcframework/ios-arm64_x86_64-simulator/*.h'
  # 使用复数形式vendored_frameworks，符合CocoaPods规范
  spec.vendored_frameworks = 'Lightstreamer_iOS_Client.xcframework'
  spec.frameworks = "Security", "SystemConfiguration"
  spec.libraries = "iconv"
  spec.requires_arc = true
end

关键修改说明：

• 移除冲突的http源，统一使用Git源匹配Podfile配置
• 将vendored_framework改为复数形式vendored_frameworks，避免CocoaPods识别异常
• 缩小source_files范围，仅匹配xcframework内的头文件，删除宽泛的通配符和不必要的preserve_paths

2. Podfile优化调整 #

# 统一平台版本，与podspec保持一致
platform :ios, '9.0'

# 暂时注释自定义spec源，优先测试Git源的有效性
# source 'https://github.com/developerOnjoyride/specsrepo.git'
source 'https://github.com/CocoaPods/Specs.git'

target 'testLSPod' do
  use_frameworks!
  pod 'Lightstreamer_iOS_Client', :git => 'https://github.com/developerOnjoyride/Lightstreamer_iOS_Client', :branch => 'CocoapodsSupport'
end

关键修改说明：

• 明确指定iOS版本，与podspec的部署目标对齐
• 暂时关闭自定义spec源，避免依赖解析冲突

3. 清理并重新安装 #

执行以下命令彻底清理后重新安装：

pod deintegrate
rm -rf Podfile.lock
pod install

额外检查点 #

• 确认Git仓库CocoapodsSupport分支中，Lightstreamer_iOS_Client.xcframework处于根目录，与podspec中的路径一致
• 打开Xcode后，检查Pods项目内的Lightstreamer_iOS_Client target类型应为Framework而非Aggregate
• 验证测试项目的Build Settings中，Framework Search Paths包含Pods/Lightstreamer_iOS_Client路径

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