Skip to content

1. 基于索引计数与对象绑定的AssetBundle加载管理简易框架。(参考: tangzx/ABSystem思路) 2. 集成导表工具框架 3. 集成资源热更以及版本强更框架

small-snail-LQ/AssetBundleLoadManager

 
 

Repository files navigation

功能模块

资源加载管理模块

基于索引计数的AssetBundle加载管理框架。(参考: tangzx/ABSystem思路)

功能支持

  1. 支持编辑器和真机加载AssetBundle同步和异步加载(统一采用callback风格)
  2. 加载Asset暂时是采用同步加载(AssetBundle.LoadAsset & AssetBundle.LoadAllAssets)
  3. 支持三种基本的资源加载类型(NormalLoad -- 正常加载(可通过Tick检测判定正常卸载) Preload -- 预加载(切场景才会卸载) PermanentLoad -- 永久加载(常驻内存永不卸载))
  4. 基于UnityEngine.Object的AB索引生命周期绑定
  5. 底层统一管理AB索引计数,管理资源加载释放
  6. 支持卸载频率,卸载帧率门槛,单次卸载数量等设置。采用Long Time Unused First Unload(越久没用越先卸载)原则卸载。
  7. 支持最大AB异步加载携程数量配置(采用队列模式)
  8. 支持编辑器下使用AssetDatabase模式(只需设置AB名字,无需打包AB,暂时只支持同步)
  9. 采用AssetBundleBrowser工具打包AB

类说明

Manager统一管理:

- ModuleManager(单例类 Manager of Manager的管理类)
- ModuleInterface(模块接口类)

资源加载类:

- ResourceLoadMethod(资源加载方式枚举类型 -- 同步 or 异步)
- ResourceLoadMode(资源加载模式 -- AssetBundle or AssetDatabase(**限Editor模式下可切换,且当前仅支持同步加载方式**))
- ResourceLoadState(资源加载状态 -- 错误,等待加载, 加载中,完成之类的)
- ResourceLoadType(资源加载类型 -- 正常加载,预加载,永久加载)
- ResourceModuleManager(资源加载模块统一入口管理类)
- AbstractResourceModule(资源加载模块抽象)
- AbstractResourceInfo(资源加载信息抽象)
- AssetBundleModule(AssetBundle模式下的实际加载管理模块)
- AssetBundleAsyncQueue(AB异步加载队列)
- AssetBundleLoader(AB资源加载任务类)
- AssetBundleInfo(AB信息以及加载状态类 -- AB访问,索引计数以及AB依赖关系抽象都在这一层)
- AssetBundlePath(AB资源路径相关 -- 处理多平台以及热更资源加载路径问题)
- ResourceDebugWindow.cs(Editor运行模式下可视化查看资源加载(AssetBundle和AssetDatabase两种都支持)详细信息的辅助工具窗口)
- AssetDatabaseModule(AssetDatabase模式下的实际加载管理模块)
- AssetDatabaseLoader(AssetDatabase模式下的资源加载任务类)
- AssetDatabaseInfo(AssetDatabase模式下资源加载信息类)
- ResourceLoadAnalyse(资源加载统计分析工具)

AB加载管理方案

加载管理方案:

  1. 加载指定资源
  2. 加载自身AB(自身AB加载完通知资源加载层移除该AB加载任务避免重复的加载任务被创建),自身AB加载完判定是否有依赖AB
  3. 有则加载依赖AB(增加依赖AB的引用计数)(依赖AB采用和自身AB相同的加载方式(ResourceLoadMethod),但依赖AB统一采用ResourceLoadType.NormalLoad加载类型)
  4. 自身AB和所有依赖AB加载完回调通知逻辑层可以开始加载Asset资源(AB绑定对象在这一步)
  5. 判定AB是否满足引用计数为0,绑定对象为空,且为NormalLoad加载方式则卸载该AB(并释放依赖AB的计数减一)(通知资源管理层AB卸载,重用AssetBundleInfo对象)
  6. 切场景,递归判定卸载PreloadLoad加载类型AB资源

相关设计:

  1. 依赖AB与被依赖者采用同样的加载方式(ResourceLoadMethod),但加载方式依赖AB统一采用ResourceLoadType.NormalLoad
  2. 依赖AB通过索引计数管理,只要原始AB不被卸载,依赖AB就不会被卸载
  3. 已加载的AB资源加载类型只允许从低往高变(NormalLoad -> Preload -> PermanentLoad),不允许从高往低(PermanentLoad -> Preload -> NormalLoad)

Demo使用说明

Tools->Debug->资源调试工具

  1. AssetBundle和AssetDatabase资源加载模式切换AssetDatabaseModuleSwitch

  2. AB依赖信息查看界面

    AssetBundleDepInfoUI

  3. AB运行时加载管理详细信息界面

    AssetBundleLoadManagerUI

  4. AssetBundkle异步加载模式加载队列信息查看界面

    AssetBundleAsyncUI

  5. 测试界面

    AssetBundleTestUI

  6. 点击加载窗口预制件按钮后:

    mRMM.requstResource(
    "mainwindow",
    (abi) =>
    {
        mMainWindow = abi.instantiateAsset("MainWindow");
        mMainWindow.transform.SetParent(UIRootCanvas.transform, false);
    });

AssetBundleLoadManagerUIAfterLoadWindow 可以看到窗口mainwindow依赖于loadingscreen,导致我们加载窗口资源时,loadingscreen作为依赖AB被加载进来了(引用计数为1),窗口资源被绑定到实例出来的窗口对象上(绑定对象MainWindow)

  1. 点击测试异步和同步加载按钮后
    Debug.Log("onTestAsynAndSyncABLoad()");
    if(mMainWindow == null)
    {
        onLoadWindowPrefab();
    }

    // 测试大批量异步加载资源后立刻同步加载其中一个该源
    var image = mMainWindow.transform.Find("imgBG").GetComponent<Image>();
    mRMM.requstResource(
        "tutorialcellspritesheet",
        (abi) =>
        {
            var sp = abi.getAsset<Sprite>(image, "TextureShader");
            image.sprite = sp;
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

    mRMM.requstResource(
        "ambient",
        (abi) =>
        {
            var sp = abi.getAsset<Sprite>(image, "ambient");
            image.sprite = sp;
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

    mRMM.requstResource(
        "basictexture",
        (abi) =>
        {
            var sp = abi.getAsset<Sprite>(image, "basictexture");
            image.sprite = sp;
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

    mRMM.requstResource(
        "diffuse",
        (abi) =>
        {
            var sp = abi.getAsset<Sprite>(image, "diffuse");
            image.sprite = sp;
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

    mRMM.requstResource(
        "pre_zombunny",
        (abi) =>
        {
            mActorInstance = abi.instantiateAsset("pre_Zombunny");
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

    //测试异步加载后立刻同步加载
    GameObject actorinstance2 = null;
    mRMM.requstResource(
        "pre_zombunny",
        (abi) =>
        {
            actorinstance2 = abi.instantiateAsset("pre_Zombunny");
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Sync);
    Debug.Log("actorinstance2.transform.name = " + actorinstance2.transform.name);

    var btnloadmat = UIRoot.transform.Find("SecondUICanvas/ButtonGroups/btnLoadMaterial");
    Material mat = null;
    mRMM.requstResource(
        "sharematerial",
        (abi) =>
        {
            var matasset = abi.getAsset<Material>(btnloadmat.gameObject, "sharematerial");
            mat = GameObject.Instantiate<Material>(matasset);
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);
    btnloadmat.GetComponent<Image>().material = mat;

    mRMM.requstResource(
        "sfxtemplate",
        (abi) =>
        {
            mSFXInstance = abi.instantiateAsset("SFXTemplate");
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

    mRMM.requstResource(
        "sfx1",
        (abi) =>
        {
            var ac = abi.getAsset<AudioClip>(mSFXInstance, "explosion");
            var audiosource = mSFXInstance.GetComponent<AudioSource>();
            audiosource.clip = ac;
            audiosource.Play();
        },
        ResourceLoadType.NormalLoad,
        ResourceLoadMethod.Async);

AssetBundleLoadManagerUIAfterLoadSprites 可以看到我们切换的所有Sprite资源都被绑定到了imgBG对象上,因为不是作为依赖AB加载进来的所以每一个sprite所在的AB引用计数依然为0.

  1. 点击销毁窗口实例对象后
    GameObject.Destroy(mMainWindow);

AssetBundleLoadManagerUIAfterDestroyWindow 窗口销毁后可以看到之前加载的资源所有绑定对象都为空了,因为被销毁了(MainWindow和imgBG都被销毁了)

  1. 等待回收检测回收后 AssetBundleLoadManagerUIAfterUnloadAB 上述资源在窗口销毁后,满足了可回收的三大条件(1. 索引计数为0 2. 绑定对象为空 3. NormalLoad加载方式),最终被成功回收。

Note:

读者可能注意到shaderlist索引计数为0,也没绑定对象,但没有被卸载,这是因为shaderlist是被我预加载以常驻资源的形式加载进来的(PermanentLoad),所以永远不会被卸载。

    mRMM.requstResource(
    "shaderlist",
    (abi) =>
    {
        abi.loadAllAsset<UnityEngine.Object>();
    },
    ResourceLoadType.PermanentLoad);          // Shader常驻

热更新模块

类说明

热更类:

- HotUpdateModuleManager.cs(热更新管理模块单例类)
- TWebRequest.cs(资源下载http抽象类)

版本信息类:

- VersionConfigModuleManager.cs(版本管理模块单例类)
- VersionConfig.cs(版本信息抽象类)

功能支持

  1. 支持游戏内版本强更(完成 -- 暂时限Android,IOS待测试)
  2. 支持游戏内资源热更(完成 -- 暂时限Android, IOS待测试)
  3. 支持游戏内代码热更(未做)

热更测试说明

之前是使用的HFS快速搭建的一个资源本地资源服务器,后来使用阿里的ISS静态资源服务器做了一个网络端的资源服务器。

版本强更流程:

  1. 比较包内版本信息和包外版本信息检查是否强更过版本
  2. 如果强更过版本清空包外相关信息目录
  3. 通过资源服务器下载最新服务器版本信息(ServerVersionConfig.json)和本地版本号作对比,决定是否强更版本
  4. 结合最新版本号和资源服务器地址(Json配置)拼接出最终热更版本所在的资源服务器地址
  5. 下载对应版本号下的强更包并安装
  6. 安装完成,退出游戏重进

资源热更流程:

  1. 初始化本地热更过的资源列表信息(暂时存储在:Application.persistentDataPath + "/ResourceUpdateList/ResourceUpdateList.txt"里)

  2. 通过资源服务器下载最新服务器版本信息(ServerVersionConfig.json)和本地资源版本号作对比,决定是否资源热更

  3. 结合最新版本号,最新资源版本号和资源服务器地址(Json配置)拼接出最终资源热更所在的资源服务器地址

  4. 下载对应地址下的ResourceUpdateList.txt(里面填写了对应版本的详细资源热更信息)(这一步如果可以服务器下发的话可以省去)

    ResourceUpdateList.txt

    2:Android;2:mainwindow
  5. 根据比较对应地址下的ResourceUpdateList.txt里的资源热更信息和本地记录的资源热更信息得出需要更新的资源列表

  6. 根据得出的需要更新的资源列表下载对应资源地址下的资源并存储在包外(Application.persistentDataPath + "/Android/"),同时写入本地已经热更的资源信息到本地文件(本地ResourceUpdateList.txt)

  7. 直到所有资源热更完成,退出重进游戏

流程图

HotUpdateFlowChat

热更新辅助工具

Tools->HotUpdate->热更新操作工具

HotUpdateToolsUI

主要分为以下4个步骤:

  1. 版本资源文件MD5计算(文件名格式:MD5+版本号+资源版本号+平台+时间戳+.txt)

    AssetBundleMD5Caculation

  2. 对比两个版本的MD5文件信息得出需要热更新的AB文件信息

  3. 执行热更新AB准备操作自动复制需要热更新的AB到热更新准备目录(然后手动拷贝需要强更或热更的资源到真正的热更新目录)

  4. 执行热更新准备操作,生成热更新所需的最新资源热更新信息文件(ResourceUpdateList.txt)和服务器最新版本信息文件(ServerVersionConfig.json)

导表模块

集成导表工具XbufferExcellToData

详情:

XbufferExcellToData

辅助功能模块

资源处理分析

  1. 支持资源依赖统计(不限资源类型)
  2. 支持内置资源引用分析
  3. 支持内置资源提取(限材质和纹理,不包含Shader是考虑到Shader可以自行下载)
  4. 支持shader变体搜集(半成品)

资源辅助工具五件套:

Tools->AssetBundle->AssetBundle操作工具

Tools->Assets->Asset相关处理

  1. AB删除判定工具

    DeleteRemovedAssetBundle

  2. 资源依赖查看工具

    AssetDependenciesBrowser

  3. 内置资源依赖统计工具(只统计了*.mat和*.prefab,场景建议做成Prefab来统计)

    BuildInResourceReferenceAnalyze

  4. 内置资源提取工具

    BuildInResourceExtraction

  5. Shader变体搜集工具

    ShaderVariantsCollection

待做事项

  1. 编辑器模式支持AssetDatabase的资源回收以及类型分类( 1. 正常加载 2.预加载 3. 永久加载)
  2. 优化AssetBundle模式绑定同一组件对象时,老的资源无法及时释放问题(因为没有挂载任何有效信息,现阶段的抽象无法反推原有组件绑定的资源信息,无法及时释放老的资源加载信息)(考虑重写部分组件来解决此问题 e.g. 重写Image成TImage后保持索引基数对象来保证关联性)
  3. 支持编辑器模式下AssetDatabase资源异步加载(方便暴露出AssetBundle加载模式下的异步问题)
  4. 支持真机资源热更以及版本强更(热更模块)
  5. 支持真机代码热更(Lua + XLua)
  6. 跨版本资源热更自动化分析
  7. 热更新资源正确性校验

个人博客

详细的博客记录学习:

AssetBundle资源打包加载管理

热更新

导表工具

鸣谢

感谢tangzx/ABSystem作者的无私分享,tangzx/ABSystem的Github链接:

tangzx/ABSystem

About

1. 基于索引计数与对象绑定的AssetBundle加载管理简易框架。(参考: tangzx/ABSystem思路) 2. 集成导表工具框架 3. 集成资源热更以及版本强更框架

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 51.3%
  • ShaderLab 25.5%
  • HLSL 21.8%
  • FreeMarker 0.7%
  • GLSL 0.4%
  • Java 0.3%