# `Rust Constructor V2`
## 基于`egui`构建的跨平台`GUI`框架, 同时兼容`bevy`, 用`Rust`开发`GUI`项目最简单的方式
[](https://github.com/ChepleBob30)
[](https://www.rust-lang.org/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/ChepleBob30/Rust-Constructor/releases)
---
## 目录
- [版本更新信息](#版本更新信息)
- [概述](#概述)
- [快速上手](#快速上手)
- [创造Rust Constructor的目的](#创造rust-constructor的目的)
- [常见问题](#常见问题)
- [许可证](#许可证)
- [尾声](#尾声)
---
## 版本更新信息
- 当前版本为`v2.11.3 兼容大更新`。
- 本更新添加了对`bevy`的兼容，现在你可以通过`bevy_egui`在`bevy`中使用`Rust Constructor`了！
- **实用改动**
- 添加`standard feature`，启用后与以前的`Rust Constructor`相同；
- 添加`bevy feature`，启用即可在`bevy`中使用`Rust Constructor`(需要注意的是，两个`feature`不能同时启用)；
- 添加`ctx_adapter`，用于兼容不同版本`egui`的特性；
- 改进了部分代码。
- **破坏性改动**
- 移除了对`epaint`的依赖，改为直接从`egui`内部调用；
- 移除了其他依赖项默认的`feature`，并且添加了对`bevy_asset`和`bevy_reflect`的依赖；
- 对部分内容进行了修改。
---
## 概述
- `Rust Constructor`是一个功能全面的GUI框架，它利用了`egui`的强大功能，为构建跨平台应用程序提供了一个简单直观的工具。
- 基于`bevy_egui`，`Rust Constructor`还与`bevy`兼容，你可以直接在`bevy`中使用它。
- `Rust Constructor`当然不是完美的，目前它还存在编写逻辑糟糕，使用方法混乱等问题，我会尽力解决这些问题。
---
## 快速上手
- 若想引入`Rust Constructor`，请添加`rust_constructor = "x.y.z"`(请根据需要自行替换xyz)到`toml`中。
- 如果想要启动`App`并进行一些简单的操作，建议查阅[egui的官方文档](https://github.com/emilk/egui)。
- 你可以参考`Rust Constructor`的官方教程（不一定与时俱进）[Rust Constructor 指南](https://github.com/ChepleBob30/Rust-Constructor-Guide)。
- 以下是一个简单的示例：
```rust
pub struct RcApp {
pub inner: rust_constructor::app::App,
}
impl eframe::App for RcApp {
fn ui(&mut self, ui: &mut egui::Ui, _frame: &mut eframe::Frame) {
egui::CentralPanel::default().show_inside(ui, |ui| {
ui.label("Hello world");
});
}
}
eframe::run_native(
"Example App",
eframe::NativeOptions::default(),
Box::new(|_| {
Ok(Box::new(RcApp {
inner: rust_constructor::app::App::default(),
}))
}),
)
.unwrap();
```
---
## 创造Rust Constructor的目的
- 在实际开发过程中，我们往往需要考虑不同屏幕尺寸下的排版以及资源呈现方式，但是`egui`自带的组件大部分情况下只适用于无需精细打磨的快捷开发，并不能满足我的需求。因此，我开发了`Rust Constructor`。
---
## 常见问题
- Q1: `Rust Constructor`支持哪些平台？
- A1: `macOS`和`Windows`已确认完全支持，其他平台视`egui`支持情况而定。
- Q2: 为什么`Rust Constructor`在`crates.io`上只有`V2`？
- A2: `Rust Constructor V0`和`Rust Constructor V1`本质上是一个臃肿的项目，有很多冗余的功能和无意义的代码，所以并未发布。
- Q3: `Rust Constructor`与`egui`有什么关系？
- A3: `Rust Constructor`基于`egui`开发，但双方开发人员之间没有任何关系。
- Q4: 遇到新的资源不知道如何处理该怎么办？
- A4: 请先用`add_resource`或`quick_place`添加它，然后翻阅源代码查找与该资源有关的方法并尝试使用。
- Q5: 有了`Rust Constructor`是否就意味着可以完全抛弃`egui`了？
- A5: 恰恰相反。在调试过程中，`Rust Constructor`的笨重劣势正需要`egui`的组件来弥补。
- Q6: 什么是`discern_type`？
- A6: `discern_type`是一个用于标记资源类型的字符串，它会在添加资源时被自动创建，名称和你使用的资源名相同。
- Q7: 能否不使用`Rust Constructor`的组件进行开发？
- A7: 当然可以。不过`Rust Constructor`的高级前端资源的确提供了一些实用功能，他们不一定能被替代。
- Q8: 如何查看`Rust Constructor`的官方文档？
- A8: 你现在看到的就是最核心的文档内容。如果还有问题，请查看[`Rust Constructor 指南`](https://github.com/ChepleBob30/Rust-Constructor-Guide)。这是`Rust Constructor`的官方教程，但不一定与时俱进。
- Q9: `Rust Constructor`以什么形式开源？如何做贡献？
- A9: `Rust Constructor`的源代码以`MIT`许可证开源。由于个人原因，我不推荐为此项目做贡献。如果你有什么想法，请选择fork本项目并自行维护。
- Q10: 我还是有问题没解决，怎么办？
- A10: 请在本项目仓库提[`issue`](https://github.com/ChepleBob30/Rust-Constructor/issues)，我会尽力解决所有问题。
---
## 许可证
[MIT](./LICENSE-MIT) © 2026 ChepleBob
## 尾声
如果你喜欢这个项目，请在`GitHub`上给我点个`star`。你也可以加入我们的组织[必达](https://github.com/Binder-organize)。