Unity | 资源热更（YooAsset AB）

一、AssetBundle

1. 插件AssetBundle Browser 打AB包

（1）Unity（我用的版本是2020.3.8）导入AssetBundle Browser

（2）设置Prefab

（3）AssetBundleBrowser面板

2. 代码打AB包

二、YooAsset

1. 准备工作

（1）官方文档

（2）通过Packages清单安装YooAsset

2.全局配置

3.资源配置

（1）Enable Addressable

（2）Pack Rule打包规则

4.资源构建

（1）Build Mode

（2）Encryption

5.YooAsset运行时

（1）初始化

（2）资源系统的运行模式

（3）获取资源版本

（4）更新资源清单

（5）资源包下载

（6）资源加载

（7）完整TestLoad

6.YooAsset测试

三、参考资料

一、AssetBundle

AB包可以存储绝大部分Unity资源但无法直接存储C#脚本，所以代码的热更新需要使用Lua或者存储编译后的DLL文件。

AB包不能重复进行加载，当AB包已经加载进内存后必须卸载后才能重新加载。

多个资源分布在不同的AB包可能会出现一个预制体的贴图等部分资源不在同一个包下，直接加载会出现部分资源丢失的情况，即AB包之间是存在依赖关系的，在加载当前AB包时需要一并加载其所依赖的包。

打包完成后，会自动生成一个主包(主包名称随平台不同而不同)，主包的manifest下会存储有版本号、校验码(CRC)、所有其它包的相关信息（名称、依赖关系）。

1. 插件AssetBundle Browser 打AB包

（1）Unity（我用的版本是2020.3.8）导入AssetBundle Browser

从github下载插件，将下载后的安装包解压到Unity工程的Packages文件夹下，如果报错，删除Tests即可。

（2）设置Prefab

（3）AssetBundleBrowser面板

正确获取到并安装完插件后，通过 Windows/AssetBundle Browser下打开AB包管理面板一共有三个面板。利用AssetBundleBrowser打包时，我们用的是Build面板，设置好之后点击[build]即可。

Configure面板：能查看当前AB包及其内部资源的基本情况（大小，资源，依赖情况等）。
Build面板：负责AssetBundle打包的相关设置。
Inspect面板：用来查看已经打包后的AB包文件的一些详细情况（大小，资源路径等）。

2. 代码打AB包

通过代码打AB包，不需要设置prefab的AssetBundle名称。

private static void BuildAssetBundles(string tempDir, string outputDir, BuildTarget target)
 {
     Debug.Log("AB outputDir："+ outputDir);
     Directory.CreateDirectory(tempDir);
     Directory.CreateDirectory(outputDir);
     
     List<AssetBundleBuild> abs = new List<AssetBundleBuild>();
     {
         var prefabAssets = new List<string>();
         string testPrefab = $"{Application.dataPath}/Prefabs/Cube.prefab";
         prefabAssets.Add(testPrefab);
         AssetDatabase.Refresh(ImportAssetOptions.ForceUpdate);
         abs.Add(new AssetBundleBuild
         {
             assetBundleName = "prefabs",
             assetNames = prefabAssets.Select(s => ToRelativeAssetPath(s)).ToArray(),
         });
     }

     BuildPipeline.BuildAssetBundles(outputDir, abs.ToArray(), BuildAssetBundleOptions.None, target);
     AssetDatabase.Refresh(ImportAssetOptions.ForceUpdate);
 }

二、YooAsset

AssetBundle 的管理和使用相对复杂，需要处理依赖关系、版本控制、加载策略等问题。因此，很多开发者会选择使用如 YooAsset 这样的资源管理框架来简化 AssetBundle 的使用，自动处理这些复杂的任务。

1. 准备工作

（1）官方文档

Introduce | YooAsset

（2）通过Packages清单安装YooAsset

直接修改Packages文件夹下的清单文件manifest.json：

{
  "dependencies": {
    "com.tuyoogame.yooasset": "2.1.0",
    ......
  },
  "scopedRegistries": [
    {
      "name": "package.openupm.cn",
      "url": "https://package.openupm.cn",
      "scopes": [
        "com.tuyoogame.yooasset"
      ]
    }
  ]
}

unity2020.3.8出现以下报错，报错代码注释掉即可，貌似DownloadHandlerAssetBundle下还没有 autoLoadAssetBundle这个变量，而且支持的版本这个值默认false。

2.全局配置

Project窗体内右键 -> Create -> YooAsset -> Create YooAsset Setting可创建YooAssetSettings全局配置文件，该文件需放在Resources文件夹下：

Manifest File Name : 清单文件名称
DefaultYooFolderName：Yoo文件夹名称

3.资源配置

Project窗体内右键 -> Create -> YooAsset -> Create AssetBundle Collector Setting可创建该文件，需要注意的是一个工程只能有一个AssetBundleCollectorSetting。

重点关注Enable Addressable及Pack Rule打包规则：

（1）Enable Addressable

启用可寻址资源定位系统。启用后加载资源时可以不写全路径，只根据资源名称即可加载：

 YooAssets.LoadSceneAsync("scene_home");

（2）Pack Rule打包规则

规则可以自定义扩展。下面是内置规则：

PackSeparately 以文件路径作为资源包名，每个资源文件单独打包（比如场景文件）。
PackDirectory 以文件所在的文件夹路径作为资源包名，该文件夹下所有文件打进一个资源包。
PackTopDirectory 以收集器下顶级文件夹为资源包名，该文件夹下所有文件打进一个资源包。
PackCollector 以收集器路径作为资源包名，收集的所有文件打进一个资源包。
PackGroup 以分组名称作为资源包名，收集的所有文件打进一个资源包。
PackRawFile 目录下的资源文件会被处理为原生资源包（比如dll.byte）。

4.资源构建

（1）Build Mode

ForceRebuild：强制构建模式，会删除指定构建平台下的所有构建记录，重新构建所有资源包。
IncrementalBuild：增量构建模式，以上一次构建结果为基础，对于发生变化的资源进行增量构建。

（2）Encryption

加密类列表。Build时选的加密类型要和加载资源时的解密类型一致，否则加载资源时会报错。比如Build时选择的加密方式为FileOffsetEncryption，则文件解密服务接口也需要为FileOffset类型：

    {
        ...
        var initParameters = new HostPlayModeParameters();//HostPlayModeParameters继承自    InitializeParameters
        initParameters.BuildinQueryServices = new GameQueryServices();//内置资源查询服务接口
        initParameters.DecryptionServices = new FileOffsetDecryption();//如果资源包在构建的时候有加密，需要提供实现IDecryptionServices接口的实例类。
        ...
    }
    /// <summary>
    /// 资源文件偏移加载解密类
    /// </summary>
    private class FileOffsetDecryption : IDecryptionServices
    {
        /// <summary>
        /// 同步方式获取解密的资源包对象
        /// 注意：加载流对象在资源包对象释放的时候会自动释放
        /// </summary>
        AssetBundle IDecryptionServices.LoadAssetBundle(DecryptFileInfo fileInfo, out Stream managedStream)
        {
            managedStream = null;
            return AssetBundle.LoadFromFile(fileInfo.FileLoadPath, fileInfo.ConentCRC, GetFileOffset());
        }

        /// <summary>
        /// 异步方式获取解密的资源包对象
        /// 注意：加载流对象在资源包对象释放的时候会自动释放
        /// </summary>
        AssetBundleCreateRequest IDecryptionServices.LoadAssetBundleAsync(DecryptFileInfo fileInfo, out Stream managedStream)
        {
            managedStream = null;
            return AssetBundle.LoadFromFileAsync(fileInfo.FileLoadPath, fileInfo.ConentCRC, GetFileOffset());
        }

        private static ulong GetFileOffset()
        {
            return 32;
        }

    }

5.YooAsset运行时

以官方提供的Space Shooter这个Demo为例，重新编写YooAsset相关的流程。先确保Demo能正常运行：

Space Shooter在导入完成后，打开YooAsset->AssetBundle Collector窗口。
点击修复按钮，然后点击Save按钮保存配置，最后关闭窗口。
找到Boot.scene场景启动游戏。

打开Boot.cs文件，注释掉 IEnumerator Start方法，在TestLoad方法中一步一步进行YooAsset资源的加载：

    private void Start()
    {
        StartCoroutine(TestLoad());
    }
    IEnumerator TestLoad()
    {
        ...
    }