配置

YAML 文件

你可以通过配置 pubspec.yaml 文件来自定义 Rinf CLI 命令的行为。所有字段都是可选的,不必全部填写。

pubspec.yaml
rinf:
  gen_input_crates:
    - hub
  gen_output_dir: lib/src/bindings
  • gen_input_crates: native 文件夹下的 crate 名称列表。rinf gen 命令将在此列表中指定的 crate 中搜索信号结构体。每个 crate 应直接位于 native 文件夹下。

  • gen_output_dir: rinf gen 命令生成的 Dart 代码所放置的目录。

你可以通过在命令行中运行以下命令来查看当前的配置状态。

CLI
rinf config

Crate Features

通过 Rinf crate 的特性(features),可以对其行为进行自定义。

native/hub/Cargo.toml
rinf = { version = "0.0.0", features = ["feature-name"] }
  • show-backtrace: 在调试模式下发生 panic 时,在命令行中打印完整的回溯信息(backtrace)。通常,在调试异步应用时回溯信息帮助不大,因此建议使用 tracing 进行日志记录。注意,此特性不会影响 Web 平台上的调试。

  • bevy: 为 DartSignalPack 实现 bevy_ecs 中的 Event trait,使 Bevy 的实体组件系统能够监听来自 Dart 的事件。此特性目前处于高度实验阶段,不建议在生产环境中使用。