Flutter与Rust交互：异步回调的实现详解

在Flutter与Rust混合开发中，异步回调是一个常见且重要的需求。本文将深入探讨如何在Flutter项目中通过flutter_rust_bridge实现Rust调用Dart函数的完整流程。

基本原理

flutter_rust_bridge提供了跨语言异步调用的能力，允许Rust代码调用Dart函数并等待其返回结果。这种机制基于Future和async/await模式，实现了无缝的异步交互。

Rust端实现

在Rust代码中，我们需要定义一个异步函数，该函数接收一个Dart回调作为参数：

use std::future::Future;
use std::pin::Pin;
use flutter_rust_bridge::DartFnFuture;

pub async fn rust_function(dart_callback: impl Fn(String) -> DartFnFuture<String>) {
    let result = dart_callback("Tom".to_owned()).await;
    println!("Received from Dart: {}", result);
}

关键点说明：

1. DartFnFuture是flutter_rust_bridge提供的特殊类型，表示一个将返回Future的Dart函数
2. 使用impl Fn语法可以接收任何符合签名的闭包或函数
3. 通过.await等待Dart函数的异步执行完成

Dart端实现

在Flutter/Dart端，我们需要提供一个符合签名的回调函数：

Future<String> handleRustCallback(String name) async {
  print('Received from Rust: $name');
  return 'Hello, $name from Dart!';
}

void initialize() async {
  await rust_agent_api.rustFunction(dartCallback: handleRustCallback);
}

或者使用匿名函数：

void initialize() async {
  await rust_agent_api.rustFunction(
    dartCallback: (name) async => 'Hello, $name from Dart!'
  );
}

高级用法

条件性回调

在实际开发中，我们可能需要根据条件选择不同的回调函数：

Future<String> callbackA(String name) => ...;
Future<String> callbackB(String name) => ...;

void initialize(bool useA) async {
  final callback = useA ? callbackA : callbackB;
  await rust_agent_api.rustFunction(dartCallback: callback);
}

错误处理

完善的错误处理机制是必不可少的：

pub async fn rust_function(dart_callback: impl Fn(String) -> DartFnFuture<String>) -> Result<(), String> {
    match dart_callback("Tom".to_owned()).await {
        Ok(result) => println!("Success: {}", result),
        Err(e) => println!("Error: {}", e),
    }
    Ok(())
}

Future<String> handleCallback(String name) async {
  try {
    // 业务逻辑
    return 'Success';
  } catch (e) {
    throw 'Error occurred: $e';
  }
}

性能考虑

1. 跨语言调用有一定开销，应避免高频的小回调
2. 大数据传递考虑使用共享内存或流式处理
3. 复杂对象序列化/反序列化可能成为瓶颈

实际应用场景

这种回调机制非常适合以下场景：

• Rust计算完成后通知Flutter更新UI
• Flutter提供用户输入或配置给Rust
• 跨语言的状态同步
• 长耗时任务的进度报告

通过flutter_rust_bridge的回调机制，我们可以构建高效、响应式的跨语言应用，充分发挥Rust的性能优势和Flutter的UI优势。