如何快速掌握GameFramework-at-YooAsset：Unity游戏开发的终极框架指南 🎮

GameFramework-at-YooAsset是一款集成了GameFramework、luban、hybridclr、YooAsset和UniTask的Unity游戏开发框架，专为提升开发效率和资源管理能力设计。本文将带你轻松了解项目结构、核心功能及快速上手方法，让新手也能快速入门Unity游戏开发。

📋 项目核心功能与优势

GameFramework-at-YooAsset框架整合了五大核心技术，为Unity开发者提供一站式解决方案：

• GameFramework：成熟的游戏逻辑架构，支持模块解耦与热更新
• YooAsset：高效资源管理系统，优化资源加载与内存占用
• luban：配置生成工具，实现Excel数据一键导出
• hybridclr：跨平台热更新方案，降低版本迭代成本
• UniTask：高性能异步编程库，提升代码响应速度

📂 项目目录结构全解析

核心目录概览

GameFramework-at-YooAsset/
├── Configs/          # 配置文件与代码生成工具
├── UnityProject/     # Unity工程主目录
│   ├── Assets/       # 游戏资源与脚本
│   ├── Packages/     # 依赖包管理
│   └── ProjectSettings/ # Unity项目设置
└── Tools/            # 辅助开发工具

关键目录详解

🎯 Configs目录

存放项目配置文件与代码生成脚本，包括：

• luban.conf：配置生成工具主文件
• Datas/：Excel数据表（如item.xlsx）
• gen_code_bin_to_project.bat：代码生成批处理文件

🎮 UnityProject/Assets目录

游戏开发核心工作区，重点子目录：

• AssetRaw/Configs/：二进制配置文件（如item_tbitem.bytes）
• GameScripts/：游戏逻辑代码，包含HotFix热更新模块
• UnityGameFramework/：框架核心脚本与预设

🔧 Editor工具目录

UnityProject/Assets/Editor/提供强大的开发辅助工具：

• LubanTools.cs：配置导出工具
• YooAssetEditor/：资源管理编辑器扩展

🚀 快速上手开发流程

1️⃣ 环境准备

git clone https://gitcode.com/gh_mirrors/ga/GameFramework-at-YooAsset

使用Unity 2020.3以上版本打开UnityProject目录即可开始开发。

2️⃣ 配置文件生成

1. 编辑Configs/Datas下的Excel表格
2. 运行gen_code_bin_to_project.bat生成C#代码
3. 配置文件自动输出至UnityProject/Assets/AssetRaw/Configs/bytes/

3️⃣ 资源管理基础

通过YooAsset管理游戏资源：

• 资源打包配置：UnityProject/Assets/Editor/YooAssetEditor/CustomPackRule.cs
• 资源加载API：YooAssets.LoadAssetAsync(assetPath)

📊 项目核心配置指南

框架配置文件

• luban.conf：配置生成规则设置
• builtin.xml：内置类型定义
• YooAssetSettings：资源管理全局设置

配置示例

修改资源最大并发下载数（位于YooAsset配置）：

{
  "MaxConcurrentDownloads": 8,
  "DefaultBundleVersion": "1.0.1"
}

💡 新手常见问题解决

Q：如何添加新的Excel配置表？

A：在Configs/Datas目录添加xlsx文件，在luban.conf中注册表名，运行生成脚本即可

Q：资源打包后如何测试热更新？

A：使用UnityProject/Assets/Editor/YooAssetEditor/中的打包工具，生成更新包后通过框架的更新流程测试

🎉 结语

GameFramework-at-YooAsset框架整合了Unity开发所需的核心工具链，无论是新手入门还是商业项目开发都能显著提升效率。通过本文介绍的目录结构与基础流程，你已经掌握了框架使用的关键知识。立即克隆项目，开启高效Unity开发之旅吧！

提示：更多高级功能请参考项目README.md与官方文档