如何将Swift编写的XCFramework集成到React Native模块并在原生桥接中调用其API

我之前开发React Native模块集成Swift写的XCFramework时，完完全全碰到过和你一样的问题——明明在Podspec里加了s.vendored_frameworks = 'ios/MyFramework.xcframework'，但在原生桥接代码里就是死活访问不到框架里的API！后来一步步排查才搞定，现在把我亲测有效的方法整理给你：

第一步：确保XCFramework的API已暴露给Objective-C #

React Native的原生桥接默认基于Objective-C层，所以Swift写的XCFramework里的类和方法必须明确允许Objective-C访问，这是很多人忽略的关键：

• 给XCFramework中的Swift类添加@objc public修饰，并且类必须继承自NSObject，比如：

@objc public class MyFrameworkCore: NSObject {
  @objc public func fetchData(input: String) -> String {
    return "XCFramework处理结果: \(input)"
  }
}

• 只有用@objc public修饰的类和方法，才能在Objective-C（或React Native桥接）中被访问到。

第二步：完善Podspec的完整配置 #

只加vendored_frameworks远远不够，还需要补充配置解决静态/动态框架冲突，以及让Xcode正确识别框架：

# 你的模块Podspec文件中的关键配置
s.vendored_frameworks = 'ios/MyFramework.xcframework'
# React Native模块通常需要设置为静态框架，避免动态链接冲突
s.static_framework = true
s.pod_target_xcconfig = {
  # 确保框架搜索路径包含XCFramework所在目录
  'FRAMEWORK_SEARCH_PATHS' => '$(inherited) "${PODS_ROOT}/../ios"',
  # 匹配XCFramework使用的Swift版本（比如5.5，根据你的实际情况调整）
  'SWIFT_VERSION' => '5.5',
  # 显式链接XCFramework
  'OTHER_LDFLAGS' => '$(inherited) -framework MyFramework'
}

第三步：配置桥接文件，实现API调用 #

根据你的桥接代码语言（Objective-C或Swift），做对应的配置：

如果你用Objective-C写桥接 #

1. 确保模块的桥接头文件（比如MyRNModule-Bridging-Header.h）中导入XCFramework的模块：

@import MyFramework;

2. 然后在你的Objective-C桥接类中就可以直接调用API了：

#import "React/RCTBridgeModule.h"

@interface MyRNModule : NSObject <RCTBridgeModule>
@end

@implementation MyRNModule

RCT_EXPORT_MODULE();

RCT_EXPORT_METHOD(callFrameworkAPI:(NSString *)input callback:(RCTResponseSenderBlock)callback) {
  MyFrameworkCore *coreInstance = [[MyFrameworkCore alloc] init];
  NSString *result = [coreInstance fetchDataWithInput:input];
  // 通过回调把结果返回给JavaScript层
  callback(@[[NSNull null], result]);
}

@end

如果你用Swift写桥接 #

1. 在Swift桥接类的顶部直接导入XCFramework：

import React
import MyFramework

@objc(MyRNModule)
class MyRNModule: NSObject, RCTBridgeModule {
  // 定义模块名称，JavaScript层会用这个名字调用
  static func moduleName() -> String {
    return "MyRNModule"
  }

  // 导出给JavaScript调用的方法
  @objc func callFrameworkAPI(_ input: String, callback: RCTResponseSenderBlock) {
    let coreInstance = MyFrameworkCore()
    let result = coreInstance.fetchData(input: input)
    callback([NSNull(), result])
  }
}

第四步：清理缓存，解决构建异常 #

很多时候配置正确了但还是出问题，都是缓存搞的鬼，按这个顺序操作：

• 执行终端命令 pod deintegrate 清理现有Pod依赖配置
• 删掉Xcode的Derived Data（路径：Xcode -> Preferences -> Locations -> Derived Data，点击箭头打开文件夹删除）
• 重新执行 pod install
• 重启Xcode后再尝试编译运行

常见坑点排查 #

• 如果提示“找不到MyFramework”：检查Podspec中XCFramework的路径是否正确，路径是相对于Podspec文件的，比如XCFramework在ios目录下，路径就是ios/MyFramework.xcframework
• 如果提示“无法访问类或方法”：确认XCFramework中对应的类和方法都加了@objc public修饰，且类继承自NSObject
• 如果出现链接错误：用lipo -info [XCFramework路径]/MyFramework命令查看框架支持的架构，确保和当前构建的目标（真机/模拟器）匹配

按照这些步骤操作，应该就能顺利在React Native桥接中调用XCFramework的API了！

内容来源于stack exchange