【Unity实战】HybridCLR热更快速集成

admin • 2024-02-24 20:57 • 游戏开发

本文假设你已经通过UPM导入了HybridCLR、Addressables、il2cpp支持并具有一定的C#基础和Unity编辑器操作能力。

热更程序集

由于本文主打快速集成，故将Assembly-CSharp划入到热更新DLL。理论上成熟的项目应该用Assembly Definition进行精细划分以便于管理和缩短编译时间。但是若掌握不好，划分不明白，可能会出现交叉引用导致反射机制原地GG。

有关Assembly Definition，请见官方文档。

Unity - Manual: Assembly definitions

打开Project Settings，找到Hybrid Settings，手动将Assembly-CSharp添加到热更新DLL范围内。

如果你有Assembly Definition，也请添加到红框上方的属性中。请注意，热更新Assembly Definition和热更新dlls属于“并且”关系，不能存在相同项。

比如你把Assembly Definition的名写到了底下热更新dlls里头了，然后上面热更新Assembly Definition那里你还把你刚才手动填名字的Assembly Definition给拖进去了。

另起一个热更入口程序集和场景

由于Assembly-CSharp为热更新DLL，那么客户端拉取热更资源的逻辑就不能放在Assembly-CSharp，否则反射机制不起作用，还带来报错。

在这个程序集的同级目录或者子级目录起一个热更入口脚本，具体怎么拉Addressables更新这里就省略了，加载热更DLL的逻辑可参考如下：

    /// <summary>
	/// 加载热更的DLL
	/// </summary>
	IEnumerator LoadHotfixDLLs()
	{
#if !UNITY_EDITOR
        // 读取的热更dll
        var hotFixDllLabelHandle = Addressables.LoadAssetsAsync<TextAsset>("HotUpdateDLL", null);
        yield return hotFixDllLabelHandle;
        var hotFixDlls = hotFixDllLabelHandle.Result;
        Addressables.Release(hotFixDllLabelHandle);
        // 加载获得的dll
        foreach (var hotFixDll in hotFixDlls) {
            Assembly.Load(hotFixDll.bytes);
        }
        Debug.Log("[HotUpdater] LoadHotfixDLLs complete!");
#endif
		yield return null;
	}
	/// <summary>
	/// 加载aot的DLL
	/// </summary>
	/// <returns></returns>
	IEnumerator LoadMetadataForAOTDLLs()
	{
#if !UNITY_EDITOR
		HomologousImageMode mode = HomologousImageMode.SuperSet;
        var aotMetadateDllHandle = Addressables.LoadAssetsAsync<TextAsset>("AOTMetadataDLL", null);
        yield return aotMetadateDllHandle;
        var AOTMetadataDlls = aotMetadateDllHandle.Result;
        foreach (var AOTMetadataDll in AOTMetadataDlls)
        {
            LoadImageErrorCode err = RuntimeApi.LoadMetadataForAOTAssembly(AOTMetadataDll.bytes, mode);
            Debug.Log($"[HotUpdater] LoadMetadataForAOTAssembly:{AOTMetadataDll.name}. mode:{mode} ret:{err}");
        }
        Addressables.Release(aotMetadateDllHandle);
		Debug.Log("[HotUpdater] LoadMetadataForAOTDLLs complete!");
#endif
		yield return null;
	}

	IEnumerator EnterGame()
	{
		yield return LoadMetadataForAOTDLLs();
		yield return LoadHotfixDLLs();
		Addressables.LoadSceneAsync("MainMenu").Completed += (obj) =>
		{
			if (obj.Status == AsyncOperationStatus.Succeeded)
			{
				Debug.Log("[HotUpdater] Successfully load into MainMenu.");
			}
			else
			{
				Debug.LogError("[HotUpdater] Failed to load MainMenu scene!");
			}
		};
	}

简而言之就是加载完热更DLL后和AOT元数据DLL后再进入你游戏的主场景（或者说有引用Assembly-CSharp代码的东西）。

这里笔者假定你的热更新DLL以及元数据DLL在Addressables里各自有标签，于是全拉出来进行Assembly.Load。

你可能会注意到宏，编辑器环境下测试是不能读取热更DLL的，因为属于同一个程序集加载了两遍，浪费不说还带来问题。