Rust GTK4 UI库libadwaita-sys的使用指南

概述

libadwaita-sys是Rust语言中用于开发现代化GNOME应用程序的低级绑定库，它提供了对GTK4和libadwaita库的原始FFI绑定。这个库特别适合需要与GNOME生态系统深度集成的应用程序开发。

主要特性

• 提供GTK4和libadwaita的原始绑定
• 支持GNOME HIG(人机界面指南)
• 现代化的UI组件和设计语言
• 深色/浅色主题支持
• 响应式布局组件

安装方法

在Cargo.toml中添加依赖：

[dependencies]
libadwaita-sys = "0.4"

基本使用方法

1. 初始化应用

use libadwaita_sys as adw;
use gtk4_sys as gtk;
use glib_sys;

unsafe {
    // 初始化GTK
    gtk::gtk_init();
    
    // 创建主窗口
    let window = gtk::gtk_application_window_new(application);
    gtk::gtk_window_set_title(window, "My Adwaita App\0".as_ptr() as *const _);
    gtk::gtk_window_set_default_size(window, 800, 600);
    
    // 创建Adwaita应用窗口
    let adw_window = adw::adw_application_window_new(application);
    // ... 更多窗口设置
}

2. 使用Adwaita组件

unsafe {
    // 创建Adwaita标题栏
    let header = adw::adw_header_bar_new();
    gtk::gtk_window_set_titlebar(window, header);
    
    // 创建Adwaita按钮
    let button = gtk::gtk_button_new_with_label("Click me\0".as_ptr() as *const _);
    gtk::gtk_button_set_icon_name(button, "document-open-symbolic\0".as_ptr() as *const _);
    gtk::gtk_header_bar_pack_start(header, button);
}

3. 主题设置

unsafe {
    // 设置深色主题
    let style_manager = adw::adw_style_manager_get_default();
    adw::adw_style_manager_set_color_scheme(style_manager, adw::AdwColorScheme_ADW_COLOR_SCHEME_FORCE_DARK);
}

高级示例：创建带有标签页的窗口

unsafe {
    // 创建主窗口
    let window = adw::adw_application_window_new(application);
    
    // 创建标签页视图
    let tab_view = adw::adw_tab_view_new();
    
    // 添加几个标签页
    for i in 0..3 {
        let page = adw::adw_tab_page_new();
        let label = gtk::gtk_label_new(format!("Tab {}\0", i + 1).as_ptr() as *const _);
        adw::adw_tab_page_set_child(page, label);
        adw::adw_tab_view_append(tab_view, page);
    }
    
    // 将标签页视图添加到窗口
    gtk::gtk_window_set_child(window, tab_view);
    
    // 显示窗口
    gtk::gtk_widget_show(window);
}

完整示例代码

use libadwaita_sys as adw;
use gtk4_sys as gtk;
use glib_sys;

fn main() {
    unsafe {
        // 初始化GTK
        gtk::gtk_init();
        
        // 创建应用
        let app = gtk::gtk_application_new("org.example.myapp\0".as_ptr() as *const _, 
                                         glib_sys::G_APPLICATION_FLAGS_NONE);
        
        // 连接activate信号
        glib_sys::g_signal_connect_data(
            app as *mut _,
            "activate\0".as_ptr() as *const _,
            Some(on_activate as glib_sys::GCallback),
            std::ptr::null_mut(),
            None,
            0
        );
        
        // 运行应用
        glib_sys::g_application_run(app as *mut _, 0, std::ptr::null_mut());
        glib_sys::g_object_unref(app as *mut _);
    }
}

unsafe extern "C" fn on_activate(app: *mut glib_sys::GApplication, _user_data: glib_sys::gpointer) {
    // 创建主窗口
    let window = adw::adw_application_window_new(app as *mut _);
    gtk::gtk_window_set_title(window, "Adwaita Demo\0".as_ptr() as *const _);
    gtk::gtk_window_set_default_size(window, 800, 600);
    
    // 创建标签页视图
    let tab_view = adw::adw_tab_view_new();
    
    // 添加3个标签页
    for i in 0..3 {
        let page = adw::adw_tab_page_new();
        let label = gtk::gtk_label_new(format!("Tab {}\0", i + 1).as_ptr() as *const _);
        adw::adw_tab_page_set_child(page, label);
        adw::adw_tab_view_append(tab_view, page);
    }
    
    // 将标签页视图添加到窗口
    gtk::gtk_window_set_child(window, tab_view);
    
    // 显示窗口
    gtk::gtk_widget_show(window);
}

注意事项

1. libadwaita-sys是低级绑定，大多数操作需要在unsafe块中进行
2. 建议配合gtk-rs的高级绑定(如gtk4-rs)一起使用
3. 字符串参数需要以null结尾(\0)
4. 内存管理需要遵循GLib的规则

这个库适合需要深度集成GNOME桌面环境的应用程序开发，提供了符合GNOME设计语言的现代化UI组件。