跳到正文
QuickGUI

入门

#系统要求

  • macOS 14 或更新版本
  • Rust 1.90 或更新版本
  • Bun 1.4 或更新版本
  • Xcode Command Line Tools（xcode-select --install）

当前支持的目标平台是 macOS。

#创建项目

bunx @quickgui/cli init my-app --language rust
cd my-app
quickgui dev

init 会写入项目并安装依赖。省略 --language 可以交互选择 Go、TypeScript 或 Rust。

#第一个窗口

生成的 src/main.rs 会打开窗口。把状态保存在 View 上，修改后调用 cx.invalidate()。

use quickgui::{
    App, AppInfo, Application, Color, EventContext, IntoElement, View, ViewContext, WindowOptions,
    div, text,
};

fn main() -> Result<(), quickgui::AppError> {
    Application::new()
        .app_info(AppInfo::new("My App", "0.1.0", "com.example.my-app").expect("valid identity"))
        .on_reopen(|has_visible_windows, cx| {
            if !has_visible_windows {
                open_window(cx);
            }
        })
        .run(open_window)
}

fn open_window(cx: &mut App) {
    cx.open_window(WindowOptions::new("My App").size(760.0, 520.0), Counter { count: 0 });
}

struct Counter {
    count: usize,
}

impl View for Counter {
    fn render(&mut self, cx: &mut ViewContext<'_, Self>) -> impl IntoElement {
        let increment = cx.listener("increment", |this, cx: &mut EventContext| {
            this.count += 1;
            cx.invalidate();
        });
        div()
            .size_full()
            .flex_col()
            .items_center()
            .justify_center()
            .gap_3()
            .child(text(format!("Count: {}", self.count)))
            .child(
                div()
                    .on_click(increment)
                    .px_4()
                    .py_2()
                    .rounded_lg()
                    .bg(Color::rgb8(37, 99, 235))
                    .child("Increment"),
            )
    }
}

当用户点击 Dock 图标且没有可见窗口时，on_reopen 会再次打开窗口。

#运行与构建

quickgui check
quickgui test
quickgui fmt
quickgui dev
quickgui build

dev 会在你编辑时重新构建。build 把打包后的应用写到 dist/。

#后续步骤