如何在React Native CLI中实现前台与后台服务（适配最新Android SDK）

推荐适配最新版本的库 #

• react-native-foreground-service：维护活跃，支持RN 0.70+、Android 13+，原生实现基于现代Android API，无需降级SDK
• react-native-background-actions：适配最新Android权限模型（如POST_NOTIFICATIONS），可稳定执行后台任务

前台服务实现示例（基于react-native-foreground-service） #

1. 安装与配置 #

npm install react-native-foreground-service
# 或 yarn add react-native-foreground-service

在AndroidManifest.xml中添加权限与服务声明：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 13+ 必填 -->

<application ...>
  <service
    android:name="com.ammarahmed.rnforegroundservice.ForegroundService"
    android:foregroundServiceType="location|mediaPlayback|dataSync" /> <!-- 根据服务类型选择 -->
</application>

2. JS端启动/停止服务 #

import ForegroundService from 'react-native-foreground-service';

// 启动前台服务
const startForegroundService = async () => {
  await ForegroundService.start({
    id: 123,
    title: '前台服务运行中',
    description: '执行后台同步任务',
    icon: 'ic_notification', // 图标需放置在android/app/src/main/res/drawable目录
    color: '#2196F3',
    foregroundServiceType: ForegroundService.FOREGROUND_SERVICE_TYPE_DATA_SYNC,
  });
};

// 停止服务
const stopForegroundService = async () => {
  await ForegroundService.stop();
};

后台服务实现（适配Android 12+） #

Android 12+ 对后台任务限制严格，建议使用WorkManager结合react-native-work-manager实现：

1. 安装 #

npm install react-native-work-manager

2. 注册与触发后台任务 #

import WorkManager from 'react-native-work-manager';

// 注册后台任务
WorkManager.registerTask('syncDataTask', async () => {
  try {
    // 执行后台逻辑（如数据同步）
    console.log('后台同步任务执行中');
    return WorkManager.Result.success();
  } catch (error) {
    console.error('后台任务失败:', error);
    return WorkManager.Result.failure();
  }
});

// 触发一次性任务
const triggerOneTimeTask = () => {
  WorkManager.enqueueOneTimeWorkRequest('syncDataTask');
};

// 触发周期性任务（Android限制最小间隔15分钟）
const triggerPeriodicTask = () => {
  WorkManager.enqueuePeriodicWorkRequest('syncDataTask', {
    repeatInterval: 15,
    repeatIntervalTimeUnit: WorkManager.TimeUnit.MINUTES,
  });
};

最佳实践 #

• 权限处理：Android 13+ 必须请求通知权限才能显示前台服务通知，可配合react-native-permissions实现：

  import { check, request, PERMISSIONS } from 'react-native-permissions';
  
  const checkNotificationPermission = async () => {
    const status = await check(PERMISSIONS.ANDROID.POST_NOTIFICATIONS);
    if (status === 'denied') {
      await request(PERMISSIONS.ANDROID.POST_NOTIFICATIONS);
    }
  };
  

• 服务类型匹配：根据实际业务选择对应的foregroundServiceType，避免被系统强制停止
• 资源清理：组件卸载或任务完成时主动停止服务，避免内存泄漏
• 测试验证：使用Android Studio的「Background Limits」工具模拟系统后台限制，验证实现稳定性

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