将UI框架作为本地Pod集成时，依赖SDK无法正确安装链接问题

我在将一个UI框架作为本地Pod集成到App项目时遇到了问题：该UI框架本身可成功构建，且已将预构建的fat framework作为依赖嵌入到UI框架中，但在App中使用该UI框架作为本地Pod时，依赖的SDK未能被正确安装或链接。

已执行步骤：

• 将依赖SDK的fat framework拖拽到UI框架项目的Frameworks组，并勾选“Embed”选项
• 在UI框架中添加指向该SDK的framework搜索路径
• 按照规范创建了UI框架的podspec，但未包含针对依赖SDK的特定配置
• 尝试在podspec中添加该SDK作为依赖，但因SDK仅存在于本地机器而无法实现

预期行为：App项目安装UI框架的本地Pod时，UI框架和依赖SDK均被包含且可访问
实际行为：仅UI框架被安装，App因缺失依赖SDK的符号或引用而编译失败

方案1：在UI框架的podspec中配置vendored_frameworks #

直接在podspec里指定本地SDK的路径，让CocoaPods自动处理它的链接与嵌入逻辑，这是最直接的解决方式。

假设SDK放在UI框架项目的Frameworks目录下，命名为TargetSDK.framework，在podspec中添加：

s.vendored_frameworks = 'Frameworks/TargetSDK.framework'

注意事项：

• 路径需相对于podspec文件的位置，确保路径准确
• 如果SDK是动态框架，若UI框架为动态类型，需确认podspec中设置了s.dynamic_framework = true，避免静态/动态框架冲突

方案2：将SDK封装为本地子Pod #

如果SDK后续有更新需求，可以把它单独做成一个本地Pod，再让UI框架的Pod依赖它：

1. 为SDK创建极简的TargetSDK.podspec文件：

Pod::Spec.new do |s|
  s.name = 'TargetSDK'
  s.version = '1.0.0'
  s.summary = 'Local dependency SDK'
  s.license = { :type => 'MIT', :file => 'LICENSE' }
  s.platform = :ios, '13.0'
  s.source = { :path => '.' }
  s.vendored_frameworks = 'TargetSDK.framework'
end

2. 在UI框架的podspec中添加本地依赖：

s.dependency 'TargetSDK', :path => '../TargetSDK' # 路径根据实际目录结构调整

3. 后续在App的Podfile中只需依赖UI框架，CocoaPods会自动拉取本地的SDK Pod

方案3：统一Embed与Link配置 #

确保UI框架项目的手动配置与podspec逻辑不冲突：

• 如果已经通过vendored_frameworks配置了SDK，可去掉UI框架项目中手动勾选的“Embed”选项，避免重复嵌入导致编译错误
• 若需要指定SDK的搜索路径，可在podspec中通过xcconfig统一配置：

s.xcconfig = { 'FRAMEWORK_SEARCH_PATHS' => '$(inherited) "${PODS_ROOT}/YourUIFramework/Frameworks"' }

• 确认SDK是完整的fat framework（包含arm64、x86_64等必要架构），避免架构不兼容导致的编译失败
• 若SDK为静态框架，且UI框架是动态类型，需确保静态框架的符号能被正确导出
• 执行pod install后，清理App项目缓存（Command+Shift+K）再重新构建

内容的提问来源于stack exchange，提问作者Vishnu Ram V