Flutter Rust Bridge 中处理复杂枚举类型的技巧

在使用 Flutter Rust Bridge 进行 Rust 与 Dart 的交互时，开发者可能会遇到枚举类型处理的问题。本文将通过一个实际案例，介绍如何解决 Simple 与 Complex 枚举类型不匹配的问题，以及如何处理 trait 对象的跨语言传递。

问题背景

当使用 Flutter Rust Bridge 自动生成代码时，可能会遇到如下错误信息：

assertion `left == right` failed
  left: Simple
 right: Complex

这个错误表明代码生成器在处理枚举类型时遇到了预期与实际不匹配的情况。错误信息没有明确指出具体是哪个类型导致了问题，给调试带来了困难。

调试技巧

要定位具体出问题的类型，可以修改 Flutter Rust Bridge 的源码，在断言失败处打印相关信息。具体来说，可以修改枚举处理相关的代码，打印出当前正在处理的枚举类型定义。

常见问题场景

一个典型的问题场景是尝试通过 Box 传递 trait 对象。例如：

pub trait SdkEventListener: MaybeSend + MaybeSync {
    fn on_event(&self, e: SdkEvent);
}

pub struct BreezSdk {}

impl BreezSdk {
    pub async fn add_event_listener(
        &self,
        listener: Box<dyn SdkEventListener>,
    ) -> AddEventListenerResponse {
        // 实现代码
    }
}

这种情况下，使用 Box 包装的 trait 对象会导致代码生成失败，而改用 Arc 则可以正常工作。

解决方案

方案一：使用包装类型

可以为 trait 对象创建一个包装类型，并标记为 #[frb(opaque)]：

#[frb(opaque)]
pub struct BoxSdkEventListener(Box<dyn SdkEventListener>);

这样 Flutter Rust Bridge 就能正确处理这个类型。

方案二：使用扩展方法

更符合 Flutter 开发习惯的做法是创建一个扩展方法，利用 StreamSink 来实现事件监听：

pub struct BindingEventListener {
    pub listener: StreamSink<SdkEvent>,
}

impl SdkEventListener for BindingEventListener {
    fn on_event(&self, e: SdkEvent) {
        let _ = self.listener.add(e);
    }
}

#[ext]
pub impl BreezSdk {
    async fn frb_override_add_event_listener(
        &self, 
        listener: StreamSink<SdkEvent>
    ) -> AddEventListenerResponse {
        self.add_event_listener(Box::new(BindingEventListener { listener })).await
    }
}

这种方法更加符合 Flutter 的开发模式，通过 StreamSink 实现了事件的跨语言传递。

最佳实践

1. 对于需要在 Dart 和 Rust 之间传递的复杂类型，优先考虑使用 Flutter Rust Bridge 明确支持的类型
2. 当遇到类型不匹配问题时，可以尝试使用包装类型或转换方法
3. 对于事件监听等场景，考虑使用 StreamSink 等 Flutter 原生机制
4. 在调试时，可以临时修改代码生成器的源码以获取更多调试信息

通过理解 Flutter Rust Bridge 的类型处理机制，开发者可以更高效地解决跨语言交互中的类型问题，构建稳定可靠的混合应用。