资讯动态

GameFramework-at-YooAsset 上手指南:从 clone 到跑通热更的 10 分钟路径

发布时间:2026/8/23 11:29:50 来源:尧图企业网站定制
GameFramework-at-YooAsset 上手指南从 clone 到跑通热更的 10 分钟路径【免费下载链接】GameFramework-at-YooAssetGameFramework-Next项目地址: https://gitcode.com/gh_mirrors/ga/GameFramework-at-YooAsset手动补资源包、手动补 DLL、手动接异步回调这三件事如果你都要做GameFramework-at-YooAsset主干分支叫 GameFramework-Next能省掉接线工作。它把 YooAsset 资源管理、HybridCLR C# 热更、UniTask 异步、Luban 配置代码生成接进同一个 Unity 工程clone 下来即可先跑通校验版本 → 下载资源 → 加载热更 DLL → 进入游戏的流程。 它接住哪些问题各由谁接游戏工程搭建期最常见的五类问题对应的承接组件资源分包与增量更新YooAssetC# 逻辑热更HybridCLRasync/await 异步UniTaskxlsx 读成强类型数据Luban启动流程状态机GameFramework Procedure五层串成一条链最外层Runtime/Procedure/状态机驱动启动流程中间 YooAsset 负责资源和代码的交付UniTask 接住异步回调HybridCLR 执行热更程序集Luban 提供强类型表。模板自带 UI 按钮素材图集已整理在Assets/AssetArt/Atlas/从 clone 到跑起来5 步git clone https://gitcode.com/gh_mirrors/ga/GameFramework-at-YooAsset——资源、配置、设置一次拿全用 Unity 2021.3.24f1工程实际版本打开UnityProject/README 声明 2019.4.12 及以上兼容——低版本编辑器可能缺 API编辑器模拟模式下直接 Play。热更入口是Assets/GameScripts/HotFix/GameLogic/GameApp.cs的Entrance()启动顺序由ProcedureLaunch → Splash → InitPackage推进——流程是状态机不用从 Awake 顺藤摸瓜真机另说按ProjectSettings/HybridCLRSettings.asset构建 HotFix 程序集DLL 以 TextAsset 打进资源包——因为ProcedureLoadAssembly在非编辑器下是读字节再 Assembly.Load改配置后跑Configs/GameConfig/下的 bat——Luban 是生成式xlsx 改动不会自动同步到代码 三个值得读源码的能力热更是怎么跑的能做到什么PC、Android、iOS、WebGL 四条 C# 热更链路均已跑通README 作者声明。底层依赖ProcedureLoadAssembly先经 YooAsset 加载热更 DLL 的 TextAssetAssembly.Load注入域再反射定位GameApp类型的Entrance方法真机还会调LoadMetadataForAOTAssembly给 AOT 程序集补元数据泛型 native 实现缺失时自动退回解释模式。拿到手怎么用业务代码写进HotFix/GameLogic/在GameApp_RegisterSystem.cs里用AddLogicSys注册系统改完代码重新打包即可。资源更新流程在做什么ProcedureInitPackage按 PlayMode 分流编辑器模拟 → 直接预加载单机 → 初始化本地资源Host/Web → 先走ProcedureUpdateVersion拿线上版本。下载与清缓存分别在ProcedureDownloadFile、ProcedureClearCache。切一下 PlayMode 就能体验三种启动形态每条失败路径都会弹原生重试弹窗。启动器 UI 已经能用能做到什么资源下载失败时展示进度与重试 / 退出弹窗。底层依赖Runtime/Launcher/的UILoadMgrUILoadTip组合由各 Procedure 在恰当的时机调用。拿到手怎么用参照UILoadUpdate的用法加自己的进度界面按钮素材就在图集里想改数据时改哪里项目路径说明数据表Configs/GameConfig/Datas/__tables__/__beans__/__enums__.xlsx在此修改生成配置Configs/GameConfig/luban.conf定义 c/s/e 分组与 server/client/all 三个目标重新生成Configs/GameConfig/gen_code_bin_to_project.bat双击执行产物落进工程运行期数据Configs/GameConfig/CustomTemplate/.../cs-bin/tables.sbn打包 bin由ConfigSystem加载生成的表类GameScripts/HotFix/GameProto/GameConfig/强类型代码属于热更域⚠️ 上手时容易踩的 3 个坑日志报 Main logic assembly missingHybridCLR 设置里的LogicMainDllName与编译出的GameLogic程序集名不一致。改ProjectSettings/HybridCLRSettings.asset保持主 DLL 名与HotUpdateAssemblies列表吻合。改 HotFix 代码编辑器生效、真机还是旧逻辑编辑器走内存程序集路径真机依赖资源包里的 DLL 字节。重建热更 DLL、更新资源包并提升版本号三步缺一不可。xlsx 改了ConfigSystem 还是旧数据多半是只重新生成了代码、没生成tables.sbn或反之。跑Configs/GameConfig/的 bat 让代码与 bin 一次生成并确认用的是与运行期匹配的那套懒加载模板。接下来可以先在编辑器模拟模式跑一遍看到成功运行了热更新代码那条日志后就可以往 HotFix 里塞自己的业务了。【免费下载链接】GameFramework-at-YooAssetGameFramework-Next项目地址: https://gitcode.com/gh_mirrors/ga/GameFramework-at-YooAsset创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价