工程開發
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