【m】框架大更新

2025-10-31 11:18:23 +08:00
parent ae6e7c804b
commit 8e1d52ddbf
1883 changed files with 213934 additions and 640 deletions
@@ -0,0 +1,106 @@
+using System.Collections.Generic;
+using System.Linq;
+
+namespace YooAsset
+{
+    public sealed class ClearCacheFilesOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            Prepare,
+            ClearCacheFiles,
+            CheckClearResult,
+            Done,
+        }
+
+        private readonly PlayModeImpl _impl;
+        private readonly ClearCacheFilesOptions _options;
+        private List<IFileSystem> _cloneList;
+        private FSClearCacheFilesOperation _clearCacheFilesOp;
+        private ESteps _steps = ESteps.None;
+
+        internal ClearCacheFilesOperation(PlayModeImpl impl, ClearCacheFilesOptions options)
+        {
+            _impl = impl;
+            _options = options;
+        }
+        internal override void InternalStart()
+        {
+            _steps = ESteps.Prepare;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.Prepare)
+            {
+                var fileSytems = _impl.FileSystems;
+                if (fileSytems == null || fileSytems.Count == 0)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = "The file system is empty !";
+                    return;
+                }
+
+                foreach (var fileSystem in fileSytems)
+                {
+                    if (fileSystem == null)
+                    {
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = "An empty object exists in the list!";
+                        return;
+                    }
+                }
+
+                _cloneList = fileSytems.ToList();
+                _steps = ESteps.ClearCacheFiles;
+            }
+
+            if (_steps == ESteps.ClearCacheFiles)
+            {
+                if (_cloneList.Count == 0)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Succeed;
+                }
+                else
+                {
+                    var fileSystem = _cloneList[0];
+                    _cloneList.RemoveAt(0);
+
+                    _clearCacheFilesOp = fileSystem.ClearCacheFilesAsync(_impl.ActiveManifest, _options);
+                    _clearCacheFilesOp.StartOperation();
+                    AddChildOperation(_clearCacheFilesOp);
+                    _steps = ESteps.CheckClearResult;
+                }
+            }
+
+            if (_steps == ESteps.CheckClearResult)
+            {
+                _clearCacheFilesOp.UpdateOperation();
+                Progress = _clearCacheFilesOp.Progress;
+                if (_clearCacheFilesOp.IsDone == false)
+                    return;
+
+                if (_clearCacheFilesOp.Status == EOperationStatus.Succeed)
+                {
+                    _steps = ESteps.ClearCacheFiles;
+                }
+                else
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _clearCacheFilesOp.Error;
+                }
+            }
+        }
+        internal override string InternalGetDesc()
+        {
+            return $"ClearMode : {_options.ClearMode}";
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 681b0c6d75e61904d9b5e6ade53b41b2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,106 @@
+
+namespace YooAsset
+{
+    public class DestroyOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            CheckInitStatus,
+            UnloadAllAssets,
+            DestroyPackage,
+            Done,
+        }
+
+        private readonly ResourcePackage _resourcePackage;
+        private UnloadAllAssetsOperation _unloadAllAssetsOp;
+        private ESteps _steps = ESteps.None;
+
+
+        public DestroyOperation(ResourcePackage resourcePackage)
+        {
+            _resourcePackage = resourcePackage;
+        }
+
+        internal override void InternalStart()
+        {
+            _steps = ESteps.CheckInitStatus;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.CheckInitStatus)
+            {
+                if (_resourcePackage.InitializeStatus == EOperationStatus.None)
+                {
+                    _steps = ESteps.DestroyPackage;
+                }
+                else if (_resourcePackage.InitializeStatus == EOperationStatus.Processing)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = "The Package is initializing ! Please try to destroy the package again later.";
+                }
+                else if (_resourcePackage.InitializeStatus == EOperationStatus.Failed)
+                {
+                    _steps = ESteps.DestroyPackage;
+                }
+                else if (_resourcePackage.InitializeStatus == EOperationStatus.Succeed)
+                {
+                    if (_resourcePackage.PackageValid)
+                        _steps = ESteps.UnloadAllAssets;
+                    else
+                        _steps = ESteps.DestroyPackage;
+                }
+                else
+                {
+                    throw new System.NotImplementedException(_resourcePackage.InitializeStatus.ToString());
+                }
+            }
+
+            if (_steps == ESteps.UnloadAllAssets)
+            {
+                if (_unloadAllAssetsOp == null)
+                {
+                    _unloadAllAssetsOp = _resourcePackage.UnloadAllAssetsAsync();
+                    _unloadAllAssetsOp.StartOperation();
+                    AddChildOperation(_unloadAllAssetsOp);
+                }
+
+                _unloadAllAssetsOp.UpdateOperation();
+                if (_unloadAllAssetsOp.IsDone == false)
+                    return;
+
+                if (_unloadAllAssetsOp.Status == EOperationStatus.Succeed)
+                {
+                    _steps = ESteps.DestroyPackage;
+                }
+                else
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _unloadAllAssetsOp.Error;
+                }
+            }
+
+            if (_steps == ESteps.DestroyPackage)
+            {
+                // 销毁包裹
+                _resourcePackage.DestroyPackage();
+
+                // 最后清理该包裹的异步任务
+                // 注意：对于有线程操作的异步任务，需要保证线程安全释放。
+                OperationSystem.ClearPackageOperation(_resourcePackage.PackageName);
+
+                _steps = ESteps.Done;
+                Status = EOperationStatus.Succeed;
+            }
+        }
+        internal override string InternalGetDesc()
+        {
+            return $"PackageVersion : {_resourcePackage.GetPackageVersion()}";
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: fbbd05ac4599c4549b2256c8dd6691a9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,424 @@
+using System.Collections;
+using System.Collections.Generic;
+
+namespace YooAsset
+{
+    public abstract class DownloaderOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            Check,
+            Loading,
+            Done,
+        }
+
+        private const int MAX_LOADER_COUNT = 64;
+
+        #region 委托定义
+        /// <summary>
+        /// 下载器结束
+        /// </summary>
+        public delegate void DownloaderFinish(DownloaderFinishData data);
+
+        /// <summary>
+        /// 下载进度更新
+        /// </summary>
+        public delegate void DownloadUpdate(DownloadUpdateData data);
+
+        /// <summary>
+        /// 下载发生错误
+        /// </summary>
+        public delegate void DownloadError(DownloadErrorData data);
+
+        /// <summary>
+        /// 开始下载某个文件
+        /// </summary>
+        public delegate void DownloadFileBegin(DownloadFileData data);
+        #endregion
+
+        private readonly string _packageName;
+        private readonly int _downloadingMaxNumber;
+        private readonly int _failedTryAgain;
+        private readonly List<BundleInfo> _bundleInfoList;
+        private readonly List<FSDownloadFileOperation> _downloaders = new List<FSDownloadFileOperation>(MAX_LOADER_COUNT);
+        private readonly List<FSDownloadFileOperation> _removeList = new List<FSDownloadFileOperation>(MAX_LOADER_COUNT);
+        private readonly List<FSDownloadFileOperation> _failedList = new List<FSDownloadFileOperation>(MAX_LOADER_COUNT);
+
+        // 数据相关
+        private bool _isPause = false;
+        private long _lastDownloadBytes = 0;
+        private int _lastDownloadCount = 0;
+        private long _cachedDownloadBytes = 0;
+        private int _cachedDownloadCount = 0;
+        private ESteps _steps = ESteps.None;
+
+
+        /// <summary>
+        /// 统计的下载文件总数量
+        /// </summary>
+        public int TotalDownloadCount { private set; get; }
+
+        /// <summary>
+        /// 统计的下载文件的总大小
+        /// </summary>
+        public long TotalDownloadBytes { private set; get; }
+
+        /// <summary>
+        /// 当前已经完成的下载总数量
+        /// </summary>
+        public int CurrentDownloadCount
+        {
+            get { return _lastDownloadCount; }
+        }
+
+        /// <summary>
+        /// 当前已经完成的下载总大小
+        /// </summary>
+        public long CurrentDownloadBytes
+        {
+            get { return _lastDownloadBytes; }
+        }
+
+        /// <summary>
+        /// 当下载器结束（无论成功或失败）
+        /// </summary>
+        public DownloaderFinish DownloadFinishCallback { set; get; }
+
+        /// <summary>
+        /// 当下载进度发生变化
+        /// </summary>
+        public DownloadUpdate DownloadUpdateCallback { set; get; }
+
+        /// <summary>
+        /// 当下载器发生错误
+        /// </summary>
+        public DownloadError DownloadErrorCallback { set; get; }
+
+        /// <summary>
+        /// 当开始下载某个文件
+        /// </summary>
+        public DownloadFileBegin DownloadFileBeginCallback { set; get; }
+
+
+        internal DownloaderOperation(string packageName, List<BundleInfo> downloadList, int downloadingMaxNumber, int failedTryAgain)
+        {
+            _packageName = packageName;
+            _bundleInfoList = downloadList;
+            _downloadingMaxNumber = UnityEngine.Mathf.Clamp(downloadingMaxNumber, 1, MAX_LOADER_COUNT); ;
+            _failedTryAgain = failedTryAgain;
+
+            // 设置包裹名称 (fix #210)
+            SetPackageName(packageName);
+
+            // 统计下载信息
+            CalculatDownloaderInfo();
+        }
+        internal override void InternalStart()
+        {
+            YooLogger.Log($"Begine to download {TotalDownloadCount} files and {TotalDownloadBytes} bytes");
+            _steps = ESteps.Check;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.Check)
+            {
+                if (_bundleInfoList == null)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = "Download list is null.";
+                }
+                else
+                {
+                    _steps = ESteps.Loading;
+                }
+            }
+
+            if (_steps == ESteps.Loading)
+            {
+                // 检测下载器结果
+                _removeList.Clear();
+                long downloadBytes = _cachedDownloadBytes;
+                foreach (var downloader in _downloaders)
+                {
+                    downloader.UpdateOperation();
+                    downloadBytes += downloader.DownloadedBytes;
+                    if (downloader.IsDone == false)
+                        continue;
+
+                    // 检测是否下载失败
+                    if (downloader.Status != EOperationStatus.Succeed)
+                    {
+                        _removeList.Add(downloader);
+                        _failedList.Add(downloader);
+                        continue;
+                    }
+
+                    // 下载成功
+                    _removeList.Add(downloader);
+                    _cachedDownloadCount++;
+                    _cachedDownloadBytes += downloader.DownloadedBytes;
+                }
+
+                // 移除已经完成的下载器（无论成功或失败）
+                foreach (var downloader in _removeList)
+                {
+                    _downloaders.Remove(downloader);
+                }
+
+                // 如果下载进度发生变化
+                if (_lastDownloadBytes != downloadBytes || _lastDownloadCount != _cachedDownloadCount)
+                {
+                    _lastDownloadBytes = downloadBytes;
+                    _lastDownloadCount = _cachedDownloadCount;
+                    Progress = (float)_lastDownloadBytes / TotalDownloadBytes;
+
+                    if (DownloadUpdateCallback != null)
+                    {
+                        var data = new DownloadUpdateData();
+                        data.PackageName = _packageName;
+                        data.Progress = Progress;
+                        data.TotalDownloadCount = TotalDownloadCount;
+                        data.CurrentDownloadCount = _lastDownloadCount;
+                        data.TotalDownloadBytes = TotalDownloadBytes;
+                        data.CurrentDownloadBytes = _lastDownloadBytes;
+                        DownloadUpdateCallback.Invoke(data);
+                    }
+                }
+
+                // 动态创建新的下载器到最大数量限制
+                // 注意：如果期间有下载失败的文件，暂停动态创建下载器
+                if (_bundleInfoList.Count > 0 && _failedList.Count == 0)
+                {
+                    if (_isPause)
+                        return;
+
+                    if (_downloaders.Count < _downloadingMaxNumber)
+                    {
+                        int index = _bundleInfoList.Count - 1;
+                        var bundleInfo = _bundleInfoList[index];
+                        var downloader = bundleInfo.CreateDownloader(_failedTryAgain);
+                        downloader.StartOperation();
+                        this.AddChildOperation(downloader);
+
+                        _downloaders.Add(downloader);
+                        _bundleInfoList.RemoveAt(index);
+
+                        if (DownloadFileBeginCallback != null)
+                        {
+                            var data = new DownloadFileData();
+                            data.PackageName = _packageName;
+                            data.FileName = bundleInfo.Bundle.BundleName;
+                            data.FileSize = bundleInfo.Bundle.FileSize;
+                            DownloadFileBeginCallback.Invoke(data);
+                        }
+                    }
+                }
+
+                // 下载结算
+                if (_downloaders.Count == 0)
+                {
+                    if (_failedList.Count > 0)
+                    {
+                        var failedDownloader = _failedList[0];
+                        string bundleName = failedDownloader.Bundle.BundleName;
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = $"Failed to download file : {bundleName}";
+
+                        if (DownloadErrorCallback != null)
+                        {
+                            var data = new DownloadErrorData();
+                            data.PackageName = _packageName;
+                            data.FileName = bundleName;
+                            data.ErrorInfo = failedDownloader.Error;
+                            DownloadErrorCallback.Invoke(data);
+                        }
+
+                        if (DownloadFinishCallback != null)
+                        {
+                            var data = new DownloaderFinishData();
+                            data.PackageName = _packageName;
+                            data.Succeed = false;
+                            DownloadFinishCallback.Invoke(data);
+                        }
+                    }
+                    else
+                    {
+                        // 结算成功
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Succeed;
+
+                        if (DownloadFinishCallback != null)
+                        {
+                            var data = new DownloaderFinishData();
+                            data.PackageName = _packageName;
+                            data.Succeed = true;
+                            DownloadFinishCallback.Invoke(data);
+                        }
+                    }
+                }
+            }
+        }
+        private void CalculatDownloaderInfo()
+        {
+            if (_bundleInfoList != null)
+            {
+                TotalDownloadBytes = 0;
+                TotalDownloadCount = _bundleInfoList.Count;
+                foreach (var packageBundle in _bundleInfoList)
+                {
+                    TotalDownloadBytes += packageBundle.Bundle.FileSize;
+                }
+            }
+            else
+            {
+                TotalDownloadBytes = 0;
+                TotalDownloadCount = 0;
+            }
+        }
+
+        /// <summary>
+        /// 合并其它下载器
+        /// </summary>
+        /// <param name="downloader">合并的下载器</param>
+        public void Combine(DownloaderOperation downloader)
+        {
+            if (_packageName != downloader._packageName)
+            {
+                YooLogger.Error("The downloaders have different resource packages !");
+                return;
+            }
+
+            if (Status != EOperationStatus.None)
+            {
+                YooLogger.Error("The downloader is running, can not combine with other downloader !");
+                return;
+            }
+
+            HashSet<string> temper = new HashSet<string>();
+            foreach (var bundleInfo in _bundleInfoList)
+            {
+                string combineGUID = bundleInfo.GetDownloadCombineGUID();
+                if (temper.Contains(combineGUID) == false)
+                {
+                    temper.Add(combineGUID);
+                }
+            }
+
+            // 合并下载列表
+            foreach (var bundleInfo in downloader._bundleInfoList)
+            {
+                string combineGUID = bundleInfo.GetDownloadCombineGUID();
+                if (temper.Contains(combineGUID) == false)
+                {
+                    _bundleInfoList.Add(bundleInfo);
+                }
+            }
+
+            // 重新统计下载信息
+            CalculatDownloaderInfo();
+        }
+
+        /// <summary>
+        /// 开始下载
+        /// </summary>
+        public void BeginDownload()
+        {
+            if (_steps == ESteps.None)
+            {
+                OperationSystem.StartOperation(_packageName, this);
+            }
+        }
+
+        /// <summary>
+        /// 暂停下载
+        /// </summary>
+        public void PauseDownload()
+        {
+            _isPause = true;
+        }
+
+        /// <summary>
+        /// 恢复下载
+        /// </summary>
+        public void ResumeDownload()
+        {
+            _isPause = false;
+        }
+
+        /// <summary>
+        /// 取消下载
+        /// </summary>
+        public void CancelDownload()
+        {
+            if (_steps != ESteps.Done)
+            {
+                _steps = ESteps.Done;
+                Status = EOperationStatus.Failed;
+                Error = "User cancel.";
+
+                foreach (var downloader in _downloaders)
+                {
+                    downloader.AbortOperation();
+                }
+            }
+        }
+    }
+
+    public sealed class ResourceDownloaderOperation : DownloaderOperation
+    {
+        internal ResourceDownloaderOperation(string packageName, List<BundleInfo> downloadList, int downloadingMaxNumber, int failedTryAgain)
+            : base(packageName, downloadList, downloadingMaxNumber, failedTryAgain)
+        {
+        }
+
+        /// <summary>
+        /// 创建空的下载器
+        /// </summary>
+        internal static ResourceDownloaderOperation CreateEmptyDownloader(string packageName, int downloadingMaxNumber, int failedTryAgain)
+        {
+            List<BundleInfo> downloadList = new List<BundleInfo>();
+            var operation = new ResourceDownloaderOperation(packageName, downloadList, downloadingMaxNumber, failedTryAgain);
+            return operation;
+        }
+    }
+    public sealed class ResourceUnpackerOperation : DownloaderOperation
+    {
+        internal ResourceUnpackerOperation(string packageName, List<BundleInfo> downloadList, int downloadingMaxNumber, int failedTryAgain)
+            : base(packageName, downloadList, downloadingMaxNumber, failedTryAgain)
+        {
+        }
+
+        /// <summary>
+        /// 创建空的解压器
+        /// </summary>
+        internal static ResourceUnpackerOperation CreateEmptyUnpacker(string packageName, int upackingMaxNumber, int failedTryAgain)
+        {
+            List<BundleInfo> downloadList = new List<BundleInfo>();
+            var operation = new ResourceUnpackerOperation(packageName, downloadList, upackingMaxNumber, failedTryAgain);
+            return operation;
+        }
+    }
+    public sealed class ResourceImporterOperation : DownloaderOperation
+    {
+        internal ResourceImporterOperation(string packageName, List<BundleInfo> downloadList, int downloadingMaxNumber, int failedTryAgain)
+            : base(packageName, downloadList, downloadingMaxNumber, failedTryAgain)
+        {
+        }
+
+        /// <summary>
+        /// 创建空的导入器
+        /// </summary>
+        internal static ResourceImporterOperation CreateEmptyImporter(string packageName, int upackingMaxNumber, int failedTryAgain)
+        {
+            List<BundleInfo> downloadList = new List<BundleInfo>();
+            var operation = new ResourceImporterOperation(packageName, downloadList, upackingMaxNumber, failedTryAgain);
+            return operation;
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 04a0f4abed132b54e92b59ca538e71fd
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,129 @@
+using System.Collections.Generic;
+using System.Linq;
+
+namespace YooAsset
+{
+    public class InitializationOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            Prepare,
+            ClearOldFileSystem,
+            InitFileSystem,
+            CheckInitResult,
+            Done,
+        }
+
+        private readonly PlayModeImpl _impl;
+        private readonly List<FileSystemParameters> _parametersList;
+        private List<FileSystemParameters> _cloneList;
+        private FSInitializeFileSystemOperation _initFileSystemOp;
+        private ESteps _steps = ESteps.None;
+
+        internal InitializationOperation(PlayModeImpl impl, List<FileSystemParameters> parametersList)
+        {
+            _impl = impl;
+            _parametersList = parametersList;
+        }
+        internal override void InternalStart()
+        {
+            _steps = ESteps.Prepare;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.Prepare)
+            {
+                if (_parametersList == null || _parametersList.Count == 0)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = "The file system parameters is empty !";
+                    return;
+                }
+
+                foreach (var fileSystemParam in _parametersList)
+                {
+                    if (fileSystemParam == null)
+                    {
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = "An empty object exists in the list!";
+                        return;
+                    }
+                }
+
+                _cloneList = _parametersList.ToList();
+                _steps = ESteps.ClearOldFileSystem;
+            }
+
+            if (_steps == ESteps.ClearOldFileSystem)
+            {
+                // 注意：初始化失败后可能会残存一些旧的文件系统！
+                foreach (var fileSystem in _impl.FileSystems)
+                {
+                    fileSystem.OnDestroy();
+                }
+
+                _impl.FileSystems.Clear();
+                _steps = ESteps.InitFileSystem;
+            }
+
+            if (_steps == ESteps.InitFileSystem)
+            {
+                if (_cloneList.Count == 0)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Succeed;
+                }
+                else
+                {
+                    var fileSystemParams = _cloneList[0];
+                    _cloneList.RemoveAt(0);
+
+                    IFileSystem fileSystemInstance = fileSystemParams.CreateFileSystem(_impl.PackageName);
+                    if (fileSystemInstance == null)
+                    {
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = "Failed to create file system instance !";
+                        return;
+                    }
+
+                    _impl.FileSystems.Add(fileSystemInstance);
+                    _initFileSystemOp = fileSystemInstance.InitializeFileSystemAsync();
+                    _initFileSystemOp.StartOperation();
+                    AddChildOperation(_initFileSystemOp);
+                    _steps = ESteps.CheckInitResult;
+                }
+            }
+
+            if (_steps == ESteps.CheckInitResult)
+            {
+                _initFileSystemOp.UpdateOperation();
+                Progress = _initFileSystemOp.Progress;
+                if (_initFileSystemOp.IsDone == false)
+                    return;
+
+                if (_initFileSystemOp.Status == EOperationStatus.Succeed)
+                {
+                    _steps = ESteps.InitFileSystem;
+                }
+                else
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _initFileSystemOp.Error;
+                    return;
+                }
+            }
+        }
+        internal override string InternalGetDesc()
+        {
+            return $"PlayMode : {_impl.PlayMode}";
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: db273663b9698b147a1393ee84d23f4d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 195a354e5545bd84a907c097f54c30a6
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,198 @@
+using System.IO;
+using System.Collections;
+using System.Collections.Generic;
+using System;
+
+namespace YooAsset
+{
+    internal class DeserializeManifestOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            RestoreFileData,
+            DeserializeFileHeader,
+            PrepareAssetList,
+            DeserializeAssetList,
+            PrepareBundleList,
+            DeserializeBundleList,
+            InitManifest,
+            Done,
+        }
+
+        private readonly IManifestRestoreServices _services;
+        private byte[] _sourceData;
+        private BufferReader _buffer;
+        private int _packageAssetCount;
+        private int _packageBundleCount;
+        private int _progressTotalValue;
+        private ESteps _steps = ESteps.None;
+
+        /// <summary>
+        /// 解析的清单实例
+        /// </summary>
+        public PackageManifest Manifest { private set; get; }
+
+        public DeserializeManifestOperation(IManifestRestoreServices services, byte[] binaryData)
+        {
+            _services = services;
+            _sourceData = binaryData;
+        }
+        internal override void InternalStart()
+        {
+            _steps = ESteps.RestoreFileData;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            try
+            {
+                if (_steps == ESteps.RestoreFileData)
+                {
+                    if (_services != null)
+                    {
+                        var resultData = _services.RestoreManifest(_sourceData);
+                        if (resultData != null)
+                            _sourceData = resultData;
+                    }
+
+                    _buffer = new BufferReader(_sourceData);
+                    _steps = ESteps.DeserializeFileHeader;
+                }
+
+                if (_steps == ESteps.DeserializeFileHeader)
+                {
+                    if (_buffer.IsValid == false)
+                    {
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = "Buffer is invalid !";
+                        return;
+                    }
+
+                    // 读取文件标记
+                    uint fileSign = _buffer.ReadUInt32();
+                    if (fileSign != ManifestDefine.FileSign)
+                    {
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = "The manifest file format is invalid !";
+                        return;
+                    }
+
+                    // 读取文件版本
+                    string fileVersion = _buffer.ReadUTF8();
+                    if (fileVersion != ManifestDefine.FileVersion)
+                    {
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Failed;
+                        Error = $"The manifest file version are not compatible : {fileVersion} != {ManifestDefine.FileVersion}";
+                        return;
+                    }
+
+                    // 读取文件头信息
+                    Manifest = new PackageManifest();
+                    Manifest.FileVersion = fileVersion;
+                    Manifest.EnableAddressable = _buffer.ReadBool();
+                    Manifest.SupportExtensionless = _buffer.ReadBool();
+                    Manifest.LocationToLower = _buffer.ReadBool();
+                    Manifest.IncludeAssetGUID = _buffer.ReadBool();
+                    Manifest.OutputNameStyle = _buffer.ReadInt32();
+                    Manifest.BuildBundleType = _buffer.ReadInt32();
+                    Manifest.BuildPipeline = _buffer.ReadUTF8();
+                    Manifest.PackageName = _buffer.ReadUTF8();
+                    Manifest.PackageVersion = _buffer.ReadUTF8();
+                    Manifest.PackageNote = _buffer.ReadUTF8();
+
+                    // 检测配置
+                    if (Manifest.EnableAddressable && Manifest.LocationToLower)
+                        throw new System.Exception("Addressable not support location to lower !");
+
+                    _steps = ESteps.PrepareAssetList;
+                }
+
+                if (_steps == ESteps.PrepareAssetList)
+                {
+                    _packageAssetCount = _buffer.ReadInt32();
+                    _progressTotalValue = _packageAssetCount;
+                    ManifestTools.CreateAssetCollection(Manifest, _packageAssetCount);
+                    _steps = ESteps.DeserializeAssetList;
+                }
+                if (_steps == ESteps.DeserializeAssetList)
+                {
+                    while (_packageAssetCount > 0)
+                    {
+                        var packageAsset = new PackageAsset();
+                        packageAsset.Address = _buffer.ReadUTF8();
+                        packageAsset.AssetPath = _buffer.ReadUTF8();
+                        packageAsset.AssetGUID = _buffer.ReadUTF8();
+                        packageAsset.AssetTags = _buffer.ReadUTF8Array();
+                        packageAsset.BundleID = _buffer.ReadInt32();
+                        packageAsset.DependBundleIDs = _buffer.ReadInt32Array();
+                        ManifestTools.FillAssetCollection(Manifest, packageAsset);
+
+                        _packageAssetCount--;
+                        Progress = 1f - _packageAssetCount / _progressTotalValue;
+                        if (OperationSystem.IsBusy)
+                            break;
+                    }
+
+                    if (_packageAssetCount <= 0)
+                    {
+                        _steps = ESteps.PrepareBundleList;
+                    }
+                }
+
+                if (_steps == ESteps.PrepareBundleList)
+                {
+                    _packageBundleCount = _buffer.ReadInt32();
+                    _progressTotalValue = _packageBundleCount;
+                    ManifestTools.CreateBundleCollection(Manifest, _packageBundleCount);
+                    _steps = ESteps.DeserializeBundleList;
+                }
+                if (_steps == ESteps.DeserializeBundleList)
+                {
+                    while (_packageBundleCount > 0)
+                    {
+                        var packageBundle = new PackageBundle();
+                        packageBundle.BundleName = _buffer.ReadUTF8();
+                        packageBundle.UnityCRC = _buffer.ReadUInt32();
+                        packageBundle.FileHash = _buffer.ReadUTF8();
+                        packageBundle.FileCRC = _buffer.ReadUInt32();
+                        packageBundle.FileSize = _buffer.ReadInt64();
+                        packageBundle.Encrypted = _buffer.ReadBool();
+                        packageBundle.Tags = _buffer.ReadUTF8Array();
+                        packageBundle.DependBundleIDs = _buffer.ReadInt32Array();
+                        ManifestTools.FillBundleCollection(Manifest, packageBundle);
+
+                        _packageBundleCount--;
+                        Progress = 1f - _packageBundleCount / _progressTotalValue;
+                        if (OperationSystem.IsBusy)
+                            break;
+                    }
+
+                    if (_packageBundleCount <= 0)
+                    {
+                        _steps = ESteps.InitManifest;
+                    }
+                }
+
+                if (_steps == ESteps.InitManifest)
+                {
+                    ManifestTools.InitManifest(Manifest);
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Succeed;
+                }
+            }
+            catch (System.Exception e)
+            {
+                Manifest = null;
+                _steps = ESteps.Done;
+                Status = EOperationStatus.Failed;
+                Error = e.Message;
+            }
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3fc880b26f2011b49a9ec9ddca089f9f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,204 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+
+namespace YooAsset
+{
+    public sealed class PreDownloadContentOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            CheckParams,
+            CheckActiveManifest,
+            LoadPackageManifest,
+            Done,
+        }
+
+        private readonly PlayModeImpl _impl;
+        private readonly string _packageVersion;
+        private readonly int _timeout;
+        private FSLoadPackageManifestOperation _loadPackageManifestOp;
+        private PackageManifest _manifest;
+        private ESteps _steps = ESteps.None;
+
+
+        internal PreDownloadContentOperation(PlayModeImpl impl, string packageVersion, int timeout)
+        {
+            _impl = impl;
+            _packageVersion = packageVersion;
+            _timeout = timeout;
+        }
+        internal override void InternalStart()
+        {
+            _steps = ESteps.CheckParams;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.CheckParams)
+            {
+                if (string.IsNullOrEmpty(_packageVersion))
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = "Package version is null or empty.";
+                    return;
+                }
+
+                _steps = ESteps.CheckActiveManifest;
+            }
+
+            if (_steps == ESteps.CheckActiveManifest)
+            {
+                // 检测当前激活的清单对象
+                if (_impl.ActiveManifest != null)
+                {
+                    if (_impl.ActiveManifest.PackageVersion == _packageVersion)
+                    {
+                        _manifest = _impl.ActiveManifest;
+                        _steps = ESteps.Done;
+                        Status = EOperationStatus.Succeed;
+                        return;
+                    }
+                }
+                _steps = ESteps.LoadPackageManifest;
+            }
+
+            if (_steps == ESteps.LoadPackageManifest)
+            {
+                if (_loadPackageManifestOp == null)
+                {
+                    var mainFileSystem = _impl.GetMainFileSystem();
+                    _loadPackageManifestOp = mainFileSystem.LoadPackageManifestAsync(_packageVersion, _timeout);
+                    _loadPackageManifestOp.StartOperation();
+                    AddChildOperation(_loadPackageManifestOp);
+                }
+
+                _loadPackageManifestOp.UpdateOperation();
+                if (_loadPackageManifestOp.IsDone == false)
+                    return;
+
+                if (_loadPackageManifestOp.Status == EOperationStatus.Succeed)
+                {
+                    _manifest = _loadPackageManifestOp.Manifest;
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Succeed;
+                }
+                else
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _loadPackageManifestOp.Error;
+                }
+            }
+        }
+
+        /// <summary>
+        /// 创建资源下载器，用于下载当前资源版本所有的资源包文件
+        /// </summary>
+        /// <param name="downloadingMaxNumber">同时下载的最大文件数</param>
+        /// <param name="failedTryAgain">下载失败的重试次数</param>
+        public ResourceDownloaderOperation CreateResourceDownloader(int downloadingMaxNumber, int failedTryAgain)
+        {
+            if (Status != EOperationStatus.Succeed)
+            {
+                YooLogger.Warning($"{nameof(PreDownloadContentOperation)} status is not succeed !");
+                return ResourceDownloaderOperation.CreateEmptyDownloader(_impl.PackageName, downloadingMaxNumber, failedTryAgain);
+            }
+
+            List<BundleInfo> downloadList = _impl.GetDownloadListByAll(_manifest);
+            var operation = new ResourceDownloaderOperation(_impl.PackageName, downloadList, downloadingMaxNumber, failedTryAgain);
+            return operation;
+        }
+
+        /// <summary>
+        /// 创建资源下载器，用于下载指定的资源标签关联的资源包文件
+        /// </summary>
+        /// <param name="tag">资源标签</param>
+        /// <param name="downloadingMaxNumber">同时下载的最大文件数</param>
+        /// <param name="failedTryAgain">下载失败的重试次数</param>
+        public ResourceDownloaderOperation CreateResourceDownloader(string tag, int downloadingMaxNumber, int failedTryAgain)
+        {
+            if (Status != EOperationStatus.Succeed)
+            {
+                YooLogger.Warning($"{nameof(PreDownloadContentOperation)} status is not succeed !");
+                return ResourceDownloaderOperation.CreateEmptyDownloader(_impl.PackageName, downloadingMaxNumber, failedTryAgain);
+            }
+
+            List<BundleInfo> downloadList = _impl.GetDownloadListByTags(_manifest, new string[] { tag });
+            var operation = new ResourceDownloaderOperation(_impl.PackageName, downloadList, downloadingMaxNumber, failedTryAgain);
+            return operation;
+        }
+
+        /// <summary>
+        /// 创建资源下载器，用于下载指定的资源标签列表关联的资源包文件
+        /// </summary>
+        /// <param name="tags">资源标签列表</param>
+        /// <param name="downloadingMaxNumber">同时下载的最大文件数</param>
+        /// <param name="failedTryAgain">下载失败的重试次数</param>
+        public ResourceDownloaderOperation CreateResourceDownloader(string[] tags, int downloadingMaxNumber, int failedTryAgain)
+        {
+            if (Status != EOperationStatus.Succeed)
+            {
+                YooLogger.Warning($"{nameof(PreDownloadContentOperation)} status is not succeed !");
+                return ResourceDownloaderOperation.CreateEmptyDownloader(_impl.PackageName, downloadingMaxNumber, failedTryAgain);
+            }
+
+            List<BundleInfo> downloadList = _impl.GetDownloadListByTags(_manifest, tags);
+            var operation = new ResourceDownloaderOperation(_impl.PackageName, downloadList, downloadingMaxNumber, failedTryAgain);
+            return operation;
+        }
+
+        /// <summary>
+        /// 创建资源下载器，用于下载指定的资源依赖的资源包文件
+        /// </summary>
+        /// <param name="location">资源定位地址</param>
+        /// <param name="downloadingMaxNumber">同时下载的最大文件数</param>
+        /// <param name="failedTryAgain">下载失败的重试次数</param>
+        public ResourceDownloaderOperation CreateBundleDownloader(string location, bool recursiveDownload, int downloadingMaxNumber, int failedTryAgain)
+        {
+            if (Status != EOperationStatus.Succeed)
+            {
+                YooLogger.Warning($"{nameof(PreDownloadContentOperation)} status is not succeed !");
+                return ResourceDownloaderOperation.CreateEmptyDownloader(_impl.PackageName, downloadingMaxNumber, failedTryAgain);
+            }
+
+            List<AssetInfo> assetInfos = new List<AssetInfo>();
+            var assetInfo = _manifest.ConvertLocationToAssetInfo(location, null);
+            assetInfos.Add(assetInfo);
+
+            List<BundleInfo> downloadList = _impl.GetDownloadListByPaths(_manifest, assetInfos.ToArray(), recursiveDownload);
+            var operation = new ResourceDownloaderOperation(_impl.PackageName, downloadList, downloadingMaxNumber, failedTryAgain);
+            return operation;
+        }
+
+        /// <summary>
+        /// 创建资源下载器，用于下载指定的资源列表依赖的资源包文件
+        /// </summary>
+        /// <param name="locations">资源定位地址列表</param>
+        /// <param name="downloadingMaxNumber">同时下载的最大文件数</param>
+        /// <param name="failedTryAgain">下载失败的重试次数</param>
+        public ResourceDownloaderOperation CreateBundleDownloader(string[] locations, bool recursiveDownload, int downloadingMaxNumber, int failedTryAgain)
+        {
+            if (Status != EOperationStatus.Succeed)
+            {
+                YooLogger.Warning($"{nameof(PreDownloadContentOperation)} status is not succeed !");
+                return ResourceDownloaderOperation.CreateEmptyDownloader(_impl.PackageName, downloadingMaxNumber, failedTryAgain);
+            }
+
+            List<AssetInfo> assetInfos = new List<AssetInfo>(locations.Length);
+            foreach (var location in locations)
+            {
+                var assetInfo = _manifest.ConvertLocationToAssetInfo(location, null);
+                assetInfos.Add(assetInfo);
+            }
+
+            List<BundleInfo> downloadList = _impl.GetDownloadListByPaths(_manifest, assetInfos.ToArray(), recursiveDownload);
+            var operation = new ResourceDownloaderOperation(_impl.PackageName, downloadList, downloadingMaxNumber, failedTryAgain);
+            return operation;
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: af6a21acd57568f4da97385c2205fbfe
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,70 @@
+
+namespace YooAsset
+{
+    public abstract class RequestPackageVersionOperation : AsyncOperationBase
+    {
+        /// <summary>
+        /// 当前最新的包裹版本
+        /// </summary>
+        public string PackageVersion { protected set; get; }
+    }
+    internal sealed class RequestPackageVersionImplOperation : RequestPackageVersionOperation
+    {
+        private enum ESteps
+        {
+            None,
+            RequestPackageVersion,
+            Done,
+        }
+
+        private readonly PlayModeImpl _impl;
+        private readonly bool _appendTimeTicks;
+        private readonly int _timeout;
+        private FSRequestPackageVersionOperation _requestPackageVersionOp;
+        private ESteps _steps = ESteps.None;
+
+        internal RequestPackageVersionImplOperation(PlayModeImpl impl, bool appendTimeTicks, int timeout)
+        {
+            _impl = impl;
+            _appendTimeTicks = appendTimeTicks;
+            _timeout = timeout;
+        }
+        internal override void InternalStart()
+        {
+            _steps = ESteps.RequestPackageVersion;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.RequestPackageVersion)
+            {
+                if (_requestPackageVersionOp == null)
+                {
+                    var mainFileSystem = _impl.GetMainFileSystem();
+                    _requestPackageVersionOp = mainFileSystem.RequestPackageVersionAsync(_appendTimeTicks, _timeout);
+                    _requestPackageVersionOp.StartOperation();
+                    AddChildOperation(_requestPackageVersionOp);
+                }
+
+                _requestPackageVersionOp.UpdateOperation();
+                if (_requestPackageVersionOp.IsDone == false)
+                    return;
+
+                if (_requestPackageVersionOp.Status == EOperationStatus.Succeed)
+                {
+                    _steps = ESteps.Done;
+                    PackageVersion = _requestPackageVersionOp.PackageVersion;
+                    Status = EOperationStatus.Succeed;
+                }
+                else
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _requestPackageVersionOp.Error;
+                }
+            }
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c932bc08fecc3bf4bbc6f5a189e20012
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,97 @@
+
+namespace YooAsset
+{
+    public sealed class UpdatePackageManifestOperation : AsyncOperationBase
+    {
+        private enum ESteps
+        {
+            None,
+            CheckParams,
+            CheckActiveManifest,
+            LoadPackageManifest,
+            Done,
+        }
+
+        private readonly PlayModeImpl _impl;
+        private readonly string _packageVersion;
+        private readonly int _timeout;
+        private FSLoadPackageManifestOperation _loadPackageManifestOp;
+        private ESteps _steps = ESteps.None;
+
+        internal UpdatePackageManifestOperation(PlayModeImpl impl, string packageVersion, int timeout)
+        {
+            _impl = impl;
+            _packageVersion = packageVersion;
+            _timeout = timeout;
+        }
+        internal override void InternalStart()
+        {
+            _steps = ESteps.CheckParams;
+        }
+        internal override void InternalUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.CheckParams)
+            {
+                if (string.IsNullOrEmpty(_packageVersion))
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = "Package version is null or empty.";
+                }
+                else
+                {
+                    _steps = ESteps.CheckActiveManifest;
+                }
+            }
+
+            if (_steps == ESteps.CheckActiveManifest)
+            {
+                // 检测当前激活的清单对象	
+                if (_impl.ActiveManifest != null && _impl.ActiveManifest.PackageVersion == _packageVersion)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Succeed;
+                }
+                else
+                {
+                    _steps = ESteps.LoadPackageManifest;
+                }
+            }
+
+            if (_steps == ESteps.LoadPackageManifest)
+            {
+                if (_loadPackageManifestOp == null)
+                {
+                    var mainFileSystem = _impl.GetMainFileSystem();
+                    _loadPackageManifestOp = mainFileSystem.LoadPackageManifestAsync(_packageVersion, _timeout);
+                    _loadPackageManifestOp.StartOperation();
+                    AddChildOperation(_loadPackageManifestOp);
+                }
+
+                _loadPackageManifestOp.UpdateOperation();
+                if (_loadPackageManifestOp.IsDone == false)
+                    return;
+
+                if (_loadPackageManifestOp.Status == EOperationStatus.Succeed)
+                {
+                    _steps = ESteps.Done;
+                    _impl.ActiveManifest = _loadPackageManifestOp.Manifest;
+                    Status = EOperationStatus.Succeed;
+                }
+                else
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _loadPackageManifestOp.Error;
+                }
+            }
+        }
+        internal override string InternalGetDesc()
+        {
+            return $"PackageVersion : {_packageVersion}";
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 096f9a639be3faa44a4794aba017bc27
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: