GF框架+XIL 项目整合

article/2025/11/10 20:49:11

项目unity版本:2020.3.18f1
XIL版本：Commits on Oct 26, 2021
GameFramework版本：Commits on Sep 28, 2021
UnityGameFramework版本：Commits on Oct 28, 2021
StarForce版本：Commits on Aug 9, 2021
HFS版本：2.3

项目克隆：

StarForce克隆仓库：https://github.com/EllanJiang/StarForce
UnityGameFramework克隆仓库：https://github.com/EllanJiang/UnityGameFramework
GameFramework克隆仓库：https://github.com/EllanJiang/GameFramework
GameFramework使用手册看源码

StartForce源码配置

1.在StarForce\Assets\GameFramework放入UnityGameFramework
2.在StarForce\Assets\GameFramework\UnityGameFramework\Libraries，把dll换成GameFramework内容。此时会报错，缺少命名空间引用。右键Libraries目录Assembly Definition生成名为GameFramework的程序集，找到UnityGameFramework.Editor和UnityGameFramework.Runtime添加GameFramework程序集的引用，报错即可消失。
3.检查不安全代码的勾是否勾上。

模拟远程AB热更配置

HFS 虚拟文件服务器

HFS下载地址:HFS

AB配置

在这里插入图片描述

打包出来目录结构是这样子的

在这里插入图片描述

在AB目录创建一个名为version.txt的文件，以json协议检查AB配置，配置此文件最好打开VersiongInfo.cs脚本配合食用，毕竟不知道代码变更，如果只是抄我的字段，那此坑得填。

namespace StarForce
{public class VersionInfo{// 是否需要强制更新游戏应用public bool ForceUpdateGame{get;set;}// 最新的游戏版本号public string LatestGameVersion{get;set;}// 最新的游戏内部版本号public int InternalGameVersion{get;set;}// 最新的资源内部版本号public int InternalResourceVersion{get;set;}// 资源更新下载地址public string UpdatePrefixUri{get;set;}// 资源版本列表长度public int VersionListLength{get;set;}// 资源版本列表哈希值public int VersionListHashCode{get;set;}// 资源版本列表压缩后长度public int VersionListCompressedLength{get;set;}// 资源版本列表压缩后哈希值public int VersionListCompressedHashCode{get;set;}}
}

在这里插入图片描述

这里的VersionList数据根据StarForce\AB\BuildReport\0_1_0_XX\BuildLog.txt找到

{"ForceGameUpdate":false,//是否强制更新"LatestGameVersion":"0.1.0",//最新的游戏版本号"InternalGameVersion":1,//最新的游戏内部版本号"InternalResourceVersion":3,//最新的资源内部版本号"UpdatePrefixUri":"http://10.23.48.21/Windows64", //服务器资源更新地址"VersionListLength":7104,//特指GameFrameworkVersion.xxxxx.dat文件的大小"VersionListHashCode":2063015162,//GameFrameworkVersion.xxxxx.dat文件hash"VersionListCompressedLength":2559,//特指GameFrameworkVersion.xxxxx.dat文件压缩后的大小"VersionListCompressedHashCode":-131527863,//GameFrameworkVersion.xxxxx.dat文件压缩后的hash"END_OF_JSON":""//结束符
}

打开文件StarForce\Assets\GameMain\Configs\BuildInfo.txt

{"GameVersion": "0.1.0",//最新的游戏版本号"InternalGameVersion": 0,//最新的游戏内部版本号"CheckVersionUrl": "http://10.23.48.21/Version.txt",//服务器文件version.txt地址"WindowsAppUrl": "http://10.23.48.21/Windows64",//win资源服务器"MacOSAppUrl": "https://starforce.gameframework.cn",//macOS资源服务器"IOSAppUrl": "https://starforce.gameframework.cn",//ios资源服务器"AndroidAppUrl": "https://starforce.gameframework.cn",//android资源服务器"END_OF_JSON": ""
}

打开HFS.exe,往里面存放full目录下的Window64和version.txt文件
在这里插入图片描述

检查Procedure是否都勾上

去掉Editor Resource Mode勾

打包运行。

代码热更

XIL仓库地址：XIL
XIL使用手册看官方文档和源码

给StartForce配置XIL

1.把Demo、hotScripts、XIL三个目录放到StartForce/Assets目录下在这里插入图片描述

2.在StartForce目录下新建HotProject~放入XIL目录下的Hot目录、DyncDll.csproj文件、Hot.sln解决方案在这里插入图片描述

在这里插入图片描述

修复编译报错

1.Hot.sln解决方案，在解决方案看dll引用，如果报黄色警告都是需要修复，
在这里插入图片描述
2.打开DyncDLL.csproj文件，修改依赖路径。

3.如何修呢，怎么知道哪些需要哪些不需要呢，我秉承一贯原则，有需要才加，像Analytics（Services玩家数据埋点接口）、Newtonsoft.Json（json工具）、Purchasing.Common、UntiyEngine.Purchasing（IAP内购支付接口）等我都直接删除.剩下些必要的就修改本机对应路径就行。

4.编辑器跑一下demo，修复奇奇怪怪的报错

5.测试热更前，做一下准备。

1.该在GF哪个流程加载dll？

ProcedurePreload.PreloadResource进行资源加载。

        private void PreloadResources(){// Preload configsLoadConfig("DefaultConfig");// Preload data tablesforeach (string dataTableName in DataTableNames){LoadDataTable(dataTableName);}// Preload dictionariesLoadDictionary("Default");// Preload fontsLoadFont("MainFont");LoadDLL("DyncDll");//GameEntry.Procedure.gameObject.AddComponent<HelloWorld>();}private void LoadDLL(string dllName){string dllAssetName = AssetUtility.GetDLLAsset(dllName, false);//Debug.Log(dllAssetName);GameFrameworkLog.Debug("dll:{0}",dllAssetName);m_LoadedFlag.Add(dllAssetName, false);GameEntry.Resource.LoadBinary(dllAssetName, new LoadBinaryCallbacks((assetName, asset, duration, userData) =>{m_LoadedFlag[dllAssetName] = true;GameFrameworkLog.Debug(asset);GameFrameworkLog.Debug(userData);GameFrameworkLog.Debug(duration);GameFrameworkLog.Debug(assetName);
#if USE_HOTwxb.hotMgr.DLL = asset;wxb.hotMgr.isGF = true;
#endifHelloWorld hellowrod = GameEntry.WebRequest.gameObject.AddComponent<HelloWorld>();Debug.Log(asset);},(assetName, status, errorMessage, userData) =>{Log.Error("Can not load font '{0}' from '{1}' with error message '{2}'.", dllAssetName, assetName, errorMessage);}));}

2.dll以什么形式打AB包？

把DyncDll.dll改成DyncDll.dll.bytes
以Load From Binary形式进行打包和加载。

3.XIL现在能支持什么形式加载域？

demo里例子是支持文件加载。客户端打包exe的GF加载框架需要添加以byte[]加载适配。

		byte[] dll { get; set; }public EditorResLoadRuntime(byte[] dll){this.dll = dll;}public Stream GetStream(){return new MemoryStream(dll);}

完整代码会上传到github仓库
仓库地址：GF-XIL
1.安装hfs，把打包的资源和version.txt放上去。
2.更改version.txt的UpdatePrefixUri为你自己的ip地址
3.更改BuildInfo文件里的ip为你自己的ip地址
4.把StarForce Launcher、Main、Menu场景放入BuildSettings里，打包出一个可以运行exe.运行即可.
5.如果想要在编辑器运行demo，点击Hotfix inject in Editor即可。