工程开发
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 dev或cargo build执行开发环境,以触发自动精灵再生并验证整合。在前端参考图标时,请依照项目中 Dioxus 的标准惯例使用 asset!() 宏。
仓库统计
- Star 数
- 220
- Fork 数
- 19
- Open Issue 数
- 24
- 主要语言
- Rust
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月3日 04:40