README.zh-TW.md

Game Frame X UI UGUI

獨立遊戲前後端一體化解決方案 · 獨立遊戲開發者的圓夢大使

文檔 · 快速開始 · QQ群: 467608841 / 233840761

English | 简体中文 | 繁體中文 | 日本語 | 한국어

功能特性

核心功能

• UGUI 組件封裝: 提供對 Unity UGUI 組件的高級封裝
• UI 管理器: 完整的 UI 界面管理系統
• 代碼生成器: 自動生成 UI 代碼，提高開發效率
• 擴展方法: 豐富的 UGUI 組件擴展方法
• 表單輔助: UI 表單創建和管理輔助工具

主要組件

UI 管理系統

• UIManager: 界面管理器，負責 UI 的打開、關閉和生命週期管理
• UGUI: 抽象 UI 基類，提供 UI 顯示狀態控制
• UGUIFormHelper: UI 表單輔助器，處理 UI 實例化和創建

擴展功能

• UGUIButtonExtension: Button 組件擴展方法
• UGUIImageExtension: Image 組件擴展方法
• RectTransformExtension: RectTransform 擴展方法
• UIImage: 增強的 Image 組件，支持異步圖片加載

編輯器工具

• UGUICodeGenerator: UGUI 代碼生成器
• UGUIComponentInspector: UGUI 組件檢查器
• UIImageReplaceHandler: UI 圖片替換處理器

快速開始

安裝

選擇以下任一方式：

1. 編輯 Unity 專案的 Packages/manifest.json，添加 scopedRegistries 部分：

   {
     "scopedRegistries": [
       {
         "name": "GameFrameX",
         "url": "https://gameframex.upm.alianblank.uk",
         "scopes": [
           "com.gameframex"
         ]
       }
     ],
     "dependencies": {
       "com.gameframex.unity.ui.ugui": "2.5.1"
     }
   }

   scopes 控制哪些套件透過此註冊表解析。只有以 com.gameframex 開頭的套件才會從這個註冊表取得。

2. 直接在 manifest.json 的 dependencies 節點下添加以下內容：

   {
      "com.gameframex.unity.ui.ugui": "https://github.com/gameframex/com.gameframex.unity.ui.ugui.git"
   }

3. 在 Unity 的 Package Manager 中使用 Git URL 的方式添加庫，地址為：https://github.com/gameframex/com.gameframex.unity.ui.ugui.git

4. 直接下載倉庫放置到 Unity 專案的 Packages 目錄下，會自動載入識別。

依賴

套件	說明
com.gameframex.unity	1.1.1
com.gameframex.unity.asset	1.0.6
com.gameframex.unity.event	1.0.0
com.gameframex.unity.ui	1.0.0

文檔與資源

• 官方文檔

社區與支援

• QQ群: 467608841 / 233840761

更新日誌

查看 Releases 了解更新日誌。

開源協議

詳見 LICENSE.md 檔案。