首页
/ Flutter与Rust交互:异步回调的实现详解

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

2025-06-12 16:43:35作者:郜逊炳

在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优势。

登录后查看全文
热门项目推荐