如何在gtk-rs中正确使用IconTheme加载自定义图标

问题根源 #

你遇到的问题来自两个核心点：

• GTK的IconTheme遵循Freedesktop图标规范，要求图标放在符合尺寸/类别结构的子目录中，而非直接放在添加的搜索路径根目录。
• has_icon()的参数应该是不带文件扩展名的图标名称，GTK会自动匹配支持的格式（如png、svg）。

修正步骤 #

1. 调整图标目录结构
   按规范组织你的图标目录，示例结构如下：

   /home/user/Projects/test_app/src/Icons/
   └── scalable/
       └── apps/
           └── test_icon.png
   

   （scalable对应矢量图标，若为位图可使用24x24、48x48等尺寸目录；apps是类别，也可根据需求用actions、devices等）

2. 修改代码中的图标名称与扫描逻辑
   调用has_icon()时去掉.png后缀，同时添加强制重新扫描的代码，确保新路径立即生效。

修正后的完整代码 #

use gtk::prelude::*;
use gtk::gdk::Display;
use adw::{Application, ApplicationWindow};
use std::path::PathBuf;

const APP_ID: &str = "org.test.app";

fn main() {
    let app = Application::builder().application_id(APP_ID).build();
    app.connect_startup(|_| load_images());
    app.connect_activate(build_ui);
    app.run();
}

fn load_images() {
    let mut icon_path = PathBuf::new();
    icon_path.push("/home/user/Projects/test_app/src/Icons");

    let icons = gtk::IconTheme::for_display(&Display::default().expect("Could not connect to a display."));
    icons.add_search_path(icon_path);

    // 强制重新扫描图标主题，确保新路径被识别
    icons.rescan_if_needed();

    println!("IconTheme.name = {:?}", icons.theme_name());
    println!("IconTheme.search_path() = {:?}", icons.search_path());
    // 使用不带扩展名的图标名
    println!("IconTheme.has_icon(\"test_icon\") = {}", icons.has_icon("test_icon"));
}

pub fn build_ui(app: &Application) {    
    let window = ApplicationWindow::builder()
        .application(app)
        .title("test_app")
        .default_width(360)
        .default_height(720)
        .build();

    window.present();
}

额外验证点 #

• 确认图标文件权限正常，当前用户可读取。
• 若使用位图图标，确保尺寸目录名称符合规范（如24x24而非24）。

内容的提问来源于stack exchange，提问作者John554