#3.1 获取并编译小飞机工程

本章使用的 dora 小飞机是一个现成的 Rust 工程，托管在 GitHub 上。它包含三个可执行程序，分别对应独立键盘版、DORA 控制器节点和 DORA 小飞机节点。

#学习目标

学完本节，你将能够：

• 从 GitHub 克隆一个 Rust 工程
• 使用 Rust 特性标记（--features dora）编译指定功能的二进制文件
• 理解三个二进制各自的作用

#第一步：克隆仓库

在终端中执行：

git clone https://github.com/DoraCN/aviation.git
cd aviation

git clone https://atomgit.com/DoraCN/aviation.git
cd aviation

克隆完成后，aviation/ 目录下有以下关键文件：

aviation/
├── Cargo.toml          # Rust 项目配置与依赖声明
├── Cargo.lock          # 依赖版本锁定
├── dataflow.yml        # DORA 数据流配置文件（本章核心）
├── .gitignore
├── README.md
├── README.zh.md
├── assets/             # 图片和字体资源
└── src/
    ├── main.rs                    # 独立键盘版入口
    ├── lib.rs                     # 共享逻辑（组件、运动系统）
    └── bin/
        ├── aviation-dora.rs       # DORA 小飞机节点入口
        └── aviation-controller.rs # DORA 控制器节点入口

#第二步：编译

小飞机工程提供三个二进制（bin）：

本章需要编译的是带 dora 特性的两个节点，执行：

cargo build --release --features dora --bins

这条命令的含义：

• cargo build --release：以 release（发布）模式编译，产物更小、运行更快
• --features dora：启用 dora 特性，编译 aviation-dora 和 aviation-controller
• --bins：编译项目中所有的二进制（bin），产出三个可执行文件

#查看编译产物

编译完成后，产物在 target/release/ 目录下：

ls -lh target/release/aviation*

应看到三个可执行文件：

-rwxr-xr-x  target/release/aviation
-rwxr-xr-x  target/release/aviation-controller
-rwxr-xr-x  target/release/aviation-dora

如果 aviation-controller 和 aviation-dora 存在，说明编译成功。

#三个二进制的关系

• aviation（独立键盘版）：直接键盘控制，不依赖 DORA——适合快速体验和调试。
• aviation-controller + aviation-dora（DORA 数据流版）：通过 DORA 数据流通信，分别启动，靠 dataflow.yml 连接——这是真正的 DORA 使用方式。

#独立键盘版试玩（可选）

前面编译时已经生成了独立键盘版的 release 二进制，直接运行即可：

./target/release/aviation

.\target\release\aviation.exe

会弹出一个标题为"航空模拟器"的窗口。使用 W/A/S/D 或方向键控制小飞机飞行。这是验证你的机器能正常显示 Bevy 窗口的好方法。

按 Ctrl+C 停止（或在终端按 Ctrl+C 结束进程）。

#小结

• 从 GitHub 或 AtomGit 克隆了 aviation 工程。
• cargo build --release --features dora --bins 编译了三个二进制。
• aviation-controller 和 aviation-dora 是接下来要通过 DORA 运行的节点。
• 独立键盘版 aviation 可用于验证图形环境正常。

编译完成，下一步就是：3.2 dora run 跑起来。