34个版本 (4个重大更改)
新 0.4.0-alpha.6 | 2024年8月21日 |
---|---|
0.4.0-alpha.3 | 2024年6月26日 |
0.3.0-alpha.1 | 2024年3月27日 |
0.0.1-alpha.5 | 2023年7月4日 |
#909 in GUI
每月248次下载
在 ribir 中使用
1MB
20K SLoC
Ribir - Rust 的无侵入式GUI框架
使用 Rust 从单个代码库构建多平台应用程序。
Ribir 是什么?
Ribir 是一个 Rust GUI 框架,它帮助您从单个代码库构建美观且本地的多平台应用程序。
体验一种基于您数据结构API的直接UI开发方法。任何数据变更都将触发精确的UI更新。您应专注于设计数据结构和其API。然后,您可以描述数据的UI而不会干扰其逻辑。
初探
计数器的简单示例
|
不使用 DSL 使用 Ribir:
use ribir::prelude::*;
fn main() {
let counter = |ctx: &mut BuildCtx| {
let cnt = Stateful::new(0);
let c_cnt = cnt.clone_writer();
let inc_btn = FilledButton::declarer()
.on_tap(move |_| *c_cnt.write() += 1)
.finish(ctx)
.with_child(Label::new("Inc"));
let counter = H1::declarer()
.text(pipe!($cnt.to_string()))
.finish(ctx);
Row::declarer()
.finish(ctx)
.with_child(inc_btn)
.with_child(counter)
.into_widget()
};
App::run(counter);
}
更多 示例
功能
- 声明式语言 它不引入全新的语言。相反,它提供了一组Rust宏,以便更容易地交互。您可以选择是否使用它。
- 小部件组合系统 有四种小部件来支持您,您可以根据不同的方式实现您的小部件
- 函数小部件和
Compose
,从其他小部件的组合。 Render
,实现您的布局并绘制任何您想要的内容。ComposeChild
,控制父小部件和子小部件之间的组合逻辑并指定子小部件的模板。
- 函数小部件和
- 非侵入状态将您的数据转换为可监听状态,并根据状态的变化更新视图。
- 布局系统学习和灵感来源于Flutter的子线性布局,但并非相同。
- 事件系统是一个组合事件系统,支持事件冒泡和捕获。允许与任何小部件组合,并且只有在使用它时才存在。
- 主题系统:支持为子树的各个部分使用不同的主题,并允许在运行时修改主题。
- 绘图器将视图转换为2D路径。
- GPU渲染是绘图器的后端,进行路径细分,以便您可以在任何GPU渲染引擎中轻松渲染三角形。提供了一个wgpu实现作为默认的GPU渲染引擎。细分基于[lyon]。
- 文本支持基本的文本排版和IME输入,处于可使用但粗糙的阶段。
- 小部件库提供了20多个基本小部件,但所有这些都在粗糙阶段,API尚未稳定。
架构概述
支持平台
平台 | 支持情况 |
---|---|
Linux | ✅ |
Windows | ✅ |
macOS | ✅ |
iOS | 🚧 尚未 |
Android | 🚧 尚未 |
Web | ✅ |
Ribir正在积极开发并测试桌面平台,桌面和Web平台已集成到我们的CI/CD流程中。
虽然该框架可以在移动平台上编译和运行,但我们尚未完全测试或为它们调整用户界面。我们计划在核心框架稳定并发布生产就绪的小部件库后,专注于移动支持。
喜欢Ribir吗?
如果您喜欢Ribir,请给我们的repo点一个⭐ STAR ⬆️,并WATCH 👀我们的仓库以了解最新动态!
每一份鼓励和反馈都能支持我们走得更远。
贡献
我们感谢社区为修复错误和改进所做的贡献。
😎 新手Ribir?
通过帮助我们改进文档来了解框架。您可以自由地打开一个新的“文档”问题。我们也非常欢迎
- 指出我们的文档中存在的误解
- 提高测试覆盖率的拉取请求
- 添加未记录的代码(例如内置小部件)
- 报告错别字
有关更多信息,请参阅:
🤔 对某事感到困惑?
请随时前往讨论区并打开一个新的“Q&A”问题以获取贡献者的帮助。通常问题会导致框架的易用性改进、更好的文档,甚至新的功能!
😱 发现了错误?
请报告所有错误!如果感兴趣且有时间,我们很高兴帮助开发者修复他们发现的错误。
谢谢
这个项目之所以存在,是因为所有贡献者
我们还从以下框架中获得了灵感
许可
Ribir遵循MIT许可
依赖关系
~19–36MB
~654K SLoC