pod install后Umbrella-Header导入语法错误问题咨询

我正在开发一个本地Expo模块，其中使用了第三方框架MyLocalFramework。我的.podspec配置如下：

Pod::Spec.new do |s|
  # root specification

  s.dependency 'ExpoModulesCore'
  s.vendored_frameworks = 'Frameworks/MyLocalFramework.framework'
  s.public_header_files = "Frameworks/MyLocalFramework.framework/Headers/*"

  # Swift/Objective-C compatibility
  s.pod_target_xcconfig = {
    'DEFINES_MODULE' => 'YES',
    'SWIFT_COMPILATION_MODE' => 'wholemodule'
  }

  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
end

在集成该模块的预构建iOS应用中执行pod install后，可在Objective-C和Swift文件中正常导入使用MyLocalFramework，但运行npx expo run:ios时，自动生成的ModuleName-umbrella.h采用"Header.h"语法导入头文件导致构建失败，手动改为<MyLocalFramework/Header.h>则可正常运行。

请问为何pod install会使用该语法？如何避免每次执行pod install后手动修改导入语句？

补充信息：模块的Build Phases > Headers > Project中已指定ModuleName-umbrella.h及MyLocalFramework的头文件。

原因分析 #

CocoaPods生成ModuleName-umbrella.h时，会根据public_header_files配置的路径决定头文件导入语法：

• 如果头文件被标记为当前pod的公共头（加入public_header_files），CocoaPods会判定这些头属于当前模块，因此用"Header.h"的相对路径语法导入。
• 但MyLocalFramework是独立的vendored framework，它的头文件属于自身模块，应该用<MyLocalFramework/Header.h>的模块式导入。你把它的头文件加到当前pod的public_header_files中，导致CocoaPods错误地将其当作当前模块的头文件处理，生成了错误的导入语法。

解决方案 #

1. 修正.podspec配置 #

移除public_header_files中对MyLocalFramework头文件的引用——vendored framework本身会自动处理自身的头文件暴露，不需要将其头文件加入当前pod的公共头列表。修改后的.podspec如下：

Pod::Spec.new do |s|
  # root specification

  s.dependency 'ExpoModulesCore'
  s.vendored_frameworks = 'Frameworks/MyLocalFramework.framework'

  # Swift/Objective-C compatibility
  s.pod_target_xcconfig = {
    'DEFINES_MODULE' => 'YES',
    'SWIFT_COMPILATION_MODE' => 'wholemodule'
  }

  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
end

2. 调整代码中的导入方式 #

确保Expo模块代码使用正确的模块导入语法：

• Objective-C文件中使用：#import <MyLocalFramework/Header.h>
• Swift文件中直接使用：import MyLocalFramework

3. 清理缓存并重新构建 #

执行以下命令彻底清理旧的构建配置，避免缓存影响：

# 在Expo项目中清理预构建缓存并重新构建
npx expo prebuild --clean && npx expo run:ios
# 或者针对Pod单独清理
pod deintegrate && pod install

4. 调整Xcode的Headers配置 #

移除Build Phases > Headers > Project中MyLocalFramework的头文件条目，这些头文件属于vendored framework，不需要加入当前模块的Headers列表。

这样修改后，CocoaPods生成的ModuleName-umbrella.h只会包含当前Expo模块自身的头文件，不会再错误导入MyLocalFramework的头文件，代码通过正确的模块导入方式可正常引用MyLocalFramework，无需再手动修改umbrella.h文件。

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