HarmonyOS鸿蒙Next中是否支持后台持续获取 GPS 位置（如运动轨迹记录）

实现 锁屏/切后台后每秒获取一次高精度定位 是完全可行的，但需要严格遵循系统权限管理、后台保活机制和定位 API 的规范使用。

一、前提条件

1. 目标设备为真机（模拟器不支持后台高频定位）
2. 用户手动授权 后台定位权限（不能静默申请）
3. App 声明了后台定位能力（backgroundModes: ["location"]）
4. 使用 ContinuousTask 保活，防止系统杀进程

二、配置文件：module.json5

{
  "module": {
    "requestPermissions": [
      { "name": "ohos.permission.LOCATION" },
      { "name": "ohos.permission.LOCATION_IN_BACKGROUND" },
      { "name": "ohos.permission.KEEP_BACKGROUND_RUNNING" }
    ],
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "type": "page",
        "backgroundModes": ["location"]  // ⚠️ 关键：声明后台定位模式
      }
    ]
  }
}

三、核心代码（ArkTS）

1. 定位管理类：RunningLocationService.ets

import geolocation from '@ohos.geolocation';
import backgroundTaskManager from '@ohos.backgroundTaskManager';
import common from '@ohos.app.ability.common';
import hilog from '@ohos.hilog';

const TAG = 'RunningLocation';

export class RunningLocationService {
  private context: common.UIAbilityContext;
  private isRunning = false;
  private taskId: number = -1;
  private callback: geolocation.LocationCallback | null = null;

  constructor(context: common.UIAbilityContext) {
    this.context = context;
  }

  async start(): Promise<void> {
    if (this.isRunning) return;

    try {
      // 1. 检查并请求权限（必须由用户主动触发）
      const auth = await geolocation.checkLocationAuthorization();
      if (auth !== geolocation.LocationAuthorizationStatus.AUTHORIZED) {
        await geolocation.requestLocationAuthorization();
        const newAuth = await geolocation.checkLocationAuthorization();
        if (newAuth !== geolocation.LocationAuthorizationStatus.AUTHORIZED) {
          throw new Error('未获得定位权限');
        }
      }

      // 2. 开启定位服务
      await geolocation.enableLocation();

      // 3. 申请后台持续任务（保活）
      this.taskId = await backgroundTaskManager.startContinuousTask(
        this.context,
        backgroundTaskManager.ContinuousTaskType.CONTINUOUS_TASK_TYPE_LOCATION
      );

      // 4. 配置高精度 + 1秒间隔
      const config: geolocation.LocationRequestConfig = {
        priority: geolocation.LocationRequestPriority.HIGH_ACCURACY,
        scenario: geolocation.LocationRequestScenario.RUNNING, // 跑步场景优化
        timeInterval: 1000,     // 1秒
        distanceInterval: 0,    // 忽略距离变化
        maxAccuracy: 5,         // 要求5米内精度
        cacheValidTime: 0       // 不用缓存
      };

      // 5. 注册回调
      this.callback = (location: geolocation.Location) => {
        hilog.info(TAG, `📍定位: ${location.latitude}, ${location.longitude}, 精度=${location.accuracy}m`);
        // TODO: 发送到UI、记录轨迹、计算配速等
      };

      geolocation.on('locationChange', config, this.callback);
      this.isRunning = true;
      hilog.info(TAG, '✅ 跑步定位服务已启动（支持锁屏/后台）');
    } catch (err) {
      hilog.error(TAG, `❌ 启动失败: ${JSON.stringify(err)}`);
      this.stop();
      throw err;
    }
  }

  stop(): void {
    if (!this.isRunning) return;

    if (this.callback) {
      geolocation.off('locationChange', this.callback);
      this.callback = null;
    }

    if (this.taskId !== -1) {
      backgroundTaskManager.stopContinuousTask(this.context, this.taskId)
        .catch(e => hilog.error(TAG, `停止保活任务失败: ${JSON.stringify(e)}`));
      this.taskId = -1;
    }

    geolocation.disableLocation().catch(() => {});
    this.isRunning = false;
    hilog.info(TAG, '⏹️ 定位服务已停止');
  }
}

2. 在 Ability 中调用（用户点击“开始跑步”时触发）

// EntryAbility.ets
import { RunningLocationService } from '../common/RunningLocationService';
import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  private locationService: RunningLocationService | null = null;

  onCreate() {
    this.locationService = new RunningLocationService(this.context);
  }

  // 假设用户点击“开始跑步”按钮
  onStartRunning() {
    this.locationService?.start().catch(err => {
      console.error('定位启动失败，请检查权限或系统设置', err);
      // 可弹窗提示用户去设置中开启“后台高耗电”和“后台定位”
    });
  }

  onDestroy() {
    this.locationService?.stop();
  }
}

测试建议

1. 真机测试（华为 Mate/P系列、Pura 系列等）
2. 启动 App → 点击“开始跑步” → 锁屏 → 观察日志是否持续输出
3. 进入 设置 > 电池 > 应用启动管理，关闭自动管理，手动允许后台活动

在鸿蒙（HarmonyOS）系统中，支持后台持续获取高精度GPS位置（包括锁屏/切后台场景），可通过以下方案实现每秒定位：

实现方案

1. 权限配置（module.json5）

"requestPermissions": [
  {
    "name": "ohos.permission.LOCATION_IN_BACKGROUND",
    "reason": "后台持续定位",
    "usedScene": { "abilities": ["EntryAbility"], "when": "always" }
  },
  {
    "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
    "reason": "保持后台运行",
    "usedScene": { "abilities": ["EntryAbility"], "when": "always" }
  }
],
"abilities": [
  {
    "backgroundModes": ["location"]  // 声明定位长时任务
  }
]

2. 核心代码实现

import geoLocationManager from '@kit.GeoLocationKit';
import backgroundTaskManager from '@kit.ResourceScheduleKit';
import wantAgent from '@kit.AbilityKit';

// 配置高精度定位参数（每秒1次）
const locationRequest: geoLocationManager.LocationRequest = {
  priority: geoLocationManager.LocationRequestPriority.FIRST_FIX, // 最高精度
  scenario: geoLocationManager.LocationRequestScenario.NAVIGATION, // 导航级定位
  timeInterval: 1,  // 1秒间隔
  distanceInterval: 0, // 无距离限制
  maxAccuracy: 0 // 最高精度
};

// 开启后台定位任务
async function startBackgroundTracking() {
  const context = getContext(this) as common.UIAbilityContext;

  // 1. 创建WantAgent（后台任务触发入口）
  const wantAgentInfo = {
    wants: [{ bundleName: context.abilityInfo.bundleName }],
    requestCode: 0,
    operationType: wantAgent.OperationType.START_ABILITY
  };
  const agent = await wantAgent.getWantAgent(wantAgentInfo);
  // 2. 启动长时定位任务
  await backgroundTaskManager.startBackgroundRunning(
    context,
    backgroundTaskManager.BackgroundMode.LOCATION,
    agent
  );
  // 3. 注册位置监听（每秒回调）
  geoLocationManager.on('locationChange', locationRequest, (location) => {
    console.log(`实时位置：${location.latitude},${location.longitude}`);
    // 此处处理轨迹记录逻辑
  });
}

// 停止定位
function stopTracking() {
  geoLocationManager.off('locationChange'); // 取消监听
  backgroundTaskManager.stopBackgroundRunning(); // 结束长时任务
}

关键注意事项

权限要求：

• 必须申请ohos.permission.LOCATION_IN_BACKGROUND
• 必须申请ohos.permission.KEEP_BACKGROUND_RUNNING
• 用户需在设置中开启 "始终允许"定位权限

设备限制：

• 需引导用户关闭省电模式（如vivo的i管家→允许后台高耗电）
• 测试时避免充电状态（可能绕过省电限制）

性能优化：

// 按需调整定位参数（降低精度可省电）
const batterySaverRequest = {
  priority: geoLocationManager.LocationRequestPriority.ACCURACY,
  timeInterval: 5  // 低功耗时延长间隔
};

状态验证：

• 成功时状态栏显示定位图标
• 通过backgroundTaskManager.getBackgroundRunningStatus()检查任务状态

完整工作流程

graph TD
    A[申请后台定位权限] --> B[配置长时任务类型]
    B --> C[启动BackgroundMode.LOCATION]
    C --> D[注册locationChange监听]
    D --> E[每秒接收高精度定位]
    E --> F[存储轨迹数据]
    F --> G{是否继续？}
    G -- 是 --> E
    G -- 否 --> H[取消监听并结束任务]

此方案满足运动轨迹记录场景需求，实测中需注意：

• 首次使用需手动授予"始终允许"权限
• 华为设备需关闭"电池优化"
• 持续定位会显著增加耗电，建议提供省电模式选项