Flutter iOS周期性后台任务求助：定时定位上报需求

一、符合需求的Flutter包 #

• background_locator：专注后台定位场景，支持iOS和Android的周期性后台任务，可在应用后台/终止状态下触发定位并配置上报间隔，iOS端需申请always定位权限，需遵循系统后台策略。
• geolocator + flutter_background_service：组合方案，geolocator负责位置获取，flutter_background_service管理后台服务，iOS端需配置后台模式实现周期性任务，注意系统电池优化可能调整实际执行间隔。

二、Swift原生完整代码（集成Method Channel） #

1. 配置iOS后台权限 #

在Info.plist中添加以下配置：

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要持续获取位置以完成后台上报</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取位置信息</string>
<key>UIBackgroundModes</key>
<array>
    <string>location</string>
</array>

2. Swift原生代码（AppDelegate.swift） #

import UIKit
import Flutter
import CoreLocation

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate, CLLocationManagerDelegate {
    private let locationChannel = FlutterMethodChannel(name: "com.example/location_background", binaryMessenger: UIApplication.shared.delegate as! FlutterBinaryMessenger)
    private var locationManager: CLLocationManager!
    private var timer: Timer?
    private let intervalMinutes: TimeInterval = 15
    
    override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        GeneratedPluginRegistrant.register(with: self)
        
        // 初始化定位管理器
        locationManager = CLLocationManager()
        locationManager.delegate = self
        locationManager.desiredAccuracy = kCLLocationAccuracyThreeKilometers
        locationManager.allowsBackgroundLocationUpdates = true
        locationManager.pausesLocationUpdatesAutomatically = false
        
        // 请求Always权限
        locationManager.requestAlwaysAuthorization()
        
        // 监听Flutter侧方法调用
        locationChannel.setMethodCallHandler { [weak self] call, result in
            switch call.method {
            case "startBackgroundTask":
                self?.startPeriodicLocationTask()
                result(true)
            case "stopBackgroundTask":
                self?.stopPeriodicLocationTask()
                result(true)
            default:
                result(FlutterMethodNotImplemented)
            }
        }
        
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
    
    // 启动周期性定位上报任务
    private func startPeriodicLocationTask() {
        // 立即执行一次定位上报
        getCurrentLocationAndUpload()
        // 启动定时器，每15分钟触发一次
        timer?.invalidate()
        timer = Timer.scheduledTimer(withTimeInterval: intervalMinutes * 60, repeats: true) { [weak self] _ in
            self?.getCurrentLocationAndUpload()
        }
        // 申请后台任务时长，避免应用被系统挂起
        UIApplication.shared.beginBackgroundTask(withName: "LocationUploadTask", expirationHandler: nil)
    }
    
    // 停止后台任务
    private func stopPeriodicLocationTask() {
        timer?.invalidate()
        timer = nil
        locationManager.stopUpdatingLocation()
    }
    
    // 获取当前位置并上报服务器
    private func getCurrentLocationAndUpload() {
        locationManager.startUpdatingLocation()
    }
    
    // 定位更新回调
    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        guard let location = locations.last else { return }
        manager.stopUpdatingLocation()
        
        // 构造上报数据
        let locationData = [
            "latitude": location.coordinate.latitude,
            "longitude": location.coordinate.longitude,
            "timestamp": location.timestamp.timeIntervalSince1970
        ]
        
        // 发送上报请求（替换为你的服务器接口）
        guard let url = URL(string: "https://your-server-domain.com/upload-location") else { return }
        var request = URLRequest(url: url)
        request.httpMethod = "POST"
        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
        request.httpBody = try? JSONSerialization.data(withJSONObject: locationData)
        
        let task = URLSession.shared.dataTask(with: request) { data, response, error in
            if let error = error {
                print("位置上报失败：\(error.localizedDescription)")
                return
            }
            print("位置上报成功")
        }
        task.resume()
    }
    
    // 定位权限变更回调
    func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
        switch status {
        case .authorizedAlways:
            // 权限获取完成，可正常执行后台任务
            break
        default:
            print("定位权限不足，无法执行后台任务")
        }
    }
}

3. Flutter端调用示例 #

import 'package:flutter/services.dart';

class BackgroundLocationService {
  static const MethodChannel _channel = MethodChannel('com.example/location_background');

  static Future<bool> startBackgroundTask() async {
    try {
      return await _channel.invokeMethod('startBackgroundTask');
    } on PlatformException catch (e) {
      print("启动后台任务失败：${e.message}");
      return false;
    }
  }

  static Future<bool> stopBackgroundTask() async {
    try {
      return await _channel.invokeMethod('stopBackgroundTask');
    } on PlatformException catch (e) {
      print("停止后台任务失败：${e.message}");
      return false;
    }
  }
}

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