1.BuildPipeline.BuildAssetBundles简介
2.常用重载形式
3.核心参数详解
4.示例
1.BuildPipeline.BuildAssetBundles简介
BuildPipeline.BuildAssetBundles是UnityEditor命名空间下的静态方法,仅在Unity编辑器环境中可用,用于将项目中标 记为AssetBundle的资源打包成独立的AssetBundle文件(AB包)
2.常用重载形式
1).基础重载(基于资源标签)publicstaticAssetBundleManifestBuildAssetBundles(stringoutputPath,// AB包输出目录BuildAssetBundleOptionsoptions,// 构建选项（压缩、增量构建等）BuildTarget targetPlatform// 目标运行平台);
2).自定义打包重载(精细化控制)publicstaticAssetBundleManifestBuildAssetBundles(stringoutputPath,AssetBundleBuild[]builds,// 自定义AB包结构（指定资源与AB包的映射）BuildAssetBundleOptionsoptions,BuildTargettargetPlatform);
3.核心参数详解
a.outputPath AB包输出的文件夹路径(如"Assets/../AssetBundles"),Unity会自动创建不存在的目录
b.options 构建选项,核心控制"压缩方式、增量构建"等,常用值-None:默认,常规构建-ChunkBasedCompression:LZ4块压缩(推荐,加载快+压缩率适中)-CompressWithLZMA:LZMA压缩(体积最小,加载最慢)-UncompressedAssetBundle:不压缩(加载最快,体积最大)-ForceRebuildAssetBundle:强制全量重建(忽略增量)
c.targetPlatform AB包适配的运行平台(如BuildTarget.StandaloneWindows64、BuildTarget.Android、BuildTarget.iOS),不同平台AB包不 通用
d.builds 自定义打包映射,可指定"哪些资源打包到哪个AB包",无需手动给资源打标签
返回值AssetBundleManifest打包清单,包含所有AB包的名称、依赖关系等信息,可用于运行时依赖加载
4.示例
1).基础打包(基于资源标签)
usingUnityEditor;usingUnityEngine;usingSystem.IO;// 编辑器脚本，仅在Unity编辑器中生效publicclassABBuilder:Editor{// 在Unity菜单栏添加打包按钮[MenuItem("Tools/Build AssetBundles")]publicstaticvoidBuildAllABs(){// 定义AB包输出路径（项目根目录的AssetBundles文件夹）stringoutputPath=Path.Combine(Application.dataPath,"../AssetBundles");// 确保输出目录存在if(!Directory.Exists(outputPath)){Directory.CreateDirectory(outputPath);}// 执行打包AssetBundleManifestmanifest=BuildPipeline.BuildAssetBundles(outputPath,// 输出路径BuildAssetBundleOptions.ChunkBasedCompression,// LZ4块压缩BuildTarget.StandaloneWindows64// 目标平台：Windows64);// 打包结果提示if(manifest!=null){Debug.Log($"AB包构建成功！输出路径：{outputPath}");// 打印所有打包的AB包名称foreach(varabNameinmanifest.GetAllAssetBundles()){Debug.Log($"已打包AB包：{abName}");}}else{Debug.LogError("AB包构建失败！");}}}
2).自定义打包(无需手动打标签)
[MenuItem("Tools/Build Custom ABs")]publicstaticvoidBuildCustomABs(){stringoutputPath=Path.Combine(Application.dataPath,"../AssetBundles");if(!Directory.Exists(outputPath))Directory.CreateDirectory(outputPath);// 定义2个AB包的打包规则AssetBundleBuild[]buildMap=newAssetBundleBuild[2];// 第一个AB包：models（包含2个预制体）buildMap[0].assetBundleName="models";buildMap[0].assetNames=newstring[]{"Assets/Models/Player.prefab","Assets/Models/Enemy.prefab"};// 第二个AB包：textures（包含2张纹理）buildMap[1].assetBundleName="textures";buildMap[1].assetNames=newstring[]{"Assets/Textures/PlayerTex.png","Assets/Textures/EnemyTex.png"};// 调用重载方法打包AssetBundleManifestmanifest=BuildPipeline.BuildAssetBundles(outputPath,buildMap,BuildAssetBundleOptions.ChunkBasedCompression,BuildTarget.Android);if(manifest!=null){Debug.Log("自定义AB包构建成功！");}}
)
