Flutter应用后台/被杀死时实现定位服务及Kotlin-Dart桥接咨询

一、Kotlin实现后台周期性定位服务的方案 #

推荐方案：WorkManager + 前台服务 #

Android后台限制严格，普通后台服务易被系统杀死，WorkManager是Google官方推荐的延迟/周期性任务处理组件，即使应用被杀死也能按条件触发任务；配合前台服务可让服务在后台稳定运行（需显示通知，符合Android规范）。

1. 创建定位Worker类
   继承CoroutineWorker，在doWork()中实现定位逻辑：

class LocationWorker(context: Context, params: WorkerParameters) : CoroutineWorker(context, params) {
    private val fusedLocationClient by lazy { LocationServices.getFusedLocationProviderClient(context) }

    override suspend fun doWork(): Result {
        // 检查定位权限
        if (ContextCompat.checkSelfPermission(applicationContext, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            return Result.failure()
        }

        // 获取最新位置
        val location = fusedLocationClient.lastLocation.await()
        location?.let {
            // 传递位置到Dart端（桥接逻辑见下文）
            sendLocationToDart(it.latitude, it.longitude)
        }

        // 返回Result.retry()可重新调度，Result.success()结束任务
        return Result.success()
    }
}

2. 配置周期性任务
   通过MethodChannel从Flutter端触发Kotlin代码，启动WorkManager周期任务：

fun startPeriodicLocationTask() {
    val constraints = Constraints.Builder()
        .setRequiredNetworkType(NetworkType.CONNECTED) // 按需设置网络约束
        .build()

    val periodicRequest = PeriodicWorkRequestBuilder<LocationWorker>(15, TimeUnit.MINUTES) // 系统最小允许15分钟间隔
        .setConstraints(constraints)
        .build()

    WorkManager.getInstance(applicationContext).enqueueUniquePeriodicWork(
        "LocationTask",
        ExistingPeriodicWorkPolicy.REPLACE,
        periodicRequest
    )
}

3. 启用前台服务（推荐）
   Android 8.0+后台服务限制严格，在Worker中启动前台服务可提升稳定性：

private suspend fun startForegroundService() {
    val notification = NotificationCompat.Builder(applicationContext, "LOCATION_CHANNEL")
        .setContentTitle("正在获取位置")
        .setContentText("后台持续定位中")
        .setSmallIcon(R.drawable.ic_location)
        .build()

    // 创建通知渠道（Android 8.0+必填）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = NotificationChannel("LOCATION_CHANNEL", "定位服务", NotificationManager.IMPORTANCE_LOW)
        val notificationManager = applicationContext.getSystemService(NotificationManager::class.java)
        notificationManager.createNotificationChannel(channel)
    }

    setForeground(ForegroundInfo(1001, notification))
}

在doWork()开头调用该方法即可。

二、Kotlin后台服务向Dart传递经纬度 #

使用EventChannel实现持续数据推送（适合后台主动向Dart发送位置更新），比单次调用的MethodChannel更适配周期性场景。

1. Kotlin端配置EventChannel
   在MainActivity中初始化通道，保存EventSink实例供后台服务调用：

class MainActivity : FlutterActivity() {
    private val LOCATION_EVENT_CHANNEL = "com.example.location/event"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        EventChannel(flutterEngine.dartExecutor.binaryMessenger, LOCATION_EVENT_CHANNEL).setStreamHandler(
            object : EventChannel.StreamHandler {
                private var eventSink: EventChannel.EventSink? = null

                override fun onListen(arguments: Any?, sink: EventChannel.EventSink?) {
                    eventSink = sink
                    LocationServiceHelper.eventSink = sink
                }

                override fun onCancel(arguments: Any?) {
                    eventSink = null
                    LocationServiceHelper.eventSink = null
                }
            }
        )
    }
}

// 全局工具类，供后台服务获取EventSink
object LocationServiceHelper {
    var eventSink: EventChannel.EventSink? = null
}

2. 后台服务发送位置数据
   在LocationWorker中实现传递逻辑：

private fun sendLocationToDart(latitude: Double, longitude: Double) {
    LocationServiceHelper.eventSink?.success(mapOf(
        "latitude" to latitude,
        "longitude" to longitude
    ))
}

3. Dart端监听位置数据
   在Flutter页面中监听数据流：

const EventChannel _locationEventChannel = EventChannel('com.example.location/event');

@override
void initState() {
    super.initState();
    _locationEventChannel.receiveBroadcastStream().listen((event) {
        double latitude = event['latitude'];
        double longitude = event['longitude'];
        // 处理获取到的经纬度
        print("收到位置：$latitude, $longitude");
    }, onError: (error) {
        print("位置监听出错：$error");
    });
}

三、AndroidManifest.xml权限与配置 #

需添加以下权限和组件声明：

1. 权限配置

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- Android 10+ 后台定位权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- Android 9+ 前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Android 12+ 定位类前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

2. 组件配置
   注册WorkManager初始化器（若使用WorkManager）：

<application ...>
    <!-- WorkManager初始化器 -->
    <provider
        android:name="androidx.startup.InitializationProvider"
        android:authorities="${applicationId}.androidx-startup"
        android:exported="false"
        tools:node="merge">
        <meta-data
            android:name="androidx.work.WorkManagerInitializer"
            android:value="androidx.startup"
            tools:node="remove" />
    </provider>
    <!-- 自定义前台服务需注册 -->
    <service android:name=".LocationForegroundService" />
</application>

四、桥接问题排查与解决 #

若已有Kotlin定位代码但无法桥接，按以下步骤排查：

• 通道名称一致性：Kotlin与Dart端的EventChannel/MethodChannel名称必须完全匹配（含大小写、路径）。
• FlutterEngine实例有效性：后台服务调用通道时，需确保使用当前活跃的FlutterEngine的binaryMessenger；应用重启后需重新初始化通道。
• 权限检查：必须动态申请定位权限（尤其是后台定位权限），无权限会导致定位逻辑无法执行。
• 连通性测试：先在前台通过MethodChannel调用Kotlin定位方法，确认通道正常后再迁移到后台服务。
• 日志调试：在Kotlin端打印位置获取状态、eventSink调用情况；在Dart端打印监听回调，定位数据流转断点。

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