QFramework框架全面解析：从入门到精通-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01073/article/details/148508713

QFramework框架全面解析：从入门到精通

QFramework Godot/Unity3D System Design Architecture 项目地址: https://gitcode.com/gh_mirrors/qf/QFramework

什么是QFramework？

QFramework是一套渐进式的Unity游戏开发框架，由凉鞋老师经过7年时间精心打磨而成。它不仅仅是一个简单的工具集，更是一套完整的开发解决方案，适用于各种类型的游戏和应用项目开发。

框架核心特性

1. 开发架构(QFramework.cs)

QFramework的核心架构设计精炼而强大，具有以下特点：

简洁易用：整个架构代码不到1000行，学习曲线平缓
MVC模式：提供清晰的代码组织结构
IOC支持：实现依赖注入，降低模块耦合度
分层架构：支持项目分层开发
CQRS模式：命令查询职责分离
SOLID原则：遵循软件设计的最佳实践
DDD支持：可以使用领域驱动设计方式开发项目

2. 工具集(QFramework.Toolkits)

QFramework提供了一系列高效的工具模块：

UIKit - 界面开发解决方案

自动生成UI代码
界面层级管理
界面堆栈管理
资源加载管理

ResKit - 资源管理解决方案

开发阶段模拟模式(无需打包)
资源名称代码生成
统一资源加载API
引用计数管理

AudioKit - 音频管理解决方案

背景音乐/人声/音效分类管理
音量控制
资源加载管理

CoreKit - 核心工具集

ActionKit：动作序列系统
CodeGenKit：代码生成工具
EventKit：事件系统
FluentAPI：链式API扩展
IOCKit：依赖注入容器
其他实用工具：本地化、日志、对象池等

为什么选择QFramework？

渐进式设计：可以根据项目需求逐步引入框架功能
开发效率：从细节上优化开发流程，提升效率
代码质量：良好的架构设计保证代码质量
社区支持：活跃的开发者社区和丰富的学习资源
实战验证：多个成功项目案例验证了框架的可靠性

典型代码示例

QFramework.cs架构代码

public class CounterAppController : MonoBehaviour, IController
{
    private Button mBtnAdd;
    private Button mBtnSub;
    private Text mCountText;
    private ICounterAppModel mModel;

    void Start()
    {
        mModel = this.GetModel<ICounterAppModel>();
        
        mBtnAdd = transform.Find("BtnAdd").GetComponent<Button>();
        mBtnSub = transform.Find("BtnSub").GetComponent<Button>();
        mCountText = transform.Find("CountText").GetComponent<Text>();
        
        mBtnAdd.onClick.AddListener(() => {
            this.SendCommand<IncreaseCountCommand>();
        });
        
        mBtnSub.onClick.AddListener(() => {
            this.SendCommand(new DecreaseCountCommand());
        });

        mModel.Count.RegisterWithInitValue(newCount => {
            UpdateView();
        }).UnRegisterWhenGameObjectDestroyed(gameObject);
    }
    
    void UpdateView() {
        mCountText.text = mModel.Count.ToString();
    }

    public IArchitecture GetArchitecture() {
        return CounterApp.Interface;
    }
}

QFramework.Toolkits代码

public partial class UIGamePanel : UIPanel
{
    private ResLoader mResLoader;
    
    protected override void OnInit(IUIData uiData = null)
    {
        mResLoader = ResLoader.Allocate();
        
        mResLoader.LoadSync<GameObject>("GameplayRoot")
            .Instantiate()
            .Identity()
            .GetComponent<GameplayRoot>()
            .InitGameplayRoot();
        
        BtnPause.onClick.AddListener(() => {
            AudioKit.PlaySound("btn_click");
            
            ActionKit.Sequence()
                .Callback(() => BtnPause.interactable = false)
                .Callback(() => BtnPause.PlayBtnFadeAnimation())
                .Delay(0.3f)
                .Callback(() => UIKit.OpenPanel<UIPausePanel>())
                .Start(this);
        });
    }

    protected override void OnClose()
    {
        mResLoader.Recycle2Cache();
        mResLoader = null;
    }
}