2023-06-08 Unity AssetBundle1——AB包介绍与使用

一、AB 包介绍

​ AB 包是特定于平台的资源压缩包,类似于压缩文件。其中资源可包括:模型、贴图、预设体、音效、材质球等等。

​ 相较于 Resources 文件夹下的资源文件,AB 包能够更好管理资源:

  • Resources 文件夹:打包时资源固定,只读,无法修改。

  • AB 包:存储位置可自定义,压缩方式可自定义,后期可动态更新。

​ 用途:

  1. 减小包体大小

    • 压缩资源
    • 减少初始包的大小
  2. 热更新

    • 资源热更新
    • 脚本热更新
#mermaid-svg-jRQDNzsf4JXc7f0d {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d .error-icon{fill:#552222;}#mermaid-svg-jRQDNzsf4JXc7f0d .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-jRQDNzsf4JXc7f0d .edge-thickness-normal{stroke-width:2px;}#mermaid-svg-jRQDNzsf4JXc7f0d .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-jRQDNzsf4JXc7f0d .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-jRQDNzsf4JXc7f0d .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-jRQDNzsf4JXc7f0d .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-jRQDNzsf4JXc7f0d .marker{fill:#333333;stroke:#333333;}#mermaid-svg-jRQDNzsf4JXc7f0d .marker.cross{stroke:#333333;}#mermaid-svg-jRQDNzsf4JXc7f0d svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-jRQDNzsf4JXc7f0d .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d .cluster-label text{fill:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d .cluster-label span{color:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d .label text,#mermaid-svg-jRQDNzsf4JXc7f0d span{fill:#333;color:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d .node rect,#mermaid-svg-jRQDNzsf4JXc7f0d .node circle,#mermaid-svg-jRQDNzsf4JXc7f0d .node ellipse,#mermaid-svg-jRQDNzsf4JXc7f0d .node polygon,#mermaid-svg-jRQDNzsf4JXc7f0d .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-jRQDNzsf4JXc7f0d .node .label{text-align:center;}#mermaid-svg-jRQDNzsf4JXc7f0d .node.clickable{cursor:pointer;}#mermaid-svg-jRQDNzsf4JXc7f0d .arrowheadPath{fill:#333333;}#mermaid-svg-jRQDNzsf4JXc7f0d .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-jRQDNzsf4JXc7f0d .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-jRQDNzsf4JXc7f0d .edgeLabel{background-color:#e8e8e8;text-align:center;}#mermaid-svg-jRQDNzsf4JXc7f0d .edgeLabel rect{opacity:0.5;background-color:#e8e8e8;fill:#e8e8e8;}#mermaid-svg-jRQDNzsf4JXc7f0d .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-jRQDNzsf4JXc7f0d .cluster text{fill:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d .cluster span{color:#333;}#mermaid-svg-jRQDNzsf4JXc7f0d div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-jRQDNzsf4JXc7f0d :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}
第一步:
获取资源服务器地址
第二步:
通过资源对比文件
检测和更新AB包
客户端

自带很少的默认资源

资源对比文件
服务器端
资源服务器

资源对比文件
最新的各种AB包
二、AB 包资源打包
(一)导入 AB 包
  • Unity2019 版本:

    在 Window -> Package Manager 中搜索 “Asset Bundle Browser” 进行安装。

    image-20230608185233975

    安装完成后,在 Project 窗口下可看见 AB 包。

    image-20230608185346645
  • 2019 以上版本:

    对于高版本 Unity,不能通过包管理器进行下载。原因:高版本 Unity 用 Addressables 功能封装了 AB 包功能。

    如果仍要使用 AB 包,在 GitHub 上搜索 AssetBundles 下载对应压缩包,对应链接:GitHub - Unity-Technologies/AssetBundles-Browser: Editor tool for viewing and debugging asset bundle contents before and after builds

    image-20230608190136883

    下载完成后解压文件夹到项目中,若导入后报错,只需删除导入内容中的事例文件夹即可。

    image-20230608190232062
(二)将资源关联 AB 包

​ 点击需要关联的资源,这里选图片 fat_boss_green01.png

image-20230608191215133

​ 在 Inspector 窗口下方的 AssetBundle 窗口内点击 new 新建 AB 包 monsters,即可将资源装进 monster 包。

image-20230608191514096

​ 点击 Window -> AssetBundle Browser,在 Configure 页签下可以查看新建的 AB 包以及对应关联的资源。

image-20230608192234300
(三)打包参数选项
image-20230608191810720

​ 点击 Build 页签,可以看到有如下打包配置参数:

  1. Build Target:目标平台

  2. Output Path:目标输出路径

  3. Clear Folders:是否清空文件夹 重新打包

  4. Copy To StreamingAssets:是否拷贝到 StreamingAssets 文件夹下

  5. Compression:压缩方式

    • NoCompression:不压缩,解压快,包较大 不推荐
    • LZMA:压缩最小,解压慢
      • 缺点:用一个资源 要解压所有
    • LZ4:压缩,相对 LZMA 大一点点
      • 建议使用,用什么解压什么,内存占用低
  6. 其他(非重要参数)

    • Exclude Type Information:在资源包中不包含资源的类型信息

    • Force Rebuild:重新打包时需要重新构建包

      和 Clear Folders 不同,它不会删除不再存在的包

    • Ignore Type Tree Changes:增量构建检查时,忽略类型数的更改

    • Append Hash:将文件哈希值附加到资源包名上

    • Strict Mode:严格模式,如果打包时报错了,则打包直接失败无法成功

    • Dry Run Build:运行时构建

(四)打包结果
image-20230608192836716
  • maps / monsters:

    maps 包和 monsters 包,为二进制文件,记录了资源数据。

  • maps.manifest / monsters.manifest:

    maps 包和 monsters 包的配置文件,为文本文件,记录了对应资源文件的配置信息。

    • 资源信息(Assets)

    • 依赖关系(Dependencies)

    • 版本信息(ManifestFileVersion)

      等等

    image-20230608193256371
  • StandaloneWindows / StandaloneWindows.manifest:

    所有 AB 包的主包(包名和文件目录名称一样),记录了所有 AB 包的关键依赖关系。

(五)AB 包信息

​ 点击 Inspect 页签,可以看到 AB 包的详细信息。

image-20230608193527659
三、加载 AB 包资源

​ 使用 AB 包加载资源主要分为 2 步:

  1. 加载 AB 包
  2. 加载 AB 包中的资源

​ 注意:AB 包不能重复加载,否则会报错。

​ 以下示例默认 AB 包存储在路径 Application.streamingAssetsPath 下。

(一)同步加载
public class ABTest : MonoBehaviour
{
    // Start is called before the first frame update
    void Start()
    {
        // 第一步 加载 AB 包
        AssetBundle ab = AssetBundle.LoadFromFile(Application.streamingAssetsPath + "/model");
        
        // 第二步 加载 AB 包中的资源
        // 只用名字加载 会出现同名不同类型资源 分不清
        // 建议使用 泛型加载
        GameObject cube = ab.LoadAsset<GameObject>("Cube");
        // GameObject cube = ab.LoadAsset("Cube", typeof(GameObject)) as GameObject;
        Instantiate(cube);
    }
}
(二)异步加载
public class ABTest : MonoBehaviour
{
    public Image image;
    
    // Start is called before the first frame update
    void Start()
    {
        // 异步加载——协程
        StartCoroutine(LoadABRes("monsters", "fly_yellow02.png"));
    }

	IEnumerator LoadABRes(string ABName, string resName) {
        // 第一步 加载 AB 包
        AssetBundleCreateRequest abcr = AssetBundle.LoadFromFileAsync(Application.streamingAssetsPath + "/" + ABName);
        yield return abcr;
        // 第二步 加载 AB 包中的资源
        AssetBundleRequest abq = abcr.assetBundle.LoadAssetAsync(resName, typeof(Sprite));
        yield return abq;

        image.sprite = abq.asset as Sprite;
    }
}
(三)卸载 AB 包
  • 卸载所有 AB 包:

    AssetBundle.UnloadAllAssetBundles(bool unloadAllObjects);

  • 卸载单个 AB 包 ab:

    ab.UnloadAllAssetBundles(bool unloadAllObjects);

    • unloadAllObjects:决定是否卸载场景中 AB 包所创建的资源
using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

public class ABTest : MonoBehaviour
{
    public Image image;
    
    // Start is called before the first frame update
    void Start()
    {
        // 第一步 加载 AB 包
        AssetBundle ab = AssetBundle.LoadFromFile(Application.streamingAssetsPath + "/model");
        
        // 第二步 加载 AB 包中的资源
        // 只用名字加载 会出现同名不同类型资源 分不清
        // 建议使用 泛型加载
        GameObject cube = ab.LoadAsset<GameObject>("Cube");
        Instantiate(cube);
        
        // 卸载单个 AB 包
        ab.Unload(false);

        // 加载一个球
        GameObject sphere = ab.LoadAsset("Sphere", typeof(GameObject)) as GameObject;
        Instantiate(sphere);
        
        // 异步加载——协程
        StartCoroutine(LoadABRes("monsters", "fly_yellow02.png"));
    }

    IEnumerator LoadABRes(string ABName, string resName) {
        // 第一步 加载 AB 包
        AssetBundleCreateRequest abcr = AssetBundle.LoadFromFileAsync(Application.streamingAssetsPath + "/" + ABName);
        yield return abcr;
        // 第二步 加载 AB 包中的资源
        AssetBundleRequest abq = abcr.assetBundle.LoadAssetAsync(resName, typeof(Sprite));
        yield return abq;

        image.sprite = abq.asset as Sprite;
    }

    // Update is called once per frame
    void Update()
    {
        if (Input.GetKeyDown(KeyCode.Space)) {
            // 卸载所有加载的 AB 包 参数为 true 会把通过 AB 包加载的资源也卸载
            AssetBundle.UnloadAllAssetBundles(false);
        }
    }
}

(四)AB 包依赖

​ 当 A 包中的某个资源 a 使用了另一个资源 b,则打包时会将 b 默认打包到 A 包中。

​ 如果将资源 b 手动打包进 B 包中,则 A 包中有资源依赖于 B 包。

​ 此时,如果要使用资源 a,则需要同时加载 A 包和 B 包。

​ 具体操作如下:

  1. 加载主包

    AssetBundle abMain = AssetBundle.LoadFromFile(Application.streamingAssetsPath + "/StandaloneWindows");
    
  2. 加载主包中的固定文件

    AssetBundleManifest abManifest = abMain.LoadAsset<AssetBundleManifest>(nameof(AssetBundleManifest);
    
  3. 从固定文件中获取 monsters 包的依赖信息

    string[] strs = abManifest.GetAllDependencies("monsters");
    
  4. 加载依赖包

    for (int i = 0; i < strs.Length; i++) {
        AssetBundle.LoadFromFile(Application.streamingAssetsPath + "/" + strs[i]);
    }