如何从Workmanager后台任务调用Method Channel

问题原因 #

后台任务运行在独立的Flutter Isolate中，使用的是与前台MainActivity完全不同的FlutterEngine。你之前仅在MainActivity的configureFlutterEngine方法中注册了Method Channel，这个注册仅对前台的FlutterEngine生效，后台任务的FlutterEngine中没有对应的Channel注册，因此调用时会抛出MissingPluginException。

解决方案 #

需要在后台任务使用的FlutterEngine中也完成Method Channel的注册，以下提供两种可行实现方式：

方式一：自定义Worker注册独立Channel #

1. Android端创建自定义Worker

在android/app/src/main/kotlin/nl/myapp/目录下新建CustomWorker.kt：

package nl.myapp

import android.content.Context
import androidx.work.WorkerParameters
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.embedding.engine.FlutterEngineCache
import io.flutter.embedding.engine.dart.DartExecutor
import io.flutter.plugin.common.MethodChannel
import io.flutter.workmanager.FlutterWorker

class CustomWorker(context: Context, params: WorkerParameters) : FlutterWorker(context, params) {
    private val DEVICE_INFO_CHANNEL = "deviceInfo"

    override fun provideFlutterEngine(context: Context): FlutterEngine {
        // 为后台任务创建独立的FlutterEngine并缓存
        val engineId = "background_engine"
        var flutterEngine = FlutterEngineCache.getInstance().get(engineId)
        if (flutterEngine == null) {
            flutterEngine = FlutterEngine(context)
            flutterEngine.dartExecutor.executeDartEntrypoint(
                DartExecutor.DartEntrypoint.createDefault()
            )
            FlutterEngineCache.getInstance().put(engineId, flutterEngine)
        }

        // 注册Method Channel
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, DEVICE_INFO_CHANNEL).setMethodCallHandler { call, result ->
            when (call.method) {
                "getBatteryLevel" -> result.success(100)
                else -> result.notImplemented()
            }
        }

        return flutterEngine
    }
}

2. 配置AndroidManifest.xml

替换原Workmanager相关配置，指定使用自定义Worker：

<manifest ...>
    <application ...>
        <!-- 禁用默认Workmanager初始化 -->
        <provider
            android:name="androidx.work.impl.WorkManagerInitializer"
            android:authorities="${applicationId}.workmanager-init"
            android:enabled="false"
            android:exported="false" />

        <!-- Workmanager广播接收器 -->
        <receiver
            android:name="io.flutter.workmanager.WorkmanagerReceiver"
            android:exported="false">
            <intent-filter>
                <action android:name="androidx.work.impl.background.systemalarm.AlarmManagerScheduler"/>
                <action android:name="androidx.work.impl.background.systemjob.SystemJobScheduler"/>
            </intent-filter>
        </receiver>

        <!-- 注册自定义Worker -->
        <service
            android:name=".CustomWorker"
            android:exported="false"
            android:permission="android.permission.BIND_JOB_SERVICE">
            <intent-filter>
                <action android:name="androidx.work.impl.background.systemjob.SystemJobService"/>
            </intent-filter>
        </service>
    </application>
</manifest>

3. Dart端指定自定义Worker

在初始化Workmanager时，指定自定义Worker的全类名：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  Workmanager().initialize(
    callbackDispatcher,
    isInDebugMode: true,
    workerClassName: "nl.myapp.CustomWorker", // 自定义Worker的全类名
  );
  Workmanager().registerPeriodicTask('uniquename', 'taskName',
    frequency: const Duration(minutes: 15),
    constraints: Constraints(networkType: NetworkType.connected));

  runApp(const MyApp());
}

方式二：全局复用FlutterEngine（推荐） #

这种方式仅注册一次Method Channel，前台和后台任务共用同一个FlutterEngine，更节省系统资源。

1. Android端创建自定义Application类

在android/app/src/main/kotlin/nl/myapp/目录下新建MyApp.kt：

package nl.myapp

import android.app.Application
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.embedding.engine.FlutterEngineCache
import io.flutter.embedding.engine.dart.DartExecutor
import io.flutter.plugin.common.MethodChannel

class MyApp : Application() {
    private val DEVICE_INFO_CHANNEL = "deviceInfo"
    private lateinit var flutterEngine: FlutterEngine

    override fun onCreate() {
        super.onCreate()

        // 创建全局FlutterEngine并执行默认入口
        flutterEngine = FlutterEngine(this)
        flutterEngine.dartExecutor.executeDartEntrypoint(
            DartExecutor.DartEntrypoint.createDefault()
        )

        // 注册Method Channel
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, DEVICE_INFO_CHANNEL).setMethodCallHandler { call, result ->
            when (call.method) {
                "getBatteryLevel" -> result.success(100)
                else -> result.notImplemented()
            }
        }

        // 缓存Engine，供前台和后台使用
        FlutterEngineCache.getInstance().put("shared_engine", flutterEngine)
    }
}

2. 修改AndroidManifest.xml指定Application类

在<application>标签中添加android:name=".MyApp"：

<application
    android:name=".MyApp"
    ...>
    <!-- 其他配置保持不变 -->
</application>

3. 修改MainActivity复用全局Engine

修改MainActivity.kt，使用缓存的全局Engine：

package nl.myapp

import io.flutter.embedding.engine.FlutterEngineCache

class MainActivity : FlutterActivity() {
    override fun provideFlutterEngine(): FlutterEngine? {
        // 返回缓存的全局Engine
        return FlutterEngineCache.getInstance().get("shared_engine")
    }
}

4. （可选）修改CustomWorker复用全局Engine

如果使用自定义Worker，修改CustomWorker.kt：

package nl.myapp

import android.content.Context
import androidx.work.WorkerParameters
import io.flutter.embedding.engine.FlutterEngineCache
import io.flutter.workmanager.FlutterWorker

class CustomWorker(context: Context, params: WorkerParameters) : FlutterWorker(context, params) {
    override fun provideFlutterEngine(context: Context): FlutterEngine {
        return FlutterEngineCache.getInstance().get("shared_engine")!!
    }
}

注意事项 #

• 确保Method Channel的名称在Dart和Android端完全一致（示例中均为deviceInfo）。
• 如果Channel涉及敏感操作，需确保后台任务已获取相应权限（如获取电池信息需android.permission.BATTERY_STATS）。
• 测试后台任务可使用Workmanager调试工具触发，无需等待周期时间。

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