# Unity UI Framework

**Repository Path**: River314588804/unity-ui-framework

## Basic Information

- **Project Name**: Unity UI Framework
- **Description**: 这是一个面向 Unity 并专注服务于 UI/UGUI 的（简易）调度管理框架。
- **Primary Language**: C#
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 4
- **Created**: 2024-05-08
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: UI, Unity, UGUI, 工具

## README

## Unity UI Framework | Unity UI 管理框架
___
[![](https://img.shields.io/badge/支持-Unity6.0-green)]() 
[![](https://img.shields.io/badge/支持-Tuanjie-green)]()
[![](https://img.shields.io/badge/平台-Windows-white)]() 
[![](https://img.shields.io/badge/平台-WebGL-white)]() 
[![fa](https://img.shields.io/badge/发行版-v1.3.0-yellow)]()
[![](https://img.shields.io/badge/不定期-更新中-green)]()

![标题Logo](https://gitee.com/River314588804/unity-ui-framework/raw/master/Doc/Title.png)<br/>

&emsp;
#### 说明 | 项目背景
___
归档工具是开发结束后必须总结的事情。其目的是为下一项目提供快速开发基础。<br/>
行业的发展诞生很多优秀的 Unity-UI 框架。但对于个人开发者而言，了解 UI 框架的原理和实现是非常重要的。
<br/>
<br/>
**核心目标**：在保持Unity环境纯净的前提下，构建一套功能完整、依赖极简的 Unity-UI （简易）管理框架。:joy:<br/>
**实现原则**：
-  最小依赖：首选使用 Unity 原生API，避免引入外部插件依赖。
-  实用主义：聚焦解决实际开发中的高频痛点，不追求"大而全"。

<br/>
<br/>

#### 说明 | 依赖环境 
___
下列配套工具包均源于 "主项目" 长期迭代后的拆分、标准化封装形成独立模块。<br/>
- [unity-pool-toolkit](https://gitee.com/River314588804/unity-pool-toolkit) 游戏对象池扩展包
- [unity-api-extension-toolkit](https://gitee.com/River314588804/unity-api-extension-toolkit) 程序集扩展包

<br/>

> 注意：UI 框架运行时会直接、间接调用底层逻辑，部署需先安装上述内容，再导入本框架，避免编译、运行异常。

<br/>
<br/>

#### 说明 | 快速部署
___
**方式 1：Package Manager**
```
https://gitee.com/River314588804/unity-api-extension-toolkit.git
https://gitee.com/River314588804/unity-pool-toolkit.git#Unity-Package-Manager
https://gitee.com/River314588804/unity-ui-framework.git#Unity-Package-Manager
```
- 通过 `add from git url` 依次添加上述地址包即可。
___
**方式 2：Manifest**
```
"com.rstudio.unity-api-extension-toolkit": "shturl.cc/hg6LsNDUNdJ5TNAm72Q9WzeADTF1sPlSXFM1EPjHZzc6J5TZArOktB",
"com.rstudio.unity-pool-toolkit": "shturl.cc/bY7yUdmQylDnC0KfL5mQgA23K4rpp8tHAn6L6DACtwVwJeepEMpWsyPyntJTofZfjEm",
"com.rstudio.unity-ui-framework": "shturl.cc/PaTbIJBkxXu3wbSSPFum1TYiMzoEpGejaCAs31fvc0EM8u9XCESLZ972IpWeDNEP7Sk"
```
- 工程目录下 `Packaage / Manifest.json` 追加至 `Dependences` 即可：

<br/>

#### 说明 | 功能支持
___
- 统一的资产输出目录：`/Asset/output`
- 程序化构建资产（Prefab、Scripts、Sprite）
- 自由稳定的框架生命周期（CreateUI/ActiveUI/StartUI/DeActiveUI/DisposeUI）
- 可视化通用 UI 行为（遮罩/阻挡/区域关闭/单实例/关闭历史/允许被关闭）
- 可视化通用 UI 样式（居中/四周型）
- 可扩展选择的资源加载模式（IAssetLoad）
- 可外部访问的生命周期事件订阅 **NEW！**

<br/>

#### 说明 | 核心模块
___
-  **记录** ：记录页面访问操作，以回退至前者或更前方。
-  **实例** ：限定该页面数实时活跃数量为1。
-  **关旧** ：关闭活跃页面中，开启 "可关" 的在活跃页面对象。
-  **可关** ：决定是否可被新页面（或调用关旧方法）关闭。
-  **回退** ：返回至上一页，哪怕它没有活跃，也会被叫出来干活。

<br/>

## 关注 | 未来路线
___
经过长达一年的持续迭代与优化，本框架现已能够稳定覆盖80%以上的实际开发场景，足以胜任各类 **中小型游戏项目** 的UI开发需求。
基于当前仓库成熟度，本仓库的更新节奏将有所调整，但项目仍会持续维护。后续我的主要精力将转向新的开源项目，同时对本仓库保持关注与支持：
- 根据社区中 Issue 中反馈，对潜在问题进行修复。
- 根据社区建议，对存在争议的交互设计进行讨论与迭代。
- 根据自用反馈，在确保稳定性的前提下，进行必要的优化。

感谢各位  **开发者**  一直以来的支持与贡献，期待在下一个项目中与大家再次相遇。