跳到主要内容
版本:2.2.x

资源构建

学习资源构建界面。

image

界面介绍

  • Build Package

    资源包裹的列表,下拉选择要构建的资源包裹。

  • Build Pipeline

    构建管线的列表,下拉选择要使用的构建管线。

    (1) BuiltinBuildPipeline: 传统的内置构建管线

    (2) ScriptableBuildPipeline: 可编程构建管线

    ​ Unity后续推出的可编程构建管线,和可编程渲染管线一样,让开发者有能力控制打包流程。

    注意:从Unity2021.3版本开始,推荐使用该构建管线!

    (3) RawFileBuildPipeline: 原生文件构建管线

    ​ 用于构建Unity引擎无法识别的资源类型,例如FMOD的音频文件(bank后缀格式)

  • Build Output

    构建输出的目录,会根据Unity编辑器当前切换的平台自动划分构建结果。

  • Build Version

    构建的资源包版本。

  • Build Mode

    构建模式

    (1) 强制构建模式:会删除指定构建平台下的所有构建记录,重新构建所有资源包。

    (2) 增量构建模式:以上一次构建结果为基础,对于发生变化的资源进行增量构建。

    (3) 演练构建模式:在不生成AssetBundle文件的前提下,进行演练构建并快速生成构建报告和补丁清单。

    (4) 模拟构建模式:在编辑器下配合EditorSimulateMode运行模式,来模拟真实运行的环境。

  • Encryption

    加密类列表。

  • Compression

    资源包的压缩方式。

  • File Name Style

    输出的资源包文件名称样式

    HashName:哈希值

    BundleName: 资源包名

    BundleName_HashName:资源包名+哈希值

  • Copy Buildin File Option

    首包资源文件的拷贝方式

    (1) None:不拷贝任何文件

    (2) ClearAndCopyAll:先清空已有文件,然后拷贝所有文件

    (3) ClearAndCopyByTags:先清空已有文件,然后按照资源标签拷贝文件

    (4) OnlyCopyAll:不清空已有文件,直接拷贝所有文件

    (5) OnlyCopyByTags:不清空已有文件,直接按照资源标签拷贝文件

  • 构建

    点击构建按钮会开始构建流程,构建流程分为多个节点顺序执行,如果某个节点发生错误,会导致构建失败。错误信息可以在控制台查看。

加密方法

在Editor目录下实现一个继承IEncryptionServices接口的类。

加密支持三种方式:

  • LoadFromFileOffset 通过文件偏移来解密加载。
  • LoadFromMemory 通过文件内存来解密加载。
  • LoadFromStream 通过文件流来解密加载。
/// <summary>
/// 文件偏移加密方式
/// </summary>
public class FileOffsetEncryption : IEncryptionServices
{
public EncryptResult Encrypt(EncryptFileInfo fileInfo)
{
// 注意:只对音频资源包加密
if (fileInfo.BundleName.Contains("_gameres_audio"))
{
int offset = 32;
byte[] fileData = File.ReadAllBytes(fileInfo.FilePath);
var encryptedData = new byte[fileData.Length + offset];
Buffer.BlockCopy(fileData, 0, encryptedData, offset, fileData.Length);

EncryptResult result = new EncryptResult();
result.Encrypted = true;
result.EncryptedData = encryptedData;
return result;
}
else
{
EncryptResult result = new EncryptResult();
result.Encrypted = false;
return result;
}
}
}

补丁包

构建成功后会在输出目录下找到补丁包文件夹,该文件夹名称为本次构建时指定的资源版本号。

补丁包文件夹里包含补丁清单文件,资源包文件,构建报告文件等。

image

补丁清单

补丁清单文件是上图中以PackageManifest开头命名的文件。

  • PackageManifest_DefaultPackage_xxx.hash

    记录了补丁清单文件的哈希值。

  • PackageManifest_DefaultPackage_xxx.json

    该文件为Json文本格式,主要用于开发者预览信息。

  • PackageManifest_DefaultPackage_xxx.bytes

    该文件为二进制格式,主要用于程序内读取加载。

构建报告

BuildReport_DefaultPackage_xxx.json文件为构建报告文件。可以通过构建报告窗口查看本次构建的详细信息。

Jenkins支持

如果需要自动化构建,可以参考如下代码范例:

下面是使用内置构建管线来构建资源包的代码。

private static void BuildInternal(BuildTarget buildTarget)
{
Debug.Log($"开始构建 : {buildTarget}");

var buildoutputRoot = AssetBundleBuilderHelper.GetDefaultBuildOutputRoot();
var streamingAssetsRoot = AssetBundleBuilderHelper.GetStreamingAssetsRoot();

// 构建参数
BuiltinBuildParameters buildParameters = new BuiltinBuildParameters();
buildParameters.BuildOutputRoot = buildoutputRoot;
buildParameters.BuildinFileRoot = streamingAssetsRoot;
buildParameters.BuildPipeline = EBuildPipeline.BuiltinBuildPipeline.ToString();
buildParameters.BuildTarget = BuildTarget;
buildParameters.BuildMode = EBuildMode.ForceRebuild;
buildParameters.PackageName = "DefaultPackage";
buildParameters.PackageVersion = "1.0";
buildParameters.VerifyBuildingResult = true;
buildParameters.EnableSharePackRule = true; //启用共享资源构建模式,兼容1.5x版本
buildParameters.FileNameStyle = EFileNameStyle.HashName;
buildParameters.BuildinFileCopyOption = EBuildinFileCopyOption.None;
buildParameters.BuildinFileCopyParams = string.Empty;
buildParameters.EncryptionServices = CreateEncryptionInstance();
buildParameters.CompressOption = ECompressOption.LZ4;

// 执行构建
BuiltinBuildPipeline pipeline = new BuiltinBuildPipeline();
var buildResult = pipeline.Run(buildParameters, true);
if (buildResult.Success)
{
Debug.Log($"构建成功 : {buildResult.OutputPackageDirectory}");
}
else
{
Debug.LogError($"构建失败 : {buildResult.ErrorInfo}");
}
}

// 从构建命令里获取参数示例
private static string GetBuildPackageName()
{
foreach (string arg in System.Environment.GetCommandLineArgs())
{
if (arg.StartsWith("buildPackage"))
return arg.Split("="[0])[1];
}
return string.Empty;
}

重要概念

  • 增量构建

    增量构建是在Unity的帮助下实现的一种快速打包机制。主要是利用资源构建相关的缓存文件来避免二次构建,以此来提高打包效率。

  • 强制构建

    强制构建是每次构建之前,都会清空之前构建的所有缓存文件,以此来重新构建资源包。

  • 首包资源

    在构建应用程序的时候,我们希望将某些资源打进首包里,首包资源拷贝至StreamingAssets/yoo/目录下。首包资源如果发生变化,也可以通过热更新来更新资源。

  • 补丁包

    无论是通过增量构建还是强制构建,在构建完成后都会生成一个以包裹版本(PackageVersion)命名的文件夹,我们把这个文件夹统称为补丁包。补丁包里包含了游戏运行需要的所有资源,我们可以无脑的将补丁包内容覆盖到CDN目录下,也可以通过编写差异分析工具,来筛选出和线上最新版本之间的差异文件,然后将差异文件上传到CDN目录里。