如何在React Native应用后台启用持续位置追踪？

Expo 环境（expo-location + TaskManager） #

按以下步骤修正配置，确保后台定位正常运行：

• 权限与配置文件：在app.json中补充完整权限和后台模式声明：

  {
    "expo": {
      "ios": {
        "infoPlist": {
          "NSLocationAlwaysAndWhenInUseUsageDescription": "需要持续获取位置以提供服务",
          "NSLocationWhenInUseUsageDescription": "需要获取位置以提供服务",
          "UIBackgroundModes": ["location"]
        }
      },
      "android": {
        "permissions": [
          "ACCESS_FINE_LOCATION",
          "ACCESS_BACKGROUND_LOCATION",
          "FOREGROUND_SERVICE_LOCATION"
        ],
        "backgroundPermissions": ["ACCESS_BACKGROUND_LOCATION"]
      }
    }
  }
  

• TaskManager 注册与启动：任务需在App初始化时注册，启动更新时配置关键参数：

  import * as Location from 'expo-location';
  import * as TaskManager from 'expo-task-manager';
  
  const BACKGROUND_LOCATION_TASK = 'background-location-task';
  
  // 在App加载时注册任务（比如App.js的useEffect或componentDidMount）
  TaskManager.defineTask(BACKGROUND_LOCATION_TASK, ({ data, error }) => {
    if (error) {
      console.error('后台定位任务出错:', error);
      return;
    }
    if (data) {
      const { locations } = data;
      console.log('后台位置更新:', locations[0]);
      // 此处处理位置数据
    }
  });
  
  // 启动后台定位流程
  async function startBackgroundLocation() {
    // 先申请前台权限
    const foregroundStatus = await Location.requestForegroundPermissionsAsync();
    if (foregroundStatus.status !== 'granted') return;
    
    // 申请后台权限
    const backgroundStatus = await Location.requestBackgroundPermissionsAsync();
    if (backgroundStatus.status !== 'granted') return;
  
    // 确认任务已注册
    const isTaskRegistered = await TaskManager.isTaskRegisteredAsync(BACKGROUND_LOCATION_TASK);
    if (!isTaskRegistered) return;
  
    await Location.startLocationUpdatesAsync(BACKGROUND_LOCATION_TASK, {
      accuracy: Location.Accuracy.High,
      distanceInterval: 10, // 移动10米触发更新
      timeInterval: 5000, // 每5秒强制更新（优先级低于distanceInterval）
      showsBackgroundLocationIndicator: true, // iOS显示后台定位指示器
      foregroundService: {
        notificationTitle: '正在定位',
        notificationBody: '应用后台持续获取位置中',
      } // Android必须配置前台服务通知
    });
  }
  

• 重要提醒：Expo Go无法测试后台定位，必须使用eas build构建正式包或开发包进行测试。

裸React Native环境（react-native-location） #

针对react-native-location的正确配置步骤：

• Android 配置：
  1. 在AndroidManifest.xml中添加权限与服务声明：

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 12+ 必需 -->
  
  <application ...>
    <service
      android:name="com.reactnativecommunity.location.LocationService"
      android:foregroundServiceType="location" />
  </application>
  

  2. 代码中初始化并启动定位：

  import RNLocation from 'react-native-location';
  
  async function initLocationTracking() {
    // 申请永久权限
    const hasPermission = await RNLocation.requestPermission({
      ios: 'always',
      android: {
        detail: 'fine',
        background: true
      }
    });
  
    if (!hasPermission) return;
  
    // 配置定位参数
    RNLocation.configure({
      distanceFilter: 10,
      desiredAccuracy: 'high',
      androidProvider: 'gps',
      interval: 5000,
      fastestInterval: 1000,
      showsBackgroundLocationIndicator: true,
      enableBackgroundUpdates: true,
      foregroundService: {
        notificationTitle: '后台定位',
        notificationBody: '应用正在后台追踪位置',
        notificationIcon: require('../assets/location-icon.png') // 可选，需提供本地图标
      }
    });
  
    // 监听位置更新
    RNLocation.subscribeToLocationUpdates((locations) => {
      console.log('位置更新:', locations[0]);
      // 处理位置数据
    });
  }
  

• iOS 配置：
  1. 在Info.plist中添加权限与后台模式：

  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>需要持续获取位置以提供服务</string>
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要获取位置以提供服务</string>
  <key>UIBackgroundModes</key>
  <array>
    <string>location</string>
  </array>
  

  2. 代码中确保申请always权限并开启后台更新：

  await RNLocation.requestPermission({ ios: 'always' });
  RNLocation.configure({ enableBackgroundUpdates: true });
  

常见问题排查 #

• iOS：
  • 必须申请always权限，whenInUse权限无法支持后台定位。
  • 低电量模式、后台刷新关闭会导致定位停止，需引导用户手动开启对应设置。
  • 系统会限制高频定位请求，避免设置过小的distanceInterval或timeInterval，否则可能被系统暂停定位。
• Android：
  • Android 10+必须申请ACCESS_BACKGROUND_LOCATION权限，且用户需在授权弹窗中选择“始终允许”。
  • Android 12+必须配置前台服务并显示通知，否则后台定位会被系统直接禁止。
  • 小米、华为等厂商有独立的后台权限管控，需引导用户在系统设置中开启应用的“后台运行权限”。

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