lms
db0143be83
- Resolve directory rename conflict from old 03/06 dirs - Move remote-added 资源加载重构方案.md into modules/frameworks/资源管理/ - Move remote-added 06_工具脚本/MCP工具 into modules/frameworks/编辑器工具/MCP工具/ - Keep Tools/CodexUnityMcp/ as MCP Server implementation - Update README.md, modules/模块索引.md, and parent READMEs - Add 文档关联 sections to new docs and fix old absolute paths Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
资源管理
分类
- 核心框架
目的
管理 AssetBundle、语言资源、图集、prefab、DllBytes 等资源的加载、缓存和释放。
核心路径
- AssetBundle：
Assets/Game/GameHFScripte/CopyToHF/AssetBundle/ - 图集：
Assets/Game/GameHFScripte/CopyToHF/SpriteAtlas/ - 资源目录：
Assets/Game/GameHFResource/CN/、EN/、DllBytes/
核心类
| 类 | 职责 |
|---|---|
HFABMgr |
AssetBundle 资源管理器单例 |
HFAssetLoader |
具体资源加载器 |
HFAssetRequest |
资源加载请求 |
HFAssetBundlePathAttribute |
资源路径属性，标记资源根目录、相对路径、语言包规则等 |
HFGlobal_SpriteAtlas |
图集全局管理 |
资源路径规则
HFAssetBundlePathAttribute 记录：
- 资源根目录
- 相对路径
- 是否忽略语言包
- 是否场景
- 线程优先级
ChangeLanguage 生成：
editorPathassetBundlePathassetBundleKeyassetName
HFABMgr.OnCheckAssetBundlePathAttributeLanguage 在当前语言无资源时回退默认语言。
加载流程
HFABMgr.LoadInMemory(pathAttr)
-> OnReadAssetBundleManifest()
-> OnCheckAssetBundlePathAttributeLanguage()
-> new HFAssetRequest(...)
-> OnStartLoad()
-> 获取或创建 HFAssetLoader
-> HFAssetLoader.LoadAsset()
加载模式
Editor 模式
enHFAbLoadModel.Editor
-> SFAssetUtility_Unity.LoadFromFile(editorPath)
-> 直接读取编辑器资源
非 Editor 模式
读取 AssetBundleManifest
-> 解析依赖
-> AssetBundle.LoadFromMemoryAsync 读取主资源
CDN / 边玩边下
缺失资源进入 WaitDownload
-> HFAssetsDownLoadManager 下载
-> HFABMgr.SaveFile 保存到本地
-> 加载完成
图集加载
SpriteAtlasManager.atlasRequested
-> HFGlobal_SpriteAtlas.Instance.GetSpriteAtlasPath(spriteAtlasName)
-> HFABMgr.OnLoadInMemory(spriteAtlasAttribute)
-> callback(SpriteAtlas)
使用规则
- 资源路径统一通过
HFAssetBundlePathAttribute配置。 - 加载资源统一走
HFFunCatalogue.Asset.LoadAsset()或HFABMgr.LoadInMemory()。 - 语言资源按
GameHFResource/<lang>/分目录存放。 - 图集按业务或 UI 模块划分。
相关模块
子文档
文档关联
当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
| 文档 | 关联原因 |
|---|---|
| modules/模块索引.md | 模块索引是项目知识总入口 |
| modules/frameworks/UI窗口系统/README.md | UI 资源加载依赖资源管理 |
| modules/frameworks/实体系统/README.md | 实体资源加载依赖资源管理 |
| modules/frameworks/场景系统.md | 场景资源加载依赖资源管理 |
| modules/frameworks/资源管理/资源加载重构方案.md | AssetBundle 加载链路重构方案 |
| rules/10-架构说明.md | 架构说明定义总体分层和依赖方向 |
| rules/30-模块登记规则.md | 模块登记规则定义分类和状态口径 |