Unity-UI-Framework: A C# repository from jiaqubo

#Unity-UI-Framework的设计与实现

@(归档)[Unity3D, UGUI]

[TOC]

###如何使用

请直接导入UnityUIFramework这个UnityPackage，然后进入名为Test的Scene即可开始体验各种特性，Enjoy！你可以通过访问我的Github进行查阅和下载，也可以通过下面的附件直接下载。

###基本概念：View，Context和UI的定义

UI是游戏中主要界面和它的子节点上的物体的统称，如装备列表界面中的装备列表和每个装备通常会被制作成两个Prefab，这两个Prefab被我们称作两个UI，这两个UI会对应两个UIType，在UIType里面会存储有这个UI全局唯一的名字和路径，如下：

public class UIType {

    public string Path { get; private set; }

    public string Name { get; private set; }

    public UIType(string path)
    {
        Path = path;
        Name = path.Substring(path.LastIndexOf('/') + 1);
    }

    public override string ToString()
    {
        return string.Format("path : {0} name : {1}", Path, Name);
    }
}

View代指游戏中的主要界面，例如：主界面，装备界面，装备详情界面等等。在View中包含了界面中处理数据的逻辑。

Context代指游戏中每个View的上下文，存储了这个界面的各种数据状态，每个特定的View会持有特定的Context，游戏中会通过栈的方式管理Context。

在本框架中，会把Context和View定义在同一个cs文件中，如下：

    public class OptionMenuContext :BaseContext
    {
        public OptionMenuContext() : base(UIType.OptionMenu){}
    }

    public class OptionMenuView : AnimateView
    {
        public override void OnEnter(BaseContext context)

        public override void OnExit(BaseContext context)

        public override void OnPause(BaseContext context)

        public override void OnResume(BaseContext context)
    }

###View的创建和销毁

所有界面上挂上的Mono脚本和关联的Prefab统一以XXXView命名。

所有View的路径统一放在UIType中进行管理，每当新创建一个View的时候，都需要在UIType中新添加一个成员变量指明View的路径。

public static readonly UIType MainMenu = new UIType("View/MainMenuView");
public static readonly UIType OptionMenu = new UIType("View/OptionMenuView");
public static readonly UIType NextMenu = new UIType("View/NextMenuView");
public static readonly UIType HighScore = new UIType("View/HighScoreView");

在游戏中单独出现的View会通过UIManager中的GetSingleUI和DestroySingleUI来进行创建和销毁。

###View的跳转

每个View都相应拥有相应的Context来保存该界面的状态，View的跳转通过ContextManger管理，ContextManager中以栈的形式储存了已经经过的界面的Context。这样在返回的时候就可以得到需要的状态参数。

当需要进入下一个View的时候，调用ContextManger.Instance.Push(nextContext)即可，nextContext即为下一个View需要的上下文参数，这是会调用当前View的OnPause函数，对当前View的上下文进行存储，并调用下一个View的OnEnter函数，对下一个Viwe的上下文进行初始化

当需要返回上一个界面的时候，调用ContextManger.Instance.Push.Pop()即可。这是会调用当前界面的OnExit函数，接着调用下一个界面的OnResume函数。

###View的动画

如果在界面上使用3D的旋转动画，就很难使用DoTween或者iTween在代码里面进行动画控制，而且为了保持战斗模块和UI模块设计的一致性。因此建议使用Animator对View的各种动画进行控制，而View的动画一般又和View的跳转逻辑联系紧密，所以建议将两者进行绑定，一个View的动画状态机如下图：

一个界面在没有显示的时候会处于Empty状态，当接收到OnEnter的Trigger的时候，会播放OnEnter动画，其他的状态如图所示，可以参考上图以及项目中的状态机。不同的界面可以使用相同的状态机，只是在某些状态上绑定的动画会有所不同。

这样做的另一个好处是，我们可以使用动画时间的方式在动画过程中做一些回调，这样的在界面上对回调时机进行编辑，相比使用协程或者Dotween的OnFinished函数，有更好的可编辑性。

###本地化

本地化是通过单例Localization和组件LocalizedText两个来协同实现的，不同语言的文字会存储在Resources/Localization中的不同JSON文件中，在单例Localization中配置后语言之后，即可读入相应的JSON文件。

每个LocalizedText所在的GameObject上都需要与Text绑定，LocalizedText会根据自己的textID对Text中的text进行本地化

###分辨率适配

UGUI中的分辨率适配是通过CanvasScaler来实现的，如下图：

在这里，我建议使用Scale With Width Or Height这种Scale模式，同时，由于大多数游戏是横屏游戏，通过使用高度固定，宽度随之变化的模式。这样我们就可以以一个固定的高度进行UI设计，只需要考虑UI在水平尺度上的延伸就可以了。

###提升滑动列表的性能

在UGUI中Scroller和Grid都是很好用的组件，但是由于它们在实现过程中考虑了太多对齐，排序的问题，这就导致它们在处理无限列表问题的时候遇到了极大的性能瓶颈，相关资料参考：Performance issues on android with Scrollrect。在本框架中实现的自定义组件GridScroller可以在保证可编辑性的同时，提升了滑动列表的性能。

GridScroller的原理是：在滑动到某个item上的时候，会把之前的item进行回收，并且把它放到下一个位置进行再利用。在使用GridScroller的时候，你同样要使用ScrollRect和GridLayout，GridScroller会从这两个组件中读取相应的属性并且运用到UI逻辑中。

GridScroller对外界代码提供了一个Init的接口，通过这个接口，外界模块可以向GridScroller传入一个onChange回调函数，这样在GridScroller在刷新的时候，就会动态刷新相应的itemPrefab，实现用到时再加载的特性。

[RequireComponent(typeof(ScrollRect))]
public class GridScroller : MonoBehaviour {

    // public UI elements //
    [SerializeField]
    private Transform _itemPrefab;
    [SerializeField]
    private GridLayoutGroup _grid;

    // public fields //
    [SerializeField]
    private Movement _moveType = Movement.Horizontal;
    
    public delegate void OnChange(Transform trans, int index);
    
    public void Init(OnChange onChange, int itemCount, Vector2? normalizedPosition = null)
    {
        Clear();
        InitScroller();
        InitGrid();
        InitChildren(onChange, itemCount);
        InitTransform(normalizedPosition);
    }

###对UI进行修饰

由于UGUI的Image，Text等属性一般是不会设置Material的，我们可以通过写脚本继承BaseVertexEffect来对UI的Vertex进行修饰，项目中的Gradient Color和Blend Color就通过这种方式实现了颜色渐变和颜色运算的功能。通过重载ModifyVertices这个方法，你可以不实用Shader直接在脚本里对UI的渲染方式进行修饰。

jiaqubo/Unity-UI-Framework