Ionic Cordova/Angular后台定位插件适配Android新版本问题求助

问题场景 #

开发的Ionic Cordova/Angular应用需实现：用户发起求助时持续发送地理位置，求助响应后停止定位。当前遇到以下问题：

• 前台状态下可正常向API发送位置，但后台状态下仅发送最后一次定位数据，切回前台才更新，该问题由Android新版本安全限制导致
• 尝试安装另一插件变体时，系统无法识别安装，还因AndroidManifest信息重复导致应用崩溃
• 原插件自2019年起未更新，无法适配Android新版本的权限与后台机制

解决方案 #

1. 调整现有插件配置适配Android权限与后台机制 #

Android 12+对后台定位有严格限制，需做好以下适配：

• 申请后台定位权限：在config.xml中添加权限声明，并在代码中动态请求ACCESS_BACKGROUND_LOCATION权限
• 优化定位参数：后台模式下避免过高的定位频率，将interval调整至30000ms（30秒）以上，同时合理设置distanceFilter与stationaryRadius，减少系统对定位服务的限制
• 启用前台服务：配置插件的Android通知参数，将定位服务设为前台服务，确保后台状态下服务不被系统回收

2. 替换为维护活跃的替代插件 #

选用适配Android 12+的活跃维护插件（如cordova-plugin-background-geolocation-lt），该插件支持最新的后台定位权限模型，能稳定处理后台定位任务。安装后通过@awesome-cordova-plugins对应的包集成到Angular项目，配置时需明确开启后台权限与前台服务通知。

3. 自定义原生插件扩展 #

若现有插件均无法满足需求，可编写自定义Android原生插件：

• 基于FusedLocationProviderClient实现后台定位服务，继承Service确保后台存活
• 通过Cordova桥接机制将定位数据传递至Angular层
• 自行处理权限请求与系统适配逻辑，完全可控定位行为

4. 优化定位逻辑 #

• 求助响应后立即调用插件的stop()方法停止定位，释放系统资源
• 后台定位优先采用“距离触发”而非“定时触发”，结合distanceFilter参数，仅当用户移动超过设定距离时才发送位置数据，降低后台资源消耗

调整后的代码示例 #

import { BackgroundGeolocation, BackgroundGeolocationConfig, BackgroundGeolocationEvents, BackgroundGeolocationResponse } from '@awesome-cordova-plugins/background-geolocation/ngx';
import { AndroidPermissions } from '@awesome-cordova-plugins/android-permissions/ngx';

constructor(
  private androidPermissions: AndroidPermissions,
  private backgroundGeolocation: BackgroundGeolocation
) {}

async initHelpLocationTracking() {
  // 先请求后台定位权限
  const permissionResult = await this.androidPermissions.requestPermission(
    this.androidPermissions.PERMISSION.ACCESS_BACKGROUND_LOCATION
  );

  if (!permissionResult.hasPermission) {
    // 处理权限拒绝逻辑
    return;
  }

  const config: BackgroundGeolocationConfig = {
    desiredAccuracy: 10,
    stationaryRadius: 50,
    distanceFilter: 50,
    stopOnStillActivity: false,
    interval: 30000, // 后台定位建议30秒间隔
    fastestInterval: 15000,
    debug: false,
    stopOnTerminate: false,
    android: {
      notificationTitle: '求助定位',
      notificationText: '正在持续发送您的位置信息',
      foregroundService: true,
      backgroundPermissionRationale: {
        title: '需要后台定位权限',
        message: '为了在您求助时持续发送位置，请允许后台定位权限'
      }
    }
  };

  this.backgroundGeolocation.configure(config).then(() => {
    this.backgroundGeolocation.on(BackgroundGeolocationEvents.location).subscribe((location: BackgroundGeolocationResponse) => {
      this.localizacao = location;
      // 执行向API发送位置的逻辑
    });
  });
}

// 求助响应后停止定位
stopHelpLocationTracking() {
  this.backgroundGeolocation.stop();
}

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