React Native中应用未启动时如何获取用户步数？

一、核心能力：Expo Pedometer vs Google Fit #

Expo Pedometer #

• 后台计步支持：iOS端配合BackgroundFetch可实现后台步数收集，但Android端表现受限——受Expo沙箱和系统后台限制，应用被挂起或杀死后易断更，只能依赖系统后台fetch触发，最小间隔15分钟，无法实时获取数据。
• 数据同步：应用启动后可拉取历史步数，但后台期间的数据完整性无法保证，Android端尤为明显。

Google Fit（仅Android） #

• 后台计步支持：完全满足需求。作为系统级健康服务，无论应用是否打开，都会持续收集步数数据，应用只需在启动后调用API查询历史数据即可，无需自行维护后台进程。
• 稳定性：系统级服务的可靠性远高于第三方库，不会因应用被杀死丢失数据。

二、适用场景 #

• Expo Pedometer：适合纯Expo项目（未eject）、快速原型开发，或对后台计步稳定性要求不高的场景。缺点是Android后台表现差，裸RN项目集成需eject或使用预构建，复杂度较高。
• Google Fit（Android）+ Core Motion（iOS）：生产级应用首选方案。iOS端依托原生Core Motion框架（或对应RN封装），Android端使用Google Fit，两端均由系统服务维护步数数据，后台持续计步稳定性强，应用启动后直接同步即可。

三、具体实现方案 #

方案1：纯Expo快速原型实现 #

1. 安装依赖：

expo install expo-pedometer expo-task-manager expo-background-fetch

2. 注册后台任务定时拉取步数：

import * as Pedometer from 'expo-pedometer';
import * as TaskManager from 'expo-task-manager';
import * as BackgroundFetch from 'expo-background-fetch';
import AsyncStorage from '@react-native-async-storage/async-storage';

const BACKGROUND_STEP_TASK = 'background-step-fetch';

// 定义后台任务逻辑
TaskManager.defineTask(BACKGROUND_STEP_TASK, async () => {
  try {
    const isAvailable = await Pedometer.isAvailableAsync();
    if (!isAvailable) return BackgroundFetch.Result.NoData;

    const end = new Date();
    const start = new Date(end.getTime() - 60 * 60 * 1000); // 拉取过去1小时步数
    const stepResult = await Pedometer.getStepCountAsync(start, end);
    
    // 缓存到本地，待应用启动后同步
    await AsyncStorage.setItem('cachedSteps', JSON.stringify(stepResult));
    return BackgroundFetch.Result.NewData;
  } catch (err) {
    return BackgroundFetch.Result.Failed;
  }
});

// 注册后台任务
async function setupBackgroundFetch() {
  await BackgroundFetch.registerTaskAsync(BACKGROUND_STEP_TASK, {
    minimumInterval: 15, // 系统限制最小触发间隔15分钟
    stopOnTerminate: false, // 应用杀死后是否继续运行（部分Android设备不支持）
    startOnBoot: true, // 设备重启后自动启动任务（部分Android设备不支持）
  });
}

3. 应用启动时同步数据：读取AsyncStorage中的缓存数据，或直接调用getStepCountAsync拉取全量历史步数。

注意：Android端后台fetch的触发时间由系统控制，无法实时获取，且国产ROM大概率会限制后台任务，易出现数据断更。

方案2：生产级跨平台实现 #

Android端（Google Fit）

1. 集成react-native-google-fit库：

npm install react-native-google-fit --save

2. 配置权限（修改AndroidManifest.xml）：

<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" />

3. 授权并查询历史步数：

import GoogleFit, { Scopes } from 'react-native-google-fit';

// 请求Google Fit权限
async function requestFitPermission() {
  const authStatus = await GoogleFit.authorize({
    scopes: [Scopes.FITNESS_ACTIVITY_READ, Scopes.FITNESS_ACTIVITY_WRITE],
  });
  if (!authStatus.success) {
    // 处理授权失败逻辑
    return;
  }
}

// 应用启动时同步历史步数
async function syncFitSteps() {
  const startDate = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000); // 拉取过去7天数据
  const endDate = new Date();
  const stepData = await GoogleFit.getDailyStepCountSamples({
    startDate: startDate.toISOString(),
    endDate: endDate.toISOString(),
  });
  // 将数据同步到应用本地或服务器
}

Google Fit会自动在后台收集步数，无需维护后台任务，应用启动后直接查询即可。

iOS端（Core Motion/Expo Pedometer）

iOS端使用Expo Pedometer即可，系统原生支持后台持续计步：

1. 配置Info.plist权限：

<key>NSMotionUsageDescription</key>
<string>需要访问运动数据以统计您的步数</string>

2. 应用启动时拉取历史步数：

import * as Pedometer from 'expo-pedometer';

async function syncIOSSteps() {
  const isAvailable = await Pedometer.isAvailableAsync();
  if (!isAvailable) return;

  const startDate = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
  const endDate = new Date();
  const stepResult = await Pedometer.getStepCountAsync(startDate, endDate);
  // 处理步数数据
}

iOS系统会自动在后台记录步数，用户授权后即可稳定获取数据，无需额外配置后台任务。

四、关键注意事项 #

• 避免同时集成Expo Pedometer和Google Fit：Android端会存在权限冲突，且Google Fit已完全覆盖Android计步需求，Expo Pedometer在Android后台无实际作用，反而会增加包体积和稳定性风险。
• Android国产ROM适配：小米、华为等品牌手机会限制后台权限，需引导用户手动开启「自启动权限」和「后台活动权限」，否则Google Fit数据同步会异常。
• iOS权限说明：必须在Info.plist中明确运动权限的用途，否则用户可能拒绝授权，导致无法获取步数数据。

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