框架使用教程.md

Deer_GameFramework_Wolong框架使用教程

1.部署HybridCLR（Wolong）环境

1. github地址：基于GameFramework框架衍生的一个Wolong

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包前需要先构建一次软件包。因为构建ab包需要导入构建软件包之后生成的aot 元数据信息文件。

   注意：构建软件包之前确定设置【Scripting Backend】为Il2cpp 和【Api Compatibility Level*】 为.Net Framework，如下图

2.生成Luban配表

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

3.构建AB包

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

2. 我们打开GF里的ResourceBuilder 工具，点击StartBuildResource按钮

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

4.Build出包

1. 找到并打开BuildSetting界面

点击build到对应出包目录。

2. 出包后，我们就可以看到出包可以正常打开

5.测试热更

1. 测试热更资源

2. 测试热更代码

   1和2找到UILoginForm.prefab 预制体打开，新建一个按钮。打开UILoginForm.cs 脚本，把刚才的按钮逻辑写完，然后打印输出。

3. 回到构建ab包，打开gf的ResourceBuilder工具，点击StartBuildResource按钮，构建完成后我们找到StreamingAssets目录下的UILoginForm.bat ab资源复制到刚才出包目录下的StreamingAssets 下对应目录，重新打开exe包，可以看到界面变化。

热更流程完结-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

6.框架配置相关

1.框架相关信息

2.UI组件生成规则相关信息