快速上手

先决条件

本指南假设您熟悉 Makepad,并且您已经准备好一个基本的应用程序,以便按照本指南开始集成 Moly Kit。

安装

将 Moly Kit 添加到您的Cargo.toml依赖项中:

1moly-kit = { git = "https://github.com/moly-ai/moly-ai.git", features = ["full"], branch = "main" }
提示

如果想使用稳定版本,请更改branch = "main"为tag = "<具体版本>"

兼容性问题

因为目前 Moly Kit 的贡献比较频繁,你在切换不同版本时,可能会遇到兼容性问题。

建议 makepad widgets 和 moly kit 的版本如下, 使用目前 moly-kit 相同的版本

1makepad-widgets = { git = "https://github.com/wyeworks/makepad", rev = "b8b65f4fa" }
2moly-kit = { git = "https://github.com/moxin-org/moly.git", features = ["full"], branch = "main" }

注册 Moly Kit Widgets

live_register 与任何 Makepad 应用一样,我们需要在应用中使用任何使用 Moly Kit 的小部件之前,先注册我们想要使用的小部件。

1impl LiveRegister for App {
2    fn live_register(cx: &mut Cx) {
3        // 注册Makepad 自带的 widgets
4        makepad_widgets::live_design(cx);
5
6        // !!! 注册Moly Kit的 widgets
7        moly_kit::widgets::live_design(cx);
8
9        // 注册你自定义的 widgets
10        crate::your_amazing_widgets::live_design(cx);
11    }
12}

在 DSL 中使用

1live_design! {
2    use link::theme::*;
3    use link::widgets::*;
4
5    // Add this line
6    use moly_kit::widgets::chat::Chat;
7
8    pub YourAmazingWidget = {{YourAmazingWidget}} {
9        // And this line
10        chat = <Chat> {}
11    }
12}