refactor : 重构资源包裹模块

Assets/YooAsset/Runtime/DownloadSystem/DownloadSystemDefine.cs

@@ -2,100 +2,6 @@ using System.Collections.Generic;
 
 namespace YooAsset
 {
-    /// <summary>
-    /// 下载器结束
-    /// </summary>
-    public struct DownloaderFinishData
-    {
-        /// <summary>
-        /// 所属包裹名称
-        /// </summary>
-        public string PackageName;
-
-        /// <summary>
-        /// 是否成功
-        /// </summary>
-        public bool Succeed;
-    }
-
-    /// <summary>
-    /// 下载器相关的更新数据
-    /// </summary>
-    public struct DownloadUpdateData
-    {
-        /// <summary>
-        /// 所属包裹名称
-        /// </summary>
-        public string PackageName;
-
-        /// <summary>
-        /// 下载进度 (0-1f)
-        /// </summary>
-        public float Progress;
-
-        /// <summary>
-        /// 下载文件总数
-        /// </summary>
-        public int TotalDownloadCount;
-
-        /// <summary>
-        /// 当前完成的下载文件数量
-        /// </summary>
-        public int CurrentDownloadCount;
-
-        /// <summary>
-        /// 下载数据总大小（单位：字节）
-        /// </summary>
-        public long TotalDownloadBytes;
-
-        /// <summary>
-        /// 当前完成的下载数据大小（单位：字节）
-        /// </summary>
-        public long CurrentDownloadBytes;
-    }
-
-    /// <summary>
-    /// 下载器相关的错误数据
-    /// </summary>
-    public struct DownloadErrorData
-    {
-        /// <summary>
-        /// 所属包裹名称
-        /// </summary>
-        public string PackageName;
-
-        /// <summary>
-        /// 下载失败的文件名称
-        /// </summary>
-        public string FileName;
-
-        /// <summary>
-        /// 错误信息
-        /// </summary>
-        public string ErrorInfo;
-    }
-
-    /// <summary>
-    /// 下载器相关的文件数据
-    /// </summary>
-    public struct DownloadFileData
-    {
-        /// <summary>
-        /// 所属包裹名称
-        /// </summary>
-        public string PackageName;
-
-        /// <summary>
-        /// 下载的文件名称
-        /// </summary>
-        public string FileName;
-
-        /// <summary>
-        /// 下载的文件大小
-        /// </summary>
-        public long FileSize;
-    }
-
     /// <summary>
     /// 导入文件的信息
     /// </summary>

Assets/YooAsset/Runtime/DownloadSystem/README.md

@@ -244,16 +244,6 @@ public struct DownloadSimulateRequestArgs
 }
 ```
 
-### 回调数据结构体
-
-| 结构体 | 用途 | 关键字段 |
-|--------|------|----------|
-| `DownloaderFinishData` | 下载完成回调 | `PackageName`, `Succeed` |
-| `DownloadUpdateData` | 进度更新回调 | `Progress`, `TotalDownloadBytes`, `CurrentDownloadBytes` |
-| `DownloadErrorData` | 下载错误回调 | `FileName`, `ErrorInfo` |
-| `DownloadFileData` | 文件完成回调 | `FileName`, `FileSize` |
-| `ImportFileInfo` | 导入文件元数据 | `FilePath`, `BundleName`, `BundleGUID` |
-
 ---
 
 ## 核心类说明

Assets/YooAsset/Runtime/ResourcePackage/Operation/DownloaderOperation.cs

@@ -3,13 +3,115 @@ using System.Collections.Generic;
 
 namespace YooAsset
 {
+    #region 下载器相关类型定义
+    /// <summary>
+    /// 下载器结束
+    /// </summary>
+    public struct DownloaderFinishData
+    {
+        /// <summary>
+        /// 所属包裹名称
+        /// </summary>
+        public string PackageName;
+
+        /// <summary>
+        /// 是否成功
+        /// </summary>
+        public bool Succeed;
+    }
+
+    /// <summary>
+    /// 下载器相关的更新数据
+    /// </summary>
+    public struct DownloadUpdateData
+    {
+        /// <summary>
+        /// 所属包裹名称
+        /// </summary>
+        public string PackageName;
+
+        /// <summary>
+        /// 下载进度 (0-1f)
+        /// </summary>
+        public float Progress;
+
+        /// <summary>
+        /// 下载文件总数
+        /// </summary>
+        public int TotalDownloadCount;
+
+        /// <summary>
+        /// 当前完成的下载文件数量
+        /// </summary>
+        public int CurrentDownloadCount;
+
+        /// <summary>
+        /// 下载数据总大小（单位：字节）
+        /// </summary>
+        public long TotalDownloadBytes;
+
+        /// <summary>
+        /// 当前完成的下载数据大小（单位：字节）
+        /// </summary>
+        public long CurrentDownloadBytes;
+    }
+
+    /// <summary>
+    /// 下载器相关的错误数据
+    /// </summary>
+    public struct DownloadErrorData
+    {
+        /// <summary>
+        /// 所属包裹名称
+        /// </summary>
+        public string PackageName;
+
+        /// <summary>
+        /// 下载失败的文件名称
+        /// </summary>
+        public string FileName;
+
+        /// <summary>
+        /// 错误信息
+        /// </summary>
+        public string ErrorInfo;
+    }
+
+    /// <summary>
+    /// 下载器相关的文件数据
+    /// </summary>
+    public struct DownloadFileData
+    {
+        /// <summary>
+        /// 所属包裹名称
+        /// </summary>
+        public string PackageName;
+
+        /// <summary>
+        /// 资源包名称
+        /// </summary>
+        public string BundleName;
+
+        /// <summary>
+        /// 文件名称
+        /// </summary>
+        public string FileName;
+
+        /// <summary>
+        /// 文件大小
+        /// </summary>
+        public long FileSize;
+    }
+    #endregion
+
     public abstract class DownloaderOperation : AsyncOperationBase
     {
         private enum ESteps
         {
             None,
             Check,
-            Loading,
+            Downloading,
+            Finish,
             Done,
         }
 
@@ -127,15 +229,37 @@ namespace YooAsset
                 {
                     _steps = ESteps.Done;
                     Status = EOperationStatus.Failed;
-                    Error = "Download list is null.";
+                    Error = "Download bundle list is null.";
+
+                    if (DownloadFinishCallback != null)
+                    {
+                        var data = new DownloaderFinishData();
+                        data.PackageName = _packageName;
+                        data.Succeed = false;
+                        DownloadFinishCallback.Invoke(data);
+                    }
+                }
+                else if (_bundleInfoList.Count == 0)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Succeed;
+                    Progress = 1f;
+
+                    if (DownloadFinishCallback != null)
+                    {
+                        var data = new DownloaderFinishData();
+                        data.PackageName = _packageName;
+                        data.Succeed = true;
+                        DownloadFinishCallback.Invoke(data);
+                    }
                 }
                 else
                 {
-                    _steps = ESteps.Loading;
+                    _steps = ESteps.Downloading;
                 }
             }
 
-            if (_steps == ESteps.Loading)
+            if (_steps == ESteps.Downloading)
             {
                 // 检测下载器结果
                 _removeList.Clear();
@@ -172,6 +296,9 @@ namespace YooAsset
                 {
                     _lastDownloadBytes = downloadBytes;
                     _lastDownloadCount = _cachedDownloadCount;
+                    if (TotalDownloadBytes == 0)
+                        Progress = (float)_lastDownloadCount / TotalDownloadCount;
+                    else
                         Progress = (float)_lastDownloadBytes / TotalDownloadBytes;
 
                     if (DownloadUpdateCallback != null)
@@ -209,15 +336,22 @@ namespace YooAsset
                         {
                             var data = new DownloadFileData();
                             data.PackageName = _packageName;
-                            data.FileName = bundleInfo.Bundle.BundleName;
+                            data.BundleName = bundleInfo.Bundle.BundleName;
+                            data.FileName = bundleInfo.Bundle.FileName;
                             data.FileSize = bundleInfo.Bundle.FileSize;
                             DownloadFileBeginCallback.Invoke(data);
                         }
                     }
                 }
 
-                // 下载结算
+                // 下载结束
                 if (_downloaders.Count == 0)
+                {
+                    _steps = ESteps.Finish;
+                }
+            }
+
+            if (_steps == ESteps.Finish)
             {
                 if (_failedList.Count > 0)
                 {
@@ -260,7 +394,6 @@ namespace YooAsset
                 }
             }
         }
-        }
         private void CalculatDownloaderInfo()
         {
             if (_bundleInfoList != null)

Assets/YooAsset/Runtime/ResourcePackage/Operation/Internal/DeserializeManifestOperation.cs

@@ -91,7 +91,7 @@ namespace YooAsset
                     {
                         _steps = ESteps.Done;
                         Status = EOperationStatus.Failed;
-                        Error = $"The manifest file version are not compatible : {fileVersion} != {ManifestDefine.FileVersion}";
+                        Error = $"The manifest version is lower than the minimum compatible version : {fileVer} < {ver2025_8_28}";
                         return;
                     }
 
@@ -158,7 +158,7 @@ namespace YooAsset
                         FillAssetCollection(Manifest, packageAsset, replaceAssetPath);
 
                         _packageAssetCount--;
-                        Progress = 1f - _packageAssetCount / _progressTotalValue;
+                        Progress = 1f - (_packageAssetCount / (float)_progressTotalValue);
                         if (IsBusy)
                             break;
                     }
@@ -192,7 +192,7 @@ namespace YooAsset
                         FillBundleCollection(Manifest, packageBundle);
 
                         _packageBundleCount--;
-                        Progress = 1f - _packageBundleCount / _progressTotalValue;
+                        Progress = 1f - (_packageBundleCount / (float)_progressTotalValue);
                         if (IsBusy)
                             break;
                     }

Assets/YooAsset/Runtime/ResourcePackage/PlayMode/PlayModeImpl.cs

@@ -298,7 +298,8 @@ namespace YooAsset
                 return new List<BundleInfo>();
 
             // 获取资源对象的资源包和所有依赖资源包
-            List<PackageBundle> checkList = new List<PackageBundle>();
+            HashSet<string> checkSet = new HashSet<string>();
+            List<PackageBundle> checkList = new List<PackageBundle>(assetInfos.Length);
             foreach (var assetInfo in assetInfos)
             {
                 if (assetInfo.IsInvalid)
@@ -309,16 +310,22 @@ namespace YooAsset
 
                 // 注意：如果清单里未找到资源包会抛出异常！
                 PackageBundle mainBundle = manifest.GetMainPackageBundle(assetInfo.Asset);
-                if (checkList.Contains(mainBundle) == false)
+                if (checkSet.Contains(mainBundle.BundleGUID) == false)
+                {
+                    checkSet.Add(mainBundle.BundleGUID);
                     checkList.Add(mainBundle);
+                }
 
                 // 注意：如果清单里未找到资源包会抛出异常！
                 List<PackageBundle> mainDependBundles = manifest.GetAssetAllDependencies(assetInfo.Asset);
                 foreach (var dependBundle in mainDependBundles)
                 {
-                    if (checkList.Contains(dependBundle) == false)
+                    if (checkSet.Contains(dependBundle.BundleGUID) == false)
+                    {
+                        checkSet.Add(dependBundle.BundleGUID);
                         checkList.Add(dependBundle);
                     }
+                }
 
                 // 下载主资源包内所有资源对象依赖的资源包
                 if (recursiveDownload)
@@ -326,18 +333,24 @@ namespace YooAsset
                     foreach (var otherMainAsset in mainBundle.IncludeMainAssets)
                     {
                         var otherMainBundle = manifest.GetMainPackageBundle(otherMainAsset.BundleID);
-                        if (checkList.Contains(otherMainBundle) == false)
+                        if (checkSet.Contains(otherMainBundle.BundleGUID) == false)
+                        {
+                            checkSet.Add(otherMainBundle.BundleGUID);
                             checkList.Add(otherMainBundle);
+                        }
 
                         List<PackageBundle> otherDependBundles = manifest.GetAssetAllDependencies(otherMainAsset);
                         foreach (var dependBundle in otherDependBundles)
                         {
-                            if (checkList.Contains(dependBundle) == false)
+                            if (checkSet.Contains(dependBundle.BundleGUID) == false)
+                            {
+                                checkSet.Add(dependBundle.BundleGUID);
                                 checkList.Add(dependBundle);
                             }
                         }
                     }
                 }
+            }
 
             List<BundleInfo> result = new List<BundleInfo>(1000);
             foreach (var packageBundle in checkList)

Assets/YooAsset/Runtime/ResourcePackage/README.md

@@ -372,6 +372,8 @@ public class PackageBundle
 
 清单序列化工具类。
 
+> 注意：`DeserializeFromJson` 仅用于编辑器/调试用途，不保证运行时可用；运行时请优先使用二进制清单 `DeserializeFromBinary`。
+
 ```csharp
 // 验证清单数据完整性
 static bool VerifyManifestData(byte[] fileData, string hashValue);
@@ -381,6 +383,7 @@ static string SerializeToJson(PackageManifest manifest);
 static byte[] SerializeToBinary(PackageManifest manifest);
 
 // 反序列化
+// 注意：JSON 反序列化仅用于编辑器/调试用途，运行时请优先使用二进制清单。
 static PackageManifest DeserializeFromJson(string jsonContent);
 static PackageManifest DeserializeFromBinary(byte[] binaryData);
 

Assets/YooAsset/Runtime/ResourcePackage/ResourcePackage.cs

@@ -1163,7 +1163,6 @@ namespace YooAsset
         #endregion
 
         #region 调试方法
-        [Conditional("DEBUG")]
         private void DebugCheckInitialize(bool checkActiveManifest = true)
         {
             if (_initializeStatus == EOperationStatus.None)