iOS端使用@supersami/rn-foreground-service注册前台服务报错求助

问题概述 #

相同代码在Android端正常运行，iOS端调用ReactNativeForegroundService.register()时触发以下错误：

ERROR  Invariant Violation: `new NativeEventEmitter()` requires a non-null argument., js engine: hermes
WARN  Module ReactNativeEventEmitter requires main queue setup since it overrides `init` but doesn't implement `requiresMainQueueSetup`.

核心原因是iOS端原生模块未正确注册，导致JS层无法获取有效模块实例初始化NativeEventEmitter，同时模块缺少requiresMainQueueSetup实现触发警告。

解决方案 #

1. 确认iOS原生模块集成状态 #

• 检查自动链接结果：打开iOS项目的Pods目录，确认是否存在RNForegroundService目标；若不存在，执行手动链接：
  1. 在Xcode中右键点击项目的Libraries文件夹，选择Add Files to [你的项目名]
  2. 选中node_modules/@supersami/rn-foreground-service/ios/RNForegroundService.xcodeproj添加
  3. 进入项目Build Phases -> Link Binary With Libraries，点击+按钮添加libRNForegroundService.a
• 重新安装依赖：

  rm -rf node_modules Podfile.lock
  npm install
  cd ios && pod install --repo-update
  

2. 配置iOS前台服务必要权限 #

iOS对前台服务有严格限制，必须在Info.plist中声明对应的后台模式：

1. 打开ios/[项目名]/Info.plist
2. 添加UIBackgroundModes数组，根据你的服务需求添加对应项（比如音频服务加audio，定位服务加location）：

   <key>UIBackgroundModes</key>
   <array>
     <string>audio</string>
     <string>location</string>
   </array>
   

3. 若涉及定位等敏感权限，还需在Info.plist中添加对应的权限描述（如NSLocationAlwaysAndWhenInUseUsageDescription）

3. 修复NativeEventEmitter初始化问题 #

在调用注册方法前，先验证原生模块是否存在：

import { NativeModules } from 'react-native';
import ReactNativeForegroundService from "@supersami/rn-foreground-service";

// 打印模块状态，确认是否加载成功
console.log('Native RNForegroundService:', NativeModules.RNForegroundService);

if (NativeModules.RNForegroundService) {
  const config = {
    config: {
      alert: true,
      onServiceErrorCallBack: function () {
        console.warn('[ReactNativeForegroundService] onServiceErrorCallBack', arguments);
      },
    }
  };
  ReactNativeForegroundService.register(config);
} else {
  console.error('RNForegroundService iOS模块未注册，请检查集成配置');
}

4. 消除requiresMainQueueSetup警告 #

该警告不影响功能，但可通过补丁解决：

1. 安装patch-package：

   npm install patch-package --save-dev
   

2. 找到node_modules/@supersami/rn-foreground-service/ios/RNForegroundService.m，添加以下方法：

   + (BOOL)requiresMainQueueSetup {
     return YES;
   }
   

3. 生成补丁：

   npx patch-package @supersami/rn-foreground-service
   

4. 将生成的patches文件夹提交到版本控制，后续安装依赖时自动应用补丁

额外注意 #

iOS的前台服务规则与Android差异较大，@supersami/rn-foreground-service的iOS实现可能仅支持特定场景（如音频、定位类后台任务），若你的服务不符合iOS后台运行要求，即使解决了当前错误，也可能无法正常运行前台服务。

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