体验 Ribir

这篇文档将向你介绍如何配置和创建一个 Ribir 应用。

你将了解

• 如何编写和启动一个简单的 Hello world! 应用

安装 Rust

首先, 你需要安装 Rust，你可以参考 Rust 官方文档.

提示

目前 Ribir 只支持 Rust nightly 版本。 你可以使用 rustup override set nightly 切换到 nightly 通道。如果你还没有安装 nightly 通道，可以查看 rustup Channels 文档。

新建 Ribir 项目

然后，打开你的终端，创建一个新的 Rust 项目:

cargo new ribir-hello-world
cd ribir-hello-world

接下来, 编辑 Cargo.toml 文件, 添加 Ribir 作为依赖:

[dependencies]
ribir = "0.2.0-beta.1"

或者直接运行 cargo add --git "https://github.com/RibirX/Ribir" ribir 让 Cargo 为你添加正在开发中的最新 Ribir 版本.

编写 main.rs

打开编辑器, 将 src/main.rs 文件修改为:

// main.rs
use ribir::prelude::*;

fn main() {
  App::run(fn_widget! { @Text { text: "Hello World!" }});
}

运行应用

cargo run

恭喜! 你完成了第一个 Ribir 项目。

运行 Ribir 自带示例

最后，Ribir 仓库中还有一些其他示例，你可以克隆 Git 仓库:

git clone git@github.com:RibirX/Ribir.git
cd Ribir/Ribir

并使用以下命令之一运行示例:

cargo run -p counter
cargo run -p storybook
cargo run -p messages
cargo run -p todos

下一步

如果你更喜欢直接使用函数调用来构建 UI，而不是通过 "DSL"，在进入下一步之前，你可能会想先看看 如何在不使用 "DSL" 的情况下使用 Ribir。