使用create-react-native-library添加Swift文件时遇「找不到文件」错误

排查步骤及解决方案 #

1. 修正Swift文件的访问权限 #

Swift默认类/方法的访问级别是internal，React Native的桥接层无法访问非公开的Swift代码。确保你的类和需要暴露的方法标记为public：

public class Test {
    public func sampleMethod() {
        // 实现逻辑
    }
}

2. 检查桥接文件与Xcode配置 #

• 确认项目中存在[你的库名称]-Bridging-Header.h文件，若需要在Objective-C桥接代码中引用Swift类，确保相关声明正确（Swift调用Swift无需额外桥接，但RN的底层桥接依赖Objective-C层识别Swift类）。
• 进入Xcode项目的Build Settings，在Swift Compiler - General下验证Objective-C Bridging Header的路径是否正确，路径需为相对于项目根目录的相对路径。

3. 清理缓存与构建产物 #

• 重置React Native缓存，避免旧缓存导致的识别问题：

npx react-native start --reset-cache

• 清理Xcode构建产物，重新编译：
  打开Xcode，点击Product -> Clean Build Folder（快捷键Cmd+Shift+K），之后重新执行构建。

4. 验证Podspec文件配置 #

确保新增的Swift文件被包含在podspec的source_files中，否则RN无法识别该文件。修改[你的库名称].podspec：

s.source_files = "ios/**/*.{h,m,swift}"

修改完成后，在ios目录下重新执行：

pod install

5. 确认文件的目标成员资格 #

选中新增的Swift文件，查看右侧File Inspector面板中的Target Membership，确保勾选了你的React Native库对应的目标（而非主应用目标）。

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