Flutter Rust Bridge 中的模块化类型扫描优化

在 Flutter Rust Bridge 项目中，类型扫描机制是一个关键功能，它负责将Rust类型转换为对应的Dart代码。本文将深入探讨该项目的类型扫描机制及其优化方向。

当前扫描机制分析

Flutter Rust Bridge 目前主要针对api模块进行全面的类型扫描。这种设计意味着：

• 只有api模块中的类型会被完整扫描
• 其他模块中的类型不会生成对应的Dart字段和方法代码

这种设计类似于将所有功能都集中在"大脑"模块中，虽然能工作，但从软件工程角度看存在一定局限性。

设计优化建议

递归解析方案

建议采用递归解析算法：

1. 从api模块中显式使用的自定义Rust类型开始
2. 递归解析每个类型的字段和参数/返回类型
3. 只要类型是公开的(public)，就继续深入解析

这种方法能确保：

• 类型依赖关系被完整追踪
• 所有必要的类型都能被扫描到
• 保持模块间的清晰边界

配置灵活性增强

建议在配置文件中增加新选项：

• 允许指定多个扫描路径
• 支持通配符模式匹配
• 只生成公开部分的代码

例如配置格式可以是：

rust_input: [
  "src/api/**/*.rs",
  "src/models/**/*.rs",
  "src/utils/**/*.rs"
]

优化带来的优势

1. 更好的模块化：各功能可以按单一职责原则组织
2. 提高可维护性：代码结构更清晰，职责更明确
3. 更完整的代码生成：确保所有必要类型都能正确转换
4. 配置灵活性：用户可以根据项目需求定制扫描范围

实现考量

在实际实现时需要考虑：

• 性能影响：扩大扫描范围可能增加生成时间
• 边界控制：确保只扫描必要的公开类型
• 向后兼容：保持现有配置的兼容性

这种优化已经在Flutter Rust Bridge的dev.38版本中实现，通过支持多输入配置解决了这一问题。开发者现在可以灵活指定多个模块路径，使项目结构更加合理，同时确保所有必要的类型都能被正确扫描和转换。