HybridCLR+Addressable资源框架（二）

最新推荐文章于 2025-05-03 08:37:46 发布
最新推荐文章于 2025-05-03 08:37:46 发布
阅读量1.1k 收藏 22
点赞数 16
文章标签： unity3d 游戏
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_43329960/article/details/142097230
版权

上一篇介绍了HybridCLR的用法，这一篇讲一下通过Addressable 来下载热更dll 以及需要补充的元数据dll ，我们知道unity 是无法直接识别dll 文件，需要把那些dll 加上.byte 后缀，所以需要写个工具转换一下，首选我在Asset 下面新建HotUpdateDlls 文件夹，然后再分别建HotUpdateDll（存放热更dll 加byte后缀）MetaDataDll（存放元数据Aot 的dll 加byte后缀）
在这里插入图片描述
1、话不多说，直接上工具代码

static string HotUpdateDllPath => $"{Application.dataPath}/../HybridCLRData/HotUpdateDlls/{EditorUserBuildSettings.activeBuildTarget}/";

static string HotUpdateDestinationPath => $"{Application.dataPath}/HotUpdateDlls/HotUpdateDll/";

static string MetaDataDLLPath => $"{Application.dataPath}/../HybridCLRData/AssembliesPostIl2CppStrip/{EditorUserBuildSettings.activeBuildTarget}/";

static string MetaDataDestinationPath => $"{Application.dataPath}/HotUpdateDlls/MetaDataDll/";

static string AOTGenericReferencesPath => $"{Application.dataPath}/HybridCLRGenerate/AOTGenericReferences.cs";

[MenuItem("Build/第一次GenerateAll拷贝热更dll以及元数据dll")]
private static void HybridCLRCopyDll()
{
    // 是否有安装HybridCLR
    var controller = new InstallerController();
    if (!controller.HasInstalledHybridCLR()) 
    {
       Debug.LogError("HybridCLR is not Installer");
        return;
    }
    //执行HybridCLR
    PrebuildCommand.GenerateAll();
    CopyHotUpdateDll();
    CopyMetaDataDll();
}
[MenuItem("Build/CompileDllActiveBuildTarget拷贝以及热更dll")]
private static void HybridCLRHofixCopyDll()
{
    // 是否有安装HybridCLR
    var controller = new InstallerController();
    if (!controller.HasInstalledHybridCLR())
    {
        Debug.LogError("HybridCLR is not Installer");
        return;
    }
    CompileDllCommand.CompileDllActiveBuildTarget();
    CopyHotUpdateDll();
}


private static void CopyHotUpdateDll()
{
    var assemblies = SettingsUtil.HotUpdateAssemblyNamesExcludePreserved;
    var dir = new DirectoryInfo(HotUpdateDllPath);
    var files = dir.GetFiles();
    var destDir = HotUpdateDestinationPath;
    if (Directory.Exists(destDir))
        Directory.Delete(destDir, true);
    Directory.CreateDirectory(destDir);
    foreach (var file in files)
    {
        if (file.Extension == ".dll" && assemblies.Contains(file.Name.Substring(0, file.Name.Length - 4)))
        {
            var desPath = destDir + file.Name + ".bytes";
            file.CopyTo(desPath, true);
        }
    }

    AssetDatabase.SaveAssets();
    AssetDatabase.Refresh();
    Debug.Log("copy hot update dlls success!");
}
private static void CopyMetaDataDll()
{
    List<string> assemblies = GetMetaDataDllList();
    var dir = new DirectoryInfo(MetaDataDLLPath);
    var files = dir.GetFiles();
    var destDir = MetaDataDestinationPath;
    if (Directory.Exists(destDir))
        Directory.Delete(destDir, true);
    Directory.CreateDirectory(destDir);
    foreach (var file in files)
    {
        if (file.Extension == ".dll" && assemblies.Contains(file.Name))
        {
            var desPath = destDir + file.Name + ".bytes";
            file.CopyTo(desPath, true);
        }
    }
    AssetDatabase.SaveAssets();
    AssetDatabase.Refresh();
    Debug.Log("copy meta data dll success!");
}
private static List<string> GetMetaDataDllList()
{
    var aotGenericRefPath = AOTGenericReferencesPath;
    List<string> result = new List<string>();
    using (StreamReader reader = new StreamReader(aotGenericRefPath))
    {
        var lineStr = "";
        while (!reader.ReadLine().Contains("new List<string>"))
        {
        }

        reader.ReadLine();
        while (true)
        {
            lineStr = reader.ReadLine().Replace("\t", "");
            if (lineStr.Contains("};"))
                break;
            var dllName = lineStr.Substring(1, lineStr.Length - 3);
            result.Add(dllName);
        }
    }

    return result;
}

这个工具干的工作 就是把生成的dll 放到指定的文件夹下 ，要说一下，元数据dll 其实是读的HybridCLRGenerate/AOTGenericReferences 里面的PatchedAOTAssemblyList
2，首先建两个场景，一个是 GameLaunher 启动场景，属于Aot（在Scenes In Build 勾选上），另一个是GameStart 场景，GameStart 是热更新完成后首个加载的热更新场景，只需要把热更脚本 挂载在这个场景上就行了 ，而且还不需要任何反射操作，也是官方推荐的做法
在这里插入图片描述
3、来看一下 Addressable 的分组，直接把所对应的文件夹拖上去就行了
在这里插入图片描述
4、先建一个热更程序集，看下图
在这里插入图片描述
5、首先在GameLaunher 新建一个进度条 ，然后挂上Launher 启动脚本
在这里插入图片描述
直接看Launher 脚本

 private byte[] _dllBytes;
 public Slider slider;
 void Start()
 {
     StartCoroutine(GameLaunch());
 }

 private IEnumerator GameLaunch() 
 {
     yield return DoUpdateAddressadble();   // 加载ab 
     yield return LoadDll();
     yield return EnterGame();
 }
 IEnumerator DoUpdateAddressadble()
 {
     AsyncOperationHandle<IResourceLocator> initHandle = Addressables.InitializeAsync();
     yield return initHandle;

     // 检测更新
     var checkHandle = Addressables.CheckForCatalogUpdates(false);
     yield return checkHandle;
     if (checkHandle.Status != AsyncOperationStatus.Succeeded)
     {
         Debug.LogError($"CheckForCatalogUpdates Error{checkHandle.OperationException.ToString()}");
         yield break;
     }
     if (checkHandle.Result.Count > 0)
     {
         var updateHandle = Addressables.UpdateCatalogs(checkHandle.Result, false);
         yield return updateHandle;

         if (updateHandle.Status != AsyncOperationStatus.Succeeded)
         {
             Debug.LogError($"UpdateCatalogs Error{updateHandle.OperationException.ToString()}");
             yield break;
         }

         // 更新列表迭代器
         List<IResourceLocator> locators = updateHandle.Result;
         foreach (var locator in locators)
         {
             List<object> keys = new List<object>();
             foreach (var key in locator.Keys)
             {
                 if (key is string)
                 {
                     keys.Add(key);
                 }
             }
             var sizeHandle = Addressables.GetDownloadSizeAsync(keys);
             yield return sizeHandle;
             if (sizeHandle.Status != AsyncOperationStatus.Succeeded)
             {
                 Debug.LogError($"GetDownloadSizeAsync Error{sizeHandle.OperationException.ToString()}");
                 yield break;
             }

             long totalDownloadSize = sizeHandle.Result;
             Debug.Log("download size : " + totalDownloadSize);
             if (totalDownloadSize > 0)
             {
                 // 下载
                 var downloadHandle = Addressables.DownloadDependenciesAsync(keys, Addressables.MergeMode.Union);
                 while (!downloadHandle.IsDone)
                 {
                     if (downloadHandle.Status == AsyncOperationStatus.Failed)
                     {
                         Debug.LogError($"DownloadDependenciesAsync Error{downloadHandle.OperationException.ToString()}");
                         yield break;
                     }
                     // 下载进度
                     float percentage = downloadHandle.PercentComplete;
                     Debug.Log($"已下载: {percentage}");
                     slider.value = percentage;
                     yield return null;
                 }
                 if (downloadHandle.Status == AsyncOperationStatus.Succeeded)
                 {
                     Debug.Log("下载完毕!");
                     slider.value = 1f;
                 }
             }
             else
             {
                 Debug.Log("无下载");
                 slider.value = 1f;
             }
         }
     }
     else
     {
         Debug.Log("没有检测到更新!");
         slider.value = 1f;
     }

     // 进游戏
 }
 private IEnumerator LoadDll()
 {
     yield return LoadMetadataForAOTAssemblies();
     yield return LoadGameHotUpdateDll();
     yield return ReloadAddressableCatalog();
     Debug.Log("LoadAssemblies finish!");
     yield return null;
 }
 private IEnumerator LoadGameHotUpdateDll()
 {
     var path = $"Assets/HotUpdateDlls/HotUpdateDll/GameHotUpdate.dll.bytes";
     ReadDllBytes(path);
     if (_dllBytes != null)
     {
         var assembly = Assembly.Load(_dllBytes);
         Debug.Log($"Load Assembly success,assembly Name:{assembly.FullName}");
     }

     yield return null;
 }
 //补充元数据
 private IEnumerator LoadMetadataForAOTAssemblies()
 {
     List<string> aotDllList = new List<string>
         {
             "mscorlib.dll",
             //"System.dll",
             //"System.Core.dll", // 如果使用了Linq，需要这个
         };

     foreach (var aotDllName in aotDllList)
     {
         var path = $"Assets/HotUpdateDlls/MetaDataDll/{aotDllName}.bytes";
         ReadDllBytes(path);
         if (_dllBytes != null)
         {
             var err = HybridCLR.RuntimeApi.LoadMetadataForAOTAssembly(_dllBytes, HomologousImageMode.SuperSet);
             Debug.Log($"LoadMetadataForAOTAssembly:{aotDllName}. ret:{err}");
         }
     }
     yield return null;

     Debug.Log("LoadMetadataForAOTAssemblies finish!");
 }
 private void ReadDllBytes(string path)
 {
     var dllText = LoadAsset<TextAsset>(path);

     if (dllText == null)
     {
         Debug.LogError($"cant load dllText,path:{path}");
         _dllBytes = null;
     }
     else
     {
         _dllBytes = dllText.bytes;
     }

     UnloadAsset(dllText);
 }

 #region 为了方便 所以写到这里了 
 public T LoadAsset<T>(string path)
 {
     var op = Addressables.LoadAssetAsync<T>(path);
     if (!op.IsValid())
         return default;
     op.WaitForCompletion();
     return op.Result;
 }
 public IEnumerator LoadScene(string sceneName)
 {
     var op = Addressables.LoadSceneAsync(sceneName, LoadSceneMode.Single);
     yield return op;
     if (op.Status != AsyncOperationStatus.Succeeded)
     {
         Debug.LogError(
             $"load scene failed,exception:{op.OperationException.Message} \r\n {op.OperationException.StackTrace}");
     }
 }
 public void UnloadAsset(UnityEngine.Object asset)
 {
     if (asset != null)
         Addressables.Release(asset);
 }
 // 加载完dll 要  重新加载catalog
 private IEnumerator ReloadAddressableCatalog()
 {
     var op = Addressables.LoadContentCatalogAsync($"{Addressables.RuntimePath}/catalog.json");
     yield return op;
     if (op.Status != AsyncOperationStatus.Succeeded)
     {
         Debug.LogError(
             $"load content catalog failed, exception:{op.OperationException.Message} \r\n {op.OperationException.StackTrace}");
     }
 }
 private IEnumerator EnterGame()
 {
     yield return LoadScene("Assets/Scenes/GameScenes/GameStart.unity");
     Debug.Log("EnterGame");
 }
 #endregion

注意：ReloadAddressableCatalog 这个方法 在加载完dll 跑一下，请看官网所提到的bug
在这里插入图片描述
如果想看更详细的，请看这位大佬写的博客 ok，剩下的 就按照Addressable 的打包资源流程走就行了 ，我这边 安卓和IOS 都跑一遍没问题，有啥不对的，欢迎小伙伴来指正哈

热更新方案 HybridCLR 学习教程 |（一）原理及准备工作
努力前行，总会成为自己心中的那道光
04-17 2万+
前面文章介绍了热更新相关的知识，包括使用xLua实现热更新实战等 那本文就来介绍一下 热更新方案 HybridCLR(代号wolong，原huatuo)和基本使用方法。 若是想了解更多关于HybridCLR的东西也可以去 官网 详细查阅。
HybridCLR+Addressables热更新（1）
惊鸿醉的博客
11-25 524
HybridCLR+Addressables热更新——环境配置
Unity 热更新(HybridCLR+Addressable)-创建Addressable资源
renkai2heng的博客
09-24 364
三、创建Addressable资源 创建三个文件夹，放Addressable资源，里面对应放程序集，预制体以及场景 拖拽到Addressable Groups对应组中 其中文件名太长，带着路径，可以简化名字 创建一个脚本，对于这个脚本进行一个打包程序集 把所有的进行一个生成 生成完成后，在Assets文件夹下会生成一个文件夹 这个是补充元素集 生成完成后就可以打包到当前平台 在Assets同级文件夹下的HybridCLRData\HotUpdateDlls\StandaloneWindows
Unity热更新-HybirdCLR + Addressable
WEIWEI6661012的博客
08-06 4499
Unity实现简单远程热更新，使用HybirdCLR + Addressable，然后就不知道说什么了.....
HybridCLR 详解：Unity 全平台原生 C# 热更新方案
最新发布
2302_76776557的博客
05-03 1366
HybridCLR（原 Huatuo）是 Unity 平台革命性的热更新解决方案，它通过扩展 Unity 的 IL2CPP 运行时，实现了基于原生 C# 的完整热更新能力。下面从原理到实践全面解析这一技术。
HybridCLR+Addressables资源代码全热更框架 二
枫尘。的博客
07-04 8754
HybridCLR，addressable，热更
HybridCLR + Addressable 热更新篇（一）
脚踏实地,实事求是。
07-09 1235
随着移动互联网和游戏行业的快速发展，热更新技术变得越来越重要。热更新能够在不重新发布应用的情况下更新内容和功能，提高了开发效率和用户体验。本篇将介绍如何使用HybridCLR和Addressable实现Unity项目的热更新
Unity热更新HybridCLR+Addressables
u010197227的博客
07-03 997
"HybridCLR/编译热更DLL，并且拷贝到Addressable"
Unity最新热更新框架 hybridclr_addressable
Momo_Da的博客
04-04 2399
为了支持2019，需要修改il2cpp生成的源码，因此我们修改了2019版本的il2cpp.exe工具。你可以先把 [com.focus-creative-games.hybridclr_unity](https://github.com/focus-creative-games/hybridclr_unity) clone或者下载到本地，然后再 [install from disk](https://docs.unity3d.com/Manual/upm-ui-local.html)
基于HybridCLR + Addressable热更新框架，提供例子基于GameFramework开发的塔防游戏.zip
09-20
Unity Engine基于HybridCLR + Addressable的热更新框架，提供例子基于GameFramework开发的塔防游戏.zip项目工程资源经过严格测试可直接运行成功且功能正常的情况才上传，可轻松复刻，拿到资料包后可轻松复现出一样的...
Unity Engine是一个基于HybridCLR+Addressable的热门更新框架，提供了
10-23
结合HybridCLR和Addressable的Unity更新框架，为游戏开发人员提供了一个既强大又灵活的解决方案，以便快速迭代游戏内容，快速响应玩家反馈，并即时部署更新，保持游戏的活跃度和参与度。 游戏框架（GameFramework）...
Unity使用HybridCLR+Addressables热更新（二）
加载中.......
12-16 1090
Unity使用HybridCLR+Addressables热更新（二）本次讲解属于简单的使用，可以帮助你简单的学习，最终的框架搭建文章结尾附上牛人搭好的链接。
Unity使用HybridCLR+Addressables热更新（一）
加载中.......
12-16 1216
Unity使用HybridCLR+Addressables热更新（一）每种热更新方案都有其优缺点，选择哪种方案通常取决于项目的需求、团队的技术栈以及维护的复杂度。对于资源热更新，可以选择 Unity 自带的 Addressables 和 AssetBundle；而对于代码热更新，ILRuntime、xlua 和 HybridCLR 是目前比较常用的解决方案。资源更新：使用来管理和更新资源，这将确保资源加载的效率和灵活性。代码更新：使用HybridCLR进行代码热更新，以保证代码逻辑的灵活性和更新能力。
Addressable从入门到实战
06-16
小新：“这Assetbundle真的搞得我太头大了，为什么要整的这么复杂呢？” 大智：“那是因为游戏里的资产管理本来就很复杂，但是Assetbundle其实只提供了很基础的功能，甚至打包及加载都需要你自己写很多代码才能做好。” 小新：“我的天呐。” 大智：“不过最近Unity刚出了一个新功能，Addressable，现在你不学Assetbundle都问题不大了。” 小新：“哇，这不巧了么不是。Addressable又是个什么鬼，名字怎么这么拗口。” 大智：“Addressable是基于Assetbundle的一个高级资源管理系统，包含了资产的打包、加载、更新、缓存等等几乎原来使用Assetbundle所需考虑的所有功能。” 小新：“看来是个好东西，我得学一学。” 大智：“那Addressable的教程呢，我已经开始制作了，目前计划的内容如下：” Addressable入门 Addressable使用流程 Addressable打包 Addressable加载 Addressable内置资产托管服务的用法 Addressable Profilter的用法 Addressable Anal
HybridCLR+Addressables资源代码全热更框架 一
枫尘。的博客
07-04 4087
HybridCLR，addressable，热更
Unity 之 Addressable可寻址系统 -- HybridCLR(华佗)+Addressable实现资源脚本全热更 -- 实战（二）
陈言必行 -- Unity游戏开发领域优质博主
01-21 5057
使用Addressable的热更新资源的机制，结合HybridCLR(华佗)对脚本的封装。实现资源和脚本全部热更新控制。
HybridCLR+Addressable资源框架（一）
weixin_43329960的博客
09-06 990
注意：还有一点，对于unity 版本 官方建议2019.4.40、2020.3.26+、 2021.3.0+、2022.3.0+ 中任一版本，对于Windows的平台 装VS 的时候，一定要安装Unity的游戏开发 和 使用c++的游戏开发 组件，其中C++游戏开发组件 一定要安装相关系统的sdk ，你是win10 的时候 就安装win10 最新的sdk 就行了 ，不然打包的时候 会报这种类似的错。看看，官网上文档写得很清楚，还有对Addressable不清楚的话 ，建议先去看我上几篇写得关于。
Unity热更新-HybirdCLR + Addressable 一
colooooooo的博客
01-02 2671
Unity现在热更新技术都很全面了，本文采用HybirdCLR + Addressable实现代码与资源热更，也参考了Hybird官方案例、以及其他各个大佬写的博客
Unity热更新之HyBirdCLR+Addressables（一）
hdjdjdhzhz的博客
09-11 1963
热更新的好处：避免重复打包，减小包体的大小，快速解决bug。
HybridCLR与Addressable热更新资源整合方案解析
本文档主要介绍如何使用HybridCLR（华佗）技术配合Addressable资源管理系统实现游戏或其他软件应用中的资源脚本的全热更新（Hot Update）功能。热更新是指在不重新发布整个应用的情况下，对应用的资源和脚本进行更新...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值