如何实现Flutter应用后台持续运行的不可终止用户位置上传服务

针对你需要的后台持续上传位置、服务不可被轻易终止、显示活跃通知的需求，WorkManager的周期性任务不适用，得用**前台服务（Android）+ 后台定位权限（iOS）**的方案，具体实现如下：

Android 端实现 #

1. 权限与配置 #

在android/app/src/main/AndroidManifest.xml中添加必要权限和服务声明：

<!-- 定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 12+ 所需 -->

<!-- 声明前台服务 -->
<service android:name=".LocationUploadService" android:foregroundServiceType="location" />

2. 编写前台服务类 #

创建LocationUploadService.kt（或Java）继承Service，实现前台服务逻辑：

class LocationUploadService : Service() {
    private val CHANNEL_ID = "LOCATION_UPLOAD_CHANNEL"
    private val NOTIFICATION_ID = 1001

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // 创建通知渠道（Android 8.0+ 必需）
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                CHANNEL_ID,
                "位置上传服务",
                NotificationManager.IMPORTANCE_LOW
            )
            val manager = getSystemService(NotificationManager::class.java)
            manager.createNotificationChannel(channel)
        }

        // 构建前台通知
        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
            .setContentTitle("位置上传中")
            .setContentText("应用正在后台持续上传位置")
            .setSmallIcon(R.drawable.ic_notification)
            .setPriority(NotificationCompat.PRIORITY_LOW)
            .build()

        // 启动前台服务
        startForeground(NOTIFICATION_ID, notification)

        // 在这里启动位置监听与上传逻辑（可通过MethodChannel与Flutter通信）
        startLocationUpload()

        // 返回START_STICKY，确保服务被杀死后系统尝试重启
        return START_STICKY
    }

    private fun startLocationUpload() {
        // 这里可以调用Flutter的位置上传逻辑，或直接在原生实现上传
        // 示例：定时获取位置并上传
        val handler = Handler(Looper.getMainLooper())
        handler.postDelayed(object : Runnable {
            override fun run() {
                // 获取位置、上传到服务器的逻辑
                handler.postDelayed(this, 5000) // 每5秒执行一次
            }
        }, 0)
    }

    override fun onBind(intent: Intent?): IBinder? {
        return null
    }
}

Flutter 端实现 #

1. 调用原生服务 #

通过MethodChannel启动/停止前台服务：

import 'package:flutter/services.dart';

class LocationServiceManager {
  static const MethodChannel _channel = MethodChannel('location_upload_service');

  static Future<void> startService() async {
    try {
      await _channel.invokeMethod('startService');
    } on PlatformException catch (e) {
      print("启动服务失败: ${e.message}");
    }
  }

  static Future<void> stopService() async {
    try {
      await _channel.invokeMethod('stopService');
    } on PlatformException catch (e) {
      print("停止服务失败: ${e.message}");
    }
  }
}

在Android的MainActivity中注册MethodChannel：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "location_upload_service"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            when (call.method) {
                "startService" -> {
                    val intent = Intent(this, LocationUploadService::class.java)
                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                        startForegroundService(intent)
                    } else {
                        startService(intent)
                    }
                    result.success(null)
                }
                "stopService" -> {
                    val intent = Intent(this, LocationUploadService::class.java)
                    stopService(intent)
                    result.success(null)
                }
                else -> result.notImplemented()
            }
        }
    }
}

2. 位置获取与上传 #

使用geolocator插件获取位置，然后持续上传：

import 'package:geolocator/geolocator.dart';

Future<void> uploadLocation() async {
  // 检查定位权限
  LocationPermission permission = await Geolocator.checkPermission();
  if (permission == LocationPermission.denied) {
    permission = await Geolocator.requestPermission();
    if (permission != LocationPermission.whileInUse && permission != LocationPermission.always) {
      return;
    }
  }

  // 持续监听位置变化
  Geolocator.getPositionStream(
    locationSettings: LocationSettings(
      accuracy: LocationAccuracy.high,
      distanceFilter: 10, // 移动10米更新一次
    )
  ).listen((Position position) {
    // 上传位置到服务器
    sendLocationToServer(position.latitude, position.longitude);
  });
}

Future<void> sendLocationToServer(double lat, double lon) async {
  // 这里实现HTTP请求上传位置的逻辑
  // 示例：
  // final response = await http.post(
  //   Uri.parse("https://your-server.com/upload-location"),
  //   body: {"lat": lat.toString(), "lon": lon.toString()},
  // );
}

iOS 端配置 #

1. Info.plist 配置 #

添加定位权限和后台模式：

<!-- 定位权限描述 -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取您的位置以提供服务</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要在后台持续获取您的位置</string>
<!-- 后台模式 -->
<key>UIBackgroundModes</key>
<array>
  <string>location</string>
</array>

2. 权限申请 #

在Flutter中申请always权限，确保后台能获取位置：

await Geolocator.requestPermission();

关键注意事项 #

• Android端：前台服务必须显示通知，且服务返回START_STICKY，即使应用从任务列表清除，服务仍会保持运行（除非系统资源极度紧张）。
• iOS端：苹果对后台定位审核严格，需确保功能是用户必需的，避免被拒。
• 电池优化：需引导用户关闭应用的电池优化，否则系统可能会限制后台运行。

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