快速开始
IriX 采用 Flutter（UI）+ Rust（底层）双栈开发。开始开发前，请确保环境满足要求。
| 依赖 | 要求 | 说明 |
|---|---|---|
| Flutter | 3.x | 跨平台 UI 框架 |
| Dart SDK | >= 3.12 | 随 Flutter 分发 |
| Rust toolchain | stable | 编译底层 crate |
| 平台工具链 | Windows / Linux / macOS | 见打包与发布 |
第一步：编译 Rust FFI 库
Section titled “第一步：编译 Rust FFI 库”Rust 动态库是应用运行与测试的前置条件：
# Windows：可直接双击 build_rust.bat，或命令行执行cargo build --release --manifest-path rust/Cargo.toml
# Linux / macOS./build_rust.sh编译完成后，脚本会把动态库（xmc_*.dll / xmc_*.so / xmc_*.dylib）复制到对应平台目录（Windows windows/runner/、Linux linux/、macOS macos/），并额外复制一份到项目根目录供集成测试使用。
第二步：安装 Dart 依赖
Section titled “第二步：安装 Dart 依赖”flutter pub get第三步：运行应用
Section titled “第三步：运行应用”flutter run验证开发环境
Section titled “验证开发环境”flutter analyze # 静态分析flutter test # 运行全部测试（FFI 集成测试需要第一步的动态库）flutter build windows --releaseflutter build linux --release # 需先 ./build_rust.shflutter build macos --release # 需先 ./build_rust.sh各平台构建的前置条件与 CI 流水线见打包与发布。
- 了解架构总览：Flutter 与 Rust 如何协作
- 掌握 Rust FFI 与编译 的流程与约定
- 查阅关键约定，避免踩坑