Flutter中如何用flutter_isolate/isolate_handler从Isolate调用平台代码？

嘿，这个问题我之前踩过坑！本质原因是Flutter的MethodChannel默认只绑定主Isolate，后台Isolate没有直接访问平台通道的权限，所以得通过「主Isolate中转消息」的方式来实现。下面我给你用flutter_isolate和isolate_handler两个库分别写可运行的示例，你可以直接照搬测试。

方案一：使用flutter_isolate实现 #

核心思路 #

后台Isolate通过SendPort给主Isolate发送调用请求 → 主Isolate调用MethodChannel执行平台代码 → 主Isolate把平台返回的结果再通过SendPort发回给后台Isolate。

具体代码实现 #

1. 主Isolate侧代码

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

void main() => runApp(const MyApp());

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  FlutterIsolate? _backgroundIsolate;
  final MethodChannel _platformChannel = const MethodChannel('com.example.platform_channel');
  String _platformResult = '';
  SendPort? _backgroundSendPort;

  // 后台Isolate的入口函数
  static void _backgroundIsolateEntry(SendPort mainSendPort) async {
    // 创建ReceivePort接收主Isolate的返回结果
    final ReceivePort receivePort = ReceivePort();
    mainSendPort.send(receivePort.sendPort);

    // 发送平台调用请求给主Isolate
    mainSendPort.send({
      'action': 'callPlatformMethod',
      'params': {'message': 'Hello from background Isolate!'}
    });

    // 监听主Isolate返回的结果
    await for (final message in receivePort) {
      if (message is Map && message.containsKey('result')) {
        print('后台Isolate收到平台返回结果: ${message['result']}');
        receivePort.close();
      }
    }
  }

  // 启动后台Isolate并建立消息通道
  Future<void> _startBackgroundIsolate() async {
    final ReceivePort mainReceivePort = ReceivePort();
    _backgroundIsolate = await FlutterIsolate.spawn(
      _backgroundIsolateEntry,
      mainReceivePort.sendPort,
    );

    // 监听后台Isolate的消息
    mainReceivePort.listen((message) {
      if (message is SendPort) {
        // 保存后台Isolate的SendPort，用于回传结果
        _backgroundSendPort = message;
      } else if (message is Map && _backgroundSendPort != null) {
        // 处理平台调用请求
        _callPlatformMethod(message, _backgroundSendPort!);
      }
    });
  }

  // 调用平台代码并回传结果给后台Isolate
  Future<void> _callPlatformMethod(Map<String, dynamic> request, SendPort sendPort) async {
    try {
      final String result = await _platformChannel.invokeMethod(
        'getPlatformResponse',
        request['params'],
      );
      setState(() {
        _platformResult = result;
      });
      // 把结果发回给后台Isolate
      sendPort.send({'result': result});
    } on PlatformException catch (e) {
      sendPort.send({'error': e.message});
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Isolate调用平台代码示例')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('主Isolate收到平台结果: $_platformResult'),
              const SizedBox(height: 20),
              ElevatedButton(
                onPressed: _startBackgroundIsolate,
                child: const Text('启动后台Isolate调用平台代码'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  @override
  void dispose() {
    _backgroundIsolate?.kill();
    super.dispose();
  }
}

2. Android平台侧代码（Kotlin）

在MainActivity.kt中添加MethodChannel处理逻辑：

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.platform_channel"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getPlatformResponse") {
                val message = call.argument<String>("message") ?: "No message"
                val platformResponse = "Android平台收到消息: $message"
                result.success(platformResponse)
            } else {
                result.notImplemented()
            }
        }
    }
}

方案二：使用isolate_handler实现 #

这个库封装了Isolate的消息传递逻辑，代码会更简洁，核心思路和方案一一致，只是用库提供的API管理消息。

具体代码实现 #

1. 主Isolate侧代码

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

void main() => runApp(const MyApp());

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final IsolateHandler _isolateHandler = IsolateHandler();
  final MethodChannel _platformChannel = const MethodChannel('com.example.platform_channel');
  String _platformResult = '';

  // 后台Isolate的入口函数
  static void _backgroundIsolateEntry(Map<String, dynamic> context) {
    final messenger = IsolateMessenger(context);
    
    // 发送平台调用请求给主Isolate
    messenger.send({
      'action': 'callPlatformMethod',
      'params': {'message': 'Hello from isolate_handler!'}
    });

    // 监听主Isolate的返回结果
    messenger.listen((message) {
      if (message is Map && message.containsKey('result')) {
        print('后台Isolate收到结果: ${message['result']}');
        messenger.close();
      }
    });
  }

  // 初始化Isolate并设置消息回调
  Future<void> _setupIsolate() async {
    _isolateHandler.spawn(
      _backgroundIsolateEntry,
      name: 'background_isolate',
      onReceive: (message) async {
        // 处理后台Isolate的平台调用请求
        if (message is Map && message['action'] == 'callPlatformMethod') {
          try {
            final String result = await _platformChannel.invokeMethod(
              'getPlatformResponse',
              message['params'],
            );
            setState(() {
              _platformResult = result;
            });
            // 把结果发回给后台Isolate
            _isolateHandler.send('background_isolate', {'result': result});
          } on PlatformException catch (e) {
            _isolateHandler.send('background_isolate', {'error': e.message});
          }
        }
      },
      onInitialized: () {
        print('后台Isolate初始化完成');
      },
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('isolate_handler调用平台代码示例')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('主Isolate收到平台结果: $_platformResult'),
              const SizedBox(height: 20),
              ElevatedButton(
                onPressed: _setupIsolate,
                child: const Text('启动Isolate调用平台代码'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  @override
  void dispose() {
    _isolateHandler.kill('background_isolate');
    super.dispose();
  }
}

2. 平台侧代码

和方案一的Android/Kotlin代码完全一致，无需修改。

关键注意事项 #

• 绝对不要在后台Isolate中直接创建MethodChannel，必须通过主Isolate中转，否则会抛出异常。
• 传递的消息必须是可序列化的类型（比如int、String、Map、List等），不能传递复杂对象。
• 页面销毁时一定要kill掉后台Isolate，避免内存泄漏。

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