Expo Modules API集成.framework文件：存放位置与集成方法问询

1. .framework 文件的正确存放位置 #

将 .framework 文件放在自定义模块的 ios 子目录下（而非 npx expo run:ios 生成的根目录 ios 文件夹），因为根目录 ios 是构建临时产物，会被 prebuild 命令覆盖。

具体操作：

• 在你的模块目录（比如 modules/your-custom-module）下创建 ios/Frameworks 文件夹
• 将 .framework 文件放入该 Frameworks 目录
• 在模块的 your-custom-module.podspec 文件中添加配置：

  s.vendored_frameworks = 'ios/Frameworks/YourSDK.framework'
  

2. 桥接头文件的存放与配置 #

桥接头文件（.h）同样放在模块的 ios 目录下，无需放到根目录 ios 文件夹。

配置要点：

• 将桥接头文件（比如 YourSDK-Bridging-Header.h）放在模块的 ios 目录
• 在 podspec 中声明头文件路径：

  # 对外暴露用 public_header_files，内部使用用 private_header_files
  s.private_header_files = 'ios/YourSDK-Bridging-Header.h'
  

• 在模块的 Objective-C++ 实现文件（比如 YourCustomModule.mm）中导入桥接头文件：

  #import "YourSDK-Bridging-Header.h"
  

常见错误解决方案 #

针对 "Module not found"、"File not found"、"{SDKName} not found" 等问题，按以下步骤排查：

• 校验 podspec 路径：确保 vendored_frameworks、source_files、header_files 的路径与实际文件位置完全匹配，避免相对路径错误
• 清理构建缓存：执行 npx expo prebuild --clean 清理旧构建产物，再重新执行 npx expo run:ios
• 验证 .framework 有效性：用命令 lipo -info ios/Frameworks/YourSDK.framework/YourSDK 检查框架是否包含所需架构（arm64 用于真机，x86_64 用于模拟器）
• 确认模块导入路径：在 React Native 代码中导入模块时，使用模块的 npm 包名（与 package.json 中 name 字段一致），例如：

  import { YourCustomModule } from 'your-custom-module'
  

• Xcode 手动检查：打开根目录 ios 下的 .xcworkspace，确认 .framework 已添加到项目的「Frameworks, Libraries and Embedded Content」列表，且嵌入方式设为「Embed & Sign」

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