GF_CLR初始用 - 正式版
阅读原文时间:2023年07月09日阅读:1

参照:DeerGF_Wolong框架使用教程 与tackor老哥的踩坑日记所编写,第二次尝试,总结第一次经验重新来。

点击链接加入群聊【Gf_Wolong热更集合】

  1. 首先安装Windows Build Support (IL2CPP)

  2. 需要完整的克隆项目,工程地址 。打开项目在编辑器菜单栏可以看到【HybridCLR--Installer..】安装界面,第一次打开工程先安装HybridCLR。

    注意:一定要拉取最新的版本,第一次尝试就是因为没有拉取最新的版本导致失败的。

  3. HybridCLR--hybridcly_unity】点击enable,开启工程里的插件开关,表示框架是否接入插件,这个开关和【HybridCLRSettings】里的enable不同。

    注意:如果需要热更需要同时开始【HybridCLR--hybridcly_unity】的enable 和【HybridCLRSettings】的enable开关,如果不启动热更新代码,则要同时关闭这两个开关。

  4. 打开工程找到工具栏【HybridCLR--Generate--All】生成桥接文件,link文件等等。
    注意:如果后边打包后加载不出来内容,多进行本步骤几次

  5. 在【HybridCLRSettings】里设置需要更新的程序集,项目克隆后本身就已经带有,没有的需要自行添加.

  6. 第一次构建ab包前需要先构建一次软件包(也就是Build一次exe文件)。因为构建ab包需要导入构建软件包之后生成的AOT元数据信息文件。
    注意:构建软件包之前确定以下几点:
    Scripting Backend】为 Il2cpp
    Api Compatibility Level*】 为 .Net Framework,如下图

补充:如果打包报错是下边的内容,就去群里看tackor老哥的踩坑日记的补充二补充三,没加群点击最上边的加群链接。
1. error: Could not set up a toolchain for Architecture x64. Make s ure you have the right build tools installed for il2cpp builds. Details.
2. Building Library\Bee\artifacts\WinPlayerBuildProgram\xxxxx\GameAssembly.dll failed with output.


  1. 找到目录:项目\ LubanTools\DesignerConfigs,运行BuildConfig_Wolong.bat批处理文件,会生成Config代码及bin文件,其中bin文件生成到上级目录GenerateDatas下,LubanConfig文件夹以及ConfigVersion.xml文件。

    补充:如果双击 BuildConfig_Wolong.bat,出现报错 sets不是内部或外部命令,也不是可运行的程序,就去群里看tackor老哥的踩坑日记的补充一,没加群点击最上边的加群链接。



  1. 所有热更代码 及aot代码都会放到 assembly.bat ab包里,Assembly文件夹在GF里的ResourceEditor 工具里不用从AssetList移动到ResourceList里,每次构建ab资源都会是最新的。其他ab文件规则不变,还按照之前GF规则移动过去
    注意:刚开始Assembly这个文件夹里是没有内容的,这是正常现象,等StartBuildResource后,就有了。

  2. 我们打开GF里的ResourceBuilder 工具,点击Start Build Resource按钮,在根目录下没有ResourcesFiles文件夹的创建一个就好了。

  3. 构建完成在StreamingAssets 目录里可以看到我们构建的资源,目前我们是单机包所以AssetsHotfixAssetsNative都会到StreamingAssets 目录。比如我们打热更包的时候其中AssetsNative里的资源为包体资源也会到StreamingAssets目录,AssetsHotfix目录里的资源则不会到此目录。

补充:我先打包的单机资源,然后项目运行后丢失了图片或者说是图集资源,问了AlanDu,他得研究研究。就先弄热更资源了,后续再补充单机资源的问题吧。
注意:
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
1. 热更资源的时候,先打开Project Settings,把DeerSetting里边Resources的下载地址设置为本地部署的服务器。
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
2. 需要自己把ConfigVersion.xml文件从StreamingAssets下放到服务器Windows64文件夹下

本地部署服务器资源已经放好,如果没有本地服务器,来看这边 用XAMPP搭建本地Apache服务器
如果搭建完了不能访问到,那因该是需要解决跨域问题,这个看这里 XAMPP-Apache-解决跨域
记得点赞!


  1. 找到并打开BuildSetting界面点击build到对应出包目录。别忘了这里把场景加上

  2. 出包后,理论上我们就可以看到出包可以正常打开.

    补充:可以看出出包没问题了,我们进行更新就好,但之后出现的问题,和我之前打包的单机资源一样,这个得等AlanDu解决后同步出来了

  3. 至此打包完成,我们需要去测试热更了.


如果还有问题 点击链接加入群聊【Gf_Wolong热更集合】 群里见,再见ヾ(•ω•`)o