YooAsset项目在Unity2021版本中ScriptableBuildPipeline依赖问题解析

在使用YooAsset 2.1.2版本时，部分开发者反馈在Unity2021.3.39f1环境下打开SourceCode工程会遇到ScriptableBuildPipeline(SBP)版本不兼容的问题。本文将详细分析该问题的成因及解决方案。

问题现象

当开发者使用Unity2021.3.39f1引擎配合YooAsset 2.1.2版本时，编译过程中会出现以下典型错误：

1. 无法找到ScriptableBuildPipeline 1.21.22版本
2. 编译错误提示SBP相关API不兼容

根本原因分析

该问题主要由两个因素导致：

1. 版本依赖关系：YooAsset在不同Unity版本中对ScriptableBuildPipeline的依赖处理方式不同。在Unity2021及以下版本中，SBP作为Unity内置包管理，而在更高版本中则作为独立包存在。

2. 宏定义差异：YooAsset源码中使用了TUANJIE_1_0_OR_NEWER宏来判断使用哪种构建方式，但在某些情况下该宏可能未正确生效。

解决方案

针对不同情况，开发者可采取以下解决方案：

情况一：通过Unity Package Manager安装YooAsset

1. 确保使用Unity2021.3.39f1官方版本
2. 通过Package Manager正常安装YooAsset
3. Unity会自动处理SBP的依赖关系，安装兼容版本(通常为1.20.2)

情况二：手动导入YooAsset源码

1. 需要手动安装兼容的ScriptableBuildPipeline版本
2. 推荐使用Unity2021兼容的SBP 1.20.2版本
3. 可通过Unity Package Manager手动添加SBP包

技术细节说明

YooAsset源码中针对不同Unity版本有专门的条件编译处理：

#if TUANJIE_1_0_OR_NEWER
    buildTasks.Add(new CreateBuiltInShadersBundle(builtInShaderBundleName));
#else
    buildTasks.Add(new CreateBuiltInBundle(builtInShaderBundleName));
#endif

这段代码会根据Unity版本自动选择不同的资源构建方式。如果宏定义未正确生效，可能导致使用了不兼容的API。

验证情况

经测试验证，以下Unity版本均可正常工作：

• Unity2020全系列
• Unity2021.3.x
• Unity2022全系列

最佳实践建议

1. 推荐优先使用Package Manager安装YooAsset
2. 如需手动管理，请确保SBP版本与Unity版本严格匹配
3. 遇到编译问题时，首先检查宏定义是否正确定义
4. 可考虑在PlayerSettings中明确定义TUANJIE_1_0_OR_NEWER宏

通过以上分析和解决方案，开发者应该能够顺利解决YooAsset在Unity2021环境下的SBP依赖问题。