From 29dec1f64b0f2fa2fc0bec84d02d937ac1eb5b39 Mon Sep 17 00:00:00 2001
From: Lenheart <947330670@qq.com>
Date: Fri, 20 Mar 2026 02:46:47 +0800
Subject: [PATCH] =?UTF-8?q?refactor(resource):=20=E9=87=8D=E6=9E=84?=
 =?UTF-8?q?=E8=B5=84=E6=BA=90=E7=AE=A1=E7=90=86=E6=A8=A1=E5=9D=97=EF=BC=8C?=
 =?UTF-8?q?=E5=B0=86utils=E7=9B=AE=E5=BD=95=E4=B8=8B=E7=9A=84=E8=B5=84?=
 =?UTF-8?q?=E6=BA=90=E7=9B=B8=E5=85=B3=E6=96=87=E4=BB=B6=E8=BF=81=E7=A7=BB?=
 =?UTF-8?q?=E5=88=B0resource=E7=9B=AE=E5=BD=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

重构资源管理模块，将原utils目录下的asset、binary_reader、pvf_archive和script_parser等资源相关文件迁移到新创建的resource目录中，并优化相关代码结构。同时更新所有引用这些文件的代码路径，保持项目一致性。

新增完整的资源管理功能：
- BinaryReader: 提供二进制文件读取功能
- PvfArchive: 实现PVF资源包解析
- ScriptParser: 支持脚本二进制数据解析
- Asset: 提供文件系统操作接口

优化内容包括：
1. 统一资源管理相关代码位置
2. 完善各模块的文档注释
3. 增加错误处理和日志记录
4. 实现更安全的资源访问方式
---
 Frostbite2D/include/frostbite2D/{utils => resource}/asset.h | 0
 .../include/frostbite2D/{utils => resource}/binary_reader.h | 0
 .../include/frostbite2D/{utils => resource}/pvf_archive.h   | 2 +-
 .../include/frostbite2D/{utils => resource}/script_parser.h | 2 +-
 Frostbite2D/src/frostbite2D/audio/music.cpp                 | 2 +-
 Frostbite2D/src/frostbite2D/audio/sound.cpp                 | 2 +-
 Frostbite2D/src/frostbite2D/core/application.cpp            | 2 +-
 Frostbite2D/src/frostbite2D/core/window.cpp                 | 2 +-
 Frostbite2D/src/frostbite2D/graphics/shader.cpp             | 2 +-
 Frostbite2D/src/frostbite2D/graphics/shader_manager.cpp     | 2 +-
 Frostbite2D/src/frostbite2D/graphics/texture.cpp            | 2 +-
 Frostbite2D/src/frostbite2D/{utils => resource}/asset.cpp   | 2 +-
 .../src/frostbite2D/{utils => resource}/binary_reader.cpp   | 4 ++--
 .../src/frostbite2D/{utils => resource}/pvf_archive.cpp     | 2 +-
 .../src/frostbite2D/{utils => resource}/script_parser.cpp   | 4 ++--
 Game/src/main.cpp                                           | 6 +++---
 16 files changed, 18 insertions(+), 18 deletions(-)
 rename Frostbite2D/include/frostbite2D/{utils => resource}/asset.h (100%)
 rename Frostbite2D/include/frostbite2D/{utils => resource}/binary_reader.h (100%)
 rename Frostbite2D/include/frostbite2D/{utils => resource}/pvf_archive.h (99%)
 rename Frostbite2D/include/frostbite2D/{utils => resource}/script_parser.h (99%)
 rename Frostbite2D/src/frostbite2D/{utils => resource}/asset.cpp (99%)
 rename Frostbite2D/src/frostbite2D/{utils => resource}/binary_reader.cpp (98%)
 rename Frostbite2D/src/frostbite2D/{utils => resource}/pvf_archive.cpp (99%)
 rename Frostbite2D/src/frostbite2D/{utils => resource}/script_parser.cpp (98%)

diff --git a/Frostbite2D/include/frostbite2D/utils/asset.h b/Frostbite2D/include/frostbite2D/resource/asset.h
similarity index 100%
rename from Frostbite2D/include/frostbite2D/utils/asset.h
rename to Frostbite2D/include/frostbite2D/resource/asset.h
diff --git a/Frostbite2D/include/frostbite2D/utils/binary_reader.h b/Frostbite2D/include/frostbite2D/resource/binary_reader.h
similarity index 100%
rename from Frostbite2D/include/frostbite2D/utils/binary_reader.h
rename to Frostbite2D/include/frostbite2D/resource/binary_reader.h
diff --git a/Frostbite2D/include/frostbite2D/utils/pvf_archive.h b/Frostbite2D/include/frostbite2D/resource/pvf_archive.h
similarity index 99%
rename from Frostbite2D/include/frostbite2D/utils/pvf_archive.h
rename to Frostbite2D/include/frostbite2D/resource/pvf_archive.h
index 3751dbd..884d890 100644
--- a/Frostbite2D/include/frostbite2D/utils/pvf_archive.h
+++ b/Frostbite2D/include/frostbite2D/resource/pvf_archive.h
@@ -1,7 +1,7 @@
 #pragma once
 
 #include <frostbite2D/types/type_alias.h>
-#include <frostbite2D/utils/binary_reader.h>
+#include <frostbite2D/resource/binary_reader.h>
 #include <optional>
 #include <string>
 #include <map>
diff --git a/Frostbite2D/include/frostbite2D/utils/script_parser.h b/Frostbite2D/include/frostbite2D/resource/script_parser.h
similarity index 99%
rename from Frostbite2D/include/frostbite2D/utils/script_parser.h
rename to Frostbite2D/include/frostbite2D/resource/script_parser.h
index 60c0e0a..bf5841c 100644
--- a/Frostbite2D/include/frostbite2D/utils/script_parser.h
+++ b/Frostbite2D/include/frostbite2D/resource/script_parser.h
@@ -1,7 +1,7 @@
 #pragma once
 
 #include <frostbite2D/types/type_alias.h>
-#include <frostbite2D/utils/pvf_archive.h>
+#include <frostbite2D/resource/pvf_archive.h>
 #include <optional>
 #include <string>
 #include <vector>
diff --git a/Frostbite2D/src/frostbite2D/audio/music.cpp b/Frostbite2D/src/frostbite2D/audio/music.cpp
index 649eb5b..bbe7f91 100644
--- a/Frostbite2D/src/frostbite2D/audio/music.cpp
+++ b/Frostbite2D/src/frostbite2D/audio/music.cpp
@@ -1,6 +1,6 @@
 #include <frostbite2D/audio/music.h>
 #include <frostbite2D/audio/audio_system.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <SDL2/SDL.h>
 #include <SDL2/SDL_mixer.h>
 #include <algorithm>
diff --git a/Frostbite2D/src/frostbite2D/audio/sound.cpp b/Frostbite2D/src/frostbite2D/audio/sound.cpp
index e0ea5e1..f9ff855 100644
--- a/Frostbite2D/src/frostbite2D/audio/sound.cpp
+++ b/Frostbite2D/src/frostbite2D/audio/sound.cpp
@@ -1,6 +1,6 @@
 #include <frostbite2D/audio/sound.h>
 #include <frostbite2D/audio/audio_system.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <SDL2/SDL.h>
 #include <SDL2/SDL_mixer.h>
 #include <algorithm>
diff --git a/Frostbite2D/src/frostbite2D/core/application.cpp b/Frostbite2D/src/frostbite2D/core/application.cpp
index 4e5c8e1..d0ed88a 100644
--- a/Frostbite2D/src/frostbite2D/core/application.cpp
+++ b/Frostbite2D/src/frostbite2D/core/application.cpp
@@ -6,7 +6,7 @@
 #include <frostbite2D/graphics/camera.h>
 #include <frostbite2D/platform/switch.h>
 #include <frostbite2D/types/type_math.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <frostbite2D/scene/scene_manager.h>
 namespace frostbite2D {
 
diff --git a/Frostbite2D/src/frostbite2D/core/window.cpp b/Frostbite2D/src/frostbite2D/core/window.cpp
index da78819..2d9bf6f 100644
--- a/Frostbite2D/src/frostbite2D/core/window.cpp
+++ b/Frostbite2D/src/frostbite2D/core/window.cpp
@@ -1,7 +1,7 @@
 #include "SDL_log.h"
 #include <SDL2/SDL.h>
 #include <frostbite2D/core/window.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <glad/glad.h>
 
 
diff --git a/Frostbite2D/src/frostbite2D/graphics/shader.cpp b/Frostbite2D/src/frostbite2D/graphics/shader.cpp
index a9b3b9d..a1db87f 100644
--- a/Frostbite2D/src/frostbite2D/graphics/shader.cpp
+++ b/Frostbite2D/src/frostbite2D/graphics/shader.cpp
@@ -1,7 +1,7 @@
 #include "SDL_log.h"
 #include <SDL2/SDL.h>
 #include <frostbite2D/graphics/shader.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <glad/glad.h>
 #include <sstream>
 
diff --git a/Frostbite2D/src/frostbite2D/graphics/shader_manager.cpp b/Frostbite2D/src/frostbite2D/graphics/shader_manager.cpp
index 272f46e..cd34714 100644
--- a/Frostbite2D/src/frostbite2D/graphics/shader_manager.cpp
+++ b/Frostbite2D/src/frostbite2D/graphics/shader_manager.cpp
@@ -2,7 +2,7 @@
 #include <SDL2/SDL.h>
 #include <frostbite2D/graphics/shader_manager.h>
 #include <frostbite2D/graphics/shader.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <json/json.hpp>
 #include <fstream>
 #include <sstream>
diff --git a/Frostbite2D/src/frostbite2D/graphics/texture.cpp b/Frostbite2D/src/frostbite2D/graphics/texture.cpp
index 0e55a35..64d7432 100644
--- a/Frostbite2D/src/frostbite2D/graphics/texture.cpp
+++ b/Frostbite2D/src/frostbite2D/graphics/texture.cpp
@@ -4,7 +4,7 @@
 #include <cstdio>
 #include <cstdlib>
 #include <frostbite2D/graphics/texture.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <glad/glad.h>
 
 namespace frostbite2D {
diff --git a/Frostbite2D/src/frostbite2D/utils/asset.cpp b/Frostbite2D/src/frostbite2D/resource/asset.cpp
similarity index 99%
rename from Frostbite2D/src/frostbite2D/utils/asset.cpp
rename to Frostbite2D/src/frostbite2D/resource/asset.cpp
index 9add6da..59bf604 100644
--- a/Frostbite2D/src/frostbite2D/utils/asset.cpp
+++ b/Frostbite2D/src/frostbite2D/resource/asset.cpp
@@ -1,4 +1,4 @@
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/asset.h>
 #include <fstream>
 #include <sstream>
 #include <system_error>
diff --git a/Frostbite2D/src/frostbite2D/utils/binary_reader.cpp b/Frostbite2D/src/frostbite2D/resource/binary_reader.cpp
similarity index 98%
rename from Frostbite2D/src/frostbite2D/utils/binary_reader.cpp
rename to Frostbite2D/src/frostbite2D/resource/binary_reader.cpp
index 55b3971..2a19258 100644
--- a/Frostbite2D/src/frostbite2D/utils/binary_reader.cpp
+++ b/Frostbite2D/src/frostbite2D/resource/binary_reader.cpp
@@ -1,5 +1,5 @@
-#include <frostbite2D/utils/binary_reader.h>
-#include <frostbite2D/utils/asset.h>
+#include <frostbite2D/resource/binary_reader.h>
+#include <frostbite2D/resource/asset.h>
 #include <fstream>
 #include <SDL.h>
 
diff --git a/Frostbite2D/src/frostbite2D/utils/pvf_archive.cpp b/Frostbite2D/src/frostbite2D/resource/pvf_archive.cpp
similarity index 99%
rename from Frostbite2D/src/frostbite2D/utils/pvf_archive.cpp
rename to Frostbite2D/src/frostbite2D/resource/pvf_archive.cpp
index db3a11d..dbb94c5 100644
--- a/Frostbite2D/src/frostbite2D/utils/pvf_archive.cpp
+++ b/Frostbite2D/src/frostbite2D/resource/pvf_archive.cpp
@@ -1,4 +1,4 @@
-#include <frostbite2D/utils/pvf_archive.h>
+#include <frostbite2D/resource/pvf_archive.h>
 #include <algorithm>
 #include <cctype>
 #include <SDL.h>
diff --git a/Frostbite2D/src/frostbite2D/utils/script_parser.cpp b/Frostbite2D/src/frostbite2D/resource/script_parser.cpp
similarity index 98%
rename from Frostbite2D/src/frostbite2D/utils/script_parser.cpp
rename to Frostbite2D/src/frostbite2D/resource/script_parser.cpp
index 38cfcd4..ddc32d1 100644
--- a/Frostbite2D/src/frostbite2D/utils/script_parser.cpp
+++ b/Frostbite2D/src/frostbite2D/resource/script_parser.cpp
@@ -1,5 +1,5 @@
-#include <frostbite2D/utils/script_parser.h>
-#include <frostbite2D/utils/pvf_archive.h>
+#include <frostbite2D/resource/script_parser.h>
+#include <frostbite2D/resource/pvf_archive.h>
 #include <algorithm>
 #include <cctype>
 #include <SDL.h>
diff --git a/Game/src/main.cpp b/Game/src/main.cpp
index 5d76c1c..9e485bb 100644
--- a/Game/src/main.cpp
+++ b/Game/src/main.cpp
@@ -9,9 +9,9 @@
 #include <frostbite2D/2d/sprite.h>
 #include <frostbite2D/scene/scene.h>
 #include <frostbite2D/scene/scene_manager.h>
-#include <frostbite2D/utils/binary_reader.h>
-#include <frostbite2D/utils/pvf_archive.h>
-#include <frostbite2D/utils/script_parser.h>
+#include <frostbite2D/resource/binary_reader.h>
+#include <frostbite2D/resource/pvf_archive.h>
+#include <frostbite2D/resource/script_parser.h>
 
 #include <frostbite2D/audio/audio_system.h>
 #include <frostbite2D/audio/sound.h>