代码剥离如何影响内容
了解Managed代码剥离配置如何影响内内容建以及如何保留内容ON依赖的代码。
阅读时间5 分钟最后更新于 6 天前
当您在 Unity 中发布 Player 版本时,UnityLinker 进程会运行,通过删除未使用的类型来减小程序集的大小。此过程可以剥离以下内容:
- 整个 C# Unity 对象,例如 和
MonoBehaviour实例。Unity 可以从核心 Unity 程序集(如ScriptableObject和UnityEngine.dll)中剥离这些程序集,但一旦这些程序集标记为已使用,就会将它们保留在自定义程序集内。Unity.dll - 常规 C# 结构和类。
- 类的一部分(例如,未使用的方法)。
- 整个 Unity 模块,例如 AI 或 Physics,如果未引用该模块的类型。
代码剥离ON内容的影响在播放Player中显示为 null 引用异常、缺失类型错误或崩溃。此外,AssetBundle 或 Addressables 的纯内容生成不能使用已从 Player 生成中删除的类型。
您可以使用生成上报 Inspector 的 Stripping 选项卡来检查 Player 生成中保留了哪些模块和类型。
在以下情况下可以防止链接器剥离代码:
防止 AssetBundles 中使用的类型的代码剥离
Unity 可能会剥离 AssetBundles 中存在的 Unity Object类型,但不会剥离 Player 构版本中包含的AnyScene或资源。这意味着,在播放模式下进行测试When,或者ON代码剥离最少的构建上进行测试时,AssetBundle 中的内容可能会有效,但在已启用了代码剥离的播放Player中会发生错误或崩溃。
要解决此问题,可以创建一个自定义义构版本脚本,直接包含 AssetBundle 的清单文件,如下所示:
- 在构建 Player 之前生成 AssetBundle。输出 Folder 为每个 AssetBundle 包含一个文件,以及一个与输出 Folder 同名的根
.manifest文件。.manifest - 使用 API 将根
BuildPipeline.BuildPlayer文件的路径通道到 Player 版本进程中。.manifest
还可以使用 Preserve 属性,或在项目中手动编写文件,以进一步影响代码剥离行为。
link.xml防止 Addressables 中使用的类型剥离
如果某种类型的 Unity Object 存在于使用 Addressables 构建的内容中,但不存在于 Player 构建的任何 Scene 或资源中,则 Unity 可能会剥离该类型。
Addressables 在 Folder 中自动生成一个文件,描述内容中使用的类型。Player 生成会考虑此文件,前提是 Addressables 内容已在 Player 生成之前或同时生成。
Library/com.unity.addressableslink.xmllink.xml还可以使用 Preserve 属性,或在项目中手动编写文件,以进一步影响代码剥离行为。
link.xml防止模块剥离
不能使用文件来防止剥离整个 Unity 模块(例如 AI 或 Physics)。
link.xml如果需要在 Addressables 生成中使用模块中的类型,请make Player 生成中包含一些引用该模块的内容。例如,要保持 Physics 模块,请将Rigidbody或碰撞体体等组件添加到版本中包含的Scene中的游戏对象对象。这会创建 Player 版本进程识别的依赖关系并保留模块。
纯脚本构建
Player 构建将使用的类型记录在 Folder 内的文件中,您可以查看该文件来诊断 Any 代码剥离问题。此文件用于支持增量构建管线,该管线可以重用以前 Player 版本的内容。在这种情况下,Player 版本会将缓存的类型用法从该文件传递给 Unity 链接器。
Library/PlayerDataCacheScriptsOnlyCache.yaml