Rust在Linux上的图形界面开发指南

Rust 在 Linux 上的图形界面开发指南

一 环境准备与工具链

• 安装 Rust 工具链：使用 rustup 安装并更新 cargo、rustc。完成后执行 cargo --version 与 rustc --version 校验环境。
• 选择 IDE：推荐使用 VS Code + Rust 扩展 + CodeLLDB 或 CLion + Rust 插件，便于构建、调试与代码提示。
• 安装系统依赖：Linux 上图形开发通常需要 GTK 3/4 开发库（见下文各框架的依赖说明）。
• 验证依赖：安装后可用 pkg-config --modversion gtk+-3.0（或 gtk4）检查版本；运行 cargo build 确认能拉取与编译依赖。

二 框架选择与适配场景

三 快速上手示例

• GTK 4 最小窗口（使用 Application API）

// Cargo.toml
// [dependencies]
// gtk = { version = "0.X", package = "gtk4" }

use gtk::prelude::*;
use gtk::{Application, ApplicationWindow, Button};

fn main() {
    let app = Application::new(
        Some("com.example.HelloGtk"),
        Default::default(),
    );
    app.connect_activate(|app| {
        let window = ApplicationWindow::new(app);
        window.set_title("Hello GTK 4");
        window.set_default_size(300, 200);

        let button = Button::with_label("Click me!");
        button.connect_clicked(|_| {
            println!("Button was clicked!");
        });

        window.set_child(Some(&button));
        window.show();
    });
    app.run();
}

• Iced 最小应用（Elm 架构）

// Cargo.toml
// [dependencies]
// iced = "0.12"

use iced::{Button, Column, Element, Text, Sandbox, Command};

struct App;

impl Sandbox for App {
    type Message = ();

    fn new() -> Self { App }
    fn title(&self) -> String { "Iced".into() }
    fn update(&mut self, _message: ()) -> Command<Self::Message> { Command::none() }
    fn view(&self) -> Element<Self::Message> {
        Column::new()
            .push(Text::new("Hello, Iced!").size(32))
            .push(Button::new("Click me", |_| ()))
            .into()
    }
}

fn main() { iced::run(App).unwrap(); }

• Druid 最小窗口（数据驱动）

// Cargo.toml
// [dependencies]
// druid = "0.8"

use druid::{AppLauncher, LocalizedString, Widget, WindowDesc, Label};

fn build_ui() -> impl Widget<()> {
    Label::new("Hello, Druid!").center()
}

fn main() -> Result<(), druid::PlatformError> {
    let main_window = WindowDesc::new(build_ui)
        .title(LocalizedString::new("hello-druid").with_placeholder("Hello World"));
    AppLauncher::with_window(main_window).launch(())?;
    Ok(())
}

以上示例覆盖了 GTK 4、Iced 与 Druid 的“Hello World”级入门路径，便于横向对比 API 风格与项目结构。

四 Linux 依赖安装与项目初始化

• GTK 3（适用于 gtk-rs GTK3 绑定、Druid 等）
  • Ubuntu/Debian：sudo apt-get install libgtk-3-dev
  • Fedora/RHEL：sudo dnf install gtk3-devel glib2-devel
• GTK 4（适用于 gtk-rs GTK4 绑定）
  • Ubuntu/Debian（示例）：sudo apt-get install libgtk-4-dev
  • 通用验证：pkg-config --modversion gtk4
• 初始化与运行
  • cargo new my-gui && cd my-gui
  • 在 Cargo.toml 添加所选框架依赖（如 gtk = { version = "0.X", package = "gtk4" }）
  • cargo build 与 cargo run 验证安装与示例运行。

五 调试、主题样式与打包发布

• 调试与 IDE
  • VS Code：安装 Rust 与 CodeLLDB 扩展，配置运行与调试任务；断点、变量与调用栈查看与常规 Rust 项目一致。
  • CLion：启用 Rust 插件，使用内置构建/运行与调试工具。
• 主题与样式
  • GTK 应用支持 CSS 主题与动态切换，可按用户系统主题或应用内配置加载样式表，提升一致性与可定制性。
• 资源与多窗口
  • 图像等资源建议按项目约定放置（如 assets/），加载时确保路径正确；复杂应用可通过框架提供的事件/命令机制实现 多窗口管理。
• 打包发布
  • 桌面应用可使用 cargo-bundle 等工具将应用及其资源打包为各平台可分发包（如 Linux 的 AppImage/deb 等），便于分发与安装。