如何在Android上不依赖flutter_background_service实现Flutter开机启动前台服务

一、需求明确 #

需实现MIT许可兼容的功能：仅在设备重启、应用升级时启动Flutter前台服务，不触发应用主界面，复用现有Flutter isolate和flutter_local_notifications通知逻辑，避免冗余功能与Copyleft依赖。

二、基于MethodChannel的Kotlin+Flutter实现方案 #

1. 配置AndroidManifest权限与组件 #

添加必要权限，注册广播接收器与前台服务：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<!-- 监听开机/应用升级广播 -->
<receiver
    android:name=".BootUpgradeReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <action android:name="android.intent.action.MY_PACKAGE_REPLACED" />
    </intent-filter>
</receiver>

<!-- 自定义前台服务 -->
<service
    android:name=".ForegroundService"
    android:foregroundServiceType="dataSync" /> <!-- 根据业务选择类型：location/mediaPlayback等 -->

2. 编写广播接收器（BootUpgradeReceiver.kt） #

收到广播后启动前台服务，避免拉起应用主界面：

class BootUpgradeReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        val triggerActions = listOf(Intent.ACTION_BOOT_COMPLETED, Intent.ACTION_MY_PACKAGE_REPLACED)
        if (triggerActions.contains(intent.action)) {
            val serviceIntent = Intent(context, ForegroundService::class.java)
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                context.startForegroundService(serviceIntent)
            } else {
                context.startService(serviceIntent)
            }
        }
    }
}

3. 编写前台服务（ForegroundService.kt） #

初始化Flutter引擎，通过MethodChannel调用Dart侧的isolate启动逻辑，同时启动前台通知：

class ForegroundService : Service() {
    private lateinit var flutterEngine: FlutterEngine
    private lateinit var methodChannel: MethodChannel

    override fun onCreate() {
        super.onCreate()
        // 初始化Flutter引擎，不拉起主界面
        flutterEngine = FlutterEngine(this)
        flutterEngine.dartExecutor.executeDartEntrypoint(
            DartExecutor.DartEntrypoint.createDefault()
        )
        // 建立MethodChannel通信通道
        methodChannel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.your.app/foreground_service")
        // 启动前台通知（可复用原生逻辑或调用Flutter侧通知）
        startForegroundNotification()
        // 调用Dart侧启动isolate的方法
        methodChannel.invokeMethod("startForegroundIsolate", null)
    }

    private fun startForegroundNotification() {
        val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        // Android 8.0+ 创建通知渠道
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                "foreground_channel",
                "后台服务通知",
                NotificationManager.IMPORTANCE_LOW
            )
            notificationManager.createNotificationChannel(channel)
        }
        val notification = NotificationCompat.Builder(this, "foreground_channel")
            .setContentTitle("服务运行中")
            .setContentText("后台任务已启动")
            .setSmallIcon(R.drawable.ic_notification)
            .build()
        startForeground(1, notification)
    }

    override fun onBind(intent: Intent): IBinder? = null

    override fun onDestroy() {
        super.onDestroy()
        flutterEngine.destroy()
    }
}

4. Dart侧MethodChannel配置 #

注册通道，接收原生调用并启动现有前台isolate：

import 'package:flutter/services.dart';
import 'dart:isolate';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  // 注册与原生通信的MethodChannel
  const methodChannel = MethodChannel('com.your.app/foreground_service');
  methodChannel.setMethodCallHandler((call) async {
    if (call.method == 'startForegroundIsolate') {
      // 调用已有的前台isolate启动逻辑
      await startMyForegroundIsolate();
    }
  });
  runApp(const MyApp());
}

// 你的现有前台isolate启动逻辑
Future<void> startMyForegroundIsolate() async {
  final receivePort = ReceivePort();
  await Isolate.spawn(foregroundIsolateEntry, receivePort.sendPort);
  // 按需处理isolate通信逻辑
}

void foregroundIsolateEntry(SendPort sendPort) {
  // 这里放置你的前台服务业务代码，包括用flutter_local_notifications显示通知
}

三、许可兼容性说明 #

该方案完全基于原生Android代码与Flutter官方平台通道实现，无第三方Copyleft依赖，可直接用于MIT许可的开源项目。

四、注意事项 #

• Android 12+需指定foregroundServiceType，需与业务场景匹配；
• 需确保应用已获取POST_NOTIFICATIONS权限，否则前台通知无法显示，服务可能被系统终止；
• 部分厂商的后台限制可能需要手动开启应用自启动权限，否则广播可能无法触发。

内容的提问来源于stack exchange，提问作者andrew-e