# 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-10-08

## 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)]()
[![fa](https://img.shields.io/badge/预览版-v2.0.0-red)]()
[![](https://img.shields.io/badge/不定期-更新中-green)]()

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

#### 活跃 | 近期动作
___
- 2026/9/28：推出 v2.0.0 预览发行版。此版本与历史版本差异较大，不建议升级并使用此版本。重点解决了嵌套 UI 调度的设计瓶颈。现在你可以直接管理多套 Canvas 了！

&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) 程序集扩展包
- [unity-coroutine-toolkit](https://gitee.com/River314588804/unity-coroutine-toolkit) 协程管理扩展包
- Addresable（Unity Technology）
- TextMeshPro（Unity Technology）
- ResourceManager（Unity Technology）
<br/>

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

<br/>
<br/>

#### 说明 | 快速部署
___
- **离线部署**：使用此工程压缩包即可。（不推荐）
- **联网部署**：
    - 准备 **Unity Technologies Inc** 官方环境
        - com.unity.textmeshpro
        - com.unity.addressables
    - 准备 **UI 管理工具包** 运行环境
```txt
# 请按照以下步骤进行
# 1. 打开 Menu 内 Window/Package Manager
# 2. 选择 add package from git url，并按照顺序依次导入以下地址

// 前置环境
https://gitee.com/River314588804/unity-api-extension-toolkit.git
https://gitee.com/River314588804/unity-observer-toolkit.git
https://gitee.com/River314588804/unity-pool-toolkit.git#Unity-Package-Manager
https://gitee.com/River314588804/unity-coroutine-toolkit.git#Unity-Package-Manager

// 本体环境
https://gitee.com/River314588804/unity-ui-framework.git#Unity-Package-Manager
```
<br/>

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

&emsp;

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

&emsp;
#### 说明 | 快速上手  
___
- 见 [Wiki](https://gitee.com/River314588804/unity-ui-framework/wikis)。

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

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