如何在React Native中创建iOS和Android跨平台后台持续运行定时器？

针对你遇到的react-native-background-timer在iOS无法正常工作的问题，以下是分平台的可行实现方案：

Android 平台实现 #

Android对后台任务限制较宽松，推荐使用Headless JS（React Native官方提供的后台任务机制），可以让定时器在后台持续运行。

步骤1：创建后台任务文件 #

新建BackgroundTimerTask.js，编写定时器逻辑：

module.exports = async () => {
  // 持续运行的定时器
  const intervalId = setInterval(() => {
    console.log("后台定时器执行中");
    // 这里写入你的业务逻辑
  }, 1000);

  // 若需长期运行，可添加唤醒锁防止系统回收（需额外配置权限）
};

步骤2：注册Android后台服务 #

在MainApplication.java中注册Headless JS服务：

import com.facebook.react.HeadlessJsTaskService;
import com.facebook.react.bridge.Arguments;
import com.facebook.react.jstasks.HeadlessJsTaskConfig;
import android.content.Intent;
import android.os.Bundle;

public class BackgroundTimerService extends HeadlessJsTaskService {
  @Override
  protected HeadlessJsTaskConfig getTaskConfig(Intent intent) {
    Bundle extras = intent.getExtras();
    return new HeadlessJsTaskConfig(
        "BackgroundTimerTask",
        extras != null ? Arguments.fromBundle(extras) : Arguments.createMap(),
        5000, // 任务超时时间（毫秒）
        false // 禁止前台运行该任务
    );
  }
}

步骤3：配置AndroidManifest.xml #

添加权限和服务声明：

<uses-permission android:name="android.permission.WAKE_LOCK" />
<service android:name=".BackgroundTimerService" />

步骤4：启动后台任务 #

在JS代码中触发任务：

import { Platform } from 'react-native';

const startAndroidBackgroundTimer = () => {
  if (Platform.OS === 'android') {
    const intent = new Intent(global.MainApplication.getAppContext(), BackgroundTimerService.class);
    global.MainApplication.getAppContext().startService(intent);
  }
};

iOS 平台实现 #

iOS对后台运行有严格限制，普通定时器会被系统暂停，需利用iOS的后台模式实现：

方案1：周期性后台任务（iOS 13+） #

适合不需要精确间隔的场景，系统会根据资源情况调度任务，需使用Background Tasks框架：

步骤1：开启后台模式

在Xcode中，进入项目Signing & Capabilities，添加Background Modes，勾选Background fetch。

步骤2：配置Info.plist

添加BGTaskSchedulerPermittedIdentifiers数组，添加任务标识（替换为你的Bundle ID）：

<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
  <string>com.yourbundleid.background.timer</string>
</array>

步骤3：注册后台任务

在AppDelegate.m中注册并调度任务：

#import <BackgroundTasks/BackgroundTasks.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // 注册后台任务
  BGTaskScheduler *scheduler = [BGTaskScheduler sharedScheduler];
  [scheduler registerForTaskWithIdentifier:@"com.yourbundleid.background.timer" usingQueue:nil launchHandler:^(BGAppRefreshTask *task) {
    // 执行定时器逻辑
    [self scheduleNextBackgroundTask];
    [task setTaskCompletedWithSuccess:YES];
  }];
  
  // 首次调度任务
  [self scheduleNextBackgroundTask];
  return YES;
}

- (void)scheduleNextBackgroundTask {
  BGTaskScheduler *scheduler = [BGTaskScheduler sharedScheduler];
  NSError *error;
  BGAppRefreshTaskRequest *request = [[BGAppRefreshTaskRequest alloc] initWithIdentifier:@"com.yourbundleid.background.timer"];
  request.earliestBeginDate = [NSDate dateWithTimeIntervalSinceNow:60]; // 1分钟后执行
  [scheduler submitTaskRequest:request error:&error];
  
  if (error) {
    NSLog(@"后台任务调度失败: %@", error.localizedDescription);
  }
}

方案2：静音音频后台模式（精确定时器） #

若需要精确的定时间隔，可以通过播放静音音频让App保持后台活跃（注意：非音频类App使用此方案可能存在App Store审核风险）：

步骤1：开启后台模式

在Xcode中Background Modes勾选Audio, AirPlay, and Picture in Picture。

步骤2：实现代码

使用expo-av或react-native-sound播放静音音频，同时启动定时器：

import { Audio } from 'expo-av';

async function startIOSBackgroundTimer() {
  const sound = new Audio.Sound();
  try {
    // 加载本地静音音频文件（需自行生成并放入项目）
    await sound.loadAsync(require('./silence.mp3'));
    await sound.setIsLoopingAsync(true);
    await sound.playAsync();
    
    // 启动精确定时器
    setInterval(() => {
      console.log("iOS后台定时器执行中");
      // 业务逻辑
    }, 1000);
  } catch (err) {
    console.error(err);
  }
}

方案3：定位后台模式（需定位权限） #

如果App本身有定位需求，可以开启Location updates后台模式，利用定位回调触发定时器逻辑，需确保权限使用合理。

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