Unity 2020.3.3f1 IL2CPP打包后加载AssetBundle动画不播放求助

该问题的核心诱因是IL2CPP构建模式下的托管代码自动剥离机制：Unity在IL2CPP打包时会自动裁剪没有被项目代码直接引用的类和方法，Mono构建模式默认的剥离规则更宽松所以运行正常，编辑器环境不会做代码剥离因此也不会触发问题。AssetBundle中的动画资源依赖的相关代码如果没有被项目本地代码直接引用，就会被IL2CPP的剥离流程误删，导致动画加载后无法正常工作。

解决方案1：调整代码剥离等级（快速验证用） #

• 打开 Player Settings > Other Settings > Optimization > Managed Stripping Level
• 把等级从默认的Medium/High改为Low，如果仍无法修复可以临时改为Disabled验证是否是代码剥离导致的问题

注意：禁用或降低剥离等级会明显增加包体体积，仅推荐用来排查问题，线上版本优先用链路保留文件方案

解决方案2：添加链路保留文件（最优方案） #

在项目Assets根目录下新建名为link.xml的文件，写入以下内容强制保留动画相关程序集不被裁剪：

<linker>
    <!-- 保留旧版Animation组件相关程序集 -->
    <assembly fullname="UnityEngine.AnimationModule" preserve="all"/>
    <!-- 保留Animator相关程序集 -->
    <assembly fullname="UnityEngine.AnimatorModule" preserve="all"/>
    <!-- 如果用到Playable动画相关逻辑，加上下面这行 -->
    <assembly fullname="UnityEngine.PlayablesModule" preserve="all"/>
</linker>

• 保存文件后重新打包IL2CPP版本即可生效

该方案仅保留指定需要的程序集，对包体体积的影响远小于降低剥离等级，是线上项目的首选方案

解决方案3：添加Dummy引用代码（兼容方案） #

如果链路文件不生效，可以在项目中任意一个不会被裁剪的全局脚本里，添加一段永远不会执行的空引用代码，强制告诉编译器保留动画相关类：

// 放在任意全局脚本的初始化方法中即可
void DummyAnimationRef()
{
    if (false) // 永远不会执行，不影响正常运行逻辑
    {
        _ = new Animation();
        _ = new Animator();
        _ = new AnimatorState();
        // 用到其他动画相关类可以在这里继续加空引用
    }
}

额外排查点 #

• 检查AssetBundle打包时是否连带打包了动画控制器、动画剪辑、对应Avatar等依赖资源，没有遗漏依赖
• 检查IL2CPP构建日志是否有动画相关的编译报错、资源打包报错

内容的提问来源于stack exchange，提问作者Mayur Asodariya