QFramework 中 ResLoader 自动回收机制的优化实践

在 Unity 游戏开发中，资源管理是一个非常重要的环节。QFramework 框架提供了 ResLoader 类来帮助开发者更方便地管理资源加载和释放。本文将介绍 ResLoader 的传统用法以及一种更简洁的自动回收机制优化方案。

传统 ResLoader 用法

在 QFramework 中，ResLoader 的传统使用方式是在需要加载资源的脚本中显式地创建和回收：

public class TestResKit : MonoBehaviour 
{
    ResLoader mResLoader = ResLoader.Allocate();
    
    void Destroy()
    {
        mResLoader.Recycle2Cache();
        mResLoader = null;
    }
}

这种方式虽然明确，但存在几个问题：

1. 需要为每个使用 ResLoader 的脚本编写样板代码
2. 容易忘记在销毁时回收资源
3. 对于没有销毁事件的对象需要额外处理

自动回收优化方案

为了解决上述问题，我们可以实现一个更智能的资源加载管理机制。核心思路是：

1. 通过接口标记需要资源加载能力的类
2. 使用静态扩展方法自动管理 ResLoader 的生命周期
3. 利用 Unity 的 GameObject 销毁事件自动回收资源

实现细节

首先定义一个标记接口：

public interface ICanLoadResource { }

然后创建静态扩展方法来提供自动管理功能：

public static class CanLoadResourceExtension
{
    private static readonly Dictionary<int, ResLoader> _resLoaderDict = new Dictionary<int, ResLoader>();

    public static ResLoader GetResLoader(this ICanLoadResource obj)
    {
        int hashCode = obj.GetHashCode();

        if (!_resLoaderDict.ContainsKey(hashCode))
        {
            _resLoaderDict.Add(hashCode, ResLoader.Allocate());

            if (obj is Component component)
            {
                var lm = component.gameObject.GetComponent<LifecycleModule>();
                if (!lm) lm = component.gameObject.AddComponent<LifecycleModule>();

                lm.OnDestroyed += () =>
                {
                    if (_resLoaderDict.ContainsKey(hashCode))
                    {
                        _resLoaderDict[hashCode].Recycle2Cache();
                        _resLoaderDict.Remove(hashCode);
                    }
                };
            }
        }

        return _resLoaderDict[hashCode];
    }
}

其中 LifecycleModule 是一个简单的组件，用于监听 GameObject 的销毁事件：

public class LifecycleModule : MonoBehaviour
{
    public Action OnDestroyed = () => { };
    private void OnDestroy()
    {
        OnDestroyed();
    }
}

使用示例

优化后的使用方式非常简单：

public class TestResKit : MonoBehaviour, ICanLoadResource
{
    void Func()
    {
        // 自动获取并管理 ResLoader
        this.GetResLoader().LoadSync<GameObject>("prefabName");
    }
}

优势分析

这种优化方案具有以下优点：

1. 代码简洁：不再需要显式创建和回收 ResLoader
2. 自动管理：资源加载器会在 GameObject 销毁时自动回收
3. 灵活性：仍然支持手动回收（通过 RecycleResLoader 方法）
4. 一致性：所有资源加载操作都通过同一接口管理

注意事项

1. 虽然不同对象的 HashCode 冲突概率很低，但在极端情况下仍可能出现
2. 对于非 Component 的对象，需要手动回收资源
3. 大量使用可能会增加少量内存开销（维护字典）

结论

这种自动回收机制显著简化了 QFramework 中资源管理的复杂度，减少了样板代码，降低了资源泄漏的风险。QFramework 官方已经采纳了类似思路，增加了 RecycleWhenGameObjectDestroyed 静态扩展方法，进一步提升了框架的易用性。

对于开发者来说，理解这种自动管理机制背后的原理，可以帮助我们更好地设计自己的资源管理系统，提高开发效率和代码质量。