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