Unity热更新方案C#Like(廿五)-实战:示范如何建立初始包CSharpLikeFreeDemo项目

C#Like

已于 2023-11-17 17:31:27 修改

阅读量121

点赞数

分类专栏： C#Like 文章标签： unity c# 游戏引擎 lua .net 游戏程序游戏

于 2023-11-16 20:04:27 首次发布

本文链接：https://blog.csdn.net/noodle009/article/details/134447702

版权

C#Like 专栏收录该内容

26 篇文章 3 订阅

订阅专栏

C#Like是Unity的热更方案,使用纯C#语言写出可以热更新的代码,就像可以在所有平台使用DLL(动态链接库)文件一样.遵从KISS设计原则,让用户轻松构建或升级成Unity的热更新项目.

简介

本篇主要介绍如何一步一步地详细地导出初始包CSharpLikeFreeDemo项目.即配置不包含任何代码和资源的非热更新部分的环境.这里以CSharpLikeFreeDemo为示范

搭建的详细步骤

我们有了上一个代码很少的项目经验后,我们再选取一个代码比较多一些的Unity出品的免费的例子"Platformer Microgame"作为示范,即官方Demo里的"PlatformerMicrogameFree"项目是如何制作

创建一个空白的2D/3D项目为CSharpLikeFreeDemo
到Unity资源商店购买相关的免费资源: 如果已购买的则跳过
- 免费购买C#Like免费版
导入相关的免费资源:
- 先打开Package Manager界面 : 菜单'Window'->'Package Manager'
- 导入'C#Like免费版' : 'Packages: My Assets'->'C#LikeFree Hot Update Framework'->'Import'
删除内置的热更新代码和资源, 确保我们初始包不包含任何'内置的例子C#Like Demo'的代码和资源
- 删除目录'Assets\C#Like\Sample'
- 删除目录'Assets\C#Like\HotUpdateScripts'
- 删除场景'Assets\C#Like\Scenes\BuildInDemoScene.unity'
导入我们热更游戏相关的必要的依赖库: 这个我们需要分析一下我们的热更新的游戏是需要哪些依赖库的, 而且这些依赖库是非热更新的,我们需要提前包含进初始包内
- 如何知道我要什么依赖库呢? 打开你想要热更新的项目,菜单'Window'->'Package Manager'->'Packages:In Project', 看看里面用到哪些依赖库,然后在初始包的项目里添加进去.
- '内置的例子C#Like Demo'并没有什么特别的依赖库
- 'Tanks! Tutorial'用到的依赖库 :
  1. TextMeshPro
  2. 2D Sprite
  3. 2D Tilemap Eitor
  4. Multiplayer HLAPI
- 'Platformer Microgame'用到的依赖库 :
  1. Cinemachine
  2. TextMeshPro
  3. 2D Animation
  4. 2D Pixel Perfect
  5. 2D PSD Importer
  6. 2D Sprite
  7. 2D SpriteShape
- 合并上述的依赖库添加到我们的初始包项目中

合并我们热更游戏的裁剪配置文件'link.xml'和AOT文件'AheadOfTime.cs': 点击按钮"Merge JSON manually"的时候会自动合并各项目的'link.xml'和'AheadOfTime.cs'的了

'Assets/C#Like/link.xml'是防止IL2CPP的时候把我们热更新游戏需要用到的依赖库代码被裁剪掉, 因为Unity没有找到我们使用它的地方,会当做垃圾代码的裁剪掉.所以我们得告诉Unity,哪个是我需要的,千万别裁剪.
'Assets/C#Like/Runtime/AheadOfTime/AheadOfTime.cs'是包含所有热更新项目里用到的类或结构体,主要用于提前注册模板类的, 防止用到的时候提示AOT异常.

最终的当前项目的'Assets/C#Like/link.xml'如下:

<linker>  
    <assembly fullname="System" preserve="all"></assembly>  
    <assembly fullname="mscorlib" preserve="all"></assembly>  
    <assembly fullname="Assembly-CSharp" preserve="all"></assembly>  
    <assembly fullname="UnityEngine" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.CoreModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.UIModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.AudioModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.ParticleSystemModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.PhysicsModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.AnimationModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.TextRenderingModule" preserve="all"></assembly>  
    <assembly fullname="UnityEngine.InputLegacyModule" preserve="all"></assembly>  
    <assembly fullname="Unity.Postprocessing.Runtime" preserve="all"></assembly>  
    <assembly fullname="com.unity.multiplayer-hlapi.Runtime" preserve="all"></assembly>  
    <assembly fullname="Unity.TextMeshPro" preserve="all"></assembly>  
</linker>

包含必要的Shader资源:
- 菜单'Edit'->'Project Settings'->'Graphics->Always Included Shaders'
- 这个看你的热更项目使用了什么Shader资源了
- 新加2个Shader,依次为'Standard'和'Legacy Shaders/Particles/Alpha Blended Premultiply',如下图
配置必要的输入: 注意不同的游戏有不同的输入设置,现在我们合并它,尽量别冲突
- 菜单'Edit'->'Project Settings'->'Input Manager'
- 根据不同的热更新游戏的输入,合并到本项目. 提示:可以到热更新项目里点击右键复制,然后到本项目里粘贴上去的哦
- 注意:如果相同名字的且设置不同的,建议要换个名字哦

处理WebGL下,'Tanks! Tutorial'项目AudioClip音效报错的问题: 'Platformer Microgame'的音效没问题,可能无需这种特殊处理

由于WebGL加载AudioClip异常,提示FMOD错误之类的,只好改为手动加载涉及的AudioClip,代码如下:

ResourceManager.LoadAudioClipAsync("https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/ShellExplosion.wav", AudioType.WAV, (AudioClip audioClip) =>  
{  
    m_ExplosionAudio.clip = audioClip;  
});

音效文件放到你自己的网站下载,即原游戏B的音效文件'Assets/AudioClips/*.*'(我是经过转码变小后方便下载)放到网站里下载,总共7个wav文件:

https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/BackgroundMusic.wav
https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/EngineDriving.wav
https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/EngineIdle.wav
https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/ShellExplosion.wav
https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/ShotCharging.wav
https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/ShotFiring.wav
https://www.csharplike.com/CSharpLikeFreeDemo/AssetBundles/Tank/WebGL/TankExplosion.wav

修改Unity配置:
- 打开'Assets/C#Like/Scenes/SampleScene.unity'场景
- 菜单 'File'->'Build Settings...'
- 点击'Add Open Scenes',令'C#Like/Scenes/SampleScene'成为'Scenes In Build'里面首个场景(而非默认的空白场景'Scenes/SampleScene')
- 选中"WebGL"后点击"Switch Platform"按钮切换当前Platform到WebGL
- 点击"Player Setting..."按钮,然后按需修改
  1. "Resolution and Presentation"
    - "Default Canvas Width" 600
    - "Default Canvas Height" 960
    - "Run In Background" "v"
  2. "Other Settings"
    - "Api Compatibility Level" ".NET Standard 2.0"
    - "Strip Engine Code" "v"
    - "Managed Stripping Level" "Medium"
  3. "Publishing Settings"
    - "Enable Exceptions" "Explicitly Thrown Exceptions Only"
    - "WebAssembly Arithmetic Exceptions" "Throw"
    - "Compression Format" "Gzip"
    - "Data Caching" "v"
    - "Decompression Fallback" "v"