iOS端React Native如何为Bridge正确添加自定义原生模块

• 第一步：检查AppDelegate的头文件导入
  你需要在AppDelegate.m（如果是Swift版AppDelegate则对应桥接文件）的顶部引入原生模块头文件，否则直接调用RCTAVAudioSessionModule.new会生成未知类型实例，无法被React Native桥接识别：

  #import "RCTAVAudioSessionModule.h"
  

  你的模块注册写法本身是符合Expo项目自定义模块添加规则的，头文件导入正确即可正常注册。如果是未集成Expo的纯React Native项目，只要正确实现导出宏就会自动注册模块，不需要手动在extraModulesForBridge方法中添加。

• 第二步：确认原生模块的导出配置正确
  打开RCTAVAudioSessionModule.h和RCTAVAudioSessionModule.m文件，检查以下基础配置：

  1. 头文件中需遵守RCTBridgeModule协议：

  #import <React/RCTBridgeModule.h>
  
  @interface RCTAVAudioSessionModule : NSObject <RCTBridgeModule>
  @end
  

  2. 实现文件中必须添加模块导出宏，以及对应方法的导出声明：

  #import "RCTAVAudioSessionModule.h"
  #import <AVFoundation/AVFoundation.h>
  #import <React/RCTLog.h>
  
  @implementation RCTAVAudioSessionModule
  
  // 导出模块，不填参数默认导出名为类名RCTAVAudioSessionModule
  RCT_EXPORT_MODULE()
  
  // 导出你要调用的getCurrentRoute方法，这里以Promise返回为例，也可改成回调写法
  RCT_EXPORT_METHOD(getCurrentRoute:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
  {
      NSError *error;
      AVAudioSessionRouteDescription *route = [[AVAudioSession sharedInstance] currentRoute];
      if (route) {
          // 按需返回你需要的路由字段即可
          resolve(route.description);
      } else {
          reject(@"get_route_fail", @"获取音频路由失败", error);
      }
  }
  
  @end
  

• 第三步：确认JS端调用方式正确
  必须从react-native包中引入NativeModules再获取对应模块：

  import { NativeModules } from 'react-native';
  const { RCTAVAudioSessionModule } = NativeModules;
  
  // 调用示例
  const getAudioRoute = async () => {
    try {
      const route = await RCTAVAudioSessionModule.getCurrentRoute();
      console.log('当前音频路由：', route);
    } catch (e) {
      console.error('获取路由失败：', e);
    }
  }
  

• 第四步：清理缓存重新编译
  原生代码改动不会触发热更新，配置完成后需要完全关闭Metro服务，清理Xcode缓存后重新编译运行项目，修改才会生效。

如果以上步骤完成后仍有报错，可以在模块实现中添加初始化日志确认模块是否被正确实例化：

- (instancetype)initWithBridge:(RCTBridge *)bridge {
  self = [super init];
  if (self) {
    RCTLogInfo(@"RCTAVAudioSessionModule 初始化成功");
  }
  return self;
}

运行后查看Xcode控制台有没有对应输出即可验证模块注册状态。

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