工程开发
add-icon avatar

add-icon

将新的 Tabler 图标新增至 Arto 应用程序,并更新图标清单与 Rust 枚举定义。

简介

此技能为开发人员提供了一个结构化的工作流程,用于将 Tabler Icons 库中的新图标整合到 Arto 代码库中。由于 Arto 使用由 Vite 插件管理的集中式图标精灵系统,仅仅新增 SVG 文件是不够的。此流程可确保图标在项目配置中被正确索引、透过构建管线处理,并可在基于 Rust 的桌面组件中进行类型安全地调用。

  • 更新 renderer/icons.json 以注册新的图标标识符给构建系统。

  • 在 Vite buildStart 钩子期间自动生成图标精灵,以最佳化性能。

  • 扩展 desktop/src/components/icon.rs 中的 IconName 枚举,以实现强类型的图标选择。

  • 更新 IconName 枚举的 Display 实现,确保字符串序列化的一致性。

  • 支持从 @tabler/icons npm 包引入外框样式的图标。

  • 修改前请先浏览 Tabler Icons 文档确认图标名称。

  • 确保对 icons.json 的新增内容按字母顺序排列,以维护配置的整洁。

  • 图标必须以 PascalCase 加入至 IconName 枚举中,以符合项目编码标准。

  • 切勿直接编辑 assets/dist/ 目录中的已生成 SVG 文件,因为这些文件是由构建管线自动管理的,且已明确排除在版本控制之外。

  • 使用 just devcargo build 执行开发环境,以触发自动精灵再生并验证整合。在前端参考图标时,请依照项目中 Dioxus 的标准惯例使用 asset!() 宏。

仓库统计

Star 数
220
Fork 数
19
Open Issue 数
24
主要语言
Rust
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 04:40
在 GitHub 查看