GF_CLR初始用 - 正式版

67 阅读4分钟

DeerGF_CLR初始用 - 正式版

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

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

一. 部署 HybridCLR(Wolong) 环境

  1. 首先安装Windows Build Support (IL2CPP)image.png
  2. 要完整的克隆项目,工程地址 。打开项目在编辑器菜单栏可以看到【HybridCLR--Installer..】安装界面,第一次打开工程先安装HybridCLR

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

  1. HybridCLR--hybridcly_unity】点击enable,开启工程里的插件开关,表示框架是否接入插件,这个开关和【HybridCLRSettings】里的enable不同。
    注意:如果需要热更需要同时开始【HybridCLR--hybridcly_unity】的enable 和【HybridCLRSettings】的enable开关,如果不启动热更新代码,则要同时关闭这两个开关。
  2. 打开工程找到工具栏【HybridCLR--Generate--All】生成桥接文件,link文件等等。
注意:如果后边打包后加载不出来内容,多进行本步骤几次

image.png image.png

  1. 在【HybridCLRSettings】里设置需要更新的程序集,项目克隆后本身就已经带有,没有的需要自行添加。 image.png
  2. 第一次构建ab包需要先构建一次软件包(也就是Build一次exe文件)。因为构建ab包需要导入构建软件包之后生成的AOT元数据信息文件。

注意:构建软件包之前确定以下几点:
【Scripting Backend】为 Il2cpp
【Api Compatibility Level*】 为 .Net Framework,如下图 image.png 补充: 如果打包报错是下边的内容,就去群里看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.


二. 生成Luban配表

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

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

image.png image.png

三. 构建AB包

  1. 所有热更代码 及aot代码都会放到 assembly.bat ab包里,Assembly文件夹在GF里的ResourceEditor 工具里不用从AssetList移动到ResourceList里,每次构建ab资源都会是最新的。其他ab文件规则不变,还按照之前GF规则移动过去。

注意: 刚开始Assembly这个文件夹里是没有内容的,这是正常现象,等StartBuildResource后,就有了。

image.png

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

image.png

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

image.png image.png

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

image.png

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

image.png image.png

四. Build出包&运行

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

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

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

image.png image.png

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

五. 热更测试

  1. 资源热更测试和代码热更测试一次做,直接看下一步骤
  2. 找到UIMenuForm.prefab 预制体打开,新建一个按钮。打开UIMenuForm.cs脚本,把刚才的按钮逻辑写完,然后打印输出。

image.png image.png

  1. 回到构建ab包,打开GFResourceBuilder工具,点击StartBuildResource按钮,构建完成后我们找到资源(如果是Package模式,则为StreamingAssets) 目录下的UIMenuForm.bat ab资源复制到刚才出包目录下的资源对应目录(如果是Package模式,则为StreamingAssets) ,重新打开exe包,可以看到界面变化。 image.png image.png
  2. 至此,热更也测试完毕,开始我们自己的项目吧。

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